What problem does it solve?
It helps you evaluate how closely an implementation matched the intended spec and identify what to improve in the next SDD cycle, including where drift happened and what lessons to carry forward.
Core Features & Use Cases
- Post-implementation drift and adherence analysis: Quantifies spec adherence using requirement coverage from spec.md, plan.md, and tasks.md, including implemented, partial, modified, and unspecified items.
- Deviation severity classification: Labels findings as CRITICAL, SIGNIFICANT, MINOR, or POSITIVE to prioritize follow-up work and spotlight process-impacting issues.
- Actionable retrospective reporting: Produces a retrospective.md report saved to the feature directory with evidence-backed findings, a coverage matrix, and prioritized recommendations.
- Constitution compliance checks: Detects constitution violations and treats them as CRITICAL.
- Human gate for spec modifications: Prevents unintended spec changes by requiring explicit user confirmation before any action that modifies spec.md.
Quick Start
Run speckit-retrospective-analyze after finishing the implementation to generate retrospective.md in the feature directory and summarize spec adherence and deviations.