What problem does it solve?
Investigate a bug or test failure methodically through four phases — understand the symptom, isolate variables, form and test hypotheses, then fix at the root. The workflow emphasizes collecting evidence before proposing fixes, rejects shotgun debugging, and escalates to architectural investigation after three failed fix attempts.
Core Features & Use Cases
- Four-phase, phase-ordered debugging workflow: Understand the symptom, identify the root cause, verify hypotheses with evidence, and implement a minimal, well-documented fix.
- Evidence-centric analysis: reproduction steps, logs, traces, and data-flow review are captured to support conclusions.
- Root-cause hypothesis and escalation: encourages explicit hypotheses, validation, and escalation when fixes stagnate.
- Safeguards against guessing: formal process prevents ad-hoc fixes and ensures traceability.
- Companion practices: aligns with start-work, root-cause-trace, and five-whys for cross-checking insights.
- Practical applicability: suitable for unclear or inconsistent failure modes in tests or production.
Quick Start
Describe the symptom and then work through Phase 1 to Phase 4 in order to gather evidence and identify the root cause before proposing a fix.