bmad-create-story

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

Updated Aug 25, 2024
One-click install
npx skills add https://github.com/LeGeRyChEeSe/LanPlay-DiscordBot --skill bmad-create-story-legerycheese
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-create-story
Source: https://github.com/LeGeRyChEeSe/LanPlay-DiscordBot/tree/main/bmad/src/bmm-skills/4-implementation/bmad-create-story
Command: npx skills add https://github.com/LeGeRyChEeSe/LanPlay-DiscordBot --skill bmad-create-story-legerycheese

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developer agents often fail because stories lack context: they reinvent existing code, use wrong libraries, break regressions, or ignore architecture constraints. This Skill creates a complete, self-contained story file that gives the dev agent everything needed for correct implementation. ## Core Features & Use Cases - Automatic Story Discovery: Reads sprint-status.yaml to find the next backlog story, or accepts an explicit epic-story identifier like "2-4". - Exhaustive Context Gathering: Analyzes epics, PRD, architecture, UX documents, previous story learnings, and git history to extract technical requirements and guardrails. - Quality Validation: Runs a checklist-based review to catch missing requirements, vague acceptance criteria, and LLM-optimization issues before marking the story ready-for-dev. - Use Case: A team using the BMad method finishes sprint planning, then asks the agent to create the next story; the Skill produces a story file with acceptance criteria, architecture compliance notes, file structure requirements, and testing standards, and updates sprint status automatically. ## Quick Start Ask the agent to create the next story from the sprint backlog, or specify a story such as "create story 2-4" to generate a fully contextualized implementation file.

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 the next story from my sprint backlog?▼

Run the create-story workflow with no arguments; it reads sprint-status.yaml, finds the first story with backlog status, and generates a complete story file. You can also specify a story directly, such as "create story 2-4".

What documents does the create-story workflow need?▼

It loads epics, PRD, architecture, and UX documents from your planning artifacts directory, plus sprint-status.yaml for tracking. Missing documents are tolerated, but richer inputs produce better developer guidance.

Can I create a story without a sprint status file?▼

Yes, but you must provide an explicit epic-story number or a path to story documents. Without either, the workflow halts and suggests running sprint-planning first to initialize tracking.

How does the workflow prevent developer implementation mistakes?▼

It extracts architecture constraints, library versions, file structure rules, previous story learnings, and git history into the story's dev notes, then validates the result against a quality checklist before marking it ready-for-dev.

What happens after a story is created?▼

The story file is saved with status ready-for-dev, sprint-status.yaml is updated, and you proceed by running the dev-story workflow for implementation, followed by code-review when complete.