tdd-workflows-tdd-refactor

Use esta habilidade quando

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

Não use esta habilidade quando

• A tarefa não estiver relacionada a fluxos de trabalho TDD, refatoração 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.

Refatore código com confiança usando uma rede de testes abrangente:

[Pensamento estendido: Esta ferramenta usa o agente tdd-orchestrator (modelo opus) para refatoração sofisticada, mantendo todos os testes em verde. Ela aplica padrões de design, melhora a qualidade do código e otimiza o desempenho com a segurança de uma cobertura de testes abrangente.]

Uso

Use a ferramenta Task com subagent_type="tdd-orchestrator" para realizar refatoração segura.

Prompt: "Refatore este código mantendo todos os testes em verde: $ARGUMENTS. Aplique a fase de refatoração TDD:

Processo Principal

1. Pré-Avaliação

• Execute testes para estabelecer a linha de base verde.
• Analise odores de código e cobertura de testes.
• Documente as métricas de desempenho atuais.
• Crie um plano de refatoração incremental.

2. Detecção de Odores de Código

• Código duplicado → Extrair métodos/classes.
• Métodos longos → Decompor em funções focadas.
• Classes grandes → Dividir responsabilidades.
• Listas longas de parâmetros → Objetos de parâmetro.
• Inveja de Funcionalidade (Feature Envy) → Mover métodos para classes apropriadas.
• Obsessão por Primitivos → Objetos de valor.
• Instruções switch → Polimorfismo.
• Código morto → Remover.

3. Padrões de Design

• Aplique Criacionais (Factory, Builder, Singleton).
• Aplique Estruturais (Adapter, Facade, Decorator).
• Aplique Comportamentais (Strategy, Observer, Command).
• Aplique de Domínio (Repository, Service, Value Objects).
• Use padrões apenas onde agregarem valor claro.

4. Princípios SOLID

• Responsabilidade Única: Uma razão para mudar.
• Aberto/Fechado: Aberto para extensão, fechado para modificação.
• Substituição de Liskov: Subtipos substituíveis.
• Segregação de Interface: Interfaces pequenas e focadas.
• Inversão de Dependência: Depender de abstrações.

5. Técnicas de Refatoração

• Extrair Método/Variável/Interface.
• Incorporar indireção desnecessária.
• Renomear para clareza.
• Mover Método/Campo para classes apropriadas.
• Substituir Números Mágicos por constantes.
• Encapsular campos.
• Substituir Condicional por Polimorfismo.
• Introduzir Objeto Nulo (Null Object).

6. Otimização de Desempenho

• Perfilar para identificar gargalos.
• Otimizar algoritmos e estruturas de dados.
• Implementar cache onde for benéfico.
• Reduzir consultas ao banco de dados (eliminação N+1).
• Carregamento preguiçoso (lazy loading) e paginação.
• Sempre medir antes e depois.

7. Passos Incrementais

• Faça alterações pequenas e atômicas.
• Execute testes após cada modificação.
• Faça commit após cada refatoração bem-sucedida.
• Mantenha a refatoração separada das mudanças de comportamento.
• Use scaffolding quando necessário.

8. Evolução da Arquitetura

• Separação de camadas e gerenciamento de dependências.
• Limites de módulos e definição de interfaces.
• Padrões orientados a eventos para desacoplamento.
• Otimização de padrões de acesso a banco de dados.

9. Verificação de Segurança

• Execute a suíte de testes completa após cada mudança.
• Testes de regressão de desempenho.
• Testes de mutação para eficácia dos testes.
• Plano de rollback para mudanças importantes.

10. Padrões Avançados

• Strangler Fig: Substituição gradual de legado.
• Branch by Abstraction: Mudanças em larga escala.
• Parallel Change: Padrão expandir-contrair.
• Mikado Method: Navegação em grafo de dependências.

Requisitos de Saída

• Código refatorado com melhorias aplicadas.
• Resultados dos testes (todos em verde).
• Comparação de métricas antes/depois.
• Lista de técnicas de refatoração aplicadas.
• Medições de melhoria de desempenho.
• Avaliação da dívida técnica restante.

Checklist de Segurança

Antes de fazer commit:

• ✓ Todos os testes passam (100% verde).
• ✓ Nenhuma regressão de funcionalidade.
• ✓ Métricas de desempenho aceitáveis.
• ✓ Cobertura de código mantida/melhorada.
• ✓ Documentação atualizada.

Protocolo de Recuperação

Se os testes falharem:

• Reverter imediatamente a última mudança.
• Identificar a refatoração que causou a falha.
• Aplicar mudanças incrementais menores.
• Usar controle de versão para experimentação segura.

Exemplo: Padrão Extrair Método

Antes:

class OrderProcessor {
  processOrder(order: Order): ProcessResult {
    // Validação
    if (!order.customerId || order.items.length === 0) {
      return { success: false, error: "Pedido inválido" };
    }

    // Calcular totais
    let subtotal = 0;

…