What problem does it solve? Debugging often leads to superficial patches that treat symptoms instead of causes, or to risky rushed changes during production incidents. This Skill enforces a disciplined root cause analysis workflow for normal bugs and a tightly constrained hotfix procedure for production emergencies. ## Core Features & Use Cases - Root Cause Analysis: Reproduce the bug, gather evidence with Grep and git log, identify the true root cause, and report it before making any fix. - Hotfix Mode (--hotfix): Create a hotfix branch from main, apply a minimal fix under ~50 lines, run only directly related tests, and require user approval of the branch name and commit message before acting. - Test-Driven Fix Verification: Add a test that reproduces the bug (failing before, passing after) and run the project's test command from tech-stack.md after fixing. - Use Case: When a production error alert fires, invoke the skill with "--hotfix payment timeout error" to get a minimal, reviewed fix on a dedicated hotfix branch without touching unrelated code. ## Quick Start Ask the assistant to debug a described bug or error message, optionally adding --hotfix for a production emergency fix.
