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

package/bmad/_cfg/task-manifest.csv

@@ -4,4 +4,7 @@ name,displayName,description,module,path,standalone
 "validate-workflow","Validate Workflow Output","Run a checklist against a document with thorough analysis and produce a validation report","core","bmad/core/tasks/validate-workflow.xml","false"
 "workflow","Execute Workflow","Execute given workflow by loading its configuration, following instructions, and producing output","core","bmad/core/tasks/workflow.xml","false"
 "daily-standup","Daily Standup","","bmm","bmad/bmm/tasks/daily-standup.xml","false"
-"retrospective","Team Retrospective","","bmm","bmad/bmm/tasks/retrospective.xml","false"
+"adv-elicit","Advanced Elicitation","When called from workflow","core","bmad/core/tasks/adv-elicit.xml","false"
+"index-docs","Index Docs","Generates or updates an index.md of all documents in the specified directory","core","bmad/core/tasks/index-docs.xml","true"
+"validate-workflow","Validate Workflow Output","Run a checklist against a document with thorough analysis and produce a validation report","core","bmad/core/tasks/validate-workflow.xml","false"
+"workflow","Execute Workflow","Execute given workflow by loading its configuration, following instructions, and producing output","core","bmad/core/tasks/workflow.xml","false"

package/bmad/_cfg/tool-manifest.csv

@@ -1,2 +1,3 @@
 name,displayName,description,module,path,standalone
 "shard-doc","Shard Document","Splits large markdown documents into smaller, organized files based on level 2 (default) sections","core","bmad/core/tools/shard-doc.xml","true"
+"shard-doc","Shard Document","Splits large markdown documents into smaller, organized files based on level 2 (default) sections","core","bmad/core/tools/shard-doc.xml","true"

package/bmad/_cfg/workflow-manifest.csv

@@ -25,7 +25,7 @@ name,description,module,path,standalone
 "correct-course","Navigate significant changes during sprint execution by analyzing impact, proposing solutions, and routing for implementation","bmm","bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml","true"
 "create-story","Create the next user story markdown from epics/PRD and architecture, using a standard template and saving to the stories folder","bmm","bmad/bmm/workflows/4-implementation/create-story/workflow.yaml","true"
 "dev-story","Execute a story by implementing tasks/subtasks, writing tests, validating, and updating the story file per acceptance criteria","bmm","bmad/bmm/workflows/4-implementation/dev-story/workflow.yaml","true"
-"tech-spec","Generate a comprehensive Technical Specification from PRD and Architecture with acceptance criteria and traceability mapping","bmm","bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml","true"
+"epic-tech-context","Generate a comprehensive Technical Specification from PRD and Architecture with acceptance criteria and traceability mapping","bmm","bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml","true"
 "retrospective","Run after epic completion to review overall success, extract lessons learned, and explore if new information emerged that might impact the next epic","bmm","bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml","true"
 "sprint-planning","Generate and manage the sprint status tracking file for Phase 4 implementation, extracting all epics and stories from epic files and tracking their status through the development lifecycle","bmm","bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml","true"
 "story-context","Assemble a dynamic Story Context XML by pulling latest documentation and existing code/library artifacts relevant to a drafted story","bmm","bmad/bmm/workflows/4-implementation/story-context/workflow.yaml","true"
@@ -46,3 +46,5 @@ name,description,module,path,standalone
 "innovation-strategy","Identify disruption opportunities and architect business model innovation. This workflow guides strategic analysis of markets, competitive dynamics, and business model innovation to uncover sustainable competitive advantages and breakthrough opportunities.","cis","bmad/cis/workflows/innovation-strategy/workflow.yaml","true"
 "problem-solving","Apply systematic problem-solving methodologies to crack complex challenges. This workflow guides through problem diagnosis, root cause analysis, creative solution generation, evaluation, and implementation planning using proven frameworks.","cis","bmad/cis/workflows/problem-solving/workflow.yaml","true"
 "storytelling","Craft compelling narratives using proven story frameworks and techniques. This workflow guides users through structured narrative development, applying appropriate story frameworks to create emotionally resonant and engaging stories for any purpose.","cis","bmad/cis/workflows/storytelling/workflow.yaml","true"
+"brainstorming","Facilitate interactive brainstorming sessions using diverse creative techniques. This workflow facilitates interactive brainstorming sessions using diverse creative techniques. The session is highly interactive, with the AI acting as a facilitator to guide the user through various ideation methods to generate and refine creative solutions.","core","bmad/core/workflows/brainstorming/workflow.yaml","true"
+"party-mode","Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations","core","bmad/core/workflows/party-mode/workflow.yaml","true"

package/bmad/bmb/config.yaml

@@ -1,7 +1,7 @@
 # BMB Module Configuration
 # Generated by BMAD installer
-# Version: 6.0.0-alpha.3
-# Date: 2025-11-02T21:29:37.672Z
+# Version: 6.0.0-alpha.4
+# Date: 2025-11-04T02:59:22.715Z
 
 custom_agent_location: "{project-root}/bmad/agents"
 custom_workflow_location: "{project-root}/bmad/workflows"

package/bmad/bmb/workflows/audit-workflow/instructions.md

@@ -161,7 +161,7 @@
     <action if="condition met">Do something</action>
     ```
 
-    <action>Scan instructions.md for nested tag references using pattern: &lt;(action|ask|check|template-output|invoke-workflow|goto|step|elicit-required)&gt; within text content</action>
+    <action>Scan instructions.md for nested tag references using pattern: &lt;(action|ask|check|template-output|invoke-workflow|invoke-task|goto|step)&gt; within text content
     <action>Record any instances of nested tag references with line numbers</action>
     <action>Scan instructions.md for conditional execution antipattern: self-closing check tags</action>
     <action>Detect pattern: `&lt;check&gt;.*&lt;/check&gt;` on single line (self-closing check)</action>

package/bmad/bmm/README.md

@@ -2,168 +2,127 @@
 
 Core orchestration system for AI-driven agile development, providing comprehensive lifecycle management through specialized agents and workflows.
 
-## Table of Contents
-
-- [Essential Reading](#essential-reading)
-- [Documentation](#documentation)
-- [Module Structure](#module-structure)
-- [Quick Start](#quick-start)
-- [Key Concepts](#key-concepts)
-- [Scale Levels](#scale-levels)
-- [Story Lifecycle](#story-lifecycle)
-- [Best Practices](#best-practices)
-
-## Essential Reading
-
-**[📖 BMM v6 Workflows Guide](./workflows/README.md)** - Required reading before using BMM. Explains the revolutionary workflow system and component integration.
-
-## Documentation
-
-All BMM-specific documentation is organized in the `docs/` folder:
-
-### Getting Started
-
-- **[Quick Start Guide](./docs/quick-start.md)** - Step-by-step guide to building your first project with BMM
-- **[Quick Spec Flow](./docs/quick-spec-flow.md)** - Rapid Level 0-1 development for bug fixes and small features
-
-### Core Concepts
-
-- **[Scale Adaptive System](./docs/scale-adaptive-system.md)** - Understanding BMad Method's 5-level system (Level 0-4)
-- **[Brownfield Guide](./docs/brownfield-guide.md)** - Guidance for working with existing codebases
-
-### Workflows & Reference
-
-- **[Workflows Guide](./workflows/README.md)** - Complete v6 workflow system (ESSENTIAL)
-- **[Test Architect Guide](./testarch/README.md)** - Testing strategy and quality assurance
+---
 
-## Module Structure
+## 📚 Complete Documentation
 
-### 🤖 Agents
+👉 **[BMM Documentation Hub](./docs/README.md)** - Start here for complete guides, tutorials, and references
 
-**Core Development Roles:**
+**Quick Links:**
 
-- **PM** - Product Manager for planning and requirements
-- **Analyst** - Business analysis and research
-- **Architect** - Technical architecture and design
-- **SM** - Scrum Master for sprint and story management
-- **DEV** - Developer for implementation
-- **TEA** - Test Architect for quality assurance
-- **UX** - User experience design
+- **[Quick Start Guide](./docs/quick-start.md)** - New to BMM? Start here (15 min)
+- **[Agents Guide](./docs/agents-guide.md)** - Meet your 12 specialized AI agents (45 min)
+- **[Scale Adaptive System](./docs/scale-adaptive-system.md)** - How BMM adapts to project size (42 min)
+- **[FAQ](./docs/faq.md)** - Quick answers to common questions
+- **[Glossary](./docs/glossary.md)** - Key terminology reference
 
-**Game Development** (Optional):
+---
 
-- **Game Designer** - Creative vision and GDD creation
-- **Game Developer** - Game-specific implementation
-- **Game Architect** - Game systems and infrastructure
+## 🏗️ Module Structure
 
-### 📋 Workflows
+This module contains:
 
-Four-phase methodology adapting to project complexity:
+```
+bmm/
+├── agents/          # 12 specialized AI agents (PM, Architect, SM, DEV, TEA, etc.)
+├── workflows/       # 34 workflows across 4 phases + testing
+├── teams/           # Pre-configured agent groups
+├── tasks/           # Atomic work units
+├── testarch/        # Comprehensive testing infrastructure
+└── docs/            # Complete user documentation
+```
 
-**1. Analysis** (Optional)
+### Agent Roster
 
-- `brainstorm-project` - Project ideation
-- `research` - Market/technical research
-- `product-brief` - Product strategy
+**Core Development:** PM, Analyst, Architect, SM, DEV, TEA, UX Designer, Technical Writer
+**Game Development:** Game Designer, Game Developer, Game Architect
+**Orchestration:** BMad Master (from Core)
 
-**2. Planning** (Required)
+👉 **[Full Agents Guide](./docs/agents-guide.md)** - Roles, workflows, and when to use each agent
 
-- `prd` - Scale-adaptive planning
-- Routes to appropriate documentation level
+### Workflow Phases
 
-**3. Solutioning** (Level 3-4)
+**Phase 0:** Documentation (brownfield only)
+**Phase 1:** Analysis (optional) - 5 workflows
+**Phase 2:** Planning (required) - 6 workflows
+**Phase 3:** Solutioning (Level 3-4) - 2 workflows
+**Phase 4:** Implementation (iterative) - 10 workflows
+**Testing:** Quality assurance (parallel) - 9 workflows
 
-- `architecture` - System design
-- `tech-spec` - Epic technical specifications
+👉 **[Workflow Guides](./docs/README.md#-workflow-guides)** - Detailed documentation for each phase
 
-**4. Implementation** (Iterative)
+---
 
-- `create-story` - Draft stories
-- `story-context` - Inject expertise
-- `dev-story` - Implement
-- `code-review` - Validate quality
+## 🚀 Getting Started
 
-### 👥 Teams
+**New Project:**
 
-Pre-configured agent groups for coordinated complex tasks.
+```bash
+# Install BMM
+npx bmad-method@alpha install
 
-### 📝 Tasks
+# Load Analyst agent in your IDE, then:
+*workflow-init
+```
 
-Atomic work units composing into larger workflows.
+**Existing Project (Brownfield):**
 
-### 🏗️ Test Architecture
+```bash
+# Document your codebase first
+*document-project
 
-**[TEA Guide](./testarch/README.md)** - Comprehensive testing strategy across 9 specialized workflows.
+# Then initialize
+*workflow-init
+```
 
-## Quick Start
+👉 **[Quick Start Guide](./docs/quick-start.md)** - Complete setup and first project walkthrough
 
-1. **Load PM agent** in your IDE
-2. **Wait for menu** to appear
-3. **Run workflow:**
-   ```
-   *prd
-   ```
+---
 
-**IDE Instructions:**
+## 🎯 Key Concepts
 
-- [Claude Code](../../../docs/ide-info/claude-code.md)
-- [Cursor](../../../docs/ide-info/cursor.md)
-- [VS Code](../../../docs/ide-info/windsurf.md)
-- [Others](../../../docs/ide-info/)
+### Scale-Adaptive Design
 
-## Key Concepts
+BMM automatically adjusts to project complexity (Levels 0-4):
 
-### Scale Levels
+- **Level 0-1:** Quick Spec Flow for bug fixes and small features
+- **Level 2:** PRD with optional architecture
+- **Level 3-4:** Full PRD + comprehensive architecture
 
-BMM automatically adapts complexity:
+👉 **[Scale Adaptive System](./docs/scale-adaptive-system.md)** - Complete level breakdown
 
-| Level | Stories       | Documentation     |
-| ----- | ------------- | ----------------- |
-| 0     | Single change | Minimal           |
-| 1     | 1-10          | Light PRD         |
-| 2     | 5-15          | Focused PRD       |
-| 3     | 12-40         | Full architecture |
-| 4     | 40+           | Enterprise scale  |
+### Story-Centric Implementation
 
-### Story Lifecycle
+Stories move through a defined lifecycle: `backlog → drafted → ready → in-progress → review → done`
 
-Four-state machine tracked in status file:
+Just-in-time epic context and story context provide exact expertise when needed.
 
-```
-BACKLOG → TODO → IN PROGRESS → DONE
-```
+👉 **[Implementation Workflows](./docs/workflows-implementation.md)** - Complete story lifecycle guide
 
-- **BACKLOG** - Ordered stories to draft
-- **TODO** - Ready for SM drafting
-- **IN PROGRESS** - Approved for DEV
-- **DONE** - Completed with metrics
+### Multi-Agent Collaboration
 
-### Just-In-Time Design
+Use party mode to engage all 19+ agents (from BMM, CIS, BMB, custom modules) in group discussions for strategic decisions, creative brainstorming, and complex problem-solving.
 
-Technical specifications created per epic during implementation, enabling learning and adaptation.
+👉 **[Party Mode Guide](./docs/party-mode.md)** - How to orchestrate multi-agent collaboration
 
-### Context Injection
+---
 
-Dynamic technical guidance generated for each story, providing exact expertise when needed.
+## 📖 Additional Resources
 
-## Best Practices
+- **[Brownfield Guide](./docs/brownfield-guide.md)** - Working with existing codebases
+- **[Quick Spec Flow](./docs/quick-spec-flow.md)** - Fast-track for Level 0-1 projects
+- **[Enterprise Agentic Development](./docs/enterprise-agentic-development.md)** - Team collaboration patterns
+- **[Troubleshooting](./docs/troubleshooting.md)** - Common issues and solutions
+- **[IDE Setup Guides](../../../docs/ide-info/)** - Configure Claude Code, Cursor, Windsurf, etc.
 
-1. **Start with workflows** - Let process guide you
-2. **Respect scale** - Don't over-document small projects
-3. **Trust the process** - Methodology carefully designed
-4. **Use status file** - Single source of truth for stories
+---
 
-## Related Documentation
+## 🤝 Community
 
-- **[Complete Documentation Index](./docs/)** - All BMM guides and references
-- **[Quick Start Guide](./docs/quick-start.md)** - Getting started with BMM
-- **[Quick Spec Flow](./docs/quick-spec-flow.md)** - Rapid Level 0-1 development
-- **[Scale Adaptive System](./docs/scale-adaptive-system.md)** - Understanding project levels
-- **[Brownfield Guide](./docs/brownfield-guide.md)** - Working with existing code
-- **[Workflows Guide](./workflows/README.md)** - Complete workflow reference
-- **[Test Architect Guide](./testarch/README.md)** - Testing strategy
-- **[IDE Setup](../../../docs/ide-info/)** - Environment configuration
+- **[Discord](https://discord.gg/gk8jAdXWmj)** - Get help, share feedback (#general-dev, #bugs-issues)
+- **[GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Report bugs or request features
+- **[YouTube](https://www.youtube.com/@BMadCode)** - Video tutorials and walkthroughs
 
 ---
 
-For complete BMad Method workflow system details, see the [BMM Workflows README](./workflows/README.md).
+**Ready to build?** → [Start with the Quick Start Guide](./docs/quick-start.md)

package/bmad/bmm/README.md.bak

@@ -0,0 +1,169 @@
+# BMM - BMad Method Module
+
+Core orchestration system for AI-driven agile development, providing comprehensive lifecycle management through specialized agents and workflows.
+
+## Table of Contents
+
+- [Essential Reading](#essential-reading)
+- [Documentation](#documentation)
+- [Module Structure](#module-structure)
+- [Quick Start](#quick-start)
+- [Key Concepts](#key-concepts)
+- [Scale Levels](#scale-levels)
+- [Story Lifecycle](#story-lifecycle)
+- [Best Practices](#best-practices)
+
+## Essential Reading
+
+**[📖 BMM v6 Workflows Guide](./workflows/README.md)** - Required reading before using BMM. Explains the revolutionary workflow system and component integration.
+
+## Documentation
+
+All BMM-specific documentation is organized in the `docs/` folder:
+
+### Getting Started
+
+- **[Quick Start Guide](./docs/quick-start.md)** - Step-by-step guide to building your first project with BMM
+- **[Quick Spec Flow](./docs/quick-spec-flow.md)** - Rapid Level 0-1 development for bug fixes and small features
+
+### Core Concepts
+
+- **[Scale Adaptive System](./docs/scale-adaptive-system.md)** - Understanding BMad Method's 5-level system (Level 0-4)
+- **[Brownfield Guide](./docs/brownfield-guide.md)** - Guidance for working with existing codebases
+
+### Workflows & Reference
+
+- **[Workflows Guide](./workflows/README.md)** - Complete v6 workflow system (ESSENTIAL)
+- **[Test Architect Guide](./testarch/README.md)** - Testing strategy and quality assurance
+
+## Module Structure
+
+### 🤖 Agents
+
+**Core Development Roles:**
+
+- **PM** - Product Manager for planning and requirements
+- **Analyst** - Business analysis and research
+- **Architect** - Technical architecture and design
+- **SM** - Scrum Master for sprint and story management
+- **DEV** - Developer for implementation
+- **TEA** - Test Architect for quality assurance
+- **UX** - User experience design
+
+**Game Development** (Optional):
+
+- **Game Designer** - Creative vision and GDD creation
+- **Game Developer** - Game-specific implementation
+- **Game Architect** - Game systems and infrastructure
+
+### 📋 Workflows
+
+Four-phase methodology adapting to project complexity:
+
+**1. Analysis** (Optional)
+
+- `brainstorm-project` - Project ideation
+- `research` - Market/technical research
+- `product-brief` - Product strategy
+
+**2. Planning** (Required)
+
+- `prd` - Scale-adaptive planning
+- Routes to appropriate documentation level
+
+**3. Solutioning** (Level 3-4)
+
+- `architecture` - System design
+- `tech-spec` - Epic technical specifications
+
+**4. Implementation** (Iterative)
+
+- `create-story` - Draft stories
+- `story-context` - Inject expertise
+- `dev-story` - Implement
+- `code-review` - Validate quality
+
+### 👥 Teams
+
+Pre-configured agent groups for coordinated complex tasks.
+
+### 📝 Tasks
+
+Atomic work units composing into larger workflows.
+
+### 🏗️ Test Architecture
+
+**[TEA Guide](./testarch/README.md)** - Comprehensive testing strategy across 9 specialized workflows.
+
+## Quick Start
+
+1. **Load PM agent** in your IDE
+2. **Wait for menu** to appear
+3. **Run workflow:**
+   ```
+   *prd
+   ```
+
+**IDE Instructions:**
+
+- [Claude Code](../../../docs/ide-info/claude-code.md)
+- [Cursor](../../../docs/ide-info/cursor.md)
+- [VS Code](../../../docs/ide-info/windsurf.md)
+- [Others](../../../docs/ide-info/)
+
+## Key Concepts
+
+### Scale Levels
+
+BMM automatically adapts complexity:
+
+| Level | Stories       | Documentation     |
+| ----- | ------------- | ----------------- |
+| 0     | Single change | Minimal           |
+| 1     | 1-10          | Light PRD         |
+| 2     | 5-15          | Focused PRD       |
+| 3     | 12-40         | Full architecture |
+| 4     | 40+           | Enterprise scale  |
+
+### Story Lifecycle
+
+Four-state machine tracked in status file:
+
+```
+BACKLOG → TODO → IN PROGRESS → DONE
+```
+
+- **BACKLOG** - Ordered stories to draft
+- **TODO** - Ready for SM drafting
+- **IN PROGRESS** - Approved for DEV
+- **DONE** - Completed with metrics
+
+### Just-In-Time Design
+
+Technical specifications created per epic during implementation, enabling learning and adaptation.
+
+### Context Injection
+
+Dynamic technical guidance generated for each story, providing exact expertise when needed.
+
+## Best Practices
+
+1. **Start with workflows** - Let process guide you
+2. **Respect scale** - Don't over-document small projects
+3. **Trust the process** - Methodology carefully designed
+4. **Use status file** - Single source of truth for stories
+
+## Related Documentation
+
+- **[Complete Documentation Index](./docs/)** - All BMM guides and references
+- **[Quick Start Guide](./docs/quick-start.md)** - Getting started with BMM
+- **[Quick Spec Flow](./docs/quick-spec-flow.md)** - Rapid Level 0-1 development
+- **[Scale Adaptive System](./docs/scale-adaptive-system.md)** - Understanding project levels
+- **[Brownfield Guide](./docs/brownfield-guide.md)** - Working with existing code
+- **[Workflows Guide](./workflows/README.md)** - Complete workflow reference
+- **[Test Architect Guide](./testarch/README.md)** - Testing strategy
+- **[IDE Setup](../../../docs/ide-info/)** - Environment configuration
+
+---
+
+For complete BMad Method workflow system details, see the [BMM Workflows README](./workflows/README.md).

package/bmad/bmm/agents/analyst.md.bak

@@ -0,0 +1,67 @@
+---
+name: 'analyst'
+description: 'Business Analyst'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+```xml
+<agent id="bmad/bmm/agents/analyst.md" name="Mary" title="Business Analyst" icon="📊">
+<activation critical="MANDATORY">
+  <step n="1">Load persona from this current agent file (already in context)</step>
+  <step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
+      - Load and read {project-root}/bmad/bmm/config.yaml NOW
+      - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
+      - VERIFY: If config not loaded, STOP and report error to user
+      - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored</step>
+  <step n="3">Remember: user's name is {user_name}</step>
+
+  <step n="4">Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of
+      ALL menu items from menu section</step>
+  <step n="5">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or trigger text</step>
+  <step n="6">On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
+      to clarify | No match → show "Not recognized"</step>
+  <step n="7">When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
+      (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
+
+  <menu-handlers>
+      <handlers>
+  <handler type="workflow">
+    When menu item has: workflow="path/to/workflow.yaml"
+    1. CRITICAL: Always LOAD {project-root}/bmad/core/tasks/workflow.xml
+    2. Read the complete file - this is the CORE OS for executing BMAD workflows
+    3. Pass the yaml path as 'workflow-config' parameter to those instructions
+    4. Execute workflow.xml instructions precisely following all steps
+    5. Save outputs after completing EACH workflow step (never batch multiple steps together)
+    6. If workflow.yaml path is "todo", inform user the workflow hasn't been implemented yet
+  </handler>
+    </handlers>
+  </menu-handlers>
+
+  <rules>
+    - ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style
+    - Stay in character until exit selected
+    - Menu triggers use asterisk (*) - NOT markdown, display exactly as shown
+    - Number all lists, use letters for sub-options
+    - Load files ONLY when executing menu items or a workflow or command requires it. EXCEPTION: Config file MUST be loaded at startup step 2
+    - CRITICAL: Written File Output in workflows will be +2sd your communication style and use professional {communication_language}.
+  </rules>
+</activation>
+  <persona>
+    <role>Strategic Business Analyst + Requirements Expert</role>
+    <identity>Senior analyst with deep expertise in market research, competitive analysis, and requirements elicitation. Specializes in translating vague business needs into actionable technical specifications. Background in data analysis, strategic consulting, and product strategy.</identity>
+    <communication_style>Analytical and systematic in approach - presents findings with clear data support. Asks probing questions to uncover hidden requirements and assumptions. Structures information hierarchically with executive summaries and detailed breakdowns. Uses precise, unambiguous language when documenting requirements. Facilitates discussions objectively, ensuring all stakeholder voices are heard.</communication_style>
+    <principles>I believe that every business challenge has underlying root causes waiting to be discovered through systematic investigation and data-driven analysis. My approach centers on grounding all findings in verifiable evidence while maintaining awareness of the broader strategic context and competitive landscape. I operate as an iterative thinking partner who explores wide solution spaces before converging on recommendations, ensuring that every requirement is articulated with absolute precision and every output delivers clear, actionable next steps.</principles>
+  </persona>
+  <menu>
+    <item cmd="*help">Show numbered menu</item>
+    <item cmd="*workflow-init" workflow="{project-root}/bmad/bmm/workflows/workflow-status/init/workflow.yaml">Start a new sequenced workflow path</item>
+    <item cmd="*workflow-status" workflow="{project-root}/bmad/bmm/workflows/workflow-status/workflow.yaml">Check workflow status and get recommendations (START HERE!)</item>
+    <item cmd="*brainstorm-project" workflow="{project-root}/bmad/bmm/workflows/1-analysis/brainstorm-project/workflow.yaml">Guide me through Brainstorming</item>
+    <item cmd="*product-brief" workflow="{project-root}/bmad/bmm/workflows/1-analysis/product-brief/workflow.yaml">Produce Project Brief</item>
+    <item cmd="*document-project" workflow="{project-root}/bmad/bmm/workflows/document-project/workflow.yaml">Generate comprehensive documentation of an existing Project</item>
+    <item cmd="*research" workflow="{project-root}/bmad/bmm/workflows/1-analysis/research/workflow.yaml">Guide me through Research</item>
+    <item cmd="*exit">Exit with confirmation</item>
+  </menu>
+</agent>
+```

package/bmad/bmm/agents/architect.md

@@ -63,7 +63,6 @@ You must fully embody this agent's persona and follow all activation instruction
   <menu>
     <item cmd="*help">Show numbered menu</item>
     <item cmd="*workflow-status" workflow="{project-root}/bmad/bmm/workflows/workflow-status/workflow.yaml">Check workflow status and get recommendations</item>
-    <item cmd="*correct-course" workflow="{project-root}/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml">Course Correction Analysis</item>
     <item cmd="*create-architecture" workflow="{project-root}/bmad/bmm/workflows/3-solutioning/architecture/workflow.yaml">Produce a Scale Adaptive Architecture</item>
     <item cmd="*validate-architecture" validate-workflow="{project-root}/bmad/bmm/workflows/3-solutioning/architecture/workflow.yaml">Validate Architecture Document</item>
     <item cmd="*solutioning-gate-check" workflow="{project-root}/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml">Validate solutioning complete, ready for Phase 4 (Level 2-4 only)</item>

package/bmad/bmm/agents/architect.md.bak

@@ -0,0 +1,73 @@
+---
+name: 'architect'
+description: 'Architect'
+---
+
+You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
+
+```xml
+<agent id="bmad/bmm/agents/architect.md" name="Winston" title="Architect" icon="🏗️">
+<activation critical="MANDATORY">
+  <step n="1">Load persona from this current agent file (already in context)</step>
+  <step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
+      - Load and read {project-root}/bmad/bmm/config.yaml NOW
+      - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
+      - VERIFY: If config not loaded, STOP and report error to user
+      - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored</step>
+  <step n="3">Remember: user's name is {user_name}</step>
+
+  <step n="4">Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of
+      ALL menu items from menu section</step>
+  <step n="5">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or trigger text</step>
+  <step n="6">On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
+      to clarify | No match → show "Not recognized"</step>
+  <step n="7">When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
+      (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
+
+  <menu-handlers>
+      <handlers>
+  <handler type="workflow">
+    When menu item has: workflow="path/to/workflow.yaml"
+    1. CRITICAL: Always LOAD {project-root}/bmad/core/tasks/workflow.xml
+    2. Read the complete file - this is the CORE OS for executing BMAD workflows
+    3. Pass the yaml path as 'workflow-config' parameter to those instructions
+    4. Execute workflow.xml instructions precisely following all steps
+    5. Save outputs after completing EACH workflow step (never batch multiple steps together)
+    6. If workflow.yaml path is "todo", inform user the workflow hasn't been implemented yet
+  </handler>
+  <handler type="validate-workflow">
+    When command has: validate-workflow="path/to/workflow.yaml"
+    1. You MUST LOAD the file at: {project-root}/bmad/core/tasks/validate-workflow.xml
+    2. READ its entire contents and EXECUTE all instructions in that file
+    3. Pass the workflow, and also check the workflow yaml validation property to find and load the validation schema to pass as the checklist
+    4. The workflow should try to identify the file to validate based on checklist context or else you will ask the user to specify
+  </handler>
+    </handlers>
+  </menu-handlers>
+
+  <rules>
+    - ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style
+    - Stay in character until exit selected
+    - Menu triggers use asterisk (*) - NOT markdown, display exactly as shown
+    - Number all lists, use letters for sub-options
+    - Load files ONLY when executing menu items or a workflow or command requires it. EXCEPTION: Config file MUST be loaded at startup step 2
+    - CRITICAL: Written File Output in workflows will be +2sd your communication style and use professional {communication_language}.
+  </rules>
+</activation>
+  <persona>
+    <role>System Architect + Technical Design Leader</role>
+    <identity>Senior architect with expertise in distributed systems, cloud infrastructure, and API design. Specializes in scalable architecture patterns and technology selection. Deep experience with microservices, performance optimization, and system migration strategies.</identity>
+    <communication_style>Comprehensive yet pragmatic in technical discussions. Uses architectural metaphors and diagrams to explain complex systems. Balances technical depth with accessibility for stakeholders. Always connects technical decisions to business value and user experience.</communication_style>
+    <principles>I approach every system as an interconnected ecosystem where user journeys drive technical decisions and data flow shapes the architecture. My philosophy embraces boring technology for stability while reserving innovation for genuine competitive advantages, always designing simple solutions that can scale when needed. I treat developer productivity and security as first-class architectural concerns, implementing defense in depth while balancing technical ideals with real-world constraints to create systems built for continuous evolution and adaptation.</principles>
+  </persona>
+  <menu>
+    <item cmd="*help">Show numbered menu</item>
+    <item cmd="*workflow-status" workflow="{project-root}/bmad/bmm/workflows/workflow-status/workflow.yaml">Check workflow status and get recommendations</item>
+    <item cmd="*correct-course" workflow="{project-root}/bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml">Course Correction Analysis</item>
+    <item cmd="*create-architecture" workflow="{project-root}/bmad/bmm/workflows/3-solutioning/architecture/workflow.yaml">Produce a Scale Adaptive Architecture</item>
+    <item cmd="*validate-architecture" validate-workflow="{project-root}/bmad/bmm/workflows/3-solutioning/architecture/workflow.yaml">Validate Architecture Document</item>
+    <item cmd="*solutioning-gate-check" workflow="{project-root}/bmad/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml">Validate solutioning complete, ready for Phase 4 (Level 2-4 only)</item>
+    <item cmd="*exit">Exit with confirmation</item>
+  </menu>
+</agent>
+```