story-readiness

Validate game story files for GDD traceability and testable acceptance criteria.

72|7|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/striderZA/OpenCodeGameStudios --skill story-readiness-striderza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: story-readiness
Source: https://github.com/striderZA/OpenCodeGameStudios/tree/main/.opencode/skills/story-readiness
Command: npx skills add https://github.com/striderZA/OpenCodeGameStudios --skill story-readiness-striderza

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents wasted implementation time by verifying that a story has complete, testable requirements and no unresolved design uncertainty.

Core Features & Use Cases

  • Story readiness validation: Checks that each story includes embedded GDD requirement traces, clear and testable acceptance criteria, and explicit boundaries.
  • Dependency and governance checks: Verifies referenced ADR status (e.g., Accepted vs Proposed), TR-ID validity when available, manifest version currency, and engine/control manifest rule notes.
  • Operational confidence checks: Ensures estimates and “definition of done” items exist (Type and Test Evidence), and optionally scans for referenced assets.

Quick Start

Run the story-readiness skill on a specific story file like "/story-readiness production/epics/combat/story-001-basic-attack.md".

Frequently Asked Questions about story-readiness

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

FAQPage Schema
How do I validate if a game story file is ready for implementation?

Story readiness validation checks embedded GDD requirement traces, testable acceptance criteria, and dependency status to return READY, NEEDS WORK, or BLOCKED verdicts. This process requires reading supporting design, architecture, and manifest context to identify specific gaps before implementation begins.

What is GDD traceability and when do I need it for sprint planning?

GDD traceability links story requirements directly to Game Design Document entries. You need it during pre-sprint vetting and sprint planning escalation to ensure no unresolved design uncertainty exists, preventing wasted implementation time on incomplete or blocked stories.

How do I check ADR status and manifest versions before starting story implementation?

Dependency and governance checks verify referenced ADR status, such as Accepted versus Proposed, alongside manifest version currency and TR-ID validity. These checks ensure technical decisions are formally approved and engine control rules are documented before development starts.

Can I use this story validation workflow for an entire production epic scope?

Yes, story readiness validation applies to workflow scenarios including single story vetting, full sprint scope checking, and all production epic stories. It evaluates operational confidence items like estimates and definition of done evidence across multiple files simultaneously.

Why does my story readiness check return a BLOCKED verdict?

A BLOCKED verdict occurs when dependency checks fail, such as referencing a Proposed rather than Accepted ADR, invalid TR-IDs, or outdated manifest versions. The validation returns specific blockers indicating unresolved design uncertainty or missing governance approvals.