bmad-create-epics-and-stories

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

Updated May 7, 2026
One-click install
npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-create-epics-and-stories-jgabriellima
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-create-epics-and-stories
Source: https://github.com/jgabriellima/deep-agent-skill/tree/main/skills/bmad-create-epics-and-stories
Command: npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-create-epics-and-stories-jgabriellima

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a PRD and architecture document into an actionable backlog is slow and error-prone: requirements get missed, epics get organized by technical layers instead of user value, and stories lack testable acceptance criteria. This Skill guides a structured, four-step workflow that extracts every requirement and converts it into a validated epic and story breakdown. ## Core Features & Use Cases - Requirements Extraction: Scans PRD, Architecture, and UX Design documents to extract functional requirements, non-functional requirements, and UX design requirements into a coverage map. - Collaborative Epic Design: Groups requirements into user-value-focused epics with explicit FR coverage mapping and user approval gates. - Story Generation with Acceptance Criteria: Produces stories in As a/I want/So that format with Given/When/Then acceptance criteria, sized for a single dev agent. - Final Validation: Verifies full FR coverage, story independence, and dependency ordering before completion. - Use Case: After finishing a PRD for a task management API, run this Skill to produce an epics.md file where every requirement maps to an approved epic and implementable story ready for sprint planning. ## 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?▼

Provide your PRD, architecture document, and optional UX design spec, then ask to create the epics and stories list. The workflow extracts all requirements, proposes user-value-focused epics for approval, and generates stories with acceptance criteria.

What input documents are required for epic and story creation?▼

A PRD containing functional and non-functional requirements and an architecture document are required. A UX design document is optional but treated as a first-class input, with its requirements extracted as separate UX-DR items.

How are acceptance criteria written for each story?▼

Each story uses the As a/I want/So that format followed by Given/When/Then acceptance criteria. Criteria are written to be independently testable, include edge cases, and reference the specific requirements the story fulfills.

Does the workflow validate that all requirements are covered?▼

Yes. The final validation step checks that every FR maps to at least one story, stories have no forward dependencies, epics deliver standalone user value, and database entities are created only when a story needs them.

Can I customize the workflow behavior for my team?▼

Yes. A customize.toml file supports team and user overrides for activation steps, persistent facts loaded from project files, and a post-completion hook, merged using BMad structural merge rules.