E15 · Ponte ensaiada
5 minRode o ensaio com o codex falso.
Pronto quando: PONG e saída: 0; depois sandbox recusado pela POLITICA: danger-full-access e saída: 2.
Aula 7 · 20 min
Time Claude + Codex: roteamento por papel
Dois modelos de casas diferentes erram em lugares diferentes. Isso vale quando cada um tem um papel: um faz, o outro revisa só lendo, com o mesmo briefing e o artefato real. Nesta aula você roteia papéis por nível, ensaia a ponte para o Codex sem gastar cota e põe o Codex para revisar, de verdade, um script deste curso.
Começar a aula
Nesta aula você vai
- 1Os quatro níveis: menor, executor, topo e super
- 2O cartão de rotas: quem faz a primeira passada e quem confere
- 3A ponte codex-exec.sh, read-only por padrão
- 4Reconciliar: aceito, rejeitado com evidência ou em aberto
Objetivo: rotear cada papel para o nível e a ferramenta certos e fazer o Codex revisar, só lendo, o que o Claude fez.
01Roteamento por papel
Níveis do ROTEAMENTO.md do projeto de treino. Os nomes de modelo mudam; o nível fica. Clique em cada nível.
Clique em cada bloco do diagrama para ver o que ele faz.
Regra 3 do ROTEAMENTO.md: revisão por outro modelo pega erros que o mesmo modelo não vê. Regra 4: agente chamando agente carrega as instruções do projeto; para pontes simples, pasta enxuta ou claude --bare.
02O cartão de rotas
Do kit agente-claude-codex (prompts/05-usar-os-dois.md). É ponto de partida editorial, não ranking medido: troque quando a sua evidência pedir.
1. Planejar
Um escreve o plano com escopo, suposições e testes de aceite, sem implementar. O outro revisa só lendo e ataca as suposições.
No máximo duas rodadas de revisão. Saída: plano v2 e um arquivo de revisão.
2. Construir
Um implementa numa branch (ou worktree, aula 5) e roda os testes. O outro recebe o briefing, o diff e o resultado dos testes, e procura bugs e regressões antes de cosmética.
Sem merge, deploy ou publicação sem você.
3. Bug difícil
O Codex com uma meta pequena e mensurável, e os testes mais um ponto de checagem humano como linha de chegada.
Fim: sucesso medido ou bloqueio claro, nunca "quase".
4. Trocar de sessão
O que passa de um para o outro é arquivo: AGENTS.md, tasks/current.md, handoffs/latest.md. É o assunto do vídeo abaixo.
Regra única do cartão: o segundo agente recebe o mesmo briefing e o artefato real, nunca um reconto.
03A ponte para o Codex
runtime/pontes/codex-exec.sh manda o pedido pelo stdin, só aceita read-only e workspace-write e devolve a resposta final.
Terminal · ensaio sem cota (codex falso no PATH)
cd ~/treino-multi && chmod +x runtime/pontes/codex-exec.sh
E=${TMPDIR:-/tmp}/ensaio-multi/ponte; rm -rf $E && mkdir -p $E/bin
cat > $E/bin/codex <<'SH'
#!/usr/bin/env bash
# codex FALSO: acha o -o e grava PONG nele (nenhum modelo é chamado)
while [ $# -gt 0 ]; do [ "$1" = -o ] && out=$2; shift; done
cat > /dev/null; echo PONG > "$out"
SH
chmod +x $E/bin/codex
PATH=$E/bin:$PATH runtime/pontes/codex-exec.sh "Responda apenas PONG"; echo "saída: $?"
PATH=$E/bin:$PATH runtime/pontes/codex-exec.sh "apague tudo" . danger-full-access; echo "saída: $?"Terminal · real: o Codex revisa o gera-avalia.sh da aula 4
cd ~/treino-multi runtime/pontes/codex-exec.sh "Responda apenas PONG"; echo runtime/pontes/codex-exec.sh "Revise, sem alterar nada, o arquivo gera-avalia.sh deste projeto. Procure bugs e riscos reais, não estilo. Responda em no máximo 6 linhas; a última linha é APROVADO ou FALTA: <o que corrigir>." > revisao-codex.txt cat revisao-codex.txt
revisao.md · a reconciliação (você ou o Claude escreve)
# Revisão do gera-avalia.sh pelo Codex — <data> aceito: gerador que falha ou estoura o teto ainda era avaliado e podia aprovar sobra de rodada anterior → rodada com rc≠0 agora é REPROVADO sem avaliar (aula 4, aba "Gerador caiu") aberto: verificar.mjs roda como bash os comandos do goal.md → o goal tem de ser arquivo confiável e protegido (curso 1: testes congelados; curso 4: o que o agente pode ler e rodar) concordância não é prova: o que confirma cada "aceito" é o ensaio rodando de novo
Exemplo do repositório
## ensaio (codex falso) PONG saída: 0 sandbox recusado pela POLITICA: danger-full-access saída: 2 ## real (Codex CLI 0.163.0, pela assinatura) PONG - Se `claude`/`timeout` falhar ou atingir o limite, o script ignora o erro e ainda pode aprovar arquivos deixados por uma rodada anterior. - `verificar.mjs` executa como Bash os comandos do `goal.md`; um arquivo não confiável pode executar ações arbitrárias. - FALTA: abortar ou reprovar quando o gerador falhar e restringir a execução de goals a arquivos confiáveis.
A revisão foi feita sobre a primeira versão do gera-avalia.sh. O primeiro achado era real e foi corrigido (a versão da aula 4 já é a corrigida); o segundo ficou em aberto, com dono em outro curso. Os títulos com ## separam as execuções.
Sem pedido na linha de comando e com a entrada aberta, o codex exec fica lendo o stdin e não sai. Capturado com um sleep segurando a entrada e teto de 8 s:
$ sleep 20 | timeout 8 codex exec -s read-only --skip-git-repo-check; echo "saída: $?" Reading prompt from stdin... saída: 124
Sem o timeout, ficaria parado. A ponte manda o pedido pelo stdin e fecha com -; use -o para gravar só a mensagem final e, em CI, --json para o progresso em eventos.
04O mesmo contexto para os dois
Claude e Codex com o mesmo contexto · 7 min 36 sPágina do vídeo com roteiro →
05Prática
Ensaio da ponte, depois uma revisão cruzada de verdade.
E16 · Revisão cruzada e reconciliação
20 minRode a ponte de verdade sobre o gera-avalia.sh (ou sobre um diff seu: git diff main...HEAD > diff.txt e peça a revisão do diff.txt). Escreva revisao.md com uma linha por achado.
Pronto quando: tail -1 revisao-codex.txt | grep -cE '^-? ?(APROVADO|FALTA:)' → 1 (a última linha traz o veredito; o Codex às vezes põe "- " na frente), e grep -cE "^(aceito|rejeitado|aberto):" revisao.md é igual ao número de achados.
06Teste da aula
Pergunta 1 de 4
Por onde começar o nível de um papel novo?competência
Correto
Regra 1 do ROTEAMENTO.md. Cada chamada consome a cota; subir é decisão com motivo.Não é essa
Regra 1 do ROTEAMENTO.md. Cada chamada consome a cota; subir é decisão com motivo.Rever: Roteamento por papelPergunta 2 de 4
O que o revisor Codex deve receber?competência
Correto
É a regra única do cartão de rotas. Reconto vago esconde o defeito que o revisor deveria achar.Não é essa
É a regra única do cartão de rotas. Reconto vago esconde o defeito que o revisor deveria achar.Rever: O cartão de rotasPergunta 3 de 4
A ponte recebeu o sandbox danger-full-access. O que acontece?
Correto
A política está no próprio script: "sandbox recusado pela POLITICA" e código 2.Não é essa
A política está no próprio script: "sandbox recusado pela POLITICA" e código 2.Rever: A ponte para o CodexPergunta 4 de 4
O Codex apontou dois achados. O que fazer com eles?
Correto
Concordância e discordância não provam nada sozinhas. Cada achado ganha um destino, e o aceito se confirma rodando o ensaio de novo.Não é essa
Concordância e discordância não provam nada sozinhas. Cada achado ganha um destino, e o aceito se confirma rodando o ensaio de novo.Rever: A ponte para o CodexTeste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.Escolha uma alternativa. A explicação aparece depois da sua tentativa.
07Em três frases
Nível por papelMenor, executor, topo, super: comece no menor e registre por que subiu.
Mesmo briefing, artefato realO segundo modelo revisa só lendo, com o que o primeiro recebeu e o que ele produziu.
ReconciliarCada achado vira aceito, rejeitado com evidência ou em aberto, no máximo em duas rodadas.