fix-root-causes
Trace symptoms to the violated invariant; ship the smallest causal fix.
SKILL.md.claude/skills/fix-root-causes/SKILL.md
GitHub<!-- Generated by mstack from Misbah's Build Like This workflow. Regenerate instead of editing. -->
fix-root-causes
Reproduce first, separate observation from guess, and keep asking why until the mechanism is confirmed. Ship only the change that evidence justifies.
When: Debugging, regressions, flaky tests, or repeated 'maybe this helps' edits.
Why: Symptom patches accumulate debt and often reintroduce the same failure nearby.
Do not: Claim root cause from correlation alone, or leave speculative belt-and-suspenders patches.
Cite this principle by id when it changed a decision. Keep the citation specific.