bmad-create-story

Generate a complete dev story file with acceptance criteria, tasks, and guardrails.

Updated Feb 11, 2026
One-click install
npx skills add https://github.com/mschuerig/peach-ios --skill bmad-create-story-mschuerig
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-create-story
Source: https://github.com/mschuerig/peach-ios/tree/main/_bmad/bmm/workflows/4-implementation/bmad-create-story
Command: npx skills add https://github.com/mschuerig/peach-ios --skill bmad-create-story-mschuerig

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill streamlines the creation of a fully-contextual story file that guides development teams by consolidating epic requirements, architecture constraints, and workflow guidelines into a single, ready-for-implementation document.

Core Features & Use Cases

  • End-to-end story generation: Produces a ready-to-dev story that includes story statement, acceptance criteria, tasks, guardrails, and references.
  • Context consolidation: Integrates inputs from epics, PRDs, architecture, and UX to ensure alignment across the project.
  • Operational guidance: Embeds developer notes, project structure recommendations, testing guidelines, and deployment considerations.

Quick Start

Provide the epic/story identifier and workflow inputs to generate a complete dev story that you can immediately hand to your dev-agent.

Frequently Asked Questions about bmad-create-story

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

FAQPage Schema
How do I generate a dev story from an epic and architecture documents?

To generate a dev story, you provide the epic or story identifier along with workflow inputs. The tool analyzes planning artifacts, architecture constraints, and previous stories to output a production-grade story file with tasks, tests, and guardrails.

What is included in a ready-for-dev story file?

A ready-for-dev story file includes the story statement, acceptance criteria, actionable tasks, developer notes, testing guidelines, deployment considerations, and references to project context and architecture.

How do I consolidate PRDs and UX guidelines into a single development story?

Consolidating PRDs and UX guidelines happens automatically by integrating inputs from epics, architecture, and UX to ensure alignment. It enforces strict structure and references to produce a unified implementation document.

Can I use this to create stories for dev-agents without manual formatting?

Yes, you can hand the generated story directly to a dev-agent. It provides operational guidance, project structure recommendations, and strict structural enforcement to ensure the agent receives complete context.

Does generating story files require previous stories to exist in the project?

Generating story files does not strictly require previous stories, but it analyzes them if available. Analyzing previous stories helps maintain strict structure, references, and project context alignment across the workflow.

Why use automated story generation instead of manually writing epic requirements?

Automated story generation streamlines the consolidation of epic requirements, architecture constraints, and workflow guidelines into a single document. This prevents context loss and provides embedded operational guidance for development teams.