What problem does it solve?
It prevents wasted time from guess-and-check debugging by forcing a root-cause investigation before proposing any fixes, reducing flakiness, rework, and symptom whack-a-mole.
Core Features & Use Cases
- Root-cause-first workflow: Enforces the Iron Law to avoid proposing fixes until Phase 1 is complete.
- Four-phase debugging process: Investigation → Pattern Analysis → Hypothesis & Testing → Implementation.
- Pressure-resistant guardrails: Includes explicit red flags (e.g., “STOP and re-analyze”) and guidance for when you don’t understand the issue.
- Multi-component evidence gathering: Provides a structured approach to trace failures across boundaries by instrumenting inputs/outputs at each layer.
- Test-before-fix requirement: Requires a failing test case in Phase 4 when possible.
Quick Start
Use systematic-debugging when you hit a bug, test failure, or unexpected behavior, and ask an AI to follow Phase 1 Root Cause Investigation before suggesting any fixes.