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.