| íëĒŠ | ë´ėŠ |
|---|---|
| Invoke | /project:epic |
| Category | pipeline |
| Complexity | moderate |
| MCP Servers | zenhub |
/project:epic#
Stage 5: Epic Creation â Creates ZenHub Epics and Stories based on design artifacts.
Triggers#
- When creating development issues after Design stage completion
- When splitting architecture/UX specs into actionable work units
Usage#
/project:epic
/project:epic --sprint current
/project:epic --feature community --entity Post
Options#
| Option | Default | Description |
|---|---|---|
--sprint |
None | Sprint assignment (current, next, number) |
--feature | slug | Feature name (snake_case) |
--entity | Auto-inferred | Entity name (PascalCase) |
Prerequisites#
- Design stage completed (Solutioning Gate passed)
- Architecture Doc, UX Spec artifacts exist
Execution Flow#
Phase 1: Epic Creation#
Source: cc-dev-cycle
-
ZenHub Epic creation (/zenhub:epic)
- Structure Epic based on Architecture Doc
- Feature/Entity mapping
- Link design artifacts in Epic description
Phase 2: Story Writing#
Source: cc-bmad
-
Individual Story writing (/bmad:create-story)
- Screen-based Stories from UX Spec
- Technical Stories from Architecture
- Connect BDD scenarios as Acceptance Criteria
- Set dependency relationships
-
Sprint planning (/bmad:sprint-planning)
- Story priority determination
- Sprint assignment
- Capacity planning
Phase 3: PM Review#
Source: cc-bmad (PM persona)
-
Story quality verification
- Story point estimation
- Labeling (type, scope, priority)
- Dependency verification
- Acceptance Criteria completeness check
Phase 4: Planning Gate#
BMAD Planning Gate verification:
- Epic/Story structure (epic_story_structure)
- Story points (story_point)
- Labeling (labeling)
- Dependencies (dependencies)
Artifacts#
- ZenHub Epic (issue number recorded)
- Linked Stories (issue number list)
- Epic number recorded in
.pipeline/{slug}.yaml
After Completion#
- Verify Planning Gate passed
- Record Epic/Story numbers in state file
- Present context-clear handoff:
â
Epic Creation stage complete (Planning Gate PASSED).
Epic #{epic_number} created with {story_count} Stories.
**Option 1 (Recommended)**: Clear context and continue to Development
/clear
Then run: /project:develop --epic {epic_number}
**Option 2**: Continue in current context
Proceed directly to /project:develop --epic {epic_number}