create-epics

Convert approved GDDs and architecture documents into epics with ADR coverage checks.

Updated Apr 9, 2026
One-click install
npx skills add https://github.com/CarlosQ96/robot-crawler --skill create-epics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-epics
Source: https://github.com/CarlosQ96/robot-crawler/tree/main/.agents/skills/create-epics
Command: npx skills add https://github.com/CarlosQ96/robot-crawler --skill create-epics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts approved game design documents and architecture decisions into formal epics so product and engineering teams have clear, architect-owned scope without manual consolidation. It surfaces gaps in ADR coverage, assesses engine risk, and prevents premature story creation so work is scoped and traceable before implementation.

Core Features & Use Cases

  • Epic generation from GDDs: Reads approved GDDs and maps each system to an architecture module to produce one epic per module.
  • Governance & traceability checks: Cross-checks ADR coverage against the TR registry, reports untraced requirements, and summarizes governing ADRs and engine risk.
  • Review gating and safe writes: Supports review modes (solo/lean/full), spawns a producer gate for full reviews, prompts for per-epic approval, and writes EPIC.md and an epics index only after confirmation.
  • Use Case: A technical director runs this skill after architecture review to create a consistent set of epics for the next milestone and to highlight ADR work that must be completed first.

Quick Start

Run /create-epics layer: core --review lean to generate epics for all core systems after architecture and TR checks.

Frequently Asked Questions about create-epics

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

FAQPage Schema
How do I turn GDDs and architecture documents into epics for project planning?

To turn GDDs and architecture documents into epics, you need to map each game system to an architecture module and define scope, ownership, and governing ADRs. This process produces one formal epic per module to ensure clear, architect-owned scope.

What is the best way to trace requirements and validate ADR coverage before creating epics?

Requirements tracing and ADR coverage validation involve cross-checking approved architecture decisions against the TR registry to identify untraced requirements. This ensures all technical requirements are governed before scoping work and prevents premature story creation.

How do I generate epics from approved game design documents without manual consolidation?

Generating epics from approved game design documents requires reading the GDDs and applying architecture rules to produce formal epics. This automated approach surfaces engine compatibility risks and prevents manual consolidation errors during pre-production.

Can I use review gates to control when epic files are written to production?

Yes, you can use review gates to control epic file generation by selecting solo, lean, or full review modes. The system prompts for per-epic approval and only writes the EPIC.md and epics index files after you explicitly confirm.

Why do I need approved ADRs and engine risk assessments before scoping epics?

You need approved ADRs and engine risk assessments before scoping epics to guarantee work is traceable and technically viable. Assessing engine compatibility risk early highlights missing architecture decisions that must be completed first.

Does epic generation work for technical directors doing pre-production planning?

Epic generation works directly for technical directors and engineering leads handling pre-production planning. It transforms approved design and architecture files into a consistent set of epics tailored for the next milestone.