SkillProgramaçãoDiagnostica
Debugging Sistemático
Encontra a causa raiz antes de qualquer correção - ler erros, reproduzir, checar mudanças, reunir evidências, formar uma única hipótese e testar de forma mínima. Use para qualquer problema técnico: falhas de teste, bugs em produção, comportamento inesperado, problemas de performance ou build.
Ações
PerfilDev
ProfundidadeAlta
IdiomaInglês (skill original)
Objetivo
Em uma frase.
Sempre encontrar a causa raiz antes de tentar correções. Correções aleatórias desperdiçam tempo e criam novos bugs; patches rápidos mascaram problemas subjacentes. A lei de ferro é clara: nenhuma correção sem investigação de causa raiz primeiro.
Aplicação
Quando
faz sentido.
Usar
- Qualquer problema técnico: falhas de teste, bugs em produção, comportamento inesperado, problemas de performance, falhas de build ou de integração.
- Especialmente sob pressão de tempo, quando uma 'correção rápida' parece óbvia.
- Quando você já tentou várias correções e a anterior não funcionou.
- Quando não entende completamente o problema.
Não usar
- A correção é genuinamente trivial E a causa raiz é óbvia em uma linha (erro de digitação em um valor literal).
- Um workflow separado já cobre o caso de ponta a ponta - use systematic-bug-investigation para ownership completo.
Prompt
Instruções
para a IA.
### Fase 1 - Investigação da causa raiz
Complete antes de qualquer correção. Leia as mensagens de erro com atenção - elas costumam conter a solução exata. Reproduza de forma consistente; sem reprodução confiável, reúna mais dados em vez de adivinhar. Cheque mudanças recentes (git diff, commits, novas dependências, config). Em sistemas multicomponente, registre os dados que entram e saem de cada fronteira para descobrir ONDE quebra. Rastreie o fluxo de dados até a origem do valor incorreto e corrija na fonte, não no sintoma.
### Fase 2 - Análise de padrões
Encontre exemplos funcionais no mesmo codebase, compare com implementações de referência lendo-as por completo e liste cada diferença, por menor que seja.
### Fase 3 - Hipótese e teste
Forme uma única hipótese específica e teste com a menor mudança possível, uma variável por vez. Se funcionar, avance; se não, forme uma NOVA hipótese - não empilhe correções.
### Fase 4 - Implementação
Crie um teste que falha reproduzindo o bug (use TDD), implemente uma única correção na causa raiz, sem melhorias 'já que estou aqui', e verifique. Se após 3 tentativas as correções falharem, pare e questione a arquitetura junto ao parceiro humano - isso não é hipótese errada, é arquitetura errada.
Complete antes de qualquer correção. Leia as mensagens de erro com atenção - elas costumam conter a solução exata. Reproduza de forma consistente; sem reprodução confiável, reúna mais dados em vez de adivinhar. Cheque mudanças recentes (git diff, commits, novas dependências, config). Em sistemas multicomponente, registre os dados que entram e saem de cada fronteira para descobrir ONDE quebra. Rastreie o fluxo de dados até a origem do valor incorreto e corrija na fonte, não no sintoma.
### Fase 2 - Análise de padrões
Encontre exemplos funcionais no mesmo codebase, compare com implementações de referência lendo-as por completo e liste cada diferença, por menor que seja.
### Fase 3 - Hipótese e teste
Forme uma única hipótese específica e teste com a menor mudança possível, uma variável por vez. Se funcionar, avance; se não, forme uma NOVA hipótese - não empilhe correções.
### Fase 4 - Implementação
Crie um teste que falha reproduzindo o bug (use TDD), implemente uma única correção na causa raiz, sem melhorias 'já que estou aqui', e verifique. Se após 3 tentativas as correções falharem, pare e questione a arquitetura junto ao parceiro humano - isso não é hipótese errada, é arquitetura errada.
Constelação
Onde
ela vive.
Execução
Como usar
com IA.
- 01Copie a skill (botão "Copiar skill para IA", no topo): o texto copiado já é a skill completa, não um resumo.
- 02Abra o Claude ou Claude Code e cole — a IA recebe todas as instruções e fica pronta para a tarefa.
- 03Prefere usar como arquivo reutilizável? Baixe o .zip e coloque o
SKILL.mdem.claude/skills/(Claude Code) ou anexe o arquivo no Claude (claude.ai).