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.