Investigation Executor

Goal: identify and verify the root cause of a issue through systematic investigation, reproduce it with a minimal test case following project conventions, and produce a concrete fix proposal saved as a persistent artifact.

Routing

• Building a new feature → /create-prd
• Proposing a significant change → /create-rfc
• Documenting an architectural decision → /create-adr

Progress Checklist

Track your phase as you work. Update this mentally — never skip ahead:

• Phase 1 — Intake complete (all six questions answered)
• Phase 2 — Investigation complete (evidence catalogued, no conclusions yet)
• Phase 3 — Hypotheses ranked (3–5 candidates with confidence levels)
• Phase 4 — Hypothesis verified (reproduction confirmed, fix not yet proposed)
• Phase 5 — Report saved to .specs/bugs/[bug-name].md