Documentation
README
Debugger Skill
Systematic debugging methodology for diagnosing failures and root cause analysis.
When to Apply This Guidance
- 2+ failed fix attempts on the same issue
- Debugging that's gone in circles
- Complex system behavior you don't understand
- Multi-system integration problems
- Intermittent failures (Heisenbugs)
Structured Analysis Framework
Step 1: Restate the Problem
Before investigating, articulate:
- What is the actual vs expected behavior?
- What assumptions might be wrong?
- What could cause the specific symptoms described?
- Are there hidden dependencies or side effects?
Step 2: Generate Ranked Hypotheses
Always generate multiple hypotheses, ranked by likelihood:
Most Likely:
- Evidence: What supports this theory?
- Test: How to verify quickly?
This is the opening of the README. Read the full README on GitHub.