story-readiness

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

3|Updated Jun 3, 2026
One-click install
npx skills add https://github.com/Negentropy-Laby/Constitution-Driven-Development --skill story-readiness-negentropy-laby
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: story-readiness
Source: https://github.com/Negentropy-Laby/Constitution-Driven-Development/tree/main/.agents/skills/story-readiness
Command: npx skills add https://github.com/Negentropy-Laby/Constitution-Driven-Development --skill story-readiness-negentropy-laby

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validate that a story file is implementation-ready by ensuring embedded CDD requirements, ADR references, technology notes, and clear acceptance criteria.

Core Features & Use Cases

  • Validates embedded CDD requirements and ADR references are traceable.
  • Checks acceptance criteria for clarity, testability, and proper scoping.
  • Produces a READY / NEEDS WORK / BLOCKED verdict with explicit gaps and suggested fixes.

Quick Start

Run the story-readiness skill on a repository's stories to produce a verdict and actionable gaps.

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 file is ready for implementation?▼

To check story readiness, validate embedded CDD requirements, ADR references, and acceptance criteria. This process surfaces missing references and unresolved questions, returning a READY, NEEDS WORK, or BLOCKED verdict with explicit gaps before development begins.

What is story readiness validation and when do I need it?▼

Story readiness validation ensures a story file has traceable CDD requirements, ADR references, and clear acceptance criteria before implementation. You need it to identify scoping gaps and unresolved questions early, returning a READY, NEEDS WORK, or BLOCKED verdict with actionable fixes.

Can I validate acceptance criteria for an entire epic collection at once?▼

Yes, you can validate acceptance criteria across individual stories, sprint-level selections, or entire epic collections. The check processes all selected story files to surface missing ADR references or unresolved CDD requirements, returning a verdict for each.

How do I ensure acceptance criteria are testable and properly scoped?▼

To ensure acceptance criteria are testable and properly scoped, run a readiness check against the story file. This validates that the criteria are clear and properly bounded, returning a NEEDS WORK or BLOCKED verdict with explicit gaps if scoping is insufficient.

What is the best way to trace ADR references and CDD requirements in stories?▼

The best way to trace ADR references and CDD requirements is to apply a readiness gate to the stories. This validates that embedded references are traceable and complete, returning a READY verdict or listing explicit gaps and suggested fixes.

Why does my story readiness check return a BLOCKED verdict?▼

A story readiness check returns a BLOCKED verdict when critical implementation prerequisites are missing. The validation explicitly identifies unresolved questions, missing ADR references, or untraceable CDD requirements, providing notes on what must be resolved before work begins.