story-readiness

Validate story files for implementation readiness with READY, NEEDS WORK, or BLOCKED verdicts.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/LordKuper/agentic-game-studio --skill story-readiness-lordkuper
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: story-readiness
Source: https://github.com/LordKuper/agentic-game-studio/tree/main/.claude/skills/story-readiness
Command: npx skills add https://github.com/LordKuper/agentic-game-studio --skill story-readiness-lordkuper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate that a story file is implementation-ready by checking embedded GDD requirements, ADR references, engine notes, clear acceptance criteria, and absence of open design questions, producing READY / NEEDS WORK / BLOCKED verdicts with gaps.

Core Features & Use Cases

  • Automated scope validation: check single story files, sprint scope, or epic-wide validations.
  • Context loading: preloads GDD, control-manifest, TR registry, and ADR statuses to inform decisions.
  • Multi-criteria readiness: evaluates design completeness, ADR status, TR-ID validity, manifest currency, engine notes, and asset references.
  • Clear verdicts and actionable gaps: outputs READY / NEEDS WORK / BLOCKED with explicit gaps.

Quick Start

Run the story-readiness command with a path to a single story file to begin evaluation.

Frequently Asked Questions about story-readiness

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a story is ready for implementation?▼

To check if a story is ready for implementation, validate its GDD references, ADR acceptance, TR-ID activity, manifest currency, scope boundaries, asset references, and a minimum of three testable acceptance criteria. The evaluation outputs a READY, NEEDS WORK, or BLOCKED verdict with explicit gaps.

What is story readiness validation in agile development?▼

Story readiness validation is the process of verifying a story file has complete design documentation, accepted ADRs, active TR-IDs, current manifests, and at least three testable acceptance criteria before implementation begins. It produces READY, NEEDS WORK, or BLOCKED statuses with identified gaps.

Can I validate sprint scope or epic-level story readiness in bulk?▼

Yes, you can validate sprint scope or perform epic-level checks. The validation process applies to single story files, sprint scope validations, and epic-wide checks by loading GDD, control-manifest, TR registry, and ADR statuses to inform readiness decisions across multiple stories.

Why does my story file return a NEEDS WORK or BLOCKED status?▼

A story file returns NEEDS WORK or BLOCKED when validation identifies missing design completeness, unaccepted ADRs, inactive TR-IDs, outdated manifests, undefined scope boundaries, missing asset references, or fewer than three testable acceptance criteria. The output explicitly lists these gaps for resolution.

Do I need ADRs and GDD references to pass story readiness checks?▼

Yes, ADRs and GDD references are required to pass readiness checks. The validation enforces design completeness and ADR acceptance alongside TR-ID activity, manifest currency, scope boundaries, asset references, and a minimum of three testable acceptance criteria to determine a READY verdict.

What is the minimum number of acceptance criteria for a ready story?▼

The minimum number of testable acceptance criteria required for a story to be considered ready is three. The validation enforces this threshold alongside checks for GDD references, ADR status, TR-ID validity, manifest currency, engine notes, and asset references.