Portões de revisão: uma checklist antes de mesclar

Um portão de revisão é uma lista curta de coisas que precisam ser verdade antes de uma mudança ir ao ar. Passe por ela você mesmo, ou peça para a IA confirmar cada item:

• Eu li o diff e entendo o que mudou e por quê
• A mudança está limitada ao que eu de fato pedi
• Os testes passam (e o novo comportamento tem um teste)
• A verificação de tipos e o linter estão limpos
• Nenhum segredo, log de depuração ou código comentado ficou para trás
• Nenhuma verificação de segurança foi removida silenciosamente
• Eu testei a mudança eu mesmo, pelo menos o caminho feliz

Se você não consegue marcar uma caixa, você não terminou.

A checklist é deliberadamente curta porque um portão que você pula não é portão nenhum. A tentação, especialmente quando você está avançando rápido e a mudança "parece boa", é deixar passar sem checar. Resista a isso em qualquer coisa voltada ao usuário. Um truque útil é fazer a IA preencher isso para você — cole a lista e pergunte: "Go through this review gate for the change you just made. For each item, say PASS or FAIL with one line of evidence." Ela não consegue escrever honestamente "os testes passam" sem tê-los rodado, e forçá-la a citar evidências linha a linha transforma um vago "parece bom" em algo que você pode auditar.