bmad-create-story

Generates comprehensive developer story files from epics, architecture, and sprint status artifacts.

1|Updated Jun 2, 2026
One-click install
npx skills add https://github.com/SevWren/Daily-Motivation-Brain-Helper --skill bmad-create-story-sevwren
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-create-story
Source: https://github.com/SevWren/Daily-Motivation-Brain-Helper/tree/main/.claude/skills/bmad-create-story
Command: npx skills add https://github.com/SevWren/Daily-Motivation-Brain-Helper --skill bmad-create-story-sevwren

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developer agents often fail because story files lack context, causing wrong libraries, broken regressions, and vague implementations. This Skill creates exhaustive story files that give the dev agent everything needed for correct implementation. ## Core Features & Use Cases - Automated Story Discovery: Reads sprint-status.yaml to find the next backlog story, or accepts an explicit epic-story number like 1-2-user-auth. - Exhaustive Context Analysis: Loads epics, PRD, architecture, and UX artifacts, plus previous story learnings and git history, to build complete developer guardrails. - Quality Validation: Validates the generated story against a checklist that hunts for missing requirements, regressions risks, and LLM optimization issues before marking it ready-for-dev. - Use Case: A team using the BMad method runs this workflow to turn a backlog epic entry into a fully-contextualized story file with acceptance criteria, architecture compliance notes, and testing requirements. ## Quick Start Ask the assistant to create the next story from the sprint status file, for example by saying create story 1-2-user-auth using the bmad-create-story workflow.

Frequently Asked Questions about bmad-create-story

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

FAQPage Schema
How do I create a story file from an epic in the BMad workflow?▼

Provide an epic-story number like 1-2-user-auth, or let the workflow auto-discover the first backlog story in sprint-status.yaml. It analyzes epics, architecture, and prior stories, then writes a ready-for-dev story file.

What inputs does the create-story workflow need?▼

It loads epics, PRD, architecture, and UX documents from the planning artifacts directory, plus sprint-status.yaml from implementation artifacts. Missing files are tolerated but reduce the quality of the generated context.

Is bmad-create-story deprecated?▼

Yes. The frontmatter states bmad-build is now the official implementation method, and this skill should only be used when explicitly invoked by name.

What happens if no sprint status file exists?▼

The workflow halts and asks you to run sprint-planning first, provide an explicit epic-story number, or supply a path to story documents. It cannot auto-discover stories without sprint-status.yaml.

How does the workflow prevent developer implementation mistakes?▼

It extracts architecture constraints, reads files being modified, analyzes previous story learnings and git commits, and validates the result against a checklist targeting regressions, wrong libraries, and vague requirements.