diff --git a/claude/code/commands/debug.md b/claude/code/commands/debug.md new file mode 100644 index 0000000..8de8400 --- /dev/null +++ b/claude/code/commands/debug.md @@ -0,0 +1,32 @@ +--- +name: debug +description: Systematic debugging workflow +--- + +# Debugging Protocol + +## Step 1: Reproduce +- Run the failing test/command +- Note exact error message +- Identify conditions for failure + +## Step 2: Isolate +- Binary search through changes (git bisect) +- Comment out code sections +- Add logging at key points + +## Step 3: Hypothesize +Before changing code, form theories: +1. Theory A: ... +2. Theory B: ... + +## Step 4: Test Hypotheses +Test each theory with minimal investigation. + +## Step 5: Fix +Apply the smallest change that fixes the issue. + +## Step 6: Verify +- Run original failing test +- Run full test suite +- Check for regressions