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

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

@@ -0,0 +1,88 @@
+# Brownfield Level 4 - Enterprise Scale Changes to Existing System
+# 40+ stories, major expansion of existing enterprise system
+
+project_type: "software"
+level: 4
+field_type: "brownfield"
+description: "Enterprise scale expansion of existing system"
+
+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"
+    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"
+
+  - phase: 1
+    name: "Analysis"
+    required: true
+    workflows:
+      - id: "brainstorm-project"
+        recommended: true
+        agent: "analyst"
+        command: "brainstorm-project"
+      - id: "research"
+        required: true
+        agent: "analyst"
+        command: "research"
+        note: "Research existing system architecture deeply"
+      - id: "product-brief"
+        required: true
+        agent: "analyst"
+        command: "product-brief"
+        note: "Strategic brief for major expansion"
+
+  - phase: 2
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "prd"
+        required: true
+        agent: "pm"
+        command: "prd"
+        output: "Comprehensive PRD considering existing system"
+      - id: "validate-prd"
+        optional: true
+        agent: "pm"
+        command: "validate-prd"
+      - id: "create-design"
+        required: true
+        agent: "ux-designer"
+        command: "create-design"
+        note: "Multiple UI/UX specifications"
+
+  - phase: 3
+    name: "Solutioning"
+    required: true
+    workflows:
+      - id: "create-architecture"
+        required: true
+        agent: "architect"
+        command: "create-architecture"
+        output: "Architecture for system expansion"
+        note: "Must maintain backward compatibility"
+      - 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"
+
+  - phase: 4
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"

package/src/modules/bmm/workflows/workflow-status/paths/game-design.yaml

@@ -0,0 +1,75 @@
+# Game Design - All Levels
+# Game development follows a different path than software
+
+project_type: "game"
+level: "all"
+field_type: "any"
+description: "Game development workflow - applies to all complexity levels"
+
+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"
+
+  - 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"
+
+  - 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"
+
+  - phase: 4
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        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"

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

@@ -0,0 +1,45 @@
+# Greenfield Level 0 - Single Atomic Change
+# The simplest possible workflow - one change, one story
+
+project_type: "software"
+level: 0
+field_type: "greenfield"
+description: "Single atomic change - bug fix, tiny feature, one story"
+
+phases:
+  - phase: 1
+    name: "Analysis"
+    optional: true
+    workflows:
+      - id: "brainstorm-project"
+        optional: true
+        agent: "analyst"
+        command: "brainstorm-project"
+      - id: "product-brief"
+        optional: true
+        agent: "analyst"
+        command: "product-brief"
+
+  - phase: 2
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "tech-spec"
+        required: true
+        agent: "pm"
+        command: "tech-spec"
+        output: "Creates Technical Specification with single story file"
+
+  - phase: 3
+    name: "Solutioning"
+    skip: true
+
+  - phase: 4
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"

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

@@ -0,0 +1,49 @@
+# Greenfield Level 1 - Small Feature
+# Coherent feature with 2-3 stories in a single epic
+
+project_type: "software"
+level: 1
+field_type: "greenfield"
+description: "Small coherent feature - 2-3 stories, single epic"
+
+phases:
+  - phase: 1
+    name: "Analysis"
+    optional: true
+    workflows:
+      - id: "brainstorm-project"
+        optional: true
+        agent: "analyst"
+        command: "brainstorm-project"
+      - id: "research"
+        optional: true
+        agent: "analyst"
+        command: "research"
+      - id: "product-brief"
+        optional: true
+        agent: "analyst"
+        command: "product-brief"
+
+  - phase: 2
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "tech-spec"
+        required: true
+        agent: "pm"
+        command: "tech-spec"
+        output: "Creates Technical Specification with an epic and 2-3 story files"
+
+  - phase: 3
+    name: "Solutioning"
+    skip: true
+
+  - phase: 4
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"

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

@@ -0,0 +1,78 @@
+# Greenfield Level 2 - Medium Project
+# Multiple epics with 10+ stories total
+
+project_type: "software"
+level: 2
+field_type: "greenfield"
+description: "Medium project - multiple epics, 10+ stories"
+
+phases:
+  - phase: 1
+    name: "Analysis"
+    optional: true
+    workflows:
+      - id: "brainstorm-project"
+        optional: true
+        agent: "analyst"
+        command: "brainstorm-project"
+      - id: "research"
+        optional: true
+        agent: "analyst"
+        command: "research"
+        note: "Can have multiple research docs"
+      - id: "product-brief"
+        recommended: true
+        agent: "analyst"
+        command: "product-brief"
+
+  - phase: 2
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "prd"
+        required: true
+        agent: "pm"
+        command: "prd"
+        output: "Creates PRD with epics.md and story list"
+      - id: "validate-prd"
+        optional: true
+        agent: "pm"
+        command: "validate-prd"
+      - id: "create-design"
+        conditional: "if_has_ui"
+        agent: "ux-designer"
+        command: "create-design"
+      - id: "tech-spec"
+        optional: true
+        agent: "pm"
+        command: "tech-spec"
+        note: "Lightweight Technical Specification planning"
+
+  - phase: 3
+    name: "Solutioning"
+    required: true
+    workflows:
+      - id: "create-architecture"
+        required: true
+        agent: "architect"
+        command: "create-architecture"
+        output: "System-wide architecture document"
+      - id: "validate-architecture"
+        optional: true
+        agent: "architect"
+        command: "validate-architecture"
+      - id: "solutioning-gate-check"
+        required: true
+        agent: "architect"
+        command: "solutioning-gate-check"
+        note: "Validate PRD + UX + architecture cohesion before implementation"
+
+  - phase: 4
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"

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

@@ -0,0 +1,73 @@
+# Greenfield Level 3 - Complex System
+# Subsystems, integrations, architectural decisions required
+
+project_type: "software"
+level: 3
+field_type: "greenfield"
+description: "Complex system - subsystems, integrations, architectural decisions"
+
+phases:
+  - phase: 1
+    name: "Analysis"
+    optional: true
+    workflows:
+      - id: "brainstorm-project"
+        optional: true
+        agent: "analyst"
+        command: "brainstorm-project"
+      - id: "research"
+        optional: true
+        agent: "analyst"
+        command: "research"
+        note: "Multiple research areas likely"
+      - id: "product-brief"
+        recommended: true
+        agent: "analyst"
+        command: "product-brief"
+
+  - phase: 2
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "prd"
+        required: true
+        agent: "pm"
+        command: "prd"
+        output: "High-level requirements and epic definitions"
+      - id: "validate-prd"
+        optional: true
+        agent: "pm"
+        command: "validate-prd"
+      - id: "create-design"
+        conditional: "if_has_ui"
+        agent: "ux-designer"
+        command: "create-design"
+
+  - phase: 3
+    name: "Solutioning"
+    required: true
+    workflows:
+      - id: "create-architecture"
+        required: true
+        agent: "architect"
+        command: "create-architecture"
+        output: "System-wide architecture document"
+      - id: "validate-architecture"
+        optional: true
+        agent: "architect"
+        command: "validate-architecture"
+      - id: "solutioning-gate-check"
+        recommended: true
+        agent: "architect"
+        command: "solutioning-gate-check"
+        note: "Validate PRD + UX + architecture cohesion before implementation"
+
+  - phase: 4
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"

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

@@ -0,0 +1,75 @@
+# Greenfield Level 4 - Enterprise Scale
+# Multiple products, enterprise architecture, 40+ stories
+
+project_type: "software"
+level: 4
+field_type: "greenfield"
+description: "Enterprise scale - multiple products, enterprise architecture"
+
+phases:
+  - phase: 1
+    name: "Analysis"
+    required: true
+    workflows:
+      - id: "brainstorm-project"
+        recommended: true
+        agent: "analyst"
+        command: "brainstorm-project"
+      - id: "research"
+        required: false
+        agent: "analyst"
+        command: "research"
+        note: "Extensive research across multiple domains"
+      - id: "product-brief"
+        required: true
+        agent: "analyst"
+        command: "product-brief"
+        note: "Strategic brief for enterprise scope"
+
+  - phase: 2
+    name: "Planning"
+    required: true
+    workflows:
+      - id: "prd"
+        required: true
+        agent: "pm"
+        command: "prd"
+        output: "Comprehensive product requirements document"
+      - id: "validate-prd"
+        optional: true
+        agent: "pm"
+        command: "validate-prd"
+      - id: "create-design"
+        required: true
+        agent: "ux-designer"
+        command: "create-design"
+        note: "Multiple UI/UX specifications needed"
+
+  - phase: 3
+    name: "Solutioning"
+    required: true
+    workflows:
+      - id: "create-architecture"
+        required: true
+        agent: "architect"
+        command: "create-architecture"
+        output: "Enterprise architecture documentation"
+      - id: "validate-architecture"
+        optional: true
+        agent: "architect"
+        command: "validate-architecture"
+      - id: "solutioning-gate-check"
+        required: true
+        agent: "architect"
+        command: "solutioning-gate-check"
+        note: "Validate PRD + UX + architecture cohesion before implementation"
+
+  - phase: 4
+    name: "Implementation"
+    required: true
+    workflows:
+      - id: "sprint-planning"
+        required: true
+        agent: "sm"
+        command: "sprint-planning"
+        note: "Creates sprint plan with all stories - subsequent work tracked in sprint plan output, not workflow-status"

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

@@ -0,0 +1,59 @@
+# BMM Project Scale Levels - Source of Truth
+# Reference: /bmad/bmm/README.md lines 77-85
+
+levels:
+  0:
+    name: "Level 0"
+    title: "Single Atomic Change"
+    stories: "1 story"
+    description: "Bug fix, tiny feature, one small change"
+    documentation: "Minimal - tech spec only"
+    architecture: false
+
+  1:
+    name: "Level 1"
+    title: "Small Feature"
+    stories: "1-10 stories"
+    description: "Small coherent feature, minimal documentation"
+    documentation: "Tech spec"
+    architecture: false
+
+  2:
+    name: "Level 2"
+    title: "Medium Project"
+    stories: "5-15 stories"
+    description: "Multiple features, focused PRD"
+    documentation: "PRD + optional tech spec"
+    architecture: false
+
+  3:
+    name: "Level 3"
+    title: "Complex System"
+    stories: "12-40 stories"
+    description: "Subsystems, integrations, full architecture"
+    documentation: "PRD + architecture + JIT tech specs"
+    architecture: true
+
+  4:
+    name: "Level 4"
+    title: "Enterprise Scale"
+    stories: "40+ stories"
+    description: "Multiple products, enterprise architecture"
+    documentation: "PRD + architecture + JIT tech specs"
+    architecture: true
+
+# Quick detection hints for workflow-init
+detection_hints:
+  keywords:
+    level_0: ["fix", "bug", "typo", "small change", "quick update", "patch"]
+    level_1: ["simple", "basic", "small feature", "add", "minor"]
+    level_2: ["dashboard", "several features", "admin panel", "medium"]
+    level_3: ["platform", "integration", "complex", "system", "architecture"]
+    level_4: ["enterprise", "multi-tenant", "multiple products", "ecosystem", "scale"]
+
+  story_counts:
+    level_0: [1, 1]
+    level_1: [1, 10]
+    level_2: [5, 15]
+    level_3: [12, 40]
+    level_4: [40, 999]

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

@@ -0,0 +1,30 @@
+# BMM Workflow Status
+
+## Project Configuration
+
+PROJECT_NAME: {{project_name}}
+PROJECT_TYPE: {{project_type}}
+PROJECT_LEVEL: {{project_level}}
+FIELD_TYPE: {{field_type}}
+START_DATE: {{start_date}}
+WORKFLOW_PATH: {{workflow_path_file}}
+
+## Current State
+
+CURRENT_PHASE: {{current_phase}}
+CURRENT_WORKFLOW: {{current_workflow}}
+CURRENT_AGENT: {{current_agent}}
+PHASE_1_COMPLETE: {{phase_1_complete}}
+PHASE_2_COMPLETE: {{phase_2_complete}}
+PHASE_3_COMPLETE: {{phase_3_complete}}
+PHASE_4_COMPLETE: {{phase_4_complete}}
+
+## Next Action
+
+NEXT_ACTION: {{next_action}}
+NEXT_COMMAND: {{next_command}}
+NEXT_AGENT: {{next_agent}}
+
+---
+
+_Last Updated: {{last_updated}}_

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

@@ -0,0 +1,30 @@
+# Workflow Status - Master Router and Status Tracker
+name: workflow-status
+description: 'Lightweight status checker - answers "what should I do now?" for any agent. Reads simple key-value status file for instant parsing. Use workflow-init for new projects.'
+author: "BMad"
+
+# Critical variables from config
+config_source: "{project-root}/bmad/bmm/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+communication_language: "{config_source}:communication_language"
+document_output_language: "{config_source}:document_output_language"
+user_skill_level: "{config_source}:user_skill_level"
+date: system-generated
+
+# Workflow components
+installed_path: "{project-root}/bmad/bmm/workflows/workflow-status"
+instructions: "{installed_path}/instructions.md"
+
+# Template for status file creation (used by workflow-init)
+template: "{installed_path}/workflow-status-template.md"
+
+# Path definitions for project types
+path_files: "{installed_path}/paths/"
+
+# Output configuration - reads existing status
+default_output_file: "{output_folder}/bmm-workflow-status.md"
+
+standalone: true
+
+web_bundle: false

package/src/modules/cis/_module-installer/installer.js

@@ -8,7 +8,7 @@ const chalk = require('chalk');
  *
  * @param {Object} options - Installation options
  * @param {string} options.projectRoot - The root directory of the target project
- * @param {Object} options.config - Module configuration from install-menu-config.yaml
+ * @param {Object} options.config - Module configuration from install-config.yaml
  * @param {Array<string>} options.installedIDEs - Array of IDE codes that were installed
  * @param {Object} options.logger - Logger instance for output
  * @returns {Promise<boolean>} - Success status

package/src/modules/cis/agents/brainstorming-coach.agent.yaml

@@ -0,0 +1,23 @@
+# Elite Brainstorming Specialist Agent Definition
+
+agent:
+  metadata:
+    id: bmad/cis/agents/brainstorming-coach.md
+    name: Carson
+    title: Elite Brainstorming Specialist
+    icon: 🧠
+    module: cis
+
+  persona:
+    role: Master Brainstorming Facilitator + Innovation Catalyst
+    identity: Elite innovation facilitator with 20+ years leading breakthrough brainstorming sessions. Expert in creative techniques, group dynamics, and systematic innovation methodologies. Background in design thinking, creative problem-solving, and cross-industry innovation transfer.
+    communication_style: Energetic and encouraging with infectious enthusiasm for ideas. Creative yet systematic in approach. Facilitative style that builds psychological safety while maintaining productive momentum. Uses humor and play to unlock serious innovation potential.
+    principles:
+      - I cultivate psychological safety where wild ideas flourish without judgment, believing that today's seemingly silly thought often becomes tomorrow's breakthrough innovation.
+      - My facilitation blends proven methodologies with experimental techniques, bridging concepts from unrelated fields to spark novel solutions that groups couldn't reach alone.
+      - I harness the power of humor and play as serious innovation tools, meticulously recording every idea while guiding teams through systematic exploration that consistently delivers breakthrough results.
+
+  menu:
+    - trigger: brainstorm
+      workflow: "{project-root}/bmad/core/workflows/brainstorming/workflow.yaml"
+      description: Guide me through Brainstorming

package/src/modules/cis/agents/creative-problem-solver.agent.yaml

@@ -0,0 +1,23 @@
+# Master Problem Solver Agent Definition
+
+agent:
+  metadata:
+    id: bmad/cis/agents/creative-problem-solver.md
+    name: Dr. Quinn
+    title: Master Problem Solver
+    icon: 🔬
+    module: cis
+
+  persona:
+    role: Systematic Problem-Solving Expert + Solutions Architect
+    identity: Renowned problem-solving savant who has cracked impossibly complex challenges across industries - from manufacturing bottlenecks to software architecture dilemmas to organizational dysfunction. Expert in TRIZ, Theory of Constraints, Systems Thinking, and Root Cause Analysis with a mind that sees patterns invisible to others. Former aerospace engineer turned problem-solving consultant who treats every challenge as an elegant puzzle waiting to be decoded.
+    communication_style: Speaks like a detective mixed with a scientist - methodical, curious, and relentlessly logical, but with sudden flashes of creative insight delivered with childlike wonder. Uses analogies from nature, engineering, and mathematics. Asks clarifying questions with genuine fascination. Never accepts surface symptoms, always drilling toward root causes with Socratic precision. Punctuates breakthroughs with enthusiastic 'Aha!' moments and treats dead ends as valuable data points rather than failures.
+    principles:
+      - I believe every problem is a system revealing its weaknesses, and systematic exploration beats lucky guesses every time. My approach combines divergent and convergent thinking - first understanding the problem space fully before narrowing toward solutions.
+      - I trust frameworks and methodologies as scaffolding for breakthrough thinking, not straightjackets. I hunt for root causes relentlessly because solving symptoms wastes everyone's time and breeds recurring crises.
+      - I embrace constraints as creativity catalysts and view every failed solution attempt as valuable information that narrows the search space. Most importantly, I know that the right question is more valuable than a fast answer.
+
+  menu:
+    - trigger: solve
+      workflow: "{project-root}/bmad/cis/workflows/problem-solving/workflow.yaml"
+      description: Apply systematic problem-solving methodologies