What problem does it solve?
When unexpected behavior or regressions occur in a codebase, it is easy to patch symptoms, introduce new regressions, or lose reproducible evidence of the bug. This Skill enforces a failing-test-first workflow so bugs are reliably reproduced, fixed at the root cause, and guarded by regression tests to prevent recurrence.
Core Features & Use Cases
- Failing-test-first methodology: Require a regression test or minimal reproduction before changing code.
- Localization and minimal fixes: Use targeted reading and grepping to locate the divergence point and apply the smallest root-cause change.
- Verification and handoff: Run targeted regression tests and a verification script, then hand off to the repository commit workflow for pre-commit gates.
- Use Case: Fix an off-by-one error by adding a failing unit test, correcting the loop boundary, and verifying the full test suite succeeds.
Quick Start
Use the fixing-bugs skill to reproduce the failure with a regression test, implement a minimal root-cause fix, and verify the full test suite before handing off for commit.