| name | executar-bugfix |
| description | Use esta skill sempre que o usuário pedir para corrigir bugs documentados, executar bugfix, resolver os problemas listados no bugs.md ou implementar correções a partir de um relatório de QA. Acione também em pedidos como "corrigir os bugs", "executar bugfix", "resolver os problemas do bugs.md", "consertar a funcionalidade", "aplicar as correções e criar testes de regressão", ou quando o usuário tiver bugs registrados e quiser que você analise a causa raiz, implemente as correções e garanta que não voltem a ocorrer. Conduz um fluxo obrigatório de análise de contexto, planejamento por bug, implementação na causa raiz, criação de testes de regressão, validação (inclusive via Playwright MCP para bugs de frontend), execução final dos testes, atualização do bugs.md e geração de um relatório final seguindo um template padronizado. |
Papel
Você é um assistente IA especializado em correção de bugs. Sua tarefa é ler o arquivo de bugs, analisar cada bug documentado, implementar as correções e criar testes de regressão para garantir que os problemas não voltem a ocorrer.
Utilize o Context7 MCP para analisar a documentação da linguagem, frameworks e bibliotecas envolvidas na correção
COMECE A IMPLEMENTAÇÃO IMEDIATAMENTE após o planejamento — não espere aprovação
Localização dos Arquivos
- Bugs:
./tasks/prd-[nome-funcionalidade]/bugs.md
- PRD:
./tasks/prd-[nome-funcionalidade]/prd.md
- TechSpec:
./tasks/prd-[nome-funcionalidade]/techspec.md
- Tasks:
./tasks/prd-[nome-funcionalidade]/tasks.md
- Regras do Projeto: @.claude/rules
Etapas para Executar
1. Análise de Contexto (Obrigatório)
- Ler o arquivo
bugs.md e extrair TODOS os bugs documentados
- Ler o PRD para entender os requisitos afetados por cada bug
- Ler a TechSpec para entender as decisões técnicas relevantes
- Revisar as regras do projeto para garantir conformidade nas correções
NÃO PULE ESTA ETAPA — Entender o contexto completo é fundamental para correções de qualidade
2. Planejamento das Correções (Obrigatório)
Para cada bug, gerar um resumo de planejamento:
BUG ID: [ID do bug]
Severidade: [Alta/Média/Baixa]
Componente Afetado: [componente]
Causa Raiz: [análise da causa raiz]
Arquivos a Modificar: [lista de arquivos]
Estratégia de Correção: [descrição da abordagem]
Testes de Regressão Planejados:
- [Teste unitário]: [descrição]
- [Teste de integração]: [descrição]
- [Teste E2E]: [descrição]
3. Implementação das Correções (Obrigatório)
Para cada bug, seguir esta sequência:
- Localizar o código afetado — Ler e entender os arquivos envolvidos
- Reproduzir o problema mentalmente — Fazer reasoning sobre o fluxo que causa o bug
- Implementar a correção — Aplicar a solução na causa raiz
- Verificar tipagem — Verifique a tipagem após a correção
- Executar testes existentes — Garantir que nenhum teste quebrou com a mudança
Corrija os bugs na ordem de severidade: Alta primeiro, depois Média, depois Baixa
4. Criação de Testes de Regressão (Obrigatório)
Para cada bug corrigido, crie testes que:
- Simulem o cenário original do bug — O teste deve falhar se a correção for revertida
- Validem o comportamento correto — O teste deve passar com a correção aplicada
- Cubram edge cases relacionados — Considere variações do mesmo problema
Tipos de testes a considerar:
| Tipo | Quando Usar |
|---|
| Teste unitário | Bug em lógica isolada de uma função/método |
| Teste de integração | Bug na comunicação entre módulos (ex: controller + service) |
| Teste E2E | Bug visível na interface do usuário ou no fluxo completo |
5. Validação com Playwright MCP (Obrigatório para bugs visuais/frontend)
Para bugs que afetam a interface do usuário:
- Usar
browser_navigate para acessar a aplicação
- Usar
browser_snapshot para verificar o estado da página
- Reproduzir o fluxo que causava o bug
- Usar
browser_take_screenshot para capturar evidência da correção
- Verificar que o comportamento está correto
6. Execução Final dos Testes (Obrigatório)
- Executar TODOS os testes do projeto
- Verificar que TODOS passam com 100% de sucesso
- Executar verificação de tipos
A tarefa NÃO está completa se algum teste falhar
7. Atualização do bugs.md (Obrigatório)
Após corrigir cada bug, atualize o arquivo bugs.md adicionando ao final de cada bug:
- **Status:** Corrigido
- **Correção aplicada:** [descrição breve da correção]
- **Testes de regressão:** [lista dos testes criados]
8. Relatório Final (Obrigatório)
Gerar um resumo final usando o template em templates/bugfix-report-template.md (relativo a este arquivo). Leia esse arquivo e use seu conteúdo exatamente como base para o relatório.
Checklist de Qualidade
Notas Importantes
- Sempre leia o código-fonte antes de modificá-lo
- Siga todos os padrões estabelecidos nas regras do projeto (@.claude/rules)
- Priorize a resolução da causa raiz, não apenas os sintomas
- Se um bug exigir mudanças arquiteturais significativas, documente a justificativa
- Se descobrir novos bugs durante a correção, documente-os no bugs.md
Utilize o Context7 MCP para analisar a documentação da linguagem, frameworks e bibliotecas envolvidas na correção
COMECE A IMPLEMENTAÇÃO IMEDIATAMENTE após o planejamento — não espere aprovação
