What problem does it solve?
This Skill prevents mid-sprint surprises and developer guesswork by validating that a user story contains all design, architecture, testing, and asset information required to begin implementation without interruptions.
Core Features & Use Cases
- Comprehensive checklist that verifies GDD references, testable acceptance criteria, ADR status, TR-ID registry lookups, manifest version consistency, engine notes, estimates, scope boundaries, and dependency states.
- Asset existence checks using globbing to confirm referenced assets are present and flag missing files.
- Aggregate and sprint modes to validate a single story, all stories in a sprint, or every story in production, emitting per-story verdicts (READY / NEEDS WORK / BLOCKED) and detailed gap lists.
- Director gate integration and escalation that respects review modes (solo/lean/full) and can spawn QA review tasks when required.
- Read-only reporting that suggests fixes and offers to draft missing sections conversationally without writing files.
Quick Start
Run the story-readiness skill on a story path, sprint, or 'all', for example: /story-readiness production/epics/combat/story-001-basic-attack.md