Revisar um diff
Leia na ordem certa e procure primeiro o que você não pediu.
Revisar o que a máquina produz
Um diff de agente é difícil de revisar, e por um motivo preciso: ele é bem escrito demais. O código de um colega com pressa traz pistas — um nome desleixado, uma indentação que falha, um comentário "TODO fix later". Essas irregularidades são sinais que chamam a atenção para o ponto de risco. Um agente produz um texto uniformemente cuidadoso: o contorno duvidoso e a correção certa têm a mesma tipografia, os mesmos comentários bem construídos, a mesma segurança. Seu detector de anomalias habitual não acende mais, e você aprova um diff de 300 linhas em quatro minutos, pensando que está limpo.
A segunda armadilha é a ordem de leitura. Diante de um diff, o instinto é começar pelo topo do primeiro arquivo e seguir em frente. Com código humano, isso funciona mais ou menos, porque o autor fez o que você pediu, nem mais nem menos. Com código de agente, você acaba lendo longamente a mudança esperada — a parte menos arriscada, a que você especificou — e chega cansado ao arquivo número sete, aquele que você nunca mencionou e onde está o problema de verdade. A revisão eficaz inverte a lógica: primeiro se procura o que não foi pedido, e só depois se verifica o que foi.
Comentários
Os comentários são alimentados pelo GitHub Discussions
Conecte-se com o GitHub para participar da discussão