Communitygithub.com

chirag127/skill-tdd

Red-Green-Refactor TDD. NENHUMA PRODUÇÃO DE CÓDIGO SEM UM TESTE FALHANDO PRIMEIRO. Bloqueia a trapaça de IA (escrever testes DEPOIS da implementação). Use ao implementar qualquer funcionalidade ou correção de bug.

O que é skill-tdd?

Esta skill impõe a prática do Test-Driven Development (TDD) no modelo Red-Green-Refactor, garantindo que nenhum código de produção seja escrito sem um teste falhando primeiro. Ela bloqueia ativamente a tendência comum de agentes de IA de escrever testes após a implementação, forçando o ciclo correto: escrever um teste que falhe (RED), implementar o código mínimo para passar (GREEN) e refatorar (REFACTOR). A skill é compatível com ferramentas como Claude Code, Cursor e Codex, e é acionada por comandos como "TDD this", "red-green-refactor" ou "test-first". Ela inclui regras rigorosas como a definição de seams (fronteiras públicas de teste), anti-padrões (acoplamento à implementação, testes tautológicos, fatias horizontais) e um sistema anti-trapaça que impede a escrita de testes após o código de produção. A skill também exige que o loop de teste seja inferior a 60 segundos e que os nomes dos testes correspondam ao vocabulário do domínio do projeto, conforme documentado no CONTEXT.md e ADRs da área.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add chirag127/skill-tdd

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

PassoAçãoDeve verificar
REDUM 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.
GREENCó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.
REFACTORExtraia módulos profundos por [[deep-modules-over-shallow]]. Renomeie para clareza. Nunca adicione comportamento na refatoração.Permanece verde.
LOOPPró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

Habilidades Relacionadas