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

Описание и применение

Проверка кода, созданного ИИ‑агентом, требует структурированного подхода: определить формат изменений, просмотреть статистику diff, читать файлы по зависимостям, проверять логическую связь и поддерживать небольшие шаги ревью.

Задача

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.

Результат

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.

Рабочий процесс

• 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.

Доказательства

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

Источник

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.

Источник

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

Источник

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

Источник

Mantenha os checkpoints pequenos

Источник