bmad-method 6.0.0-alpha.21 → 6.0.0-alpha.23

package/src/modules/bmm/workflows/generate-project-context/workflow.md

@@ -32,6 +32,7 @@ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
 - `project_name`, `output_folder`, `user_name`
 - `communication_language`, `document_output_language`, `user_skill_level`
 - `date` as system-generated current datetime
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
 
 ### Paths
 

package/src/modules/bmm/workflows/testarch/test-design/instructions.md

@@ -25,11 +25,11 @@ The workflow auto-detects which mode to use based on project phase.
 ### Mode Detection
 
 1. **Check for sprint-status.yaml**
-   - If `{output_folder}/bmm-sprint-status.yaml` exists → **Epic-Level Mode** (Phase 4)
+   - If `{implementation_artifacts}/sprint-status.yaml` exists → **Epic-Level Mode** (Phase 4)
    - If NOT exists → Check workflow status
 
 2. **Check workflow-status.yaml**
-   - Read `{output_folder}/bmm-workflow-status.yaml`
+   - Read `{planning_artifacts}/bmm-workflow-status.yaml`
    - If `implementation-readiness: required` or `implementation-readiness: recommended` → **System-Level Mode** (Phase 3)
    - Otherwise → **Epic-Level Mode** (Phase 4 without sprint status yet)
 

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

@@ -15,8 +15,8 @@
 - BMM artifacts: PRD, epics, architecture, UX, brief, research, brainstorm
 - Implementation: stories, sprint-status, workflow-status
 - Codebase: source directories, package files, git repo
-- Check both {output_folder} and {implementation_artifacts} locations
-  </action>
+- Check both {planning_artifacts} and {implementation_artifacts} locations
+</action>
 
 <action>Categorize into one of these states:
 
@@ -25,7 +25,7 @@
 - ACTIVE: Has stories or sprint status
 - LEGACY: Has code but no BMM artifacts
 - UNCLEAR: Mixed state needs clarification
-  </action>
+</action>
 
 <ask>What's your project called? {{#if project_name}}(Config shows: {{project_name}}){{/if}}</ask>
 <action>Store project_name</action>
@@ -68,7 +68,7 @@ Choice [1-4]</ask>
 
   <check if="choice == 2">
     <ask>Archive existing work? (y/n)</ask>
-    <action if="y">Move artifacts to {output_folder}/archive/</action>
+    <action if="y">Move artifacts to {planning_artifacts}/archive/</action>
     <output>Ready for fresh start!</output>
     <action>Continue to step 3</action>
   </check>
@@ -323,10 +323,10 @@ Choice:</ask>
 
 <check if="y">
   <action>Generate YAML from template with all variables</action>
-  <action>Save to {output_folder}/bmm-workflow-status.yaml</action>
+  <action>Save to {planning_artifacts}/bmm-workflow-status.yaml</action>
   <action>Identify next workflow and agent</action>
 
-<output>✅ **Created:** {output_folder}/bmm-workflow-status.yaml
+<output>✅ **Created:** {planning_artifacts}/bmm-workflow-status.yaml
 
 **Next:** {{next_workflow_name}}
 **Agent:** {{next_agent}}

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

@@ -7,6 +7,7 @@ author: "BMad"
 config_source: "{project-root}/_bmad/bmm/config.yaml"
 output_folder: "{config_source}:output_folder"
 implementation_artifacts: "{config_source}:implementation_artifacts"
+planning_artifacts: "{config_source}:planning_artifacts"
 user_name: "{config_source}:user_name"
 project_name: "{config_source}:project_name"
 communication_language: "{config_source}:communication_language"
@@ -23,7 +24,7 @@ template: "{project-root}/_bmad/bmm/workflows/workflow-status/workflow-status-te
 path_files: "{project-root}/_bmad/bmm/workflows/workflow-status/paths/"
 
 # Output configuration
-default_output_file: "{output_folder}/bmm-workflow-status.yaml"
+default_output_file: "{planning_artifacts}/bmm-workflow-status.yaml"
 
 standalone: true
 web_bundle: false

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

@@ -34,7 +34,7 @@
 </step>
 
 <step n="1" goal="Check for status file">
-<action>Search {output_folder}/ for file: bmm-workflow-status.yaml</action>
+<action>Search {planning_artifacts}/ for file: bmm-workflow-status.yaml</action>
 
 <check if="no status file found">
   <output>No workflow status found.</output>
@@ -197,7 +197,7 @@ Your choice:</ask>
 <!-- ============================================= -->
 
 <step n="10" goal="Validate mode - Check if calling workflow should proceed">
-<action>Read {output_folder}/bmm-workflow-status.yaml if exists</action>
+<action>Read {planning_artifacts}/bmm-workflow-status.yaml if exists</action>
 
 <check if="status file not found">
   <template-output>status_exists = false</template-output>
@@ -261,7 +261,7 @@ Your choice:</ask>
 </step>
 
 <step n="20" goal="Data mode - Extract specific information">
-<action>Read {output_folder}/bmm-workflow-status.yaml if exists</action>
+<action>Read {planning_artifacts}/bmm-workflow-status.yaml if exists</action>
 
 <check if="status file not found">
   <template-output>status_exists = false</template-output>
@@ -309,7 +309,7 @@ Your choice:</ask>
 </step>
 
 <step n="30" goal="Init-check mode - Simple existence check">
-<action>Check if {output_folder}/bmm-workflow-status.yaml exists</action>
+<action>Check if {planning_artifacts}/bmm-workflow-status.yaml exists</action>
 
 <check if="exists">
   <template-output>status_exists = true</template-output>
@@ -325,7 +325,7 @@ Your choice:</ask>
 </step>
 
 <step n="40" goal="Update mode - Centralized status file updates">
-<action>Read {output_folder}/bmm-workflow-status.yaml</action>
+<action>Read {planning_artifacts}/bmm-workflow-status.yaml</action>
 
 <check if="status file not found">
   <template-output>success = false</template-output>
@@ -343,11 +343,11 @@ Your choice:</ask>
   <!-- ============================================= -->
   <check if="action == complete_workflow">
     <action>Get {{workflow_id}} parameter (required)</action>
-    <action>Get {{output_file}} parameter (required - path to created file)</action>
+    <action>Get {{default_output_file}} parameter (required - path to created file)</action>
 
     <critical>ONLY write the file path as the status value - no other text, notes, or metadata</critical>
     <action>Update workflow status in YAML:</action>
-    - In workflow_status section, update: {{workflow_id}}: {{output_file}}
+    - In workflow_status section, update: {{workflow_id}}: {{default_output_file}}
 
     <action>Find {{workflow_id}} in loaded path YAML</action>
     <action>Determine next workflow from path sequence</action>
@@ -359,7 +359,7 @@ Your choice:</ask>
     <template-output>next_workflow = {{determined next workflow}}</template-output>
     <template-output>next_agent = {{determined next agent from path file}}</template-output>
     <template-output>completed_workflow = {{workflow_id}}</template-output>
-    <template-output>output_file = {{output_file}}</template-output>
+    <template-output>default_output_file = {{default_output_file}}</template-output>
 
   </check>
 

package/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml

@@ -7,116 +7,97 @@ field_type: "brownfield"
 description: "Enterprise-grade planning for complex brownfield additions with extended requirements"
 
 phases:
-  - prerequisite: true
+  - phase: 0
     name: "Documentation"
     conditional: "if_undocumented"
-    note: "NOT a phase - prerequisite for brownfield without docs (nearly mandatory for enterprise)"
+    note: "Prerequisite for brownfield without docs"
     workflows:
       - id: "document-project"
         required: true
+        workflow: "{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml"
         agent: "analyst"
-        command: "document-project"
+        command: "/bmad:bmm:workflows:document-project"
         output: "Comprehensive project documentation"
-        purpose: "Understand existing codebase - critical for enterprise brownfield"
-
-  - phase: 0
-    name: "Discovery (Required)"
-    required: true
-    note: "Analysis phase required for enterprise projects"
+        purpose: "Understand existing codebase before planning"
+  - phase: 1
+    name: "Analysis (Optional)"
+    optional: true
+    note: "User-selected during workflow-init"
     workflows:
       - id: "brainstorm-project"
+        exec: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
         optional: true
         agent: "analyst"
-        command: "brainstorm-project"
-        note: "Uses core brainstorming workflow with project context template"
+        command: "/bmad:bmm:workflows:brainstorming"
         included_by: "user_choice"
-
+        note: "Uses core brainstorming workflow with project context template"
       - id: "research"
-        recommended: true
+        exec: "{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.md"
+        optional: true
         agent: "analyst"
-        command: "research"
+        command: "/bmad:bmm:workflows:research"
         included_by: "user_choice"
-        note: "Highly recommended - compliance, integration, risk research"
-
+        note: "Can have multiple research workflows"
       - id: "product-brief"
+        exec: "{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md"
         optional: true
         agent: "analyst"
-        command: "product-brief"
+        command: "/bmad:bmm:workflows:create-product-brief"
         included_by: "user_choice"
-        note: "Optional for brownfield enterprise"
-
-  - phase: 1
+        note: "Recommended for greenfield Method projects"
+  - phase: 2
     name: "Planning"
     required: true
     workflows:
       - id: "prd"
+        exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md"
         required: true
         agent: "pm"
-        command: "prd"
-        output: "Enterprise PRD with compliance requirements"
-        note: "Must address existing system constraints and migration strategy"
-
+        command: "/bmad:bmm:workflows:create-prd"
+        output: "Product Requirements Document with FRs and NFRs"
       - id: "create-ux-design"
-        recommended: true
+        conditional: "if_has_ui"
+        exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md"
         agent: "ux-designer"
-        command: "create-ux-design"
-        note: "Recommended - must integrate with existing UX patterns"
-
-  - phase: 2
+        command: "/bmad:bmm:workflows:create-ux-design"
+        note: "Determined after PRD - user/agent decides if needed"
+  - phase: 3
     name: "Solutioning"
     required: true
     workflows:
       - id: "create-architecture"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md"
         agent: "architect"
-        command: "create-architecture"
-        output: "Integration architecture with enterprise considerations"
-        note: "Distills brownfield context + adds security/scalability/compliance design"
-
+        command: "/bmad:bmm:workflows:create-architecture"
+        output: "System architecture document"
+        note: "Complete system design for greenfield projects"
       - id: "create-epics-and-stories"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md"
         agent: "pm"
-        command: "create-epics-and-stories"
+        command: "/bmad:bmm:workflows:create-epics-and-stories"
         note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
-
       - id: "test-design"
-        required: true
+        optional: true
+        workflow: "{project-root}/_bmad/bmm/workflows/testarch/test-design/workflow.yaml"
         agent: "tea"
-        command: "test-design"
+        command: "/bmad:bmm:workflows:test-design"
         output: "System-level testability review"
-        note: "Enterprise requires testability validation - auto-detects system-level mode"
-
-      # - id: "create-security-architecture"
-      #   optional: true
-      #   agent: "architect"
-      #   command: "create-security-architecture"
-      #   output: "Security architecture for brownfield integration"
-      #   note: "Future workflow - optional extended enterprise workflow for threat model, auth integration, audit requirements"
-
-      # - id: "create-devops-strategy"
-      #   optional: true
-      #   agent: "architect"
-      #   command: "create-devops-strategy"
-      #   output: "DevOps strategy for brownfield deployment"
-      #   note: "Future workflow - optional extended enterprise workflow for CI/CD integration, deployment strategy, monitoring"
-
-      - id: "validate-architecture"
-        recommended: true
-        agent: "architect"
-        command: "validate-architecture"
-
+        note: "Testability assessment before gate check - auto-detects system-level mode"
       - id: "implementation-readiness"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md"
         agent: "architect"
-        command: "implementation-readiness"
+        command: "/bmad:bmm:workflows:implementation-readiness"
         note: "Validates PRD + Architecture + Epics + UX (optional)"
-
-  - phase: 3
+  - phase: 4
     name: "Implementation"
     required: true
     workflows:
       - id: "sprint-planning"
         required: true
+        workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
         agent: "sm"
-        command: "sprint-planning"
-        note: "Enterprise brownfield requires careful phasing and feature flags"
+        command: "/bmad:bmm:workflows:sprint-planning"
+        note: "Creates sprint plan - subsequent work tracked there"

package/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml

@@ -7,104 +7,94 @@ field_type: "greenfield"
 description: "Complete enterprise-grade planning with security, devops, and test strategy"
 
 phases:
-  - phase: 0
-    name: "Discovery (Required)"
-    required: true
-    note: "Analysis phase required for enterprise projects"
+  - phase: 1
+    name: "Analysis (Optional)"
+    optional: true
+    note: "User-selected during workflow-init"
     workflows:
       - id: "brainstorm-project"
+        exec: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
         optional: true
         agent: "analyst"
-        command: "brainstorm-project"
-        note: "Uses core brainstorming workflow with project context template"
+        command: "/bmad:bmm:workflows:brainstorming"
         included_by: "user_choice"
+        note: "Uses core brainstorming workflow with project context template"
 
       - id: "research"
-        recommended: true
+        exec: "{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.md"
+        optional: true
         agent: "analyst"
-        command: "research"
+        command: "/bmad:bmm:workflows:research"
         included_by: "user_choice"
-        note: "Highly recommended for enterprise - domain and compliance research"
+        note: "Can have multiple research workflows"
 
       - id: "product-brief"
-        recommended: true
+        exec: "{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md"
+        optional: true
         agent: "analyst"
-        command: "product-brief"
+        command: "/bmad:bmm:workflows:create-product-brief"
         included_by: "user_choice"
-        note: "Recommended for strategic alignment"
+        note: "Recommended for greenfield Method projects"
 
-  - phase: 1
+  - phase: 2
     name: "Planning"
     required: true
     workflows:
       - id: "prd"
+        exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md"
         required: true
         agent: "pm"
-        command: "prd"
-        output: "Comprehensive Product Requirements Document"
-        note: "Enterprise-level requirements with compliance considerations"
+        command: "/bmad:bmm:workflows:create-prd"
+        output: "Product Requirements Document with FRs and NFRs"
 
       - id: "create-ux-design"
-        recommended: true
+        conditional: "if_has_ui"
+        exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md"
         agent: "ux-designer"
-        command: "create-ux-design"
-        note: "Highly recommended for enterprise - design system and patterns"
+        command: "/bmad:bmm:workflows:create-ux-design"
+        note: "Determined after PRD - user/agent decides if needed"
 
-  - phase: 2
+  - phase: 3
     name: "Solutioning"
     required: true
     workflows:
       - id: "create-architecture"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md"
         agent: "architect"
-        command: "create-architecture"
-        output: "Enterprise-grade system architecture"
-        note: "Includes scalability, multi-tenancy, integration architecture"
-
-      - id: "test-design"
-        required: true
-        agent: "tea"
-        command: "test-design"
-        output: "System-level testability review"
-        note: "Enterprise requires testability validation - auto-detects system-level mode"
-
-      # - id: "create-security-architecture"
-      #   optional: true
-      #   agent: "architect"
-      #   command: "create-security-architecture"
-      #   output: "Security architecture and threat model"
-      #   note: "Future workflow - optional extended enterprise workflow for security design, auth, compliance"
-
-      # - id: "create-devops-strategy"
-      #   optional: true
-      #   agent: "architect"
-      #   command: "create-devops-strategy"
-      #   output: "DevOps pipeline and infrastructure plan"
-      #   note: "Future workflow - optional extended enterprise workflow for CI/CD, deployment, monitoring"
-
-      - id: "validate-architecture"
-        recommended: true
-        agent: "architect"
-        command: "validate-architecture"
+        command: "/bmad:bmm:workflows:create-architecture"
+        output: "System architecture document"
+        note: "Complete system design for greenfield projects"
 
       - id: "create-epics-and-stories"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md"
         agent: "pm"
-        command: "create-epics-and-stories"
+        command: "/bmad:bmm:workflows:create-epics-and-stories"
         note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
 
+      - id: "test-design"
+        optional: true
+        workflow: "{project-root}/_bmad/bmm/workflows/testarch/test-design/workflow.yaml"
+        agent: "tea"
+        command: "/bmad:bmm:workflows:test-design"
+        output: "System-level testability review"
+        note: "Testability assessment before gate check - auto-detects system-level mode"
+
       - id: "implementation-readiness"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md"
         agent: "architect"
-        command: "implementation-readiness"
+        command: "/bmad:bmm:workflows:implementation-readiness"
         note: "Validates PRD + Architecture + Epics + UX (optional)"
 
-  - phase: 3
+  - phase: 4
     name: "Implementation"
     required: true
     workflows:
       - id: "sprint-planning"
         required: true
+        workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
         agent: "sm"
-        command: "sprint-planning"
-        note: "Creates sprint plan - enterprise projects may require phased rollout"
+        command: "/bmad:bmm:workflows:sprint-planning"
+        note: "Creates sprint plan - subsequent work tracked there"

package/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml

@@ -7,100 +7,97 @@ field_type: "brownfield"
 description: "Complete product and system design for complex brownfield work"
 
 phases:
-  - prerequisite: true
+  - phase: 0
     name: "Documentation"
     conditional: "if_undocumented"
-    note: "NOT a phase - prerequisite for brownfield without docs"
+    note: "Prerequisite for brownfield without docs"
     workflows:
       - id: "document-project"
         required: true
+        workflow: "{project-root}/_bmad/bmm/workflows/document-project/workflow.yaml"
         agent: "analyst"
-        command: "document-project"
+        command: "/bmad:bmm:workflows:document-project"
         output: "Comprehensive project documentation"
         purpose: "Understand existing codebase before planning"
-
-  - phase: 0
-    name: "Discovery (Optional)"
+  - phase: 1
+    name: "Analysis (Optional)"
     optional: true
     note: "User-selected during workflow-init"
     workflows:
       - id: "brainstorm-project"
+        exec: "{project-root}/_bmad/core/workflows/brainstorming/workflow.md"
         optional: true
         agent: "analyst"
-        command: "brainstorm-project"
+        command: "/bmad:bmm:workflows:brainstorming"
         included_by: "user_choice"
         note: "Uses core brainstorming workflow with project context template"
-
       - id: "research"
+        exec: "{project-root}/_bmad/bmm/workflows/1-analysis/research/workflow.md"
         optional: true
         agent: "analyst"
-        command: "research"
+        command: "/bmad:bmm:workflows:research"
         included_by: "user_choice"
-
+        note: "Can have multiple research workflows"
       - id: "product-brief"
+        exec: "{project-root}/_bmad/bmm/workflows/1-analysis/create-product-brief/workflow.md"
         optional: true
         agent: "analyst"
-        command: "product-brief"
+        command: "/bmad:bmm:workflows:create-product-brief"
         included_by: "user_choice"
-        note: "Optional for brownfield, less common than greenfield"
-
-  - phase: 1
+        note: "Recommended for greenfield Method projects"
+  - phase: 2
     name: "Planning"
     required: true
     workflows:
       - id: "prd"
+        exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/prd/workflow.md"
         required: true
         agent: "pm"
-        command: "prd"
-        output: "PRD focused on new features/changes"
-        note: "Must consider existing system constraints"
-
+        command: "/bmad:bmm:workflows:create-prd"
+        output: "Product Requirements Document with FRs and NFRs"
       - id: "create-ux-design"
         conditional: "if_has_ui"
+        exec: "{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.md"
         agent: "ux-designer"
-        command: "create-ux-design"
-
-  - phase: 2
+        command: "/bmad:bmm:workflows:create-ux-design"
+        note: "Determined after PRD - user/agent decides if needed"
+  - phase: 3
     name: "Solutioning"
     required: true
     workflows:
       - id: "create-architecture"
-        recommended: true
+        required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-architecture/workflow.md"
         agent: "architect"
-        command: "create-architecture"
-        output: "Integration architecture - solution design for THIS project"
-        note: "HIGHLY RECOMMENDED: Distills massive brownfield context into focused solution design. Prevents agent confusion."
-
+        command: "/bmad:bmm:workflows:create-architecture"
+        output: "System architecture document"
+        note: "Complete system design for greenfield projects"
       - id: "create-epics-and-stories"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/create-epics-and-stories/workflow.md"
         agent: "pm"
-        command: "create-epics-and-stories"
+        command: "/bmad:bmm:workflows:create-epics-and-stories"
         note: "Required: Break down PRD into implementable epics and stories with full context (PRD + UX + Architecture)"
-
       - id: "test-design"
-        recommended: true
+        optional: true
+        workflow: "{project-root}/_bmad/bmm/workflows/testarch/test-design/workflow.yaml"
         agent: "tea"
-        command: "test-design"
+        command: "/bmad:bmm:workflows:test-design"
         output: "System-level testability review"
         note: "Testability assessment before gate check - auto-detects system-level mode"
-
-      - id: "validate-architecture"
-        optional: true
-        agent: "architect"
-        command: "validate-architecture"
-
       - id: "implementation-readiness"
         required: true
+        exec: "{project-root}/_bmad/bmm/workflows/3-solutioning/check-implementation-readiness/workflow.md"
         agent: "architect"
-        command: "implementation-readiness"
+        command: "/bmad:bmm:workflows:implementation-readiness"
         note: "Validates PRD + Architecture + Epics + UX (optional)"
-
-  - phase: 3
+  - phase: 4
     name: "Implementation"
     required: true
     workflows:
       - id: "sprint-planning"
         required: true
+        workflow: "{project-root}/_bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml"
         agent: "sm"
-        command: "sprint-planning"
-        note: "Creates sprint plan with stories"
+        command: "/bmad:bmm:workflows:sprint-planning"
+        note: "Creates sprint plan - subsequent work tracked there"