bmad-sprint-planning

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

Updated Mar 1, 2026
One-click install
npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-sprint-planning-hexalith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-sprint-planning
Source: https://github.com/Hexalith/Hexalith.Parties/tree/main/.agents/skills/bmad-sprint-planning
Command: npx skills add https://github.com/Hexalith/Hexalith.Parties --skill bmad-sprint-planning-hexalith

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Agile teams lose track of which epics and stories are done, in progress, or blocked when sprint state lives only in chat history or scattered notes. This Skill checks whether your planning artifacts are complete enough to implement, then generates and maintains a structured sprint-status.yaml file that tracks every epic, story, and retrospective. ## Core Features & Use Cases - Readiness Gate: Audits briefs, PRDs, architecture docs, and epics to confirm a developer could implement the plan without inventing unrecorded decisions, returning a PASS, CONCERNS, or FAIL verdict. - Deterministic Tracking Generation: Parses epic files into kebab-case story keys and writes sprint-status.yaml via a Python script with atomic writes, status preservation, and legacy v6 status normalization. - Status, Validate, and Fix Flows: Summarizes sprint progress with risks and next recommended actions, validates the tracking file's structure, and rebuilds broken files through evidence-gathering and user confirmation. - Use Case: After writing epics for a new feature, ask the assistant to run sprint planning; it verifies readiness, generates sprint-status.yaml, and later tells you which story to build next. ## Quick Start Ask the assistant to run sprint planning and generate the sprint status file from the epics in your planning docs folder.

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 epic markdown files for Epic and Story headings and writes sprint-status.yaml via the sprint_plan.py script. Each story gets a kebab-case key, and existing statuses are preserved without downgrades.

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

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

What epic file format does the sprint planning script expect?

The parser recognizes headings like '## Epic N:' and '### Story N.M: Title' in markdown files, ignoring fenced code blocks. Headings that mention epics or stories but miss the pattern are reported as warnings so you can fix them.

Can I repair a broken or hand-edited sprint-status.yaml?

Yes, the fix flow validates the file, gathers evidence from epics, story files, and git history, proposes corrected statuses, and rebuilds the file with the script's --fresh and --set flags after your confirmation.

Does the script support legacy v6 status values like drafted?

Yes, legacy statuses such as drafted and contexted are normalized on read to ready-for-dev and in-progress. They merge and count by their modern meaning and are reported in the legacy_mapped field, never silently reset.