bmad-method 6.0.0-alpha.2 → 6.0.0-alpha.3

package/src/modules/bmm/workflows/workflow-status/README.md

@@ -19,7 +19,7 @@ The workflow status system provides:
 workflow-status/
 ├── workflow.yaml              # Main configuration
 ├── instructions.md            # Status checker (99 lines)
-├── workflow-status-template.md # Clean key-value template
+├── workflow-status-template.yaml # Clean YAML status template
 ├── project-levels.yaml        # Source of truth for scale definitions
 └── paths/                     # Modular workflow definitions
     ├── greenfield-level-0.yaml through level-4.yaml
@@ -61,25 +61,44 @@ workflow-init/
 
 ## Status File Format
 
-Simple key-value pairs for instant parsing:
-
-```markdown
-PROJECT_NAME: MyProject
-PROJECT_TYPE: software
-PROJECT_LEVEL: 2
-FIELD_TYPE: greenfield
-CURRENT_PHASE: 2-Planning
-CURRENT_WORKFLOW: prd
-NEXT_ACTION: Continue PRD
-NEXT_COMMAND: prd
-NEXT_AGENT: pm
+Clean YAML format with all workflows listed up front:
+
+```yaml
+# generated: 2025-10-29
+# project: MyProject
+# project_type: software
+# project_level: 2
+# field_type: greenfield
+# workflow_path: greenfield-level-2.yaml
+
+workflow_status:
+  # Phase 1: Analysis
+  brainstorm-project: optional
+  research: optional
+  product-brief: recommended
+
+  # Phase 2: Planning
+  prd: docs/prd.md
+  validate-prd: optional
+  create-design: conditional
+
+  # Phase 3: Solutioning
+  create-architecture: required
+  validate-architecture: optional
+  solutioning-gate-check: required
 ```
 
-Any agent can instantly grep what they need:
+**Status Values:**
 
-- Any: `grep 'NEXT_ACTION:' status.md`
-- Any: `grep 'CURRENT_PHASE:' status.md`
-- Any: `grep 'NEXT_COMMAND:' status.md`
+- `required` / `optional` / `recommended` / `conditional` - Not yet started
+- `{file-path}` - Completed (e.g., `docs/prd.md`)
+- `skipped` - Optional workflow that was skipped
+
+Any agent can instantly parse what they need:
+
+- Read YAML to see all workflows and their status
+- Check which workflows are completed vs pending
+- Auto-detect existing work by scanning for output files
 
 ## Project Levels
 
@@ -213,10 +232,10 @@ Other workflows read the status to coordinate:
 **Phase 4 (Implementation):**
 
 - workflow-status only tracks sprint-planning completion
-- After sprint-planning, all story/epic tracking happens in the sprint plan output file
+- After sprint-planning, all story/epic tracking happens in sprint-status.yaml
 - Phase 4 workflows do NOT read/write workflow-status (except sprint-planning for prerequisite verification)
 
-The status file is the single source of truth for Phases 1-3 and the hub that keeps all agents synchronized.
+The workflow-status.yaml file is the single source of truth for Phases 1-3, and sprint-status.yaml takes over for Phase 4 implementation tracking.
 
 ## Benefits
 

package/src/modules/bmm/workflows/workflow-status/init/instructions.md

@@ -261,36 +261,129 @@ Here's the complexity scale for reference:
 <template-output>workflow_path_file</template-output>
 </step>
 
-<step n="5" goal="Generate workflow summary">
-<action>Build workflow from loaded path file</action>
-<action>Display phases and workflows</action>
-<action>Set initial values for status file</action>
-
-<template-output>current_phase</template-output>
-<template-output>current_workflow</template-output>
-<template-output>current_agent</template-output>
-<template-output>next_action</template-output>
-<template-output>next_command</template-output>
-<template-output>next_agent</template-output>
+<step n="5" goal="Build workflow status YAML structure">
+<action>Parse the loaded workflow path file and extract all workflows</action>
+
+<action>For each phase in the path file:
+
+- Extract phase number and name
+- Extract all workflows in that phase
+- For each workflow, determine its status type:
+  - required: true → status = "required"
+  - recommended: true → status = "recommended"
+  - conditional: "if_has_ui" → status = "conditional"
+  - optional: true → status = "optional"
+  - Default if not specified → status = "required"
+    </action>
+
+<action>Build the workflow_items list in this format:
+
+For each phase:
+
+1. Add comment header: `  # Phase {n}: {Phase Name}`
+2. For each workflow in phase:
+   - Add entry: `  {workflow-id}: {status}`
+3. Add blank line between phases
+
+Example structure:
+
+```
+  # Phase 1: Analysis
+  brainstorm-project: optional
+  research: optional
+  product-brief: recommended
+
+  # Phase 2: Planning
+  prd: required
+  validate-prd: optional
+  create-design: conditional
+```
+
+</action>
+
+<action>Scan for existing workflow output files to auto-detect completion:
+
+For each workflow in the list, check common output locations:
+
+- {output_folder}/brainstorm-\*.md for brainstorm-project
+- {output_folder}/research-\*.md for research
+- {output_folder}/product-brief.md for product-brief
+- {output_folder}/prd.md for prd
+- {output_folder}/ux-design.md for create-design
+- {output_folder}/architecture.md for create-architecture
+- {output_folder}/tech-spec.md for tech-spec
+- {output_folder}/sprint-status.yaml for sprint-planning
+
+CRITICAL: If file exists, replace status with ONLY the file path - nothing else.
+Example: product-brief: docs/product-brief.md
+NOT: product-brief: "completed - docs/product-brief.md" or any other text.
+</action>
+
+<template-output>workflow_items</template-output>
 </step>
 
-<step n="6" goal="Create status file">
-<action>Initialize all status values</action>
-<template-output>start_date</template-output>
-<template-output>last_updated</template-output>
-<template-output>phase_1_complete</template-output>
-<template-output>phase_2_complete</template-output>
-<template-output>phase_3_complete</template-output>
-<template-output>phase_4_complete</template-output>
+<step n="6" goal="Create workflow status file">
+<action>Set generated date to current date</action>
+<template-output>generated</template-output>
+
+<action>Prepare all template variables for workflow-status-template.yaml:
+
+- generated: {current_date}
+- project_name: {project_name}
+- project_type: {project_type}
+- project_level: {project_level}
+- field_type: {field_type}
+- workflow_path_file: {workflow_path_file}
+- workflow_items: {workflow_items from step 5}
+  </action>
+
+<action>Display a preview of what will be created:
+
+Show the first workflow in each phase and total count:
+
+"Ready to create workflow status tracking:
+
+- Phase 1 ({phase_1_workflow_count} workflows): Starting with {first_workflow_phase_1}
+- Phase 2 ({phase_2_workflow_count} workflows): Starting with {first_workflow_phase_2}
+- Phase 3 ({phase_3_workflow_count} workflows): Starting with {first_workflow_phase_3}
+- Phase 4 (Implementation tracked separately in sprint-status.yaml)
+
+{{#if detected_completed_workflows}}
+Found existing work:
+{{#each detected_files}}
+
+- {{workflow_name}}: {{file_path}}
+  {{/each}}
+  {{/if}}"
+  </action>
 
 <ask>Ready to create your workflow status file? (y/n)</ask>
 
 <check if="answer == y">
-  <action>Save status file to {output_folder}/bmm-workflow-status.md</action>
-  <output>✅ Status file created! Next up: {{next_agent}} agent, run `{{next_command}}`</output>
-  <check if="next_agent !== current_agent">
-    <output>It is strongly recommended to clear the context or start a new chat and load the next agent to execute the next command from that agents help menu, unless there is something else I can do for you first.</output>
-  </check>
+  <action>Generate YAML from workflow-status-template.yaml with all variables</action>
+  <action>Save status file to {output_folder}/bmm-workflow-status.yaml</action>
+
+<action>Identify the first non-completed workflow in the list</action>
+<action>Look up that workflow's agent and command from the path file</action>
+
+<output>✅ Workflow status file created at {output_folder}/bmm-workflow-status.yaml
+
+**Next Steps:**
+
+{{#if detected_completed_workflows}}
+You have {{detected_count}} workflow(s) already completed. Great progress!
+{{/if}}
+
+**Next Workflow:** {{next_workflow_name}}
+
+**Agent:** {{next_agent}}
+
+**Command:** /bmad:bmm:workflows:{{next_workflow_id}}
+
+{{#if next_agent !== 'pm'}}
+It is recommended to start a new chat and load the {{next_agent}} agent before running the next workflow.
+{{/if}}
+</output>
 </check>
 </step>
 

package/src/modules/bmm/workflows/workflow-status/init/workflow.yaml

@@ -16,13 +16,13 @@ date: system-generated
 # Workflow components
 installed_path: "{project-root}/bmad/bmm/workflows/workflow-status/init"
 instructions: "{installed_path}/instructions.md"
-template: "{project-root}/bmad/bmm/workflows/workflow-status/workflow-status-template.md"
+template: "{project-root}/bmad/bmm/workflows/workflow-status/workflow-status-template.yaml"
 
 # Path data files
 path_files: "{project-root}/bmad/bmm/workflows/workflow-status/paths/"
 
 # Output configuration
-default_output_file: "{output_folder}/bmm-workflow-status.md"
+default_output_file: "{output_folder}/bmm-workflow-status.yaml"
 
 standalone: true
 web_bundle: false