🔌 Projeto 2: MCP e hooks entre Claude e Codex

Objetivo: reproduzir o inventário na sua máquina antes de mudar qualquer coisa, para ter linha de base.

# MCP que o Claude enxerga (global + por projeto)
claude mcp list
# esperado nesta máquina: magnific, metricool

# MCP por projeto ficam no .mcp.json de cada repo
ls ~/projetos/wifi/.mcp.json ~/projetos/2cerebrox/.mcp.json 2>/dev/null

# MCP que o Codex enxerga
codex mcp list
# esperado HOJE: lista vazia — este é o gap do projeto

# hooks dos dois lados
grep -o '"SessionStart"\|"PostToolUse"\|"Stop"' ~/.claude/settings.json | sort | uniq -c
grep -o '"SessionStart"\|"PostToolUse"\|"Stop"' ~/.codex/hooks.json | sort | uniq -c

Como verificar: anote as duas listas em context/overview.md do projeto onde você está trabalhando. No fim deste módulo, codex mcp list tem que deixar de ser vazio — e essa é a única métrica que importa no tópico 2.

Objetivo: registrar magnific e metricool no Codex referenciando as keys do .env, sem gravar valor nenhum.

# 1. wrapper que carrega o .env em runtime e passa o bastão pro servidor
mkdir -p ~/.local/bin
cat > ~/.local/bin/mcp-magnific.sh <<'SH'
#!/usr/bin/env bash
set -euo pipefail
set -a; . "$HOME/projetos/openpcbotv2/.env"; set +a   # carrega, não copia
exec npx -y @magnific/mcp-server                      # troque pelo comando real do seu MCP
SH
chmod 700 ~/.local/bin/mcp-magnific.sh

# 2. registrar no Codex: a config guarda um CAMINHO, nunca uma key
codex mcp add magnific  -- "$HOME/.local/bin/mcp-magnific.sh"
codex mcp add metricool -- "$HOME/.local/bin/mcp-metricool.sh"

# 3. conferir
codex mcp list

Como verificar: codex mcp list deixa de vir vazio e mostra os dois nomes. Depois abra codex numa pasta qualquer e peça "liste as ferramentas de MCP disponíveis" — os nomes têm que aparecer na resposta, não só no arquivo.

Objetivo: provar que nenhum segredo foi parar na configuração — este é o teste que fecha o tópico.

# procura prefixos típicos de key dentro da config do Codex
grep -rIl -e 'sk-' -e 'API_KEY=' -e 'TOKEN=' ~/.codex 2>/dev/null
# esperado: NENHUMA linha de saída

# confere que o wrapper não é legível por outros usuários
stat -c '%a %n' ~/.local/bin/mcp-*.sh
# esperado: 700 em todos

# confere que o .env continua sendo a fonte única
grep -c '=' ~/projetos/openpcbotv2/.env   # só a contagem; nunca imprima o conteúdo

Como verificar: o primeiro comando tem que sair mudo. Se ele imprimir qualquer caminho, pare tudo: alguma key foi copiada. Remova o registro com codex mcp remove <nome>, rotacione a key, e refaça pelo wrapper.

Objetivo: classificar automaticamente as suas skills entre "reutilizável" e "adaptador", para saber o que portar hoje.

# adaptador = o SKILL.md menciona MCP, plugin ou subagente
cd ~/.claude/skills
for d in */; do
  s="${d%/}"
  if grep -qE 'mcp__|AskUserQuestion|subagent_type|superpowers:|context-mode:' "$s/SKILL.md" 2>/dev/null; then
    echo "ADAPTADOR  $s"
  else
    echo "portavel   $s"
  fi
done | sort | tee ~/classificacao-skills.txt | awk '{print $1}' | uniq -c

# ver só as travadas, e por qual dependência
grep '^ADAPTADOR' ~/classificacao-skills.txt | awk '{print $2}' | while read s; do
  echo "== $s"; grep -ohE 'mcp__[a-z0-9_]+' "$s/SKILL.md" | sort -u
done

Como verificar: a contagem deve bater com a ordem de grandeza do diagnóstico — dezenas de portáveis contra cerca de 15 adaptadores. Se der 80 adaptadores, seu grep está pegando menção em exemplo; ajuste para olhar só as linhas de instrução.

Objetivo: ler o que está de fato registrado nos dois lados, em vez de supor.

# quais eventos o Codex tem registrados nesta máquina
python3 -c "import json;print(list(json.load(open('$HOME/.codex/hooks.json'))['hooks']))"
# esperado: ['PostToolUse', 'Stop']

# o matcher e o timeout de cada um
grep -E '"matcher"|"timeout"|"statusMessage"' ~/.codex/hooks.json

# o alvo dos dois hooks existe? (o hook é escrito para falhar em silêncio se não existir)
ls -l ~/.agents/skills/impeccable/scripts/hook.mjs

# o que o Claude dispara no SessionStart — este é o que NÃO tem par
grep -A4 '"SessionStart"' ~/.claude/settings.json

Como verificar: a lista do Codex sai com dois nomes e nenhum deles é SessionStart. Se o ls do hook.mjs falhar, os hooks do Codex estão registrados mas inertes — o [ ! -f ... ] || no começo do comando faz eles saírem calados.

Objetivo: acrescentar a regra de ritmo ao ~/.codex/AGENTS.md, substituindo o hook por leitura.

# backup antes de tocar na base global (Projeto 1 criou este arquivo)
cp ~/.codex/AGENTS.md ~/.codex/AGENTS.md.bak-$(date +%Y%m%d)

cat >> ~/.codex/AGENTS.md <<'MD'

## Regra de ritmo (era o hook fable-mindset no Claude)

- **Pense antes de agir.** Antes da primeira edição, diga em uma frase
  qual é o problema e qual é a menor mudança que o resolve. Se não
  souber, leia mais; não comece a editar para descobrir.
- **Feche o loop verificando.** Toda mudança termina com um comando que
  prova o resultado (teste, `grep`, `status`, readback) e com a saída
  colada na resposta. "Deve funcionar" não fecha o loop.
- **Uma correção por vez.** Se a resposta foi reescrever tudo,
  provavelmente faltava uma proteção — registre isso no FALHAS.md.
MD

# conferir que entrou e que o arquivo continua curto
tail -14 ~/.codex/AGENTS.md
wc -l ~/.codex/AGENTS.md

Como verificar: rode codex exec "Antes de editar qualquer arquivo, o que você deve dizer primeiro? Cite a fonte." a partir de ~. A resposta tem que mencionar a frase sobre o problema e a menor mudança, citando o AGENTS.md. Se ele responder bem sem citar a fonte, é coincidência do modelo, não leitura — e não conta como aceite.

Objetivo: converter os 7 subagentes em skills de papel, preservando o corpo do prompt e trocando só o cabeçalho.

mkdir -p ~/.agents/skills
for a in advogado-do-diabo analista-neutro estrategista-otimista \
         mestre-do-conselho diretor-ecossistema web-research-assistant \
         triple-x-responder; do
  src=~/.claude/agents/$a.md
  [ -f "$src" ] || { echo "faltou: $a"; continue; }
  mkdir -p ~/.agents/skills/papel-$a
  {
    echo "---"
    echo "name: papel-$a"
    echo "description: Assume o papel do $a. Use quando a tarefa pedir essa voz explicitamente."
    echo "---"
    echo
    echo "> Papel derivado do subagente \`$a\` do Claude Code."
    echo "> Aqui NÃO há execução paralela: assuma o papel no contexto atual e"
    echo "> deixe claro na resposta quando estiver falando por ele."
    echo
    sed '1{/^---$/!q}; 1,/^---$/d' "$src"   # tira só o front-matter antigo
  } > ~/.agents/skills/papel-$a/SKILL.md
  echo "papel-$a"
done

Como verificar: ls ~/.agents/skills | grep -c '^papel-' devolve 7. Depois, codex exec "Use o papel-advogado-do-diabo para atacar esta decisão: migrar tudo de uma vez." — a resposta tem que citar o arquivo da skill e sustentar a voz do contraditório do começo ao fim.