What problem does it solve?
This Skill eliminates the wasted time and compounded errors that come from guessing at bug fixes or addressing only symptoms instead of root causes. It provides a structured, repeatable process to diagnose, fix, and guard against any unexpected failure in tests, builds, runtime behavior, or production systems.
Core Features & Use Cases
- Stop-the-Line Rule: Prevents error compounding by halting feature work when unexpected issues arise, preserving evidence, and fixing root causes before resuming development.
- 6-Step Triage Checklist: A repeatable workflow covering reproduction, localization, reduction to a minimal failing case, root cause fixing, recurrence guarding, and end-to-end verification.
- Error-Specific Patterns: Tailored triage steps for test failures, build breaks, and runtime errors, plus safe fallback patterns for time-pressured scenarios.
- Safety Guardrails: Rules for treating error output as untrusted data, common rationalization red flags, and instrumentation guidelines to avoid introducing new issues during debugging.
Use case example: If your test suite fails after a code change, this Skill guides you to reproduce the failure, isolate the affected layer, create a minimal reproduction, fix the underlying issue (not just the test output), add a regression test, and verify the full suite passes without side effects.
Quick Start
Use the debugging-and-error-recovery skill to diagnose and fix the failing test suite after your latest code change, following the structured triage process to identify the root cause and add a regression test to prevent recurrence.
