Better Debugger (Codex)
Use this skill for systematic root-cause analysis.
Trigger
Use when the user asks to:
- debug failures in runtime behavior,
- trace errors from logs to source,
- isolate regression-introducing changes,
- produce actionable fix hypotheses.
Primary Workflow
- Collect symptom details and failure context.
- Analyze logs/trace evidence and map error signatures.
- Trace code paths and recent changes affecting those paths.
- Form and test hypotheses against available evidence.
- Produce root-cause statement and fix validation plan.
Operating Rules
- Separate confirmed facts from hypotheses.
- Do not claim root cause without evidence chain.
- Prefer minimal reproducible failure cases.
- No code modifications unless user requests fixes.
Output Contract
Symptom summaryEvidence chainMost likely root causeFix plan+validation plan