bmad-sprint-planning

Generates and validates sprint-status.yaml tracking files from epic planning documents.

Updated Sep 3, 2026
One-click install
npx skills add https://github.com/watchthelight/shatterfish --skill bmad-sprint-planning-watchthelight
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-sprint-planning
Source: https://github.com/watchthelight/shatterfish/tree/main/.claude/skills/bmad-sprint-planning
Command: npx skills add https://github.com/watchthelight/shatterfish --skill bmad-sprint-planning-watchthelight

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? It turns epic and story planning documents into a structured sprint-status.yaml tracking file, checks whether a plan is ready to implement, and keeps sprint progress reporting consistent and machine-validated. ## Core Features & Use Cases - Readiness Gate: Audits planning artifacts (PRDs, specs, architecture, epics) and returns a PASS, CONCERNS, or FAIL verdict on whether the plan is implementable. - Tracking Generation: Parses epic files into a sprint-status.yaml with epic, story, and retrospective statuses, merging with existing progress without downgrading it. - Status, Validate, and Fix: Summarizes sprint progress with risks and next recommended actions, validates file structure, and rebuilds broken tracking files from evidence. - Use Case: After writing epics for a project, ask for sprint planning to gate readiness and produce a tracking file that later workflows use to pick the next story to build. ## Quick Start Ask the assistant to run sprint planning to check implementation readiness and generate the sprint status tracking 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 flow, which parses Epic and Story headings from your epic Markdown files and writes a sprint-status.yaml with backlog defaults. Stories that already have files on disk are floored at ready-for-dev, and existing statuses are preserved, never downgraded.

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

Use the readiness intent, which inventories planning artifacts like PRDs, specs, architecture, and epics, then returns a PASS, CONCERNS, or FAIL verdict. It checks that requirements trace into stories and that no story depends on decisions nothing records.

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

Stories use backlog, ready-for-dev, in-progress, review, and done; epics use backlog, in-progress, and done; retrospectives use optional or done. Legacy v6 values like drafted and contexted are normalized to ready-for-dev and in-progress automatically.

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

Yes, the fix flow validates the file, gathers evidence from epic files, story files, and git history, proposes corrected statuses for your confirmation, then regenerates a pristine file with the script's --fresh and --set options.

Does sprint planning work in headless or non-interactive mode?

Yes, headless mode runs the readiness gate and generates tracking without asking questions, ending with a JSON response containing status, intent, and gate verdict. Ambiguities that would require user input halt with a blocked status instead of guessing.