What problem does it solve?
Systematic Debugging replaces ad-hoc guessing with a repeatable process to reproduce, isolate, diagnose, and verify fixes for software bugs, runtime errors, test failures, and performance regressions. It reduces time-to-resolution by focusing investigation on the true root cause and preventing recurrence through verification and tests.
Core Features & Use Cases
- Reproduce reliably: Capture clear reproduction steps and environment details to avoid guessing.
- Isolate efficiently: Use binary-search narrowing, targeted logging, and layer-by-layer checks to pinpoint the failing component, file, function, or line.
- Diagnose and verify: Parse error messages fully, validate assumptions with concrete checks, implement a corrective change, and add regression tests to prevent recurrence.
- Use Case: Investigate a production-only "invalid password" login failure by reproducing the error, isolating the backend comparison, discovering hashing-config mismatches, applying a progressive migration fix, and verifying with staged tests.
Quick Start
Run the systematic-debugging skill by providing clear reproduction steps, the full error message, environment details, and any relevant logs to receive a prioritized isolation plan and verification checklist.
