RECEITAS / 02
Dois agentes e um arquivo de passagem
O Claude Code revisa o módulo de cupom e grava os achados em REVISAO.md; o Codex lê o arquivo, corrige o primeiro achado e roda os testes.
Atualizado para o PrumoGrid 0.5.11
O cenário
Você quer uma segunda opinião antes de corrigir: um agente revisa, outro corrige. Na loja-api, o Claude Code revisa src/cupom.cjs sem alterar código e grava os achados em REVISAO.md. Depois, o Codex lê esse arquivo, corrige só o primeiro achado e roda npm test.
Veja no vídeo
Dois agentes, um fluxo. O Claude Code revisa, o Codex corrige e roda os testes, com um arquivo como ponte entre os dois. Legendas e transcrição ↗
Por que um arquivo
O Claude Code e o Codex são programas diferentes, cada um com sua conversa. Quando a etapa do Codex começa, ele não sabe nada do que o Claude Code leu ou concluiu. O PrumoGrid entrega a instrução da segunda etapa no terminal do Codex quando a primeira fica pronta, mas não copia o histórico de uma conversa para a outra.
Por isso a primeira etapa grava o que descobriu num arquivo do projeto, e a segunda começa lendo esse arquivo. O arquivo também fica para você: dá para ler, corrigir à mão ou guardar no repositório.
Passo a passo
Primeira etapa: a revisão
- Selecione
loja-apie clique em Fluxo e em Criar fluxo. Escreva a tarefa:
Revise src/cupom.cjs e grave até três achados em REVISAO.md, com arquivo e linha. Não altere o código.- Confira o resumo (Claude Code · loja-api), clique em Conferir etapa e em Adicionar ao planejamento.
Segunda etapa: a correção
- Clique em + Nova etapa, no topo. Com o fluxo planejado, ela abre em Acrescentar ao fluxo, depois da etapa 1.
- Executa: Codex CLI. Em Onde esta etapa roda, um terminal novo.
- Começa: após a etapa 1 ficar pronta.
Tarefa:
Leia REVISAO.md, corrija só o primeiro achado e rode npm test.- Em Ao criar, escolha Só planejar e confirme com Adicionar ao planejamento.
Executar
- Clique em Executar fluxo e passe para a Grade.
- O Claude Code revisa e grava
REVISAO.md. Enquanto isso, o terminal do Codex fica aberto, esperando. - Quando a revisão fica pronta, a instrução chega ao Codex. Ele altera o cupom e roda
npm test. - No Fluxo, as duas etapas aparecem concluídas, e cada uma tem seu resultado.
O que conferir
- Leia
REVISAO.md: os achados têm arquivo e linha? git diffmostra mudança só no que o primeiro achado pedia? Se o Codex mexeu empackage.jsonou em vários arquivos, devolva com uma instrução mais precisa.npm testpassou no terminal do Codex. Para que isso conte como critério, e não só como relato, marque na segunda etapa que ela fica pronta quando o comando passar. Veja Verificação.
Dicas
- Escreva no arquivo de passagem o que o próximo agente precisa para começar: o problema, onde está e o que não deve ser alterado. Um formato fixo ("achado, arquivo, linha, sugestão") ajuda.
- Se as etapas rodam em worktrees diferentes, aponte um caminho que o segundo agente consiga ler, por exemplo um arquivo na pasta principal do projeto.
- Peça à primeira etapa para não alterar código. Assim, se a revisão errar, nada precisa ser desfeito.
- Para devolver trabalho ao primeiro agente, acrescente uma nova etapa com o destino certo. Mudar só o papel de uma etapa não transfere uma tarefa que já começou.
Limites
- A sandbox de algumas CLIs, em modo só leitura, pode impedir o agente de gravar ou de ler arquivos fora da pasta. Nesse caso a etapa pode terminar sem o arquivo. A verificação por comando é o que pega isso.
- A instrução de uma etapa tem até 512 caracteres, numa linha só. Para contexto longo, aponte para um arquivo do projeto.