bmad-sprint-planning

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

Updated May 7, 2026
One-click install
npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-sprint-planning-jgabriellima
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-sprint-planning
Source: https://github.com/jgabriellima/deep-agent-skill/tree/main/skills/bmad-sprint-planning
Command: npx skills add https://github.com/jgabriellima/deep-agent-skill --skill bmad-sprint-planning-jgabriellima

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agile teams lose track of which epics and stories are in backlog, in progress, or done when status lives only in scattered planning documents. This Skill scans your epic markdown files and produces a single structured sprint-status.yaml that reflects the real state of development. ## Core Features & Use Cases - Epic and Story Parsing: Discovers whole or sharded epic documents (epics.md, epic-1.md, etc.) and extracts every epic, story, and retrospective entry with kebab-case keys. - Intelligent Status Detection: Upgrades story status to ready-for-dev when a matching story file exists, and never downgrades existing advanced statuses like done. - Validated YAML Output: Generates a fully commented sprint-status.yaml with a defined state machine (backlog → ready-for-dev → in-progress → review → done) and runs coverage validation against the source epics. - Use Case: After drafting epics for a task management API, run sprint planning to produce a sprint-status.yaml that developers and agents update as stories move through implementation and code review. ## Quick Start Ask the agent to run sprint planning and generate the sprint status file from your 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 documents?▼

Run the sprint planning workflow, which scans your planning artifacts directory for files matching *epic*.md, extracts all epics and stories, and writes a sprint-status.yaml with detected statuses to your implementation artifacts folder.

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 the file exists, the story status is upgraded to at least ready-for-dev, but existing more advanced statuses like done are never downgraded.

Can it handle sharded epic files split across multiple documents?▼

Yes. If no whole epic document is found, it looks for an epics/index.md, reads the index, then loads every listed epic section file. If both whole and sharded versions exist, the whole document takes priority.

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

Epics flow through backlog, in-progress, and done. Stories flow through backlog, ready-for-dev, in-progress, review, and done. Retrospective entries toggle between optional and done.

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

Missing stories usually mean the epic files use nonstandard headers. The parser expects patterns like '### Story 1.1: Title' and '## Epic 1:'. Run the validation checklist to compare epic file contents against the generated YAML.