Tratando Execuções de Agentes como Pacotes de Revisão: Um Padrão Prático para Claude Code e Codex

Um usuário do Reddit que experimenta fluxos de trabalho de agente estilo Codex/Claude compartilha um padrão que melhorou seus resultados: em vez de tratar execuções de agente como transcrições de chat, eles agora produzem uma pasta durável com vários artefatos que outro humano ou agente pode inspecionar.

Artefatos principais por execução

• research.md — fontes e suposições usadas pelo agente
• drafts.md — saídas candidatas, incluindo as rejeitadas
• evals.md — rubrica de pontuação e raciocínio para a opção escolhida
• approval-packet.md — ponto de verificação antes da etapa irreversível
• metrics.json — resultados numéricos da execução
• memory.md — apenas lições reutilizáveis do fluxo de trabalho

Duas grandes lições

A memória deve ser sobre como trabalhar, não um banco de dados de fatos não revisados. Se uma alegação é importante, ela pertence a um artefato revisado com uma fonte.

“Totalmente autônomo” é menos útil do que “autônomo até a etapa irreversível.” Para código, isso significa commit/deploy. Para conteúdo, significa publicar. Para fluxos de trabalho locais, significa qualquer coisa que envolva credenciais ou contas de terceiros.

Por que isso ajuda

As falhas se tornam visíveis em estágios específicos: A pesquisa estava errada? O rascunho era ruim? A rubrica de avaliação era muito vaga? O pacote de aprovação perdeu algum risco? A memória armazenou uma lição que realmente ajudou da próxima vez? Isso torna a iteração mais rápida e direcionada do que confiar em transcrições de chat.

O post é um iniciador de discussão — o autor está curioso para saber se outros estão usando artefatos duráveis ou confiando em transcrições de chat para fluxos de trabalho Claude Code/Codex.