Skip to content
🤖 Consolidated, AI-optimized BMAD docs: llms-full.txt. Fetch this plain text file for complete context.

How to Run Sprint Planning

Use the sprint-planning workflow to initialize the sprint tracking file and organize work for implementation.


  • Once at the start of Phase 4 (Implementation)
  • After implementation-readiness gate passes
  • When starting a new sprint cycle

  • BMad Method installed
  • SM (Scrum Master) agent available
  • Epic files created from create-epics-and-stories
  • Implementation-readiness passed (for BMad Method/Enterprise)

Start a fresh chat and load the SM (Scrum Master) agent.

*sprint-planning

Point the agent to your epic files created during Phase 3.

The agent organizes stories into the sprint tracking file.


A sprint-status.yaml file containing:

  • All epics with their stories
  • Story status tracking (TODO, IN PROGRESS, READY FOR REVIEW, DONE)
  • Dependencies between stories
  • Priority ordering

Stories move through these states in the sprint status file:

StateDescription
TODOStory identified but not started
IN PROGRESSStory being implemented
READY FOR REVIEWImplementation complete, awaiting code review
DONEAccepted and complete

  • Complete Phases 1-3
  • PRD/GDD + Architecture complete
  • Epics+Stories created via create-epics-and-stories

Start of Phase 4:

  1. SM runs sprint-planning (once)

Per Story (repeat until epic complete):

  1. SM runs create-story
  2. DEV runs dev-story
  3. DEV runs code-review
  4. Update sprint-status.yaml

After Epic Complete:

  • SM runs retrospective
  • Move to next epic

  • Run sprint-planning only once at Phase 4 start
  • Use sprint-status during Phase 4 to check current state
  • Keep the sprint-status.yaml file as single source of truth
  • Update story status after each stage