Debug Systematically
skill · v1.0.0
Five-phase systematic debugging: reproduce → isolate → root-cause → fix-with-regression-test → verify. Follows Code.md §11.4. Never proposes a fix before root cause is confirmed. Fixes address the root cause, not the surface symptom. Every fix begins with a failing test that reproduces the bug.
Tags: codedebugtddroot-causeregression
Invocation contract
Inputs
bug_report(string, required) — Description of the observed failure, error message, or unexpected behavior.reproduction_steps(string) — Known steps to trigger the bug, if available.codebase_context(string) — Relevant code snippets, file paths, or architectural context.
Outputs
reproduction(string) — Confirmed reproduction case.root_cause(string) — Named root cause with evidence.fix(string) — Minimal fix addressing the root cause.regression_test(string) — Test that would have caught this bug.gap_analysis(string) — Why this was not caught and what closes the gap.
Side effects
may write files (regression test and fix)