1---2name: superpowers-debug3description: "Systematic debugging: reproduce, isolate, form hypotheses, instrument, fix, and add regression tests. Use when troubleshooting errors, failing tests, or unexpected behavior."4metadata:5 source: https://skillmd.com/skills/phoroth/superpowers-debug6---78# Debug Skill910## When to use this skill11- runtime errors, flaky tests, wrong outputs12- “it used to work” regressions13- performance or timeout problems (initial triage)1415## Debug workflow (do not skip steps)161. **Reproduce**17 - Capture exact error, inputs, enprojectnment, command.182. **Minimize**19 - Reduce to smallest repro (one file, one function, smallest dataset).203. **Hypotheses (2–5)**21 - Rank by likelihood.224. **Instrument**23 - Add temporary logging/assertions or use existing diagnostics.245. **Fix**25 - Smallest change that removes root cause.266. **Prevent**27 - Add regression test or permanent guard/validation.287. **Verify**29 - Run the failing case + relevant suites.3031## Reporting format32- Symptom33- Repro steps34- Root cause35- Fix36- Regression protection37- Verification