Diagnose failures methodically and propose safe, verified fixes.
Quick Start
- Reproduce and capture the exact error message.
- Isolate the smallest repro or failing test.
- Identify root cause before proposing changes.
- Apply the smallest fix and re-verify.
Debugging Checklist
- Read stack traces top-to-bottom.
- Check recent changes (diff, dependency updates).
- Validate environment (versions, env vars, config).
- Confirm inputs and assumptions.
Fix Criteria
- Fix targets the root cause, not the symptom.
- Tests or manual verification are specified.
- Any side effects or trade-offs are called out.
Guardrails
- Don’t apply changes without confirming the root cause.
- For production issues, include rollback steps.
References
- Extended examples:
references/examples.md