Epic Run Skill
A user invocation (/epic-run <epic-slug>) forks the epic-orchestrator agent to execute an
epic that epic-planner has already prepared. The epic slug (or a path under
docs/features/epics/) for this run is:
$ARGUMENTS
Procedure
- Resolve the epic home. A bare slug resolves to
docs/features/epics/<epic-slug>/; a path argument resolves to its containing epic folder. - Read the committed kickoff artifact at
docs/features/epics/<epic-slug>/epic-kickoff.md.- If the file does not exist, STOP without delegating anything and report that the epic has
no committed kickoff artifact: the user must run
/epic-planfirst (or, for an epic that was authored manually, invoke/epic-orchestrate <epic-manifest-path>directly).
- If the file does not exist, STOP without delegating anything and report that the epic has
no committed kickoff artifact: the user must run
- Execute the kickoff artifact's
## Invocation Promptsection as the epic objective, applying theepic-orchestrateskill procedure and the## Prepared-Epic Execution (epic-planner Handoff)section of.claude/agents/epic-orchestrator.md: reuse the existing integration branch, and have each childAgent(orchestrator)delegation resume at atomic execution from its committedplan-pathrather than re-running promotion, research, or planning. - Honor existing checkpoint state: if
artifacts/orchestration/epic-orchestrator-state.jsonalready tracks this epic, resume per theepic-orchestrateskill's resume procedure instead of restarting.
Scope
This skill adds no procedure of its own beyond kickoff-artifact resolution; wave scheduling,
the wave barrier, merge-on-green fan-in, worktree cleanup, epic-status.md maintenance, and
the final integration-to-main PR are governed entirely by the epic-orchestrate skill.