Merge 2 techniques from superpowers-systematic-debugging into debug, then delete it #14

Open
opened 2026-07-25 20:46:56 +00:00 by mathias · 0 comments
Owner

Overlap audit (fork, 2026-07-25): debug and superpowers-systematic-debugging cover the same core (hypothesis-before-fix) but debug is tighter and better-integrated: diagnose-only, ranked 3-5 hypotheses w/ VERIFY/EXPECTED format, delegates fix to tdd, brain/session_log-integrated (146 lines). systematic-debugging (296 lines) duplicates a fix-implementation phase that belongs to tdd, uses generic "your human partner" phrasing, and its rationalization table mostly restates debug's own Anti-Patterns table.

Action:

  1. Fold into debug: multi-component evidence-gathering technique (log at each boundary when a bug spans components) + the "3+ failed fixes → question architecture, not the fix" escalation rule. Not currently in debug.
  2. Drop everything else from systematic-debugging as pure restatement (phase-gate ceremony, duplicate fix-phase, restated rationalization table).
  3. Delete superpowers-systematic-debugging. Update SKILLS_INDEX.md + trigger table refs.

Target: debug grows ~146→~180 lines, stays the single debugging skill.

Overlap audit (fork, 2026-07-25): `debug` and `superpowers-systematic-debugging` cover the same core (hypothesis-before-fix) but `debug` is tighter and better-integrated: diagnose-only, ranked 3-5 hypotheses w/ VERIFY/EXPECTED format, delegates fix to `tdd`, brain/session_log-integrated (146 lines). `systematic-debugging` (296 lines) duplicates a fix-implementation phase that belongs to `tdd`, uses generic "your human partner" phrasing, and its rationalization table mostly restates debug's own Anti-Patterns table. Action: 1. Fold into `debug`: multi-component evidence-gathering technique (log at each boundary when a bug spans components) + the "3+ failed fixes → question architecture, not the fix" escalation rule. Not currently in `debug`. 2. Drop everything else from `systematic-debugging` as pure restatement (phase-gate ceremony, duplicate fix-phase, restated rationalization table). 3. Delete `superpowers-systematic-debugging`. Update `SKILLS_INDEX.md` + trigger table refs. Target: `debug` grows ~146→~180 lines, stays the single debugging skill.
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mathias/skills#14