skills.rest
sumilee-pcu
sumilee-pcuCOMMUNITY
Explore all skills by this author →
GitHub

story-readiness

Validate story files for GDD requirements, ADR references, and acceptance criteria.

Updated Apr 15, 2026
Search Tags:#architecture#quality assurance#agile#sprint planning#story validation#gdd
One-click install
npx skills add https://github.com/sumilee-pcu/game2026 --skill story-readiness-sumilee-pcu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: story-readiness
Source: https://github.com/sumilee-pcu/game2026/tree/main/.claude/skills/story-readiness
Command: npx skills add https://github.com/sumilee-pcu/game2026 --skill story-readiness-sumilee-pcu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill prevents development delays caused by ambiguous requirements, missing design documentation, or incomplete acceptance criteria by validating story files before implementation begins.

Core Features & Use Cases

  • Design Validation: Checks for linked GDD requirements and ADR references to ensure technical alignment.
  • Readiness Scoring: Provides a clear verdict of READY, NEEDS WORK, or BLOCKED based on a comprehensive checklist of architectural and scope requirements.
  • Use Case: Before starting a new sprint, use this skill to scan all assigned stories to identify which ones are missing testable acceptance criteria or have unresolved design questions.

Quick Start

Ask the AI to validate the readiness of all stories in the current sprint.

Frequently Asked Questions about story-readiness

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

FAQPage Schema
How do I validate user stories for sprint readiness before development starts?▼

Validate user stories for sprint readiness by checking individual files, sprint plans, or epic directories for GDD requirements, ADR references, and testable acceptance criteria to identify design and scope gaps.

What is story validation in agile software engineering?▼

Story validation in agile software engineering is the process of verifying story files for design documentation, architectural alignment, and testable acceptance criteria before implementation begins to prevent development delays.

How do I check if my epic directories have missing design documentation?▼

Check epic directories for missing design documentation by scanning story files to identify gaps in scope, architecture, and unresolved design questions.

Can I use story validation to scan all assigned stories in a sprint plan?▼

Yes, you can use story validation to scan all assigned stories in a sprint plan. It operates on individual files, sprint plans, or entire epic directories to identify missing testable acceptance criteria.

What does a readiness score mean for agile story files?▼

A readiness score for agile story files provides a clear verdict of READY, NEEDS WORK, or BLOCKED based on a comprehensive checklist of architectural and scope requirements.

Do I need defined manifest versions and registry lookups to validate story readiness?▼

Yes, validating story readiness requires adherence to defined manifest versions and registry lookups to ensure all stories meet the studio's quality standards.

Related Skills

Explore More Software Engineering Skills→
Euraika-LabsEuraika-Labs
14

create-stories

Generate story markdown files from epics with GDD and ADR validation.

Official
Advanced
shwilliamsonshwilliamson

user-stories

Write user stories with acceptance criteria and INVEST guidelines.

Community
Basic
AgLyx3AgLyx3

agile-product-owner

Generate user stories and acceptance criteria for agile backlog management.

Community
Advanced
HakAlHakAl
5

plan-craft

Evaluate plan scope, task decomposition, risks, and verification signals.

Community
Advanced