bmad-sprint-planning

Parse epic markdown files into an ordered sprint-status.yaml inventory.

1|Updated May 16, 2026
One-click install
npx skills add https://github.com/enigmaicon-eng/AI-Enterprise-OS --skill bmad-sprint-planning-enigmaicon-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-sprint-planning
Source: https://github.com/enigmaicon-eng/AI-Enterprise-OS/tree/main/examples/BMAD-METHOD/src/bmm-skills/4-implementation/bmad-sprint-planning
Command: npx skills add https://github.com/enigmaicon-eng/AI-Enterprise-OS --skill bmad-sprint-planning-enigmaicon-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, and includes references (resource) components.

What problem does it solve?

It eliminates the manual effort of keeping sprint tracking aligned with changing epic and story documents by automatically producing an up-to-date sprint-status.yaml.

Core Features & Use Cases

  • Epic + Story Inventory: Loads all epic markdown files, extracts epic/story identifiers and titles, and builds a complete ordered status structure.
  • Intelligent Status Detection: Infers story states by checking whether corresponding story files exist and preserves any more advanced existing statuses from a prior sprint-status.yaml.
  • Sprint Status Output: Generates a standardized sprint-status.yaml with epic, story, and retrospective entries suitable for ongoing sprint management and re-runs.

Quick Start

Ask the system to run sprint planning so it generates the sprint-status.yaml file by scanning your epic markdown files.

Frequently Asked Questions about bmad-sprint-planning

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

FAQPage Schema
How do I auto-generate sprint status from epic markdown files?

Sprint planning automation infers story status by checking for the presence of story markdown files. It builds a complete status structure by scanning epic files and preserves any advanced existing statuses from a prior sprint-status.yaml across re-runs.

How does story status detection work during sprint planning?

Story status detection works by checking whether corresponding story markdown files exist. If a prior sprint-status.yaml exists, it preserves more advanced states and applies legal state transitions to maintain accurate sprint tracking.

Do I need YAML frontmatter in my markdown files for sprint tracking?

Yes, YAML frontmatter-driven activation is required. The system uses frontmatter to resolve customizations, load configurations, and perform full epic discovery, including handling sharded epic layouts during the parsing process.

Can I use Python to automate project workflow tracking for agile epics?

Yes, this Python 3-based automation tool loads all epic markdown files to build an ordered status structure. It generates a standardized sprint-status.yaml output suitable for ongoing agile sprint management and re-runs.

What happens to existing story statuses when I re-run sprint planning?

When re-running sprint planning, the tool preserves any more advanced existing statuses from a prior sprint-status.yaml. It validates legal state transitions and updates the inventory while maintaining previously tracked story progress.

Does this sprint planning tool handle sharded epic layouts in markdown?

Yes, full epic discovery includes support for sharded layouts. The tool scans all referenced markdown shards to extract epic and story identifiers, ensuring complete inventory generation before writing the final sprint-status.yaml.