bmad-story-planning

Generate developer-ready user stories with acceptance criteria from epics and architecture decisions.

67|11|Updated Oct 28, 2025
One-click install
npx skills add https://github.com/bacoco/BMad-Skills --skill bmad-story-planning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-story-planning
Source: https://github.com/bacoco/BMad-Skills/tree/main/.claude/skills/bmad-story-planning
Command: npx skills add https://github.com/bacoco/BMad-Skills --skill bmad-story-planning

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) and references (resource) components.

What problem does it solve?

This skill transforms high-level epics and architecture decisions into developer-ready user stories, acceptance criteria, dependencies, and delivery signals.

Core Features & Use Cases

  • Story generation: produces markdown files for each story with structured acceptance criteria.
  • Prereqs & references: injects PRD/architecture references into stories.
  • Output artifacts: story markdown files and backlog summaries.

Quick Start

Provide a JSON or structured data and run the story generator to produce stories/ files using the templates in assets/.

Frequently Asked Questions about bmad-story-planning

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

FAQPage Schema
How do I break down epics into developer-ready user stories?

Breaking epics into developer-ready stories involves transforming high-level requirements into structured user stories with acceptance criteria, prerequisites, and task definitions. This skill automates that process by taking your PRD and architecture decisions as input and generating markdown story files with detailed breakdowns for sprint planning.

What should I include in user story acceptance criteria?

Acceptance criteria define the conditions a story must meet to be complete. This skill generates criteria by extracting requirements from your epic, linking them to architecture decisions, and structuring them as testable conditions developers can verify before marking a story done.

Can I generate story templates and backlog summaries automatically?

Yes. This skill produces structured markdown files for each story using predefined templates in its assets, plus a backlog summary that organizes all generated stories. You provide the epic and architecture context; it outputs ready-to-use story files and planning documents.

How do I connect stories to architecture decisions and PRD references?

This skill injects traceable references to your PRD and architecture decisions directly into each generated story file. Dependencies and design rationale become part of the story artifact, so developers understand the context behind each task without hunting for external documents.

What format should my epic and architecture input be in?

Provide your input as JSON or structured data containing the epic description and relevant architecture decisions. The skill processes this data through its story generation templates to produce developer-ready output files organized in a stories/ directory.

Do I need existing PRD and architecture decisions before using this?

Yes. This skill applies when a PRD and architecture decisions already exist and epics are defined. It requires these inputs to generate accurate stories and link them to design context; it does not create strategy or high-level planning from scratch.