bmad-sprint-planning

Generates sprint-status.yaml tracking files by parsing epic and story markdown documents.

2|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/Wizarck/nexandro --skill bmad-sprint-planning-wizarck
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-sprint-planning
Source: https://github.com/Wizarck/nexandro/tree/main/skills/bmad-sprint-planning
Command: npx skills add https://github.com/Wizarck/nexandro --skill bmad-sprint-planning-wizarck

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams using file-based agile planning lose track of which epics and stories are backlog, in-progress, or done because status lives scattered across markdown files. This Skill consolidates epic documents into a single structured sprint-status.yaml that reflects current development state. ## Core Features & Use Cases - Epic and Story Parsing: Scans epic markdown files (whole or sharded) and extracts every epic, story, and retrospective entry into kebab-case keys. - Intelligent Status Detection: Upgrades story status to ready-for-dev when a matching story file exists, and preserves more advanced existing statuses without downgrading. - Validation and Reporting: Verifies complete coverage of epics and stories, checks YAML validity, and reports totals for epics, stories, and completed work. - Use Case: After writing epics for a new project, run sprint planning to produce a sprint-status.yaml that developers and agents update as stories move from backlog through review to done. ## Quick Start Run sprint planning to generate the sprint status file from my epic documents.

Frequently Asked Questions about bmad-sprint-planning

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

FAQPage Schema
How do I generate a sprint status file from epic markdown documents?▼

Run the sprint planning workflow, which scans files matching the epic pattern in your planning artifacts folder, extracts every epic and story, and writes a sprint-status.yaml with backlog defaults and detected statuses.

How does sprint status detection work for stories?▼

The workflow checks whether a story file exists at the story location using the kebab-case story key. If found, the story status upgrades to at least ready-for-dev, but existing more advanced statuses like in-progress or done are never downgraded.

Can I use sharded epic files instead of one epics.md?▼

Yes. If no whole epic document is found, the workflow reads the sharded index.md and all referenced epic section files, then combines them for complete sprint status coverage. Whole documents take priority when both exist.

What statuses can epics and stories have in sprint-status.yaml?▼

Epics flow from backlog to in-progress to done. Stories flow from backlog to ready-for-dev, in-progress, review, and done. Retrospectives toggle between optional and done.

Why is my sprint-status.yaml missing stories after generation?▼

Missing stories usually mean the epic files were not fully loaded or story headers do not match the expected pattern like '### Story 1.1: Title'. The validation step compares epic files against the YAML and reports coverage gaps.