bmad-create-story

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

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-create-story-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-create-story
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/bmad-create-story
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-create-story-hordricjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developer agents often fail because stories lack context: wrong libraries, wrong file locations, missed regressions, and vague acceptance criteria. This Skill builds a complete story file that gives the dev agent everything needed for implementation by exhaustively analyzing epics, PRD, architecture, UX docs, previous stories, and git history. ## Core Features & Use Cases - Automatic 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 extraction: Analyzes epics, architecture, previous story learnings, recent git commits, and current library versions to build developer guardrails. - Quality validation checklist: Validates the generated story against a competitive review checklist that catches critical misses, enhancements, and LLM-optimization issues before finalizing. - Use Case: A team using the BMAD method runs sprint-planning, then invokes this Skill to auto-generate the next story file with full technical requirements, architecture compliance notes, and testing standards, marked ready-for-dev. ## Quick Start Ask the AI to create the next backlog story from sprint-status.yaml 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 developer story from epics and architecture docs?

Run the create-story workflow after sprint-planning has produced sprint-status.yaml. It auto-discovers the first backlog story, analyzes epics, architecture, and previous stories, then writes a complete story file marked ready-for-dev.

How does the workflow pick which story to create next?

It reads sprint-status.yaml top to bottom and selects the first story key matching the number-number-name pattern with status backlog. You can also pass an explicit epic-story number like 2-4 or a story document path.

Can I customize the create-story workflow behavior?

Yes. The customize.toml file supports activation step prepends and appends, persistent facts loaded from files like project-context.md, and an on_complete hook. Team and user override files merge with structural rules.

What happens if no sprint status file exists?

The workflow halts and asks you to either run sprint-planning first, provide an explicit epic-story number, or supply a path to story documents. It will not proceed without a target story.

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.