debugginglisted
Install: claude install-skill soden46/engineer-flow
# debugging
Use this skill for failures, exceptions, incorrect behavior, intermittent bugs, and root-cause analysis.
## Principles
Reproduce before changing code when practical.
Separate:
- symptom
- trigger
- root cause
Collect evidence from relevant:
- errors
- logs
- inputs
- state
- recent changes
- traces
- database behavior
- network behavior
Reduce the problem to the smallest useful reproduction.
Avoid broad speculative changes.
Once root cause is identified:
1. make the smallest correct fix
2. add regression protection where useful
3. verify nearby behavior
4. remove temporary debugging instrumentation
Do not hide failures merely by suppressing exceptions or logs.
## Adaptation
Use project evidence to determine the actual language, framework, runtime, and existing conventions.
When stack-specific implementation guidance is needed, prefer project evidence, native framework or language mechanisms, and relevant user-installed specialist skills. Technology-specific guidance must not redefine or weaken the core engineering requirement.