Project: {{project_name}}
Created: {{start_date}}
Last Updated: {{last_updated}}
Status File: bmm-workflow-status.md
Current Phase: {{current_phase}} Current Workflow: {{current_workflow}} Current Agent: {{current_agent}} Overall Progress: {{progress_percentage}}%
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:
Story Tracking: {{story_tracking_mode}}
{{#if in_phase_4}}
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:
{{todo_story_file}}create-story workflow to draft this storyInstructions:
story-ready workflow{{current_story_file}}{{current_story_context_file}}dev-story workflow to implement this storyInstructions:
story-approved workflow| 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:
story-approved workflow (DEV agent)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}}
Story Lifecycle:
BACKLOG → TODO → IN PROGRESS → DONE
Transition Rules:
story-ready workflow after reviewing drafted storystory-approved workflow after DoD completeImportant:
{{/if}}
| Artifact | Status | Location | Date | | ——– | —— | ——– | —- |
{{#artifacts}} | {{name}} | {{status}} | {{path}} | {{date}} | {{/artifacts}}
What to do next: {{next_action}}
Command to run: {{next_command}}
Agent to load: {{next_agent}}
{{expected_outputs}}
{{workflow_steps}}
{{next_steps}}
{{special_notes}}
{{technical_preferences}}
story-<short-title>.mdstory-icon-migration.md, story-login-fix.md{{dev_story_location}}/story-<title>-<n>.mdstory-oauth-integration-1.md, story-oauth-integration-2.md{{dev_story_location}}/story-<epic>.<story>.mdstory-1.1.md, story-1.2.md, story-2.1.md{{dev_story_location}}/{{#decisions}}
{{#changes}}
When to use this file:
create-story workflow → Read “TODO (Needs Drafting)” section for exact story to draftstory-ready workflow → Update status file, move story from TODO → IN PROGRESS, move next story from BACKLOG → TODOKey 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 draftingtodo_story_file → The exact file path to createKey fields to update:
Workflows:
create-story - Drafts the story in TODO section (user reviews it)story-ready - After user approval, moves story TODO → IN PROGRESSWhen to use this file:
dev-story workflow → Read “IN PROGRESS (Approved for Development)” section for current storystory-approved workflow → Update status file, move story from IN PROGRESS → DONE, move TODO story → IN PROGRESS, move BACKLOG story → TODOKey fields to read:
current_story_file → The story to implementcurrent_story_context_file → The context XML for this storycurrent_story_status → Current status (Ready | In Review)Key fields to update:
Workflows:
dev-story - Implements the story in IN PROGRESS sectionstory-approved - After user approval (DoD complete), moves story IN PROGRESS → DONEWhen to use this file:
Key fields:
progress_percentage → Overall project progresscurrent_phase → What phase are we inartifacts table → What’s been generatedThis 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}}