bmad-method 6.0.0-alpha.1 → 6.0.0-alpha.10

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

@@ -0,0 +1,126 @@
+# BMad Enterprise Method - Greenfield
+# Extended enterprise planning with security/devops/test for greenfield (30+ stories typically)
+
+method_name: "Enterprise BMad Method"
+track: "enterprise-bmad-method"
+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-epics-and-stories"
+        optional: true
+        agent: "pm"
+        command: "create-epics-and-stories"
+        note: "Optional: Create epic breakdown early (basic structure only)"
+
+      - id: "create-design"
+        recommended: true
+        agent: "ux-designer"
+        command: "create-design"
+        note: "Highly recommended for enterprise - design system and patterns"
+
+      - id: "create-epics-and-stories-after-ux"
+        optional: true
+        agent: "pm"
+        command: "create-epics-and-stories"
+        note: "Optional: Create epic breakdown with UX context"
+
+  - 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: "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"
+
+      - id: "create-epics-and-stories-final"
+        required: true
+        agent: "pm"
+        command: "create-epics-and-stories"
+        note: "Required: Create final epic breakdown with full context (PRD + UX + Architecture)"
+
+      - id: "implementation-readiness"
+        required: true
+        agent: "architect"
+        command: "implementation-readiness"
+        note: "Validates all planning artifacts + Epics + testability 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/game-design.yaml

@@ -1,75 +1,52 @@
-# Game Design - All Levels
-# Game development follows a different path than software
+# Game Development - Use BMGD Module
+# Game development workflows have been moved to the BMad Game Development module
 
 project_type: "game"
 level: "all"
 field_type: "any"
-description: "Game development workflow - applies to all complexity levels"
+description: "⚠️ Game development requires the BMGD module"
 
-phases:
-  - phase: 1
-    name: "Analysis"
-    optional: true
-    workflows:
-      - id: "brainstorm-game"
-        optional: true
-        agent: "game-designer"
-        command: "brainstorm-game"
-      - id: "research"
-        optional: true
-        agent: "analyst"
-        command: "research"
-        note: "Market research, competitive analysis"
-      - id: "game-brief"
-        recommended: true
-        agent: "game-designer"
-        command: "game-brief"
-        output: "Game concept and vision document"
+error_message: |
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-  - phase: 2
-    name: "Planning"
-    required: true
-    workflows:
-      - id: "gdd"
-        required: true
-        agent: "pm"
-        command: "gdd"
-        output: "Game Design Document with features and mechanics"
-      - id: "tech-spec"
-        conditional: "if_level_0_1"
-        agent: "architect"
-        command: "tech-spec"
-        note: "For simpler games, jump to implementation"
+  🎮 **GAME DEVELOPMENT DETECTED**
 
-  - phase: 3
-    name: "Solutioning"
-    conditional: "if_level_3_4"
-    workflows:
-      - id: "create-architecture"
-        required: true
-        agent: "architect"
-        command: "create-architecture"
-        note: "Engine architecture, networking, systems"
-      - id: "validate-architecture"
-        optional: true
-        agent: "architect"
-        command: "validate-architecture"
-      - id: "solutioning-gate-check"
-        required: true
-        agent: "architect"
-        command: "solutioning-gate-check"
+  Game development workflows are now part of the **BMad Game Development (BMGD)** module,
+  which provides specialized workflows and agents for game creation.
+
+  **To proceed with game development:**
 
-  - phase: 4
-    name: "Implementation"
-    required: true
+  1. Install the BMGD module:
+     ```bash
+     bmad install bmgd
+     ```
+
+  2. The BMGD module includes:
+     - Game Designer, Game Developer, Game Architect agents
+     - Game Dev Scrum Master for sprint coordination
+     - Industry-standard game dev workflows:
+       • Phase 1 (Preproduction): brainstorm-game, game-brief
+       • Phase 2 (Design): GDD, narrative design
+       • Phase 3 (Technical): game architecture
+       • Phase 4 (Production): sprint planning, story management
+
+  3. After installation, load the Game Designer or Game Dev Scrum Master agent
+     to begin your game development workflow
+
+  **Why a separate module?**
+  - Game development follows different phases than software development
+  - Specialized agents understand game-specific terminology and patterns
+  - Workflows configured for game development needs (playtesting, balancing, etc.)
+  - Can be used standalone or alongside BMM for complete coverage
+
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+# Placeholder phases - this file should not be used for actual workflow tracking
+# Users should install BMGD module instead
+phases:
+  - phase: 1
+    name: "ERROR - Install BMGD Module"
     workflows:
-      - id: "sprint-planning"
+      - id: "install-bmgd"
         required: true
-        agent: "sm"
-        command: "sprint-planning"
-        note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"
-
-special_considerations:
-  - "Iterative playtesting throughout development"
-  - "Art and audio pipelines run parallel to code"
-  - "Balance and tuning as ongoing process"
+        note: "Run: bmad install bmgd"

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

@@ -0,0 +1,122 @@
+# BMad Method - Brownfield
+# Full product + architecture planning for complex brownfield additions (10-50+ stories typically)
+
+method_name: "BMad Method"
+track: "bmad-method"
+field_type: "brownfield"
+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"
+    workflows:
+      - id: "document-project"
+        required: true
+        agent: "analyst"
+        command: "document-project"
+        output: "Comprehensive project documentation"
+        purpose: "Understand existing codebase before planning"
+
+  - 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"
+        included_by: "user_choice"
+
+      - id: "product-brief"
+        optional: true
+        agent: "analyst"
+        command: "product-brief"
+        included_by: "user_choice"
+        note: "Optional for brownfield, less common than greenfield"
+
+  - phase: 1
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "prd"
+        required: true
+        agent: "pm"
+        command: "prd"
+        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-epics-and-stories"
+        optional: true
+        agent: "pm"
+        command: "create-epics-and-stories"
+        note: "Optional: Create epic breakdown early (basic structure only)"
+
+      - id: "create-design"
+        conditional: "if_has_ui"
+        agent: "ux-designer"
+        command: "create-design"
+
+      - id: "create-epics-and-stories-after-ux"
+        optional: true
+        agent: "pm"
+        command: "create-epics-and-stories"
+        note: "Optional: Create epic breakdown with UX context"
+
+  - phase: 2
+    name: "Solutioning"
+    required: true
+    workflows:
+      - id: "create-architecture"
+        recommended: true
+        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."
+
+      - id: "create-epics-and-stories-final"
+        required: true
+        agent: "pm"
+        command: "create-epics-and-stories"
+        note: "Required: Create final epic breakdown with full context (PRD + UX + Architecture)"
+
+      - id: "test-design"
+        recommended: true
+        agent: "tea"
+        command: "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
+        agent: "architect"
+        command: "implementation-readiness"
+        note: "Validates PRD + UX + Architecture + Epics cohesion before implementation"
+
+  - phase: 3
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Creates sprint plan with stories"

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

@@ -0,0 +1,113 @@
+# BMad Method - Greenfield
+# Full product + architecture planning for greenfield projects (10-50+ stories typically)
+
+method_name: "BMad Method"
+track: "bmad-method"
+field_type: "greenfield"
+description: "Complete product and system design methodology for greenfield projects"
+
+phases:
+  - 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"
+        included_by: "user_choice"
+        note: "Can have multiple research workflows"
+
+      - id: "product-brief"
+        optional: true
+        agent: "analyst"
+        command: "product-brief"
+        included_by: "user_choice"
+        note: "Recommended for greenfield Method projects"
+
+  - phase: 1
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "prd"
+        required: true
+        agent: "pm"
+        command: "prd"
+        output: "Product Requirements Document with FRs and NFRs"
+
+      - id: "validate-prd"
+        optional: true
+        agent: "pm"
+        command: "validate-prd"
+        note: "Quality check for PRD completeness"
+
+      - id: "create-epics-and-stories"
+        optional: true
+        agent: "pm"
+        command: "create-epics-and-stories"
+        note: "Optional: Create epic breakdown early (basic structure only)"
+
+      - id: "create-design"
+        conditional: "if_has_ui"
+        agent: "ux-designer"
+        command: "create-design"
+        note: "Determined after PRD - user/agent decides if needed"
+
+      - id: "create-epics-and-stories-after-ux"
+        optional: true
+        agent: "pm"
+        command: "create-epics-and-stories"
+        note: "Optional: Create epic breakdown with UX context"
+
+  - phase: 2
+    name: "Solutioning"
+    required: true
+    workflows:
+      - id: "create-architecture"
+        required: true
+        agent: "architect"
+        command: "create-architecture"
+        output: "System architecture document"
+        note: "Complete system design for greenfield projects"
+
+      - id: "create-epics-and-stories-final"
+        required: true
+        agent: "pm"
+        command: "create-epics-and-stories"
+        note: "Required: Create final epic breakdown with full context (PRD + UX + Architecture)"
+
+      - id: "test-design"
+        recommended: true
+        agent: "tea"
+        command: "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"
+        note: "Quality check for architecture completeness"
+
+      - id: "implementation-readiness"
+        required: true
+        agent: "architect"
+        command: "implementation-readiness"
+        note: "Validates PRD + UX + Architecture + Epics + Testability cohesion before implementation"
+
+  - phase: 3
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Creates sprint plan - subsequent work tracked there"

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

@@ -1,38 +1,42 @@
-# Brownfield Level 1 - Small Feature in Existing Codebase
-# 1-10 stories adding to existing system
+# BMad Quick Flow - Brownfield
+# Fast implementation path for existing codebases (1-15 stories typically)
 
-project_type: "software"
-level: 1
+method_name: "BMad Quick Flow"
+track: "quick-flow"
 field_type: "brownfield"
-description: "Small feature addition 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"
+
       - id: "research"
         optional: true
         agent: "analyst"
         command: "research"
+        included_by: "user_choice"
 
-  - phase: 2
+  - phase: 1
     name: "Planning"
     required: true
     workflows:
@@ -40,14 +44,10 @@ phases:
         required: true
         agent: "pm"
         command: "tech-spec"
-        output: "Creates story files for feature"
-        note: "Must integrate with existing architecture"
-
-  - phase: 3
-    name: "Solutioning"
-    skip: true
+        output: "Technical Specification with stories (auto-detects epic if 2+ stories)"
+        note: "Integrates with existing codebase patterns from document-project"
 
-  - phase: 4
+  - phase: 2
     name: "Implementation"
     required: true
     workflows:
@@ -55,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-1.yaml → quick-flow-greenfield.yaml}

@@ -1,30 +1,31 @@
-# Greenfield Level 1 - Small Feature
-# Coherent feature with 2-3 stories in a single epic
+# BMad Quick Flow - Greenfield
+# Fast implementation path with tech-spec planning (1-15 stories typically)
 
-project_type: "software"
-level: 1
+method_name: "BMad Quick Flow"
+track: "quick-flow"
 field_type: "greenfield"
-description: "Small coherent feature - 2-3 stories, single epic"
+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"
+        included_by: "user_choice"
+
       - id: "research"
         optional: true
         agent: "analyst"
         command: "research"
-      - id: "product-brief"
-        optional: true
-        agent: "analyst"
-        command: "product-brief"
+        included_by: "user_choice"
+        note: "Can have multiple research workflows"
 
-  - phase: 2
+  - phase: 1
     name: "Planning"
     required: true
     workflows:
@@ -32,13 +33,10 @@ phases:
         required: true
         agent: "pm"
         command: "tech-spec"
-        output: "Creates Technical Specification with an epic and 2-3 story files"
+        output: "Technical Specification with stories (auto-detects epic if 2+ stories)"
+        note: "Quick Spec Flow - implementation-focused planning"
 
-  - phase: 3
-    name: "Solutioning"
-    skip: true
-
-  - phase: 4
+  - phase: 2
     name: "Implementation"
     required: true
     workflows:

package/src/modules/bmm/workflows/workflow-status/project-levels.yaml

@@ -1,5 +1,5 @@
 # BMM Project Scale Levels - Source of Truth
-# Reference: /bmad/bmm/README.md lines 77-85
+# Reference: /{bmad_folder}/bmm/README.md lines 77-85
 
 levels:
   0:

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

@@ -0,0 +1,24 @@
+# Workflow Status Template
+
+# This tracks progress through BMM methodology Analysis, Planning, and Solutioning phases.
+# Implementation phase is tracked separately in sprint-status.yaml
+
+# STATUS DEFINITIONS:
+# ==================
+# Initial Status (before completion):
+#   - required: Must be completed to progress
+#   - optional: Can be completed but not required
+#   - recommended: Strongly suggested but not required
+#   - conditional: Required only if certain conditions met (e.g., if_has_ui)
+#
+# Completion Status:
+#   - {file-path}: File created/found (e.g., "docs/product-brief.md")
+#   - skipped: Optional/conditional workflow that was skipped
+
+generated: "{{generated}}"
+project: "{{project_name}}"
+project_type: "{{project_type}}"
+selected_track: "{{selected_track}}"
+field_type: "{{field_type}}"
+workflow_path: "{{workflow_path_file}}"
+workflow_status: "{{workflow_items}}"