tdd-workflows-tdd-cycle

Use esta habilidade quando

• Trabalhando em fluxos de trabalho TDD, tarefas ou fluxos do ciclo TDD
• Precisando de orientação, melhores práticas ou checklists para fluxos de trabalho TDD, ciclo TDD

Não use esta habilidade quando

• A tarefa não estiver relacionada a fluxos de trabalho TDD, ciclo TDD
• Você precisar de um domínio ou ferramenta diferente fora deste escopo

Instruções

• Clarifique objetivos, restrições e entradas necessárias.
• Aplique melhores práticas relevantes e valide os resultados.
• Forneça etapas acionáveis e verificação.
• Se exemplos detalhados forem necessários, abra resources/implementation-playbook.md.

Execute um fluxo de trabalho abrangente de Desenvolvimento Orientado a Testes (TDD) com disciplina rigorosa de vermelho-verde-refatoração:

[Pensamento estendido: Este fluxo de trabalho impõe o desenvolvimento "test-first" através da orquestração coordenada de agentes. Cada fase do ciclo TDD é estritamente aplicada com verificação de falha inicial, implementação incremental e refatoração contínua. O fluxo de trabalho suporta abordagens de teste único e suítes de testes com limiares de cobertura configuráveis.]

Configuração

Limiares de Cobertura

• Cobertura mínima de linha: 80%
• Cobertura mínima de branch: 75%
• Cobertura de caminho crítico: 100%

Gatilhos de Refatoração

• Complexidade ciclomática > 10
• Comprimento do método > 20 linhas
• Comprimento da classe > 200 linhas
• Blocos de código duplicados > 3 linhas

Fase 1: Especificação e Design de Testes

1. Análise de Requisitos

• Use a ferramenta Task com subagent_type="comprehensive-review::architect-review"
• Prompt: "Analise os requisitos para: $ARGUMENTS. Defina critérios de aceitação, identifique casos extremos e crie cenários de teste. Gere uma especificação de teste abrangente."
• Saída: Especificação de teste, critérios de aceitação, matriz de casos extremos
• Validação: Garanta que todos os requisitos tenham cenários de teste correspondentes

2. Design da Arquitetura de Testes

• Use a ferramenta Task com subagent_type="unit-testing::test-automator"
• Prompt: "Projete a arquitetura de testes para: $ARGUMENTS com base na especificação de teste. Defina a estrutura de testes, fixtures, mocks e estratégia de dados de teste. Garanta testabilidade e manutenibilidade."
• Saída: Arquitetura de testes, design de fixtures, estratégia de mocks
• Validação: A arquitetura suporta testes isolados, rápidos e confiáveis

Fase 2: VERMELHO - Escreva Testes Falhando

3. Escreva Testes de Unidade (Falhando)

• Use a ferramenta Task com subagent_type="unit-testing::test-automator"
• Prompt: "Escreva testes de unidade FALHANDO para: $ARGUMENTS. Os testes devem falhar inicialmente. Inclua casos extremos, cenários de erro e caminhos felizes. NÃO implemente código de produção."
• Saída: Testes de unidade falhando, documentação de testes
• CRÍTICO: Verifique se todos os testes falham com mensagens de erro esperadas

4. Verifique a Falha do Teste

• Use a ferramenta Task com subagent_type="tdd-workflows::code-reviewer"
• Prompt: "Verifique se todos os testes para: $ARGUMENTS estão falhando corretamente. Garanta que as falhas sejam pelos motivos certos (implementação ausente, não erros de teste). Confirme que não há falsos positivos."
• Saída: Relatório de verificação de falha de teste
• GATE: Não prossiga até que todos os testes falhem apropriadamente

Fase 3: VERDE - Faça os Testes Passarem

5. Implementação Mínima

• Use a ferramenta Task com subagent_type="backend-development::backend-architect"
• Prompt: "Implemente código MÍNIMO para fazer os testes passarem para: $ARGUMENTS. Concentre-se apenas em fazer os testes ficarem verdes. Não adicione recursos ou otimizações extras. Mantenha simples."
• Saída: Implementação mínima funcional
• Restrição: Nenhum código além do necessário para passar nos testes

6. Verifique o Sucesso do Teste

• Use a ferramenta Task com subagent_type="unit-testing::test-automator"
• Prompt: "Execute todos os testes para: $ARGUMENTS e verifique se eles passam. Verifique as métricas de cobertura de teste. Garanta que nenhum teste foi quebrado acidentalmente."
• Saída: Relatório de execução de testes, métricas de cobertura
• GATE: Todos os testes devem passar antes de prosseguir

Fase 4: REFACTOR - Melhore a Qualidade do Código

7. Refatoração de Código

• Use a ferramenta Task com subagent_type="tdd-workflows::code-reviewer"
• Prompt: "Refatore a implementação para: $ARGUMENTS mantendo os testes verdes. Aplique princípios SOLID, remova duplicação, melhore a nomenclatura e otimize o desempenho. Execute os testes após cada refatoração."
• Saída: Código refatorado, relatório de refatoração
• Restrição: Os testes devem permanecer verdes durante todo o processo

8. Refatoração de Testes

• Use a ferramenta Task com subagent_type="unit-testing::test-automator"
• Prompt: "Refatore os testes para: $ARGUMENTS. Remova duplicação de testes, melhore os nomes dos testes, extraia fixtures comuns e aprimore a legibilidade dos testes. Garanta que os testes ainda forneçam a mesma cobertura."
• Saída: Testes refatorados, estrutura de testes aprimorada

…