BLACK FRIDAY 50% em todos os cursos com o cupom BLACK50, até 30/11 →GRÁTIS Curso gratuito de ChatGPT: lançamento 17/11, garanta sua vagaCurso gratuito de ChatGPT no ar, receba o acesso por e-mail →

Codex e desenvolvimento

Testes e critérios de aceite para código produzido com IA

Um teste comprova apenas o comportamento que ele verifica. Quando a mesma interpretação errada orienta implementação e teste, os dois podem concordar e ainda deixar o requisito de fora. Este guia mostra como transformar uma regra de negócio em verificações independentes e proporcionais ao risco da mudança.

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.