story-readiness

Validate implementation-ready stories and flag missing requirements before development begins.

18|5|Updated Nov 25, 2025
One-click install
npx skills add https://github.com/wsman/MY-DOGE-MICRO --skill story-readiness-wsman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: story-readiness
Source: https://github.com/wsman/MY-DOGE-MICRO/tree/main/.agents/skills/story-readiness
Command: npx skills add https://github.com/wsman/MY-DOGE-MICRO --skill story-readiness-wsman

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams verify that a story is ready for implementation before work starts, reducing rework, missing requirements, and mid-sprint design churn.

Core Features & Use Cases

  • Readiness Review: Checks whether the story includes clear acceptance criteria, scope boundaries, estimates, dependencies, and test evidence.
  • Architecture and Governance Checks: Verifies CDD traceability, ADR status, TR-ID validity, and manifest version alignment when applicable.
  • Use Case: A producer can run this on a drafted story and immediately see whether it is READY, NEEDS WORK, or BLOCKED, along with the specific gaps to fix.

Quick Start

Ask the story-readiness skill to validate the selected story file and return a readiness verdict with the missing details if any.

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 development before sprint planning?▼

To check story readiness, validate the story file for clear acceptance criteria, scope boundaries, dependency checks, and test evidence. This returns a READY, NEEDS WORK, or BLOCKED verdict with specific missing requirements to resolve before implementation begins.

What is story readiness validation and why does it matter for sprint planning?▼

Story readiness validation is the process of verifying drafted stories have complete requirements before development begins. It matters because catching gaps early reduces mid-sprint design churn, missing requirements, and costly rework during the active sprint cycle.

How do I validate acceptance criteria and traceability for multiple stories?▼

You can validate acceptance criteria and traceability by running a readiness review across single-story, sprint, or all-story scopes. This checks CDD traceability, ADR status, TR-ID validity, and manifest version alignment to flag gaps across batches.

Can I run a readiness triage on stories with open dependencies and questions?▼

Yes, you can run readiness triage on stories with open dependencies and blocking questions. The validation checks dependency status and flags unresolved open questions that would block development, returning a NEEDS WORK or BLOCKED status.

What architecture and governance checks are needed before implementation starts?▼

Architecture and governance checks needed before implementation include verifying CDD traceability, ADR status, TR-ID validity, and manifest version alignment. These checks ensure the story aligns with architectural decisions and governance requirements.

Why does my story get a BLOCKED verdict during pre-sprint review?▼

A story receives a BLOCKED verdict during pre-sprint review when validation identifies missing requirements like unclear acceptance criteria, unresolved dependencies, invalid TR-IDs, or blocking open questions that prevent development from starting.