BMAD-METHOD/src/modules/bmm/workflows/_shared/bmm-workflow-status-template.md

Project Workflow Status

Project: {{project_name}} Created: {{start_date}} Last Updated: {{last_updated}} Status File: bmm-workflow-status.md

---

Workflow Status Tracker

Current Phase: {{current_phase}} Current Workflow: {{current_workflow}} Current Agent: {{current_agent}} Overall Progress: {{progress_percentage}}%

Phase Completion Status

• 1-Analysis - Research, brainstorm, brief (optional)
• 2-Plan - PRD/GDD/Tech-Spec + Stories/Epics
• 3-Solutioning - Architecture + Tech Specs (Level 2+ only)
• 4-Implementation - Story development and delivery

Planned Workflow Journey

This section documents your complete workflow plan from start to finish.

Phase	Step	Agent	Description	Status

{{#planned_workflow}} | {{phase}} | {{step}} | {{agent}} | {{description}} | {{status}} | {{/planned_workflow}}

Current Step: {{current_step}} Next Step: {{next_step}}

Instructions:

• This plan was created during initial workflow-status setup
• Status values: Planned, Optional, Conditional, In Progress, Complete
• Current/Next steps update as you progress through the workflow
• Use this as your roadmap to know what comes after each phase

Implementation Progress (Phase 4 Only)

Story Tracking: {{story_tracking_mode}}

{{#if in_phase_4}}

BACKLOG (Not Yet Drafted)

Ordered story sequence - populated at Phase 4 start:

Epic	Story	ID	Title	File

{{#backlog_stories}} | {{epic_num}} | {{story_num}} | {{story_id}} | {{story_title}} | {{story_file}} | {{/backlog_stories}}

Total in backlog: {{backlog_count}} stories

Instructions:

• Stories move from BACKLOG → TODO when previous story is complete
• SM agent uses story information from this table to draft new stories
• Story order is sequential (Epic 1 stories first, then Epic 2, etc.)

TODO (Needs Drafting)

• Story ID: {{todo_story_id}}
• Story Title: {{todo_story_title}}
• Story File: {{todo_story_file}}
• Status: Not created OR Draft (needs review)
• Action: SM should run create-story workflow to draft this story

Instructions:

• Only ONE story in TODO at a time
• Story stays in TODO until user marks it "ready for development"
• SM reads this section to know which story to draft next
• After SM creates/updates story, user reviews and approves via story-ready workflow

IN PROGRESS (Approved for Development)

• Story ID: {{current_story_id}}
• Story Title: {{current_story_title}}
• Story File: {{current_story_file}}
• Story Status: Ready | In Review
• Context File: {{current_story_context_file}}
• Action: DEV should run dev-story workflow to implement this story

Instructions:

• Only ONE story in IN PROGRESS at a time
• Story stays here until user marks it "approved" (DoD complete)
• DEV reads this section to know which story to implement
• After DEV completes story, user reviews and runs story-approved workflow

DONE (Completed Stories)

Story ID	File	Completed Date	Points

{{#done_stories}} | {{story_id}} | {{story_file}} | {{completed_date}} | {{story_points}} | {{/done_stories}}

Total completed: {{done_count}} stories Total points completed: {{done_points}} points

Instructions:

• Stories move here when user runs story-approved workflow (DEV agent)
• Immutable record of completed work
• Used for velocity tracking and progress reporting

Epic/Story Summary

Total Epics: {{total_epics}} Total Stories: {{total_stories}} Stories in Backlog: {{backlog_count}} Stories in TODO: {{todo_count}} (should always be 0 or 1) Stories in IN PROGRESS: {{in_progress_count}} (should always be 0 or 1) Stories DONE: {{done_count}}

Epic Breakdown: {{#epics}}

• Epic {{epic_number}}: {{epic_title}} ({{epic_done_stories}}/{{epic_total_stories}} stories complete) {{/epics}}

State Transition Logic

Story Lifecycle:

BACKLOG → TODO → IN PROGRESS → DONE

Transition Rules:

1. BACKLOG → TODO: Automatically when previous story moves TODO → IN PROGRESS
2. TODO → IN PROGRESS: User runs SM agent story-ready workflow after reviewing drafted story
3. IN PROGRESS → DONE: User runs DEV agent story-approved workflow after DoD complete

Important:

• SM agent NEVER searches for "next story" - always reads TODO section
• DEV agent NEVER searches for "current story" - always reads IN PROGRESS section
• Both agents update this status file after their workflows complete

{{/if}}

Artifacts Generated

Artifact	Status	Location	Date

{{#artifacts}} | {{name}} | {{status}} | {{path}} | {{date}} | {{/artifacts}}

Next Action Required

What to do next: {{next_action}}

Command to run: {{next_command}}

Agent to load: {{next_agent}}

---

Assessment Results

Project Classification

• Project Type: {{project_type}} ({{project_type_display_name}})
• Project Level: {{project_level}}
• Instruction Set: {{instruction_set}}
• Greenfield/Brownfield: {{field_type}}

Scope Summary

• Brief Description: {{scope_description}}
• Estimated Stories: {{story_count}}
• Estimated Epics: {{epic_count}}
• Timeline: {{timeline}}

Context

• Existing Documentation: {{existing_docs}}
• Team Size: {{team_size}}
• Deployment Intent: {{deployment_intent}}

Recommended Workflow Path

Primary Outputs

{{expected_outputs}}

Workflow Sequence

{{workflow_steps}}

Next Actions

{{next_steps}}

Special Considerations

{{special_notes}}

Technical Preferences Captured

{{technical_preferences}}

Story Naming Convention

Level 0 (Single Atomic Change)

• Format: story-<short-title>.md
• Example: story-icon-migration.md, story-login-fix.md
• Location: {{dev_story_location}}/
• Max Stories: 1 (if more needed, consider Level 1)

Level 1 (Coherent Feature)

• Format: story-<title>-<n>.md
• Example: story-oauth-integration-1.md, story-oauth-integration-2.md
• Location: {{dev_story_location}}/
• Max Stories: 2-3 (prefer longer stories over more stories)

Level 2+ (Multiple Epics)

• Format: story-<epic>.<story>.md
• Example: story-1.1.md, story-1.2.md, story-2.1.md
• Location: {{dev_story_location}}/
• Max Stories: Per epic breakdown in epics.md

Decision Log

Planning Decisions Made

{{#decisions}}

• {{decision_date}}: {{decision_description}} {{/decisions}}

---

Change History

{{#changes}}

{{change_date}} - {{change_author}}

• Phase: {{change_phase}}
• Changes: {{change_description}} {{/changes}}

---

Agent Usage Guide

For SM (Scrum Master) Agent

When to use this file:

• Running create-story workflow → Read "TODO (Needs Drafting)" section for exact story to draft
• Running story-ready workflow → Update status file, move story from TODO → IN PROGRESS, move next story from BACKLOG → TODO
• Checking epic/story progress → Read "Epic/Story Summary" section

Key fields to read:

• todo_story_id → The story ID to draft (e.g., "1.1", "auth-feature-1")
• todo_story_title → The story title for drafting
• todo_story_file → The exact file path to create

Key fields to update:

• Move completed TODO story → IN PROGRESS section
• Move next BACKLOG story → TODO section
• Update story counts

Workflows:

1. create-story - Drafts the story in TODO section (user reviews it)
2. story-ready - After user approval, moves story TODO → IN PROGRESS

For DEV (Developer) Agent

When to use this file:

• Running dev-story workflow → Read "IN PROGRESS (Approved for Development)" section for current story
• Running story-approved workflow → Update status file, move story from IN PROGRESS → DONE, move TODO story → IN PROGRESS, move BACKLOG story → TODO
• Checking what to work on → Read "IN PROGRESS" section

Key fields to read:

• current_story_file → The story to implement
• current_story_context_file → The context XML for this story
• current_story_status → Current status (Ready | In Review)

Key fields to update:

• Move completed IN PROGRESS story → DONE section with completion date
• Move TODO story → IN PROGRESS section
• Move next BACKLOG story → TODO section
• Update story counts and points

Workflows:

1. dev-story - Implements the story in IN PROGRESS section
2. story-approved - After user approval (DoD complete), moves story IN PROGRESS → DONE

For PM (Product Manager) Agent

When to use this file:

• Checking overall progress → Read "Phase Completion Status"
• Planning next phase → Read "Overall Progress" percentage
• Course correction → Read "Decision Log" for context

Key fields:

• progress_percentage → Overall project progress
• current_phase → What phase are we in
• artifacts table → What's been generated

---

This file serves as the single source of truth for project workflow status, epic/story tracking, and next actions. All BMM agents and workflows reference this document for coordination.

Template Location: bmad/bmm/workflows/_shared/bmm-workflow-status-template.md

File Created: {{start_date}}