Como revisar uma alteração de código feita por IA

Para revisar uma alteração de código feita por IA, compare o pedido original com o diff e confira o comportamento resultante. O resumo da ferramenta orienta a leitura, mas não substitui a evidência dos arquivos.

Uma revisão útil responde a três perguntas: a mudança resolve o problema, preserva o que importa e pode ser verificada? Vamos organizar essa leitura antes de aceitar a sugestão.

1. Releia o objetivo em uma frase

Escreva o problema usando um exemplo de antes e depois. “O filtro deve incluir itens exatamente no limite” é mais fácil de avaliar do que “melhorar a filtragem”.

Separe requisitos obrigatórios de melhorias opcionais. Se o objetivo é corrigir uma condição, uma troca de biblioteca não deve passar despercebida como parte inevitável da solução.

2. Observe a extensão da mudança

Confira quais arquivos foram alterados e o papel de cada um. Uma correção pode exigir mais de um arquivo, mas a relação com o problema deve ser explicável.

A documentação do git diff descreve a comparação de alterações. Em um repositório local, uma primeira leitura pode usar:

git diff --stat
git diff

Esses comandos mostram mudanças ainda não preparadas para commit. Se os arquivos já estiverem preparados, use git diff --cached para conferir essa outra área.

3. Leia comportamento antes de acabamento

Comece por condições, entradas, saídas e tratamento de erros. Depois avalie nomes, organização e comentários.

Para cada trecho importante, pergunte qual situação passa a funcionar e qual pode mudar de resultado. Não confunda uma reorganização visual com uma mudança de comportamento que precisa de teste.

Camada	Pergunta de revisão
Escopo	Isso foi necessário para o pedido?
Lógica	Qual entrada muda de resultado?
Integração	Quem usa essa função ou saída?
Evidência	Que verificação demonstra o comportamento?

4. Peça uma justificativa que você consiga conferir

Use a IA para localizar pontos de atenção, mantendo o pedido ligado aos arquivos reais.

Revise este diff em relação ao objetivo descrito.
Liste somente mudanças que afetam comportamento.
Para cada uma, cite o trecho, explique o efeito e proponha
um caso de teste que diferencie a versão antiga da nova.
Separe defeitos encontrados de dúvidas que exigem contexto.
Não edite arquivos nesta etapa.

Uma dúvida sem contexto não precisa virar defeito afirmado. Peça que a resposta indique o que falta saber para decidir, como uma regra externa ou um consumidor da função.

5. Confira as verificações relevantes

Execute os testes relacionados ao comportamento alterado e registre o resultado. Se houve correção depois do teste, confirme novamente a parte afetada.

O guia para propor testes com IA ajuda a escolher casos que realmente distinguem erros. Evite transformar a revisão em uma lista de checagens sem relação com a mudança.

6. Registre uma decisão clara

A documentação de revisões de pull request do GitHub distingue comentar, aprovar e solicitar alterações. Mesmo fora dessa interface, a distinção ajuda a comunicar o estado da revisão.

Finalize com o que mudou, a evidência conferida e qualquer pendência concreta. Assim, a decisão pode ser entendida por quem não acompanhou a conversa com a IA.

Perguntas frequentes

O que conferir primeiro em uma alteração feita por IA?

Compare o objetivo pedido com os arquivos e comportamentos alterados. Mudanças fora do escopo precisam de uma justificativa clara.

Uma explicação da IA substitui a leitura do diff?

Não. A explicação ajuda a orientar a revisão, mas o diff mostra as alterações efetivamente feitas.

Que evidência pedir antes de aceitar a alteração?

Peça os casos verificados, os resultados e as limitações que ainda existem. Confira se os testes exercitam a versão que será aceita.