create-epics

Translate approved GDD systems into bounded epics aligned to architecture modules.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/WindXRan/y3td --skill create-epics-windxran
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-epics
Source: https://github.com/WindXRan/y3td/tree/main/.claude/skills/create-epics
Command: npx skills add https://github.com/WindXRan/y3td --skill create-epics-windxran

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create-epics eliminates the ambiguity between game design docs (GDDs), architectural ownership, and engineering execution by translating approved design inputs into clearly bounded epics that are governed by accepted ADRs and validated against engine risk and requirement tracing.

Core Features & Use Cases

  • GDD-to-epic translation by architectural module: Maps each system to an architectural module and records layer ownership for clean division of responsibility.
  • ADR coverage and requirement tracing guardrails: Loads authoritative system lists and architecture boundaries, then checks which TR requirements are traced vs untraced by accepted ADRs.
  • Layer-ordered epic creation workflow with gating: Runs once per layer in safe dependency order (Foundation → Core → Feature → Presentation), and uses a producer assessment gate (PR-EPIC) in full mode to avoid unrealistic scope.

Quick Start

Run create-epics with the specific scope you want, for example: create epics for the Core layer using lean review mode.

Frequently Asked Questions about create-epics

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

FAQPage Schema
How do I translate game design docs into epics aligned with architecture modules?

To translate GDDs into architecture-aligned epics, map each approved system to a bounded architectural module and record layer ownership. This ensures engineering execution directly reflects design inputs and architectural boundaries.

What is the correct layer order for generating epics in game development?

The correct layer order for generating epics is Foundation, then Core, then Feature, then Presentation. Running once per layer in this dependency-safe sequence prevents scope gaps and ensures foundational systems exist before building features.

How do ADRs trace requirements when creating epics from GDDs?

ADRs trace requirements by loading authoritative system lists and architecture boundaries, then checking which TR requirements are traced versus untraced by accepted ADRs. The workflow warns you about untraced TRs to maintain requirement coverage.

Can I generate epics for a specific system instead of an entire architectural layer?

Yes, you can generate epics for either a specific system or an entire architectural layer. Specifying a system scope filters the GDD summary to isolate in-scope requirements, ensuring targeted epic creation.

What inputs do I need to run a GDD to epics workflow?

You need an approved GDD summary, an architecture definition, a control manifest, a TR registry, and an engine version input. Loading these inputs enables dependency-safe layer ordering and validates epics against engine risk.

Does the epic generation process create user stories automatically?

No, the epic generation process never creates user stories. It strictly writes EPIC.md files and an epics index, leaving story creation as a separate downstream step to maintain clear scope boundaries.