debuglisted

# /debug - Systematic Debugging Workflow Structured approach to debugging issues. ## Usage ``` /debug <error message or description> /debug --trace # Include stack trace analysis /debug --bisect # Git bisect guidance ``` ## What This Skill Does 1. **Understand the Problem** - Parse error, reproduce issue 2. **Form Hypotheses** - Likely causes based on error type 3. **Systematic Investigation** - Step-by-step debugging 4. **Identify Root Cause** - Narrow down to exact issue 5. **Propose Fix** - Solution with verification ## Debugging Framework ```markdown # Debug Session: [Issue Description] ## 1. Problem Statement **Error**: [Exact error message] **When**: [When does it occur] **Frequency**: [Always / Sometimes / Once] ## 2. Reproduction Steps 1. Step 1 2. Step 2 3. Error occurs **Minimal Reproduction**: ```python # Smallest code that reproduces the issue ``` ## 3. Initial Hypotheses | # | Hypothesis | Likelihood | Test | |---|------------|------------|------| | 1 | Null pointer | High | Add null check | | 2 | Race condition | Medium | Add logging | | 3 | Config issue | Low | Check config | ## 4. Investigation Log ### Test 1: [Hypothesis being tested] **Action**: What I did **Result**: What happened **Conclusion**: Confirmed / Ruled out ### Test 2: ... ## 5. Root Cause [Exact cause identified] ## 6. Fix ```python # Before problematic_code() # After fixed_code() ``` ## 7. Verification - [ ] Fix applied - [ ] Original issue resolved