What problem does it solve?
The bug-fix Skill helps you reliably resolve defects without compounding failures by enforcing a disciplined workflow: stop early on failures, diagnose the root cause, add a regression test, and verify everything end-to-end.
Core Features & Use Cases
- Stop-the-Line Protocol: Prevents symptom-level edits by freezing changes when tests/builds/lint fail and capturing the exact evidence needed to debug correctly.
- Triage Sequence: Guides reproduction, localization to the causal layer, minimal failing cases, and root-cause fixes instead of speculative refactors.
- Regression Guard & Verification: Requires a regression test and reruns the full check suite to ensure the fix is durable.
- Use Case: When a CI failure appears after a merge (e.g., a race condition causing a hang or timeout), apply the triage steps to isolate the real causal layer, implement the minimal root-cause fix, and add a test that would have caught it earlier.
Quick Start
Use the bug-fix skill when you see a “fix bug” style request or a failing test/build, and ask your agent to reproduce the issue, diagnose the causal layer, implement the minimal root-cause fix, add a regression test, and verify with the full lint/typecheck/test suite.