story-readiness

Featured

Validate that a story file is implementation-ready. Checks for embedded GDD requirements, ADR references, engine notes, clear acceptance criteria, and no open design questions. Produces READY / NEEDS WORK / BLOCKED verdict with specific gaps. Use when user says 'is this story ready', 'can I start on this story', 'is story X ready to implement'.

AI & Automation 40,030 stars 5224 forks Updated 1 weeks ago MIT

Install

View on GitHub

Quality Score: 97/100

Stars 20%
100
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Story Readiness This skill validates that a story file contains everything a developer needs to begin implementation — no mid-sprint design interruptions, no guessing, no ambiguous acceptance criteria. Run it before assigning a story. **This skill is read-only.** It never edits story files. It reports findings and asks whether the user wants help filling gaps. **Output:** Verdict per story (READY / NEEDS WORK / BLOCKED) with a specific gap list for each non-ready story. --- ## Phase 0: Resolve Review Mode Resolve the review mode once at startup (store for all gate spawns this run): 1. If skill was called with `--review [full|lean|solo]` → use that value 2. Else read `production/review-mode.txt` → use that value 3. Else → default to `lean` See `.claude/docs/director-gates.md` for the full check pattern and mode definitions. --- ## 1. Parse Arguments **Scope:** `$ARGUMENTS[0]` (blank = ask user via AskUserQuestion) - **Specific path** (e.g., `/story-readiness production/epics/combat/story-001-basic-attack.md`): validate that single story file. - **`sprint`**: read the current sprint plan from `production/sprints/` (most recent file), extract every story path it references, validate each one. - **`all`**: glob `production/epics/**/*.md`, exclude `EPIC.md` index files, validate every story file found. - **No argument**: ask the user which scope to validate. If no argument is given, use `AskUserQuestion`: - "What would you like to validate?" - Options: "A sp...

Details

Author
Donchitos
Repository
Donchitos/Claude-Code-Game-Studios
Created
9 months ago
Last Updated
1 weeks ago
Language
Shell
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category