Como ler de verdade o código que seu agente de IA escreveu

Description and use

Reviewing code generated by AI agents needs a structured approach: identify the change format, view diff stats, read files by dependencies, verify logic, and keep review steps small.

Problem

Revisar código gerado por agentes de IA pode ser confuso quando o resumo e o diff não coincidem, levando a merges sem revisão adequada.

Outcome

A adoção desse fluxo de revisão reduz a probabilidade de merges com código inesperado ou incompleto, aumentando a confiança nos resultados gerados por agentes de IA.

Workflow

• Identificar o formato de saída do agente (commit, branch ou mudanças locais).
• Executar git diff --stat e git diff --name-status para visão geral.
• Perguntar: todos os arquivos esperados? Onde está o peso? Testes foram alterados?
• Ordenar a leitura por dependências: contratos, lógica, chamadas, testes.
• Abrir funções afetadas para contexto completo.
• Verificar se o código resolve a causa do bug, não apenas o sintoma.
• Confirmar chamadas e definições de funções citadas no resumo.
• Revisar em etapas pequenas, pedindo commits a cada passo lógico.
• Usar ferramentas auxiliares como Yenpo para diffs inline e navegação de definição.
• Executar testes para garantir que todos passam.
• Merge apenas após confirmação de que o resumo e o código estão alinhados.

Evidence

Uma sessão com um agente termina com um resumo animado e um diff que mexe em um monte de arquivos.

Source

O resumo diz o que o agente pretendia fazer; o diff mostra o que ele fez de fato, e as duas coisas nem sempre batem.

Source

Antes de ler qualquer hunk, tenha uma visão geral: git diff --stat main...feature e git diff --name-status main...feature

Source

Leia na ordem das dependências, com o código ao redor aberto.

Source

Mantenha os checkpoints pequenos

Source