Voltar para a escrita

Revisando código gerado por IA: o checklist do meu time

Código escrito à mão costuma falhar onde a pessoa estava cansada ou com pressa. Código gerado falha onde o modelo estava confiante e errado — um problema de busca bem diferente, que derruba os hábitos de revisão que a maioria de nós construiu na última década.

Então anotamos as diferenças. O checklist é curto de propósito: tratamento de erro no caminho infeliz, fronteiras entre módulos, qualquer coisa que toque em dinheiro, fuso horário ou permissões, e cada dependência que o diff adiciona.

O item mais valioso é o menos técnico: este código faz algo que a especificação nunca pediu? Abstração extra, uma flag de configuração especulativa, um helper que ninguém chamou. Código gerado é generoso, e é assim que uma base de código fica pesada.

Aqui está o checklist completo, com um exemplo de cada tipo de falha pego em um pull request real.