create-stories

Break epics into story files with TR-ID and ADR traceability.

Updated Feb 8, 2024
One-click install
npx skills add https://github.com/kay6198835/Game-RPG --skill create-stories-kay6198835
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-stories
Source: https://github.com/kay6198835/Game-RPG/tree/main/.claude/skills/create-stories
Command: npx skills add https://github.com/kay6198835/Game-RPG --skill create-stories-kay6198835

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Break a single epic into implementable story files by reading the epic, its GDD, governing ADRs, and the control manifest. Each story embeds its GDD requirement TR-ID, ADR guidance, acceptance criteria, story type, and test evidence path. Run after /create-epics for each epic.

Core Features & Use Cases

  • Breaks epics into discrete, implementable stories that map to GDD requirements and ADR decisions
  • Reads epic overview, GDD, governing ADRs, and the control manifest to ensure alignment
  • Embeds TR-ID, ADR governing guidance, acceptance criteria, story type, and test evidence path into each story
  • Outputs ready-to-commit story files under production/epics/[epic-slug]/story-NNN-[slug].md
  • Guides the workflow sequence: /create-epics -> /story-readiness -> /dev-story
  • Validates ADR existence before story decomposition and ensures traceability to TRs and GDD criteria

Quick Start

Run this skill after /create-epics for each epic to generate story files

Frequently Asked Questions about create-stories

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

FAQPage Schema
How do I break epics into actionable stories with traceability to ADRs and GDDs?

To break epics into actionable stories, load the epic overview, governing ADRs, and control manifest. This validates ADR existence and maps each story to GDD requirements using TR-IDs, generating ready-to-implement story files.

What is the best way to ensure my story decomposition aligns with architectural decisions?

The best way to ensure alignment is to validate ADR existence before decomposition. By embedding governing ADR guidance and GDD criteria directly into each generated story file, you guarantee full architectural traceability for implementation.

How do I map GDD requirement TR-IDs to individual story files?

You map GDD requirement TR-IDs by loading the Game Design Document and control manifest during story generation. The skill automatically embeds the TR-ID, acceptance criteria, and test evidence path into each story file.

When do I need to generate story files from epics in the development workflow?

You need to generate story files from epics after creating epics and before story readiness checks. This workflow sequence ensures epics are fully decomposed into implementable tasks mapped to ADRs and GDDs prior to development.

Can I generate production-ready stories without an existing ADR or GDD?

No, you cannot generate production-ready stories without existing ADRs or GDDs. The process validates ADR existence and ensures GDD criteria alignment before producing any story files under the production/epics directory.

What file format and structure does automated story generation output?

Automated story generation outputs ready-to-commit markdown files. These files are structured as story-NNN-[slug].md and placed under the production/epics/[epic-slug]/ directory to maintain organized implementation tracking.