What problem does it solve?
It prevents stories from being marked complete when acceptance criteria, evidence, and design/architecture alignment have not actually been verified, reducing drift between GDD/ADR intent and implementation reality.
Core Features & Use Cases
- Acceptance-criteria verification: Reads a story file and checks each acceptance criterion via file/test/string and dependency checks, with optional manual confirmation for subjective or hard-to-automate items.
- Traceability and evidence gating: Builds a criterion-to-test traceability table and enforces evidence expectations based on story type (e.g., BLOCKING for missing Logic unit tests, advisory for missing UI/Visual evidence).
- Deviation detection with explicit reporting: Checks for GDD/registry mismatches, manifest staleness, ADR constraint issues, numeric hardcoding, and out-of-scope file touches, then prompts for code review and surfaces the next ready story.
Quick Start
Run the story-done skill with the target story file path to validate acceptance criteria, document deviations, and mark the story as Complete.