| name | superpowers-systematic-debugging |
| description | Debug by reproducing, isolating root cause, fixing the cause, and verifying the fix instead of guessing. |
Systematic Debugging
Use this for bugs, failures, confusing behavior, and regressions.
Process:
- Reproduce or inspect the failing path.
- Gather evidence from code, logs, tests, and exact error output.
- Form a minimal hypothesis.
- Isolate the root cause.
- Fix the root cause, not the symptom.
- Add a regression test when practical.
- Verify with the narrow test and required check command.
Do not make unrelated cleanup changes while debugging.