create-epics

Generate bounded epics from GDDs with ADR governance and requirement traceability.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/imclab/xrA1-swarm --skill create-epics-imclab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-epics
Source: https://github.com/imclab/xrA1-swarm/tree/main/.claude/skills/create-epics
Command: npx skills add https://github.com/imclab/xrA1-swarm --skill create-epics-imclab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It converts approved GDDs and architecture modules into well-scoped epics, so your team has clear ownership, governing ADRs, and traceability before implementation starts.

Core Features & Use Cases

  • Epic generation per architectural module: Creates one epic per module with an explicit layer and system-to-module mapping.
  • ADR governance and engine risk surfacing: Identifies governing ADRs, summarizes decisions, and derives engine risk from the highest-risk ADR.
  • Requirements traceability with gap detection: Uses the TR registry to report which requirements are covered by accepted ADRs and which remain untraced (blocked until ADRs exist).
  • Collaboration protocol and gates: Performs per-epic definition approval and runs the PR-EPIC producer gate (skipped in solo/lean modes).
  • Integration with next workflow: Writes EPIC.md files and updates production/epics/index.md, then instructs you to run /create-stories [epic-slug] next.

Quick Start

Use create-epics to generate Foundation epics by running: /create-epics layer: foundation

Frequently Asked Questions about create-epics

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

FAQPage Schema
How do I generate architecture epics from an approved GDD?

To generate architecture epics from an approved GDD, you parse the GDD summary and map architectural module ownership into bounded epics per system and layer. This process applies ADR governance and requirement traceability to ensure clear ownership before implementation.

What is requirements traceability and how does it apply to epic generation?

Requirements traceability in epic generation uses the TR registry to map accepted ADRs to specific requirements. It identifies which requirements are covered and flags untraced gaps as blocked until governing ADRs are established.

How do I scope epic generation to a specific architectural layer?

You scope epic generation to a specific architectural layer by passing a layer argument during execution, such as specifying foundation. The system then loads full GDD context only for in-scope systems and generates epics in dependency-safe order across foundation, core, feature, and presentation layers.

Can I skip collaboration gates when generating epics in a solo development workflow?

Yes, you can skip collaboration gates when generating epics in a solo workflow by using solo or lean modes. These modes bypass the producer PR-EPIC gate and per-epic definition approval steps to streamline the orchestration process.

How does ADR governance surface engine risk during project orchestration?

ADR governance surfaces engine risk by identifying governing Architectural Decision Records for each epic, summarizing their decisions, and deriving the overall engine risk from the highest-risk ADR. This ensures development governance highlights critical technical constraints.

What should I do after writing EPIC markdown files for my project?

After writing EPIC markdown files and updating the epics index, you should run the create-stories command with the specific epic-slug. This next step converts the scoped architecture epics into actionable implementation stories.