/debug

Name

debug

Description

Expert debugging methodology. Triggers on debug, investigate, fix bug, troubleshoot.

# Debug Like an Expert

**Core principle:** VERIFY, DON'T ASSUME. Code you wrote deserves extra skepticism.

## Phase 1: EVIDENCE GATHERING
- Document exact error (full message, stack trace)
- Identify affected components
- Check recent changes (`git diff`, `git log`)
- Research error via context7 MCP if needed

**Output:** Evidence summary
**Gate:** Have reproducible steps before proceeding

## Phase 2: ROOT CAUSE ANALYSIS
- Form 2-3 testable hypotheses
- Test ONE variable at a time
- Read complete files, not snippets
- Chase dependencies to their source

**Output:** Identified root cause with evidence
**Gate:** Can explain WHY the bug occurs

## Phase 3: SOLUTION
- Implement minimal fix
- Verify fix addresses root cause (not symptoms)
- Test original reproduction steps
- Check for regressions

**Output:** Working fix with verification

## Rules
- No fixes without explaining WHY they work
- Never assume - verify every assumption
- Test one change at a time
- Would this fix survive code review?