---

name: debug-workflow description: Systematic debugging and problem resolution

Debug Workflow

Process

Copy1. Reproduce -> 2. Hypothesize -> 3. Investigate -> 4. Fix -> 5. Verify

Step 1: Reproduce

• Confirm issue exists
• Find consistent trigger
• Document steps

Step 2: Hypothesize

• List possible causes
• Rank by likelihood
• Plan investigation

Step 3: Investigate

Copy| Hypothesis | Test | Result |
|------------|------|--------|
| [Cause] | [How to verify] | [Finding] |

Step 4: Fix

• Implement minimal fix
• Avoid side effects
• Add regression test

Step 5: Verify

• Issue resolved
• No new issues
• Tests pass

Debug Template

Copy# Debug: [Issue]

## Symptoms
## Reproduction Steps
## Hypotheses
## Investigation
## Root Cause
## Fix
## Prevention