bmad-create-epics-and-stories

Decompose PRD and architecture requirements into epics and user stories with acceptance criteria.

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-create-epics-and-stories-hexalith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-create-epics-and-stories
Source: https://github.com/Hexalith/Hexalith.Parties/tree/main/.agents/skills/bmad-create-epics-and-stories
Command: npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-create-epics-and-stories-hexalith

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a PRD and architecture document into an actionable backlog is slow and error-prone; this Skill guides a structured, step-by-step workflow that extracts every requirement and converts it into approved epics and developer-ready stories. ## Core Features & Use Cases - Requirements Extraction: Scans PRD, Architecture, and UX design documents to inventory functional, non-functional, and UX design requirements. - Epic Design: Groups requirements into user-value-focused epics with an FR coverage map, validated collaboratively with the user. - Story Generation: Produces stories in As a/I want/So that format with Given/When/Then acceptance criteria, sized for a single dev agent. - Use Case: After finishing a PRD for a new product, run this workflow to produce a complete epics.md with validated coverage of every requirement before development begins. ## Quick Start Ask the agent to create the epics and stories list from your PRD and architecture documents.

Frequently Asked Questions about bmad-create-epics-and-stories

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

FAQPage Schema
How do I break a PRD into epics and user stories?

Run this workflow after your PRD and architecture documents exist. It extracts all functional and non-functional requirements, proposes user-value-focused epics for your approval, then generates stories with testable acceptance criteria for each epic.

What documents are required to create epics and stories?

The workflow requires a PRD containing functional and non-functional requirements and an Architecture document with technical decisions. A UX design document is optional but treated as a first-class input when present.

How are user stories formatted in the output?

Each story uses the As a / I want / So that format followed by acceptance criteria written in Given/When/Then style. Stories are sized so a single dev agent can complete them and must not depend on future stories.

Does the workflow check that all requirements are covered?

Yes. The final validation step verifies every FR maps to at least one story, checks epic independence and story dependency ordering, and confirms UX design requirements are covered before completing.

Can I customize the epics and stories workflow behavior?

Yes. A customize.toml file supports activation step overrides, persistent facts loaded as context, and an on_complete hook, merged with team and user-level TOML overrides in the project.