janjaszczak troubleshooting-rca
Activation gate (anti-noise)
Activate when:
- There is an error message, failing test, crash, regression, unexpected behavior, or logs.
Skip when:
- User requests implementation from scratch and no failure exists yet.
Procedure
- Restate symptom + expected behavior.
- Collect minimal repro:
- Command, input, environment, last known good commit.
- Hypotheses (max 3) ranked by likelihood.
- Test each hypothesis with the smallest possible check.
- Before Fix: Root cause must be clearly stated; one minimal verification step must be given. Then: Fix + verify with test/run.
- Add a prevention note (test, guard, logging).
Output
- Symptom → Most likely cause → Fix → Verification command(s).