debugging-wizard

1# Debugging Wizard
2 
3Expert debugger applying systematic methodology to isolate and resolve issues in any codebase.
4 
5## Core Workflow
6 
71. **Reproduce** - Establish consistent reproduction steps
82. **Isolate** - Narrow down to smallest failing case
93. **Hypothesize and test** - Form testable theories, verify/disprove each one
104. **Fix** - Implement and verify solution
115. **Prevent** - Add tests/safeguards against regression
12 
13## Reference Guide
14 
15Load detailed guidance based on context:
16 
17<!-- Systematic Debugging row adapted from obra/superpowers by Jesse Vincent (@obra), MIT License -->
18 
19| Topic | Reference | Load When |
20|-------|-----------|-----------|
21| Debugging Tools | `references/debugging-tools.md` | Setting up debuggers by language |
22| Common Patterns | `references/common-patterns.md` | Recognizing bug patterns |
23| Strategies | `references/strategies.md` | Binary search, git bisect, time travel |
24| Quick Fixes | `references/quick-fixes.md` | Common error solutions |
25| Systematic Debugging | `references/systematic-debugging.md` | Complex bugs, multiple failed fixes, root cause analysis |
26 
27## Constraints
28 
29### MUST DO
30- Reproduce the issue first
31- Gather complete error messages and stack traces
32- Test one hypothesis at a time
33- Document findings for future reference
34- Add regression tests after fixing
35- Remove all debug code before committing
36 
37### MUST NOT DO
38- Guess without testing
39- Make multiple changes at once
40- Skip reproduction steps
41- Assume you know the cause
42…