# Specsfy Specialist Debugging

> Diagnosticar bugs, regressões, falhas intermitentes e problemas de performance por reprodução, minimização, hipótese e instrumentação. Use quando o usuário pedir diagnóstico ou relatar algo quebrado; não implementar correção quando o pedido for somente diagnóstico.

- Skill: `promovaweb/specsfy-specialist-debugging-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add promovaweb/specsfy-specialist-debugging-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/promovaweb/specsfy-specialist-debugging-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: promovaweb (https://skillmd.com/u/promovaweb)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/promovaweb/specsfy-specialist-debugging-2

---


# Diagnóstico

## Fluxo

1. Capturar comportamento esperado, observado, ambiente e última ocorrência.
2. Construir reprodução confiável ou sinal observável.
3. Reduzir input, componentes e tempo até o menor caso.
4. Formular hipóteses falsificáveis e ordená-las.
5. Instrumentar o boundary mais discriminante.
6. Identificar causa, extensão e mecanismo.
7. Se autorizado, corrigir e adicionar teste de regressão.

## Padrões

- Não alterar várias causas possíveis ao mesmo tempo.
- Separar correlação temporal de causalidade.
- Preservar evidência antes de reiniciar ou limpar estado.
- Comparar ambiente bom e ruim sistematicamente.
- Tratar flakiness como concorrência, tempo, estado ou dependência até prova.
- Remover instrumentação sensível ou ruidosa ao concluir.
- Descrever causa no nível do mecanismo, não do sintoma.

## Validação

- Reprodução falha antes e passa após a correção.
- Teste de regressão falha pelo motivo correto.
- Verificação de cenários adjacentes e impacto.
- Registro conciso de causa, evidência e prevenção.

Leia [references/standards.md](references/standards.md) para técnicas de
reprodução, concorrência, performance e incidentes.