tdd — Red-Green-Refactor
A Lei de Ferro
NENHUMA PRODUÇÃO DE CÓDIGO SEM UM TESTE FALHANDO PRIMEIRO.
Escreveu código antes do teste? Apague. Comece de novo. Sem exceções — não guarde como "referência", não "adapte" enquanto escreve testes, não olhe para ele. Implemente do zero a partir dos testes.
Violar a letra das regras é violar o espírito.
Gatilho
Disparar em: "TDD this" · "red-green-refactor" · "test-first" · nova funcionalidade · correção de bug · refatoração · mudança de comportamento. No modo AFK, tarefa por [[afk-vs-hitl-tasks]] com infraestrutura de teste presente, disparar silenciosamente.
Exceções (perguntar primeiro): protótipos descartáveis, código gerado, arquivos de configuração.
Está pensando "pular TDD só desta vez"? Pare. Isso é racionalização — veja references/rationalizations.md se estiver em dúvida.
Pré-condição
Loop de teste <60s por [[feedback-loops-are-the-ceiling]]. Loop lento → corrija o loop PRIMEIRO, nunca pule TDD para evitar testes lentos.
Leia CONTEXT.md + ADRs da área primeiro — nomes de testes e vocabulário de interface devem corresponder à linguagem do domínio do projeto. (Etapa de vocabulário de domínio de Matt Pocock 2026-07-08.)
Seams — concordar primeiro
Seam = fronteira pública onde você observa o comportamento, sem acessar internos. Testes vivem em seams, nunca contra implementações internas. O código muda; testes ancorados em seams sobrevivem.
Confirme seams com o usuário antes de escrever qualquer teste. Nenhum teste escrito em seam não confirmado. Esforço concentra-se em caminhos críticos + lógica complexa, não em cada caso extremo. Pergunte: "Quais seams devemos testar?" (Enquadramento de seams de Matt Pocock 2026-07-08.)
O ciclo — ordem estrita
| Passo | Ação | Deve verificar |
|---|---|---|
| RED | UM teste falhando em um seam acordado. Menor comportamento observável. Código real, sem mocks a menos que inevitável. Nome claro, sem "e". | Teste FALHA com o erro esperado. Passou imediatamente? Você está testando comportamento existente — corrija o teste. Erros? Corrija o erro, execute novamente até falhar corretamente. |
| GREEN | Código mínimo para passar. Sem opções YAGNI. Sem tratamento de erros não testado. | Teste PASSA. Outros testes ainda passam. Saída limpa. Falhando? Corrija o código, nunca o teste. |
| REFACTOR | Extraia módulos profundos por [[deep-modules-over-shallow]]. Renomeie para clareza. Nunca adicione comportamento na refatoração. | Permanece verde. |
| LOOP | Próximo teste falhando. Fatia vertical — um teste → uma implementação → repita, cada um um traçador que responde ao que o último ciclo ensinou. Volte ao RED. | — |
Anti-padrões — travados
- Acoplado à implementação — simula colaboradores internos, testa métodos privados, afirma através de canais laterais (consulta DB vs interface). Sinal: quebra na refatoração quando o comportamento não muda.
- Tautológico — a asserção recalcula o valor esperado da mesma forma que o código (
esperar(soma(a,b)).toBe(a+b), snapshot derivado à mão, constante-igual-a-si-mesma). Passa por construção. Valores esperados de fonte independente: literal conhecido como bom, exemplo resolvido, especificação. (Enquadramento tautológico de Matt Pocock 2026-07-08.) - Fatia horizontal — todos os testes primeiro, depois toda a implementação. Verifica comportamento imaginado; testes tornam-se insensíveis a mudanças reais. Trabalhe apenas em fatias verticais. (Enquadramento horizontal-vs-vertical de Matt Pocock 2026-07-08.)
Anti-trapaça — travado
- DEVE ver a saída do teste falhando antes de escrever código de produção.
- NÃO DEVE escrever vários testes antes do primeiro passar.
- NÃO DEVE pular a refatoração.
- NÃO DEVE reescrever o teste para corresponder à implementação depois do fato.
Teste escrito APÓS o código = moldado pelo código, não pela especificação. Rejeita o propósito.
Formato de saída por ciclo
SEAM: <interface pública sob teste>
RED: <nome do teste> → <mensagem de falha esperada>
GREEN: <arquivos alterados, delta de LOC>
REFACTOR: <o que foi extraído/renomeado>
Referências cruzadas
- feedback-loops-are-the-ceiling
- deep-modules-over-shallow
- afk-vs-hitl-tasks
references/rationalizations.md— cada objeção "TDD-é-dogmático" + a contra-argumentação- Fonte: Kent Beck 1999 · obra/superpowers test-driven-development mesclado em 2026-07-04 · Matt Pocock 2026-07-04 (checklist da skill) + 2026-07-08 (seams, tautológico, fatia vertical, CONTEXT.md)