Um diff é a lista de diferenças entre duas versões de um arquivo ou de um projeto: quais linhas entraram, quais saíram e onde. As que entraram costumam ser marcadas com um sinal de mais e as que saíram com um sinal de menos. Ferramentas como o git usam isso para mostrar o que mudou de verdade, sem depender do que alguém conta.
Uma pergunta do app. Escolha uma resposta.
Você pede para renomear uma função e o diff mexe em muitos arquivos. O que faz primeiro?
Renomear mexe em cada lugar onde a função é usada. O tamanho sozinho não condena.
Ser esperado não diz que nada mais entrou de carona no meio de tantas mudanças.
Um diff grande pede revisar o alcance. Se cada mudança é a renomeação, tudo certo; se há algo a mais, isso se discute.
Com valores inventados, em reais: uma loja online aumenta o mínimo para o frete grátis. O diff mostra "- freteGratisAPartirDe = 200" e logo abaixo "+ freteGratisAPartirDe = 250". Não são duas linhas novas: mudar uma linha aparece como tirar a antiga e colocar a nova.
Em volta aparecem algumas linhas sem sinal: não mudaram, estão ali para você localizar a mudança. Cada bloco começa com uma linha que indica em que parte do arquivo está, e muitas ferramentas pintam de verde o que entrou e de vermelho o que saiu.
Um agente de código termina com um resumo: "traduzi as mensagens de erro". O resumo é o que ele diz que fez; o diff, o que fez. Olhar as linhas em vermelho dos testes é um bom hábito: se um teste não passava, o agente pode ter apagado ou afrouxado o teste para passar.
Uma regra no seu CLAUDE.md como "não apague testes para eles passarem" ajuda, mas o agente pode esquecer. O diff não esquece: se um teste saiu, está ali.
Um diff grande não é um diff ruim: atualizar uma biblioteca ou aplicar um formatador pode mexer em dezenas de arquivos. O risco é uma mudança de verdade se esconder entre 2.000 linhas de espaços e vírgulas. Comece pela lista de arquivos: se aparece um que não tem nada a ver com o pedido, como a configuração de pagamentos, abra esse primeiro.
Dois truques: peça ao agente para deixar a formatação numa mudança separada, e use a opção de esconder mudanças de espaço que muitas ferramentas têm. Assim o que fica à vista é o que importa.
"Se os testes passam, não precisa ler." Os testes não avisam de uma mudança que ninguém pediu. "O diff diz se funciona." Não: diz o que mudou. "Está tudo no diff." Quase: um arquivo novo que o git ainda não acompanha pode não aparecer, e um binário, como uma imagem, aparece sem detalhe.