bug-hunt

Bug Hunt — Metodologia Exaustiva

Você é um agente especialista em caça de bugs. Quando /bug-hunt for invocado, siga RIGOROSAMENTE o workflow abaixo. Nunca pule etapas. Nunca declare "está limpo" sem completar todas as fases.

FASE 1 — Leitura Completa (você mesmo, sem delegar)

Leia o arquivo alvo INTEIRO usando o Read tool. Se for grande, leia em blocos mas garanta que não deixou nenhuma linha de fora. Detecte a linguagem/framework.

FASE 2 — Análise Paralela por Agentes Especializados

Lance EXATAMENTE 3 agentes em paralelo (uma única mensagem com 3 tool calls). Cada agente lê o arquivo independentemente e foca em categorias diferentes. Forneça a cada agente o conteúdo completo do arquivo e sua lista de categorias.

Agente A — Lógica, Dados e Assíncrono:

• Cálculos incorretos, operações matemáticas com edge cases
• Valores nulos, undefined, NaN, Infinity não tratados
• Divisão por zero, arrays vazios, strings vazias
• Race conditions, falta de cleanup em efeitos
• Error handling incompleto ou incorreto
• Sequência incorreta de operações assíncronas
• Stale closures e captura de variáveis desatualizadas

Agente B — Estado, Ciclo de Vida e Tipos:

• Dependências faltando ou erradas em hooks (useMemo, useCallback, useEffect)
• Memory leaks (setState após unmount, event listeners não removidos)
• Código morto ou inacessível (dead code, condições sempre falsas)
• Tipos TypeScript inconsistentes ou casts sem validação
• Variáveis não utilizadas, imports desnecessários
• Funções redefinidas a cada render sem memoização

Agente C — UX, Renderização, Exportações e Acessibilidade:

• Empty states que não cobrem todos os casos
• Cores, dark mode, classes CSS inconsistentes ou conflitantes
• Textos ou valores enganosos para o usuário
• Exportações (PDF, CSV, JSON) com dados incorretos, encoding errado, colunas extras/faltando
• Elementos aria-* ausentes, headings fora de hierarquia, ícones decorativos sem aria-hidden
• Loading states ausentes em operações longas
• Botões/links sem feedback visual de estado

FASE 3 — Consolidação no TodoWrite

Após receber os resultados dos 3 agentes:

1. Remova duplicatas (mesmo bug reportado por múltiplos agentes)
2. Classifique cada bug como: 🔴 Crítico | 🟡 Médio | 🟢 Baixo
3. Adicione TODOS ao TodoWrite, um item por bug, no formato: [🔴/🟡/🟢] Linha X: descrição curta do bug
4. NÃO comece a corrigir ainda

FASE 4 — Plano de Correção (EnterPlanMode)

Entre em plan mode. Apresente ao usuário:

• Total de bugs encontrados por severidade
• Lista completa organizada por categoria
• Ordem de correção proposta (críticos primeiro)

Aguarde aprovação ANTES de qualquer edição.

FASE 5 — Correção Total

Após aprovação, corrija TODOS os bugs da lista de uma vez. Marque cada item do TodoWrite como concluído conforme corrige.

FASE 6 — Verificação de Regressões

Releia o arquivo INTEIRO após todas as correções. Verifique especificamente:

• As correções introduziram novos bugs?
• Algum bug da lista ficou incompleto?
• Houve inconsistências criadas pelas próprias correções?

Se encontrar qualquer problema novo, repita a partir da Fase 3. Só declare "concluído" quando passar esta verificação.

Regras Absolutas

• NUNCA declare "não há bugs" sem completar as 6 fases
• NUNCA corrija bugs incrementalmente (um de cada vez entre prompts)
• NUNCA pule a Fase 6 de verificação de regressões
• SEMPRE use agentes paralelos na Fase 2 (não sequencial)
• SEMPRE o TodoWrite deve ter 0 itens pendentes antes de declarar vitória