What problem does it solve? Debugging often produces quick patches that silence symptoms while the real bug survives, accumulating fragile workarounds across the codebase. This Skill enforces a disciplined root-cause methodology so fixes actually eliminate defects. ## Core Features & Use Cases - Reproduce-First Discipline: Requires reproducing a bug before attempting a fix, ensuring the fix can be verified. - Root-Cause Tracing: Applies iterative "why" questioning to reach the underlying cause and rejects nil-check guards that merely silence crashes. - Pattern-Wide Fixes: Greps for the same defect pattern across the codebase and fixes all instances, not just the reported one. - Restart-Bug Heuristic: Directs investigation toward stale persistent state (config files, caches, lock files) when failures appear only after restarts. - Use Case: A crash reappears after every deploy. Instead of adding another guard clause, use this Skill to reproduce the failure, trace it to a corrupted cache file, and add state validation as the real fix. ## Quick Start Apply the fix-root-causes principle to debug this recurring crash and trace it to its underlying cause before proposing any fix.
