WJTTC Builder - Gerador de Conjuntos de Testes de Campeonato

Filosofia: "Nós quebramos coisas para que outros nunca precisem saber que elas foram quebradas."

Esta habilidade gera conjuntos de testes inspirados em F1 seguindo a metodologia WJTTC (Wolfe James Tests The Code).

OBJETIVOS

Código GOLD ✨

O código ganha status GOLD quando:

┌────────────────────────────────────────┐
│         ✪ GOLD CODE ✨                │
│  ════════════════════════════════════  │
│  ✓ Pre-test plan defined               │
│  ✓ Inline testing at write time        │
│  ✓ Layer 1: 100% industry coverage     │
│  ✓ Layer 2: WJTTC expert edge cases    │
│  ✓ Bi-sync with project.faf            │
│  ✓ All tests passing                   │
│  ════════════════════════════════════  │
│  This code has earned its name.        │
└────────────────────────────────────────┘

Posição no Pipeline de Desenvolvimento

WJTTC vem DEPOIS de project.faf, ANTES da codificação:

1. project.faf      → Define WHAT we're building (context)
2. WJTTC-TESTS.md   → Define SUCCESS CRITERIA (tests first)
3. Code             → Build to pass the tests
4. Test             → Pass/Fail
5. Repeat           → Until Championship grade

Código Orientado a Testes (TDC)

O Ciclo WJTTC:

Think → Cross-check → Confirm → Code → Test → [Repeat]
  │         │           │        │       │
  │         │           │        │       └── Pass/Fail verdict
  │         │           │        └── Write implementation
  │         │           └── Green light to proceed
  │         └── STOP if missing info - get it first
  └── Understand what we're building

Portão de Verificação Cruzada: PARE se faltar informação. Obtenha-a antes de prosseguir.

• Requisitos faltando? Pergunte.
• Critérios de aceitação pouco claros? Esclareça.
• Casos de borda desconhecidos? Defina-os.

Vermelho → Verde → Refatorar:

1. Escreva teste falhando (VERMELHO)
2. Escreva código para passar (VERDE)
3. Limpe (REFATORAR)

Nunca codifique sem saber como é "pronto".

Arquitetura de Teste de Duas Camadas

Camada 1: Padrão da Indústria (100% de Cobertura)

Use os testes nativos do framework - Jest, pytest, Vitest, etc.

• Testes unitários
• Testes de integração
• Asserções padrão
• Requisitos de cobertura

Esta é a base. Não negociável.

Camada 2: Especialista WJTTC (Estresse + Casos de Borda)

A camada de campeonato que captura o que os testes da indústria perdem:

Alvos de Teste:

• Servidores e ferramentas MCP
• Comandos e flags CLI
• Endpoints e payloads de API
• Internos do motor
• Configurações de infraestrutura

Testamos os Testes

Checklist de meta-testes:

• Os testes realmente rodam?
• Eles falham quando o código está quebrado?
• Eles passam quando o código está correto?
• Casos de borda são cobertos?
• Os testes podem ser executados isoladamente?
• Os testes limpam após si mesmos?

Auditoria de Integridade do Sinal (A Doutrina Vermelho-Significa-Real)

Antes de medir a cobertura, meça a confiança do sinal.

CI vermelho é um contrato: pare, olhe, conserte. Se vermelho significa "dê de ombros, o executor teve um vizinho barulhento, apenas execute novamente", o sinal está morto — e sinal morto é pior do que nenhum sinal. Um conjunto de testes com 100% de cobertura, mas com falhas intermitentes, é menos confiável do que um com 80% de cobertura e zero alarmes falsos, porque a equipe parou de ler os vermelhos.

Esta é a doutrina principal. Todos os outros princípios de teste a servem.

A Auditoria

Para qualquer conjunto de testes em revisão, classifique os últimos 30 dias de falhas de CI em três categorias:

…