Escreva critérios que alguém consiga observar
Considere uma regra fictícia: clientes ativos podem usar um cupom de 10% em pedidos a partir de R$ 100, com desconto limitado a R$ 30. O cupom não vale para frete e não pode ser usado duas vezes no mesmo pedido. Esse texto já contém várias decisões que precisam aparecer na implementação.
Transforme a regra em exemplos de entrada e saída. Um subtotal elegível de R$ 100 recebe R$ 10 de desconto. R$ 500 recebem R$ 30, por causa do limite. R$ 99 não recebem desconto. Escreva também o que deve acontecer quando o cliente estiver inativo ou quando o cupom for aplicado novamente.
Separe regra, integração e experiência
A função que calcula desconto pode estar correta enquanto o total exibido na tela continua errado. Por isso, escolha verificações em camadas. Testes da regra avaliam o cálculo; testes de integração conferem contratos e persistência; uma verificação do fluxo confirma o que a pessoa realmente vê.
Não é necessário construir uma suíte extensa para toda alteração. Para uma correção textual simples, inspeção pode bastar. Para uma regra que afeta cobrança, os cenários de limite e repetição merecem atenção. A quantidade de testes deve responder ao risco concreto, não ao volume de código produzido.
Proteja a independência dos exemplos
Defina os resultados esperados antes de pedir a implementação ou confira-os manualmente depois. Evite calcular o valor esperado chamando a própria função que está sendo testada. Isso verificaria consistência interna, mas não a regra combinada.
Peça ao agente que explique qual requisito cada teste cobre. Se um teste só reproduz a estrutura da solução, pergunte que erro ele detectaria. Um teste útil falha quando um comportamento importante é quebrado, mesmo que a organização interna do código mude.
- Qual é a fonte da regra e quem resolveu suas ambiguidades?
- Existe um caso no limite e outro imediatamente fora dele?
- O resultado esperado foi calculado de forma independente?
- O teste falharia se o requisito fosse implementado incorretamente?
Investigue falhas sem enfraquecer o teste
Quando um teste falhar, identifique se a causa está na implementação, no ambiente, no dado de teste ou no entendimento da regra. Alterar o resultado esperado apenas para obter aprovação elimina a evidência que o teste deveria produzir.
Um pedido prático: Analise esta falha e relacione-a ao critério de aceite. Explique a causa antes de propor mudanças. Se considerar o teste incorreto, mostre qual regra ou contrato sustenta a correção. Não desative a verificação nem reduza o escopo silenciosamente.
Leia a execução e revise o comportamento
Confira quais comandos foram executados, quantos casos passaram e quais foram ignorados. Uma suíte pode terminar sem erro porque nenhum teste foi selecionado. Dependências indisponíveis e verificações puladas devem aparecer no relato final.
Depois examine o diff. Procure alterações em validações, contratos, tratamento de erros e testes existentes. Para interfaces, abra o fluxo relevante e confira estados vazio, carregando e erro quando fizerem parte do escopo. A revisão visual e funcional complementa a evidência automatizada.
Use um critério explícito para concluir
Considere a tarefa pronta para revisão quando cada requisito tiver uma evidência correspondente e as limitações estiverem documentadas. Se uma verificação crítica depender de um ambiente indisponível, registre a pendência e a pessoa responsável por concluí-la.
As documentações de Codex e Claude Code recomendam fornecer formas de verificar o trabalho. O procedimento deste guia acrescenta uma pergunta de produto: a verificação demonstra o que foi combinado? Essa pergunta continua válida quando você troca de agente, modelo ou linguagem.
Fontes e referências
Consulte a documentação original para disponibilidade e condições atuais. Fontes consultadas em 21 de outubro de 2026.