Correção de Testes

Identifique e corrija sistematicamente todos os testes com falha usando estratégias de agrupamento inteligentes.

Quando Usar

• Solicita explicitamente a correção de testes ("corrija estes testes", "faça os testes passarem")
• Relata falhas de teste ("testes estão falhando", "suíte de testes está quebrada")
• Conclui a implementação e quer que os testes passem
• Menciona falhas de CI/CD devido a testes

Abordagem Sistemática

1. Execução Inicial dos Testes

Execute make test para identificar todos os testes com falha.

Analise a saída para:

• Número total de falhas
• Tipos e padrões de erro
• Módulos/arquivos afetados

2. Agrupamento Inteligente de Erros

Agrupe falhas semelhantes por:

• Tipo de erro: ImportError, AttributeError, AssertionError, etc.
• Módulo/arquivo: Mesmo arquivo causando múltiplas falhas de teste
• Causa raiz: Dependências ausentes, alterações de API, impactos de refatoração

Priorize grupos por:

• Número de testes afetados (maior impacto primeiro)
• Ordem de dependência (corrija a infraestrutura antes da funcionalidade)

3. Processo Sistemático de Correção

Para cada grupo (começando pelo de maior impacto):

1. Identifique a causa raiz

   • Leia o código relevante
   • Verifique alterações recentes com git diff
   • Entenda o padrão de erro

2. Implemente a correção

   • Use a ferramenta de Edição para alterações de código
   • Siga as convenções do projeto (veja CLAUDE.md)
   • Faça alterações mínimas e focadas

3. Verifique a correção

   • Execute um subconjunto de testes para este grupo
   • Use marcadores pytest ou padrões de arquivo:

     uv run pytest tests/path/to/test_file.py -v
     uv run pytest -k "pattern" -v
     

   • Garanta que o grupo passe antes de seguir em frente

4. Passe para o próximo grupo

4. Estratégia de Ordem de Correção

Infraestrutura primeiro:

• Erros de importação
• Dependências ausentes
• Problemas de configuração

Em seguida, alterações de API:

• Alterações na assinatura da função
• Reorganização de módulos
• Variáveis/funções renomeadas

Finalmente, problemas de lógica:

• Falhas de asserção
• Bugs na lógica de negócios
• Tratamento de casos extremos

5. Verificação Final

Após todos os grupos corrigidos:

• Execute a suíte de testes completa: make test
• Verifique se não há regressões
• Verifique se a cobertura de testes permanece intacta

Melhores Práticas

• Corrija um grupo por vez
• Execute testes focados após cada correção
• Use git diff para entender as alterações recentes
• Procure padrões nas falhas
• Não passe para o próximo grupo até que o atual passe
• Mantenha as alterações mínimas e focadas

Fluxo de Trabalho de Exemplo

Usuário: "Os testes estão falhando após meu refatoramento"

1. Execute make test → 15 falhas identificadas
2. Agrupe erros:
   • 8 ImportErrors (módulo renomeado)
   • 5 AttributeErrors (assinatura da função alterada)
   • 2 AssertionErrors (bugs de lógica)
3. Corrija os ImportErrors primeiro → Execute subconjunto → Verifique
4. Corrija os AttributeErrors → Execute subconjunto → Verifique
5. Corrija os AssertionErrors → Execute subconjunto → Verifique
6. Execute a suíte completa → Todos passam ✓

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão de especialistas.
• Pare e peça esclarecimentos se os inputs, permissões, limites de segurança ou critérios de sucesso necessários estiverem ausentes.