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

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

@@ -0,0 +1,120 @@
+# BMad Enterprise Method - Brownfield
+# Extended enterprise planning for complex brownfield with security/devops/test (30+ stories typically)
+
+method_name: "BMad Enterprise Method"
+track: "enterprise"
+field_type: "brownfield"
+description: "Enterprise-grade planning for complex brownfield additions with extended requirements"
+
+phases:
+  - prerequisite: true
+    name: "Documentation"
+    conditional: "if_undocumented"
+    note: "NOT a phase - prerequisite for brownfield without docs (nearly mandatory for enterprise)"
+    workflows:
+      - id: "document-project"
+        required: true
+        agent: "analyst"
+        command: "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"
+    workflows:
+      - id: "brainstorm-project"
+        optional: true
+        agent: "analyst"
+        command: "brainstorm-project"
+        included_by: "user_choice"
+
+      - id: "research"
+        recommended: true
+        agent: "analyst"
+        command: "research"
+        included_by: "user_choice"
+        note: "Highly recommended - compliance, integration, risk research"
+
+      - id: "product-brief"
+        optional: true
+        agent: "analyst"
+        command: "product-brief"
+        included_by: "user_choice"
+        note: "Optional for brownfield enterprise"
+
+  - phase: 1
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "prd"
+        required: true
+        agent: "pm"
+        command: "prd"
+        output: "Enterprise PRD with compliance requirements"
+        note: "Must address existing system constraints and migration strategy"
+
+      - id: "validate-prd"
+        recommended: true
+        agent: "pm"
+        command: "validate-prd"
+
+      - id: "create-design"
+        recommended: true
+        agent: "ux-designer"
+        command: "create-design"
+        note: "Recommended - must integrate with existing UX patterns"
+
+  - phase: 2
+    name: "Solutioning"
+    required: true
+    workflows:
+      - id: "create-architecture"
+        required: true
+        agent: "architect"
+        command: "create-architecture"
+        output: "Integration architecture with enterprise considerations"
+        note: "Distills brownfield context + adds security/scalability/compliance design"
+
+      - id: "create-security-architecture"
+        required: true
+        agent: "architect"
+        command: "create-security-architecture"
+        output: "Security architecture for brownfield integration"
+        note: "Future workflow - threat model, auth integration, audit requirements"
+
+      - id: "create-devops-strategy"
+        required: true
+        agent: "architect"
+        command: "create-devops-strategy"
+        output: "DevOps strategy for brownfield deployment"
+        note: "Future workflow - CI/CD integration, deployment strategy, monitoring"
+
+      - id: "create-test-strategy"
+        required: true
+        agent: "tea"
+        command: "create-test-strategy"
+        output: "Test strategy including regression testing"
+        note: "Future workflow - critical for brownfield to prevent breaking existing functionality"
+
+      - id: "validate-architecture"
+        optional: true
+        agent: "architect"
+        command: "validate-architecture"
+
+      - id: "solutioning-gate-check"
+        required: true
+        agent: "architect"
+        command: "solutioning-gate-check"
+        note: "Critical gate - validates all planning before touching production system"
+
+  - phase: 3
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Enterprise brownfield requires careful phasing and feature flags"

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

@@ -0,0 +1,108 @@
+# BMad Enterprise Method - Greenfield
+# Extended enterprise planning with security/devops/test for greenfield (30+ stories typically)
+
+method_name: "BMad Enterprise Method"
+track: "enterprise"
+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"
+    workflows:
+      - id: "brainstorm-project"
+        optional: true
+        agent: "analyst"
+        command: "brainstorm-project"
+        included_by: "user_choice"
+
+      - id: "research"
+        recommended: true
+        agent: "analyst"
+        command: "research"
+        included_by: "user_choice"
+        note: "Highly recommended for enterprise - domain and compliance research"
+
+      - id: "product-brief"
+        recommended: true
+        agent: "analyst"
+        command: "product-brief"
+        included_by: "user_choice"
+        note: "Recommended for strategic alignment"
+
+  - phase: 1
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "prd"
+        required: true
+        agent: "pm"
+        command: "prd"
+        output: "Comprehensive Product Requirements Document"
+        note: "Enterprise-level requirements with compliance considerations"
+
+      - id: "validate-prd"
+        recommended: true
+        agent: "pm"
+        command: "validate-prd"
+
+      - id: "create-design"
+        recommended: true
+        agent: "ux-designer"
+        command: "create-design"
+        note: "Highly recommended for enterprise - design system and patterns"
+
+  - phase: 2
+    name: "Solutioning"
+    required: true
+    workflows:
+      - id: "create-architecture"
+        required: true
+        agent: "architect"
+        command: "create-architecture"
+        output: "Enterprise-grade system architecture"
+        note: "Includes scalability, multi-tenancy, integration architecture"
+
+      - id: "create-security-architecture"
+        required: true
+        agent: "architect"
+        command: "create-security-architecture"
+        output: "Security architecture and threat model"
+        note: "Future workflow - security design, auth, compliance"
+
+      - id: "create-devops-strategy"
+        required: true
+        agent: "architect"
+        command: "create-devops-strategy"
+        output: "DevOps pipeline and infrastructure plan"
+        note: "Future workflow - CI/CD, deployment, monitoring"
+
+      - id: "create-test-strategy"
+        required: true
+        agent: "tea"
+        command: "create-test-strategy"
+        output: "Comprehensive test strategy"
+        note: "Future workflow - test approach, automation, quality gates"
+
+      - id: "validate-architecture"
+        optional: true
+        agent: "architect"
+        command: "validate-architecture"
+
+      - id: "solutioning-gate-check"
+        required: true
+        agent: "architect"
+        command: "solutioning-gate-check"
+        note: "Validates all planning artifacts align before implementation"
+
+  - phase: 3
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Creates sprint plan - enterprise projects may require phased rollout"

package/src/modules/bmm/workflows/workflow-status/paths/{brownfield-level-4.yaml → method-brownfield.yaml}

@@ -1,44 +1,49 @@
-# Brownfield Level 4 - Enterprise Scale Changes to Existing System
-# 40+ stories, major expansion of existing enterprise system
+# BMad Method - Brownfield
+# Full product + architecture planning for complex brownfield additions (10-50+ stories typically)
 
-project_type: "software"
-level: 4
+method_name: "BMad Method"
+track: "method"
 field_type: "brownfield"
-description: "Enterprise scale expansion of existing system"
+description: "Complete product and system design for complex brownfield work"
 
 phases:
   - prerequisite: true
     name: "Documentation"
     conditional: "if_undocumented"
-    note: "NOT a phase - prerequisite for brownfield without docs OR post-completion cleanup. Critical for enterprise-scale changes"
+    note: "NOT a phase - prerequisite for brownfield without docs"
     workflows:
       - id: "document-project"
         required: true
         agent: "analyst"
         command: "document-project"
         output: "Comprehensive project documentation"
-        purpose: "Understand existing codebase before planning OR create superior final docs after Phase 4"
+        purpose: "Understand existing codebase before planning"
 
-  - phase: 1
-    name: "Analysis"
-    required: true
+  - phase: 0
+    name: "Discovery (Optional)"
+    optional: true
+    note: "User-selected during workflow-init"
     workflows:
       - id: "brainstorm-project"
-        recommended: true
+        optional: true
         agent: "analyst"
         command: "brainstorm-project"
+        included_by: "user_choice"
+
       - id: "research"
-        required: true
+        optional: true
         agent: "analyst"
         command: "research"
-        note: "Research existing system architecture deeply"
+        included_by: "user_choice"
+
       - id: "product-brief"
-        required: true
+        optional: true
         agent: "analyst"
         command: "product-brief"
-        note: "Strategic brief for major expansion"
+        included_by: "user_choice"
+        note: "Optional for brownfield, less common than greenfield"
 
-  - phase: 2
+  - phase: 1
     name: "Planning"
     required: true
     workflows:
@@ -46,38 +51,42 @@ phases:
         required: true
         agent: "pm"
         command: "prd"
-        output: "Comprehensive PRD considering existing system"
+        output: "PRD focused on new features/changes"
+        note: "Must consider existing system constraints"
+
       - id: "validate-prd"
         optional: true
         agent: "pm"
         command: "validate-prd"
+
       - id: "create-design"
-        required: true
+        conditional: "if_has_ui"
         agent: "ux-designer"
         command: "create-design"
-        note: "Multiple UI/UX specifications"
 
-  - phase: 3
+  - phase: 2
     name: "Solutioning"
     required: true
     workflows:
       - id: "create-architecture"
-        required: true
+        recommended: true
         agent: "architect"
         command: "create-architecture"
-        output: "Architecture for system expansion"
-        note: "Must maintain backward compatibility"
+        output: "Integration architecture - solution design for THIS project"
+        note: "HIGHLY RECOMMENDED: Distills massive brownfield context into focused solution design. Prevents agent confusion."
+
       - id: "validate-architecture"
         optional: true
         agent: "architect"
         command: "validate-architecture"
+
       - id: "solutioning-gate-check"
         required: true
         agent: "architect"
         command: "solutioning-gate-check"
-        note: "Critical validation before major changes"
+        note: "Validates PRD + UX + Architecture (if created) cohesion"
 
-  - phase: 4
+  - phase: 3
     name: "Implementation"
     required: true
     workflows:
@@ -85,4 +94,4 @@ phases:
         required: true
         agent: "sm"
         command: "sprint-planning"
-        note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
+        note: "Creates sprint plan with stories"

package/src/modules/bmm/workflows/workflow-status/paths/{greenfield-level-3.yaml → method-greenfield.yaml}

@@ -1,31 +1,38 @@
-# Greenfield Level 3 - Complex System
-# Subsystems, integrations, architectural decisions required
+# BMad Method - Greenfield
+# Full product + architecture planning for greenfield projects (10-50+ stories typically)
 
-project_type: "software"
-level: 3
+method_name: "BMad Method"
+track: "method"
 field_type: "greenfield"
-description: "Complex system - subsystems, integrations, architectural decisions"
+description: "Complete product and system design methodology for greenfield projects"
 
 phases:
-  - phase: 1
-    name: "Analysis"
+  - phase: 0
+    name: "Discovery (Optional)"
     optional: true
+    note: "User-selected during workflow-init"
     workflows:
       - id: "brainstorm-project"
         optional: true
         agent: "analyst"
         command: "brainstorm-project"
+        included_by: "user_choice"
+
       - id: "research"
         optional: true
         agent: "analyst"
         command: "research"
-        note: "Multiple research areas likely"
+        included_by: "user_choice"
+        note: "Can have multiple research workflows"
+
       - id: "product-brief"
-        recommended: true
+        optional: true
         agent: "analyst"
         command: "product-brief"
+        included_by: "user_choice"
+        note: "Recommended for greenfield Method projects"
 
-  - phase: 2
+  - phase: 1
     name: "Planning"
     required: true
     workflows:
@@ -33,17 +40,21 @@ phases:
         required: true
         agent: "pm"
         command: "prd"
-        output: "High-level requirements and epic definitions"
+        output: "Product Requirements Document with epics and stories"
+
       - id: "validate-prd"
         optional: true
         agent: "pm"
         command: "validate-prd"
+        note: "Quality check for PRD completeness"
+
       - id: "create-design"
         conditional: "if_has_ui"
         agent: "ux-designer"
         command: "create-design"
+        note: "Determined after PRD - user/agent decides if needed"
 
-  - phase: 3
+  - phase: 2
     name: "Solutioning"
     required: true
     workflows:
@@ -51,18 +62,22 @@ phases:
         required: true
         agent: "architect"
         command: "create-architecture"
-        output: "System-wide architecture document"
+        output: "System architecture document"
+        note: "Complete system design for greenfield projects"
+
       - id: "validate-architecture"
         optional: true
         agent: "architect"
         command: "validate-architecture"
+        note: "Quality check for architecture completeness"
+
       - id: "solutioning-gate-check"
-        recommended: true
+        required: true
         agent: "architect"
         command: "solutioning-gate-check"
-        note: "Validate PRD + UX + architecture cohesion before implementation"
+        note: "Validates PRD + UX + Architecture cohesion before implementation"
 
-  - phase: 4
+  - phase: 3
     name: "Implementation"
     required: true
     workflows:
@@ -70,4 +85,4 @@ phases:
         required: true
         agent: "sm"
         command: "sprint-planning"
-        note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
+        note: "Creates sprint plan - subsequent work tracked there"

package/src/modules/bmm/workflows/workflow-status/paths/{brownfield-level-0.yaml → quick-flow-brownfield.yaml}

@@ -1,49 +1,53 @@
-# Brownfield Level 0 - Single Atomic Change in Existing Codebase
-# One change to existing system
+# BMad Quick Flow - Brownfield
+# Fast implementation path for existing codebases (1-15 stories typically)
 
-project_type: "software"
-level: 0
+method_name: "BMad Quick Flow"
+track: "quick-flow"
 field_type: "brownfield"
-description: "Single atomic change to existing codebase"
+description: "Fast tech-spec based implementation for brownfield projects"
 
 phases:
   - prerequisite: true
     name: "Documentation"
     conditional: "if_undocumented"
-    note: "NOT a phase - prerequisite for brownfield without docs OR post-completion cleanup"
+    note: "NOT a phase - prerequisite for brownfield without docs"
     workflows:
       - id: "document-project"
         required: true
         agent: "analyst"
         command: "document-project"
         output: "Comprehensive project documentation"
-        purpose: "Understand existing codebase before planning OR create superior final docs after Phase 4"
+        purpose: "Understand existing codebase before planning"
 
-  - phase: 1
-    name: "Analysis"
+  - phase: 0
+    name: "Discovery (Optional)"
     optional: true
+    note: "User-selected during workflow-init"
     workflows:
       - id: "brainstorm-project"
         optional: true
         agent: "analyst"
         command: "brainstorm-project"
+        included_by: "user_choice"
 
-  - phase: 2
+      - id: "research"
+        optional: true
+        agent: "analyst"
+        command: "research"
+        included_by: "user_choice"
+
+  - phase: 1
     name: "Planning"
     required: true
     workflows:
       - id: "tech-spec"
         required: true
-        agent: "architect"
+        agent: "pm"
         command: "tech-spec"
-        output: "Creates single story file"
-        note: "Must understand existing patterns"
+        output: "Technical Specification with stories (auto-detects epic if 2+ stories)"
+        note: "Integrates with existing codebase patterns from document-project"
 
-  - phase: 3
-    name: "Solutioning"
-    skip: true
-
-  - phase: 4
+  - phase: 2
     name: "Implementation"
     required: true
     workflows:
@@ -51,4 +55,4 @@ phases:
         required: true
         agent: "sm"
         command: "sprint-planning"
-        note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
+        note: "Creates sprint plan with all stories"

package/src/modules/bmm/workflows/workflow-status/paths/{greenfield-level-0.yaml → quick-flow-greenfield.yaml}

@@ -1,26 +1,31 @@
-# Greenfield Level 0 - Single Atomic Change
-# The simplest possible workflow - one change, one story
+# BMad Quick Flow - Greenfield
+# Fast implementation path with tech-spec planning (1-15 stories typically)
 
-project_type: "software"
-level: 0
+method_name: "BMad Quick Flow"
+track: "quick-flow"
 field_type: "greenfield"
-description: "Single atomic change - bug fix, tiny feature, one story"
+description: "Fast tech-spec based implementation for greenfield projects"
 
 phases:
-  - phase: 1
-    name: "Analysis"
+  - phase: 0
+    name: "Discovery (Optional)"
     optional: true
+    note: "User-selected during workflow-init"
     workflows:
       - id: "brainstorm-project"
         optional: true
         agent: "analyst"
         command: "brainstorm-project"
-      - id: "product-brief"
+        included_by: "user_choice"
+
+      - id: "research"
         optional: true
         agent: "analyst"
-        command: "product-brief"
+        command: "research"
+        included_by: "user_choice"
+        note: "Can have multiple research workflows"
 
-  - phase: 2
+  - phase: 1
     name: "Planning"
     required: true
     workflows:
@@ -28,13 +33,10 @@ phases:
         required: true
         agent: "pm"
         command: "tech-spec"
-        output: "Creates Technical Specification with single story file"
-
-  - phase: 3
-    name: "Solutioning"
-    skip: true
+        output: "Technical Specification with stories (auto-detects epic if 2+ stories)"
+        note: "Quick Spec Flow - implementation-focused planning"
 
-  - phase: 4
+  - phase: 2
     name: "Implementation"
     required: true
     workflows:

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

@@ -1,11 +1,11 @@
 # Workflow Status Template
-# This tracks progress through phases 1-3 of the BMM methodology
-# Phase 4 (Implementation) is tracked separately in sprint-status.yaml
+# This tracks progress through BMM methodology phases
+# Phase 3/4 (Implementation) is tracked separately in sprint-status.yaml
 
 # generated: {{generated}}
 # project: {{project_name}}
 # project_type: {{project_type}}
-# project_level: {{project_level}}
+# selected_track: {{selected_track}}
 # field_type: {{field_type}}
 # workflow_path: {{workflow_path_file}}
 
@@ -24,7 +24,7 @@
 generated: "{{generated}}"
 project: "{{project_name}}"
 project_type: "{{project_type}}"
-project_level: "{{project_level}}"
+selected_track: "{{selected_track}}"
 field_type: "{{field_type}}"
 workflow_path: "{{workflow_path_file}}"
 

package/tools/cli/commands/install.js

@@ -61,7 +61,7 @@ module.exports = {
           chalk.bold(result.path || path.resolve(config.directory, 'bmad')),
         );
         console.log(chalk.yellow('\nThank you for helping test the early release version of the new BMad Core and BMad Method!'));
-        console.log(chalk.cyan('Check docs/alpha-release-notes.md in this repository for important information.'));
+        console.log(chalk.cyan('Stable Beta coming soon - please read the full readme.md and linked documentation to get started!'));
         process.exit(0);
       }
     } catch (error) {