bmad-create-story

Generate BMAD story file scaffolds with embedded context and guardrails.

4|1|Updated Sep 30, 2024
One-click install
npx skills add https://github.com/co-cddo/ndx --skill bmad-create-story-co-cddo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-create-story
Source: https://github.com/co-cddo/ndx/tree/main/_bmad/bmm/workflows/4-implementation/bmad-create-story
Command: npx skills add https://github.com/co-cddo/ndx --skill bmad-create-story-co-cddo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creates a dedicated story file scaffold that encapsulates all context the dev agent will need to implement the story, ensuring consistency and preventing interpretation errors.

Core Features & Use Cases

  • Automatically generates a complete story skeleton including user story, acceptance criteria, tasks, dev notes, project structure notes, and references.
  • Integrates with the BMAD workflow (workflow.md) and planning artifacts (epics.md, prd.md, architecture.md) to surface relevant context and preserve linkages to source documents.
  • Use cases: when a user asks to create the next story or a specific story by identifier, or during sprint planning to scaffold new stories.

Quick Start

Provide an epic-story identifier (e.g., 1-2-user-auth) to generate a ready-to-edit BMAD story skeleton saved to the configured output path.

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 development story scaffold with acceptance criteria and dev notes?

To generate a development story scaffold with acceptance criteria and dev notes, provide an epic-story identifier to automatically create a ready-to-edit file containing user stories, tasks, and project structure references.

Does bmad-create-story integrate with existing architecture and planning artifacts?

Yes, story generation integrates with existing architecture and planning artifacts. It surfaces context from epics.md, prd.md, and architecture.md to preserve linkages to source documents during story creation.

What is the best way to automate dev story creation during sprint planning?

Automating dev story creation during sprint planning is best handled by generating a complete story skeleton. This provides a deterministic output file path and templates so the dev agent can immediately proceed with implementation.

Can I create a specific story by identifier instead of just the next one in sequence?

Yes, you can create a specific story by identifier. Providing an epic-story identifier like 1-2-user-auth triggers the automatic generation of a ready-to-use story file scaffold for that exact item.

Why does story generation include guardrails and embedded context for the dev agent?

Story generation includes guardrails and embedded context to ensure consistency and prevent interpretation errors. This encapsulates all context the dev agent needs to implement the story flawlessly.

Do I need a specific workflow file to generate ready-to-use story context?

You need to integrate with the BMAD workflow.md file to generate ready-to-use story context. This ensures the story skeleton aligns with established planning and architecture references.