fix-root-causes

Trace symptoms to the violated invariant; ship the smallest causal fix.

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.