🐛 Structured Bug Report - Avancado
O Structured Bug Report avancado adiciona camadas de contexto que aceleram a investigacao. Alem do basico (bug, esperado, atual), voce inclui ambiente, historico de mudancas recentes e hipoteses iniciais.
🎯 Template Avancado
Investigue este bug com profundidade total: ## Contexto - Bug: [descricao precisa] - Ambiente: [dev/staging/prod] [OS] [Node/Python version] - Primeira ocorrencia: [quando comecou] - Frequencia: [sempre/intermitente/condicional] ## Sintomas - Esperado: [comportamento correto] - Atual: [comportamento errado] - Erro exato: [mensagem/stack trace - cole aqui] ## Historico - Mudancas recentes: [commits ou deploys recentes que podem ter causado] - Ja tentei: [o que voce ja fez para resolver] ## Investigacao 1. Identifique a causa raiz (nao o sintoma) 2. Trace o fluxo de dados desde a entrada ate o ponto de falha 3. Verifique se ha outros lugares no codigo com o mesmo padrao vulneravel 4. Proponha fix minimo + teste de regressao 5. Avalie impacto: essa correcao pode quebrar algo?
💡 Dica Pratica
O campo "Ja tentei" e crucial. Ele evita que o Claude sugira solucoes que voce ja sabe que nao funcionam, economizando tempo e tokens. Sempre liste o que ja testou.
📊 Log Analysis
O prompt de Log Analysis transforma o Claude em um analisador de logs especializado. Ele identifica padroes, anomalias e correlacoes que seriam dificeis de encontrar manualmente em logs extensos.
🎯 Template do Prompt
Analise estes logs e encontre o problema: [COLE OS LOGS AQUI] Preciso que voce: 1. Identifique a sequencia de eventos que levou ao erro 2. Separe logs normais de logs anomalos 3. Encontre o PRIMEIRO evento que divergiu do comportamento esperado 4. Correlacione timestamps para identificar latencias anormais 5. Identifique se ha padroes repetitivos (loops, retries excessivos) 6. Proponha a causa raiz baseada na evidencia dos logs Formato: Timeline com [timestamp] [evento] [normal/anomalo] [significado]
💡 Dica Pratica
Para logs muito longos, filtre antes de colar. Use grep -A5 -B5 "ERROR\|WARN" para extrair apenas as linhas relevantes com contexto. O Claude analisa melhor logs focados do que logs gigantes.
📚 Stack Trace Handling
O Stack Trace Handling ensina o Claude a interpretar stack traces de forma eficiente, separando o codigo do seu projeto das bibliotecas externas e identificando exatamente onde o problema esta.
🎯 Template do Prompt
Analise este stack trace: [COLE O STACK TRACE] 1. Separe as linhas do NOSSO codigo das linhas de bibliotecas externas 2. Identifique a linha EXATA do nosso codigo onde o erro originou 3. Leia o arquivo e a funcao apontados pelo stack trace 4. Explique o que estava acontecendo no momento do erro 5. Identifique a causa raiz (tipo errado? null? async nao tratado?) 6. Proponha a correcao minima Foque apenas no nosso codigo - ignore frames de node_modules/stdlib.
💡 Dica Pratica
Sempre cole o stack trace completo, nao apenas a mensagem de erro. Os frames intermediarios muitas vezes contem a pista mais importante - especialmente em erros de callback e promises.
🏷️ Categorizacao de Erros
A categorizacao de erros e um prompt que organiza multiplos erros por tipo, prioridade e relacao entre eles. Ideal para quando voce tem varios bugs simultaneos e precisa saber por onde comecar.
🎯 Template do Prompt
Estou vendo multiplos erros. Categorize e priorize: [COLE TODOS OS ERROS/LOGS] Para cada erro: 1. Categoria: [Tipo | Runtime | Build | Config | Network | Auth | Data] 2. Severidade: [Critico | Alto | Medio | Baixo] 3. Relacionamento: Este erro pode ser CAUSADO por outro erro na lista? 4. Ordem de resolucao: Qual resolver primeiro? Identifique se ha um erro RAIZ que, ao ser resolvido, corrige os outros em cascata.
💡 Dica Pratica
Erros em cascata sao extremamente comuns. Um erro de configuracao pode gerar 10 erros de runtime diferentes. Sempre resolva o erro raiz primeiro - muitas vezes, 80% dos erros desaparecem sozinhos.
🔬 Root Cause Analysis
O Root Cause Analysis forca o Claude a ir alem da correcao superficial e encontrar por que o bug existe em primeiro lugar. Isso previne que o mesmo tipo de bug apareca novamente em outro lugar do codigo.
🎯 Template do Prompt
Faca uma analise de causa raiz completa usando os 5 Porques: Bug: [descricao] Para cada "por que": 1. Por que o erro aconteceu? → [resposta] 2. Por que [resposta 1] aconteceu? → [resposta] 3. Por que [resposta 2] aconteceu? → [resposta] 4. Por que [resposta 3] aconteceu? → [resposta] 5. Por que [resposta 4] aconteceu? → [causa raiz] Depois: - Existe esse mesmo padrao em outros lugares do codigo? - Que mudanca SISTEMICA preveniria esse tipo de bug? - Que regra podemos adicionar ao CLAUDE.md para evitar?
💡 Dica Pratica
Apos encontrar a causa raiz, adicione a prevencao ao CLAUDE.md. Exemplo: se o bug foi causado por falta de validacao de input, adicione: "Sempre valide inputs antes de processar. Nunca assuma que dados externos sao validos."
🔄 Workflow Completo de Debugging
O workflow completo de debugging combina todos os prompts anteriores em uma sequencia logica. Siga essa ordem para resolver qualquer bug de forma sistematica, do mais simples ao mais complexo.
🎯 Sequencia de Debugging
💡 Dica Pratica
Para bugs simples, pule direto para o passo 3 (Bug Report). A sequencia completa e para bugs complexos ou intermitentes que resistem a correcoes superficiais. Sempre termine com prevencao - o melhor debug e o que nunca precisa acontecer de novo.
📋 Resumo do Modulo
Proximo Modulo:
4.5 - Prompts de Code Quality