bmad-sprint-planning

Validates planning readiness and generates sprint-status.yaml tracking files from epic documents.

Updated Sep 4, 2026
One-click install
npx skills add https://github.com/Joao-Victor-Medeiros/save-sc --skill bmad-sprint-planning-joao-victor-medeiros
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bmad-sprint-planning
Source: https://github.com/Joao-Victor-Medeiros/save-sc/tree/main/.agents/skills/bmad-sprint-planning
Command: npx skills add https://github.com/Joao-Victor-Medeiros/save-sc --skill bmad-sprint-planning-joao-victor-medeiros

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ruamel.yaml, and includes scripts (resource) and references (resource) components.

What problem does it solve? Agile teams need a reliable way to know whether their planning artifacts are complete enough to build from, and a single source of truth for tracking epic and story progress. This Skill checks implementation readiness, then generates and maintains a sprint-status.yaml file that stays in sync with your epic documents. ## Core Features & Use Cases - Readiness Gate: Audits briefs, PRDs, architecture, and epics against one question — could a developer implement these stories without inventing unrecorded decisions — and returns a PASS, CONCERNS, or FAIL verdict. - Deterministic Tracking Generation: Parses epic files into kebab-case story keys, merges with existing statuses without downgrades, detects story files on disk, and writes sprint-status.yaml atomically with post-write validation. - Status, Validate, and Repair: Summarizes sprint progress with risks and next recommended actions, validates tracking file structure, and rebuilds broken files through evidence-gathering and user confirmation. - Use Case: After finishing your PRD and epics, ask the agent to run sprint planning; it flags a story with no recorded architecture decision, you fix it, and it generates a sprint-status.yaml ready for the build workflow. ## Quick Start Ask the agent to run sprint planning and generate the sprint status file from your epics.

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 flow, which parses Markdown epic files for Epic and Story headings, derives kebab-case keys, and writes sprint-status.yaml via the sprint_plan.py generate command. Existing statuses are preserved and never downgraded during regeneration.

How do I check if my project planning is ready for implementation?▼

Use the readiness intent, which inventories briefs, PRDs, architecture, and epics, then assesses whether a developer could implement the stories without inventing unrecorded decisions. It returns a PASS, CONCERNS, or FAIL verdict with findings.

Can I validate or repair a broken sprint-status.yaml file?▼

Yes. The validate subcommand checks structure, key grammar, and legal statuses without writing anything. The fix flow gathers evidence from epics, story files, and git history, confirms a proposed state with you, then rebuilds the file with --fresh and --set.

What happens to legacy v6 statuses like drafted or contexted?▼

Legacy statuses are normalized on every read: drafted maps to ready-for-dev and contexted maps to in-progress. They merge and count by their modern meaning and are reported in the legacy_mapped field, never silently reset.

Why does sprint status generation warn about unparsed headings?▼

The parser expects headings like '## Epic N:' and '### Story N.M: Title'. Headings mentioning epic or story that miss this format are reported as warnings so you can fix the epic file or accept the omission before regenerating.