bmad-create-epics-and-stories

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

1|Updated Sep 18, 2026
One-click install
npx skills add https://github.com/PastaSus/egg-defender --skill bmad-create-epics-and-stories-pastasus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-create-epics-and-stories
Source: https://github.com/PastaSus/egg-defender/tree/main/.agents/skills/bmad-create-epics-and-stories
Command: npx skills add https://github.com/PastaSus/egg-defender --skill bmad-create-epics-and-stories-pastasus

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 ready for developers. ## Core Features & Use Cases - Requirements Extraction: Scans PRD, Architecture, and UX design documents to inventory all functional requirements, non-functional requirements, and UX design requirements. - User-Value Epic Design: Groups requirements into standalone epics organized by user outcome, with a full FR-to-epic coverage map and file-churn consolidation checks. - Story Generation with Acceptance Criteria: Produces developer-ready stories in Given/When/Then format, sized for a single dev agent and free of forward dependencies. - Use Case: After finishing your PRD and architecture docs, run this workflow to produce a complete epics.md where every FR, NFR, and UX requirement maps to at least one validated story. ## 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 and architecture documents, then the workflow extracts all functional and non-functional requirements, groups them into user-value-focused epics, and generates stories with Given/When/Then acceptance criteria. Each step requires your confirmation before proceeding.

What documents are required to create epics and stories?

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 epics organized in the breakdown?

Epics are organized by user value rather than technical layers, so each epic delivers complete standalone functionality. The workflow also checks for file churn and consolidates epics that repeatedly modify the same core files without a genuine risk boundary.

Can stories depend on future stories in the same epic?

No. Each story must be completable using only the output of previous stories, and the final validation step explicitly checks for forward dependencies. Stories are also sized so a single dev agent can complete each one.

How is requirements coverage validated before development?

The final validation step maps every FR to at least one story, verifies acceptance criteria address each requirement, checks architecture constraints like starter templates, and confirms all UX design requirements are covered.