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

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/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/sm.md

@@ -70,7 +70,7 @@ You must fully embody this agent's persona and follow all activation instruction
     <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="*sprint-planning" workflow="{project-root}/bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml">Generate or update sprint-status.yaml from epic files</item>
-    <item cmd="*epic-tech-context" workflow="{project-root}/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml">(Optional) Use the PRD and Architecture to create a Tech-Spec for a specific epic</item>
+    <item cmd="*epic-tech-context" workflow="{project-root}/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml">(Optional) Use the PRD and Architecture to create a Epic-Tech-Spec for a specific epic</item>
     <item cmd="*validate-epic-tech-context" validate-workflow="{project-root}/bmad/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml">(Optional) Validate latest Tech Spec against checklist</item>
     <item cmd="*create-story" workflow="{project-root}/bmad/bmm/workflows/4-implementation/create-story/workflow.yaml">Create a Draft Story</item>
     <item cmd="*validate-create-story" validate-workflow="{project-root}/bmad/bmm/workflows/4-implementation/create-story/workflow.yaml">(Optional) Validate Story Draft with Independent Review</item>

package/bmad/bmm/agents/{paige.md → tech-writer.md}

@@ -1,12 +1,12 @@
 ---
-name: 'paige'
-description: 'Documentation Guide'
+name: 'tech writer'
+description: 'Technical Writer'
 ---
 
 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/paige.md" name="Paige" title="Documentation Guide" icon="📚">
+<agent id="bmad/bmm/agents/tech-writer.md" name="paige" title="Technical Writer" 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:

package/bmad/bmm/config.yaml

@@ -1,13 +1,14 @@
 # BMM Module Configuration
 # Generated by BMAD installer
-# Version: 6.0.0-alpha.3
-# Date: 2025-11-02T21:29:37.673Z
+# Version: 6.0.0-alpha.5
+# Date: 2025-11-05T04:14:53.511Z
 
 project_name: BMAD-METHOD
 include_game_planning: false
-user_skill_level: intermediate
+user_skill_level: expert
 tech_docs: "{project-root}/docs"
 dev_story_location: "{project-root}/docs/stories"
+install_user_docs: false
 tea_use_mcp_enhancements: false
 
 # Core Configuration Values

package/bmad/bmm/tasks/daily-standup.xml

@@ -64,7 +64,7 @@
       <i>Primary: Sarah (PO), Bob (SM), James (Dev)</i>
       <i>Secondary: Murat (TEA)</i>
     </context>
-    <context type="architecture-review">
+    <context type="validate-architecture">
       <i>Primary: Winston (Architect), James (Dev), Murat (TEA)</i>
       <i>Secondary: Sarah (PO)</i>
     </context>

package/bmad/bmm/workflows/2-plan-workflows/create-ux-design/instructions.md

@@ -9,26 +9,8 @@
 <critical>Communicate all responses in {communication_language} and tailor to {user_skill_level}</critical>
 <critical>Generate all documents in {document_output_language}</critical>
 <critical>SAVE PROGRESS after each major step - use <template-output> tags throughout</critical>
-
 <critical>DOCUMENT OUTPUT: Professional, specific, actionable UX design decisions WITH RATIONALE. User skill level ({user_skill_level}) affects conversation style ONLY, not document content.</critical>
-
-## 📚 Input Document Discovery
-
-This workflow requires: PRD or product brief, and may reference epics/stories, brainstorming documents, or brownfield project documentation.
-
-**Discovery Process** (execute for each referenced document):
-
-1. **Search for whole document first** - Use fuzzy file matching to find the complete document
-2. **Check for sharded version** - If whole document not found, look for `{doc-name}/index.md`
-3. **If sharded version found**:
-   - Read `index.md` to understand the document structure
-   - Read ALL section files listed in the index
-   - Treat the combined content as if it were a single document
-4. **Brownfield projects**: The `document-project` workflow always creates `{output_folder}/docs/index.md`
-
-**Priority**: If both whole and sharded versions exist, use the whole document.
-
-**Fuzzy matching**: Be flexible with document names - users may use variations in naming conventions.
+<critical>Input documents specified in workflow.yaml input_file_patterns - workflow engine handles fuzzy matching, whole vs sharded document discovery automatically</critical>
 
 <step n="0" goal="Validate workflow readiness" tag="workflow-status">
 <action>Check if {output_folder}/bmm-workflow-status.yaml exists</action>

package/bmad/bmm/workflows/2-plan-workflows/prd/checklist.md

@@ -234,21 +234,22 @@
 - [ ] Dependencies on external systems documented
 - [ ] Data requirements specified
 
-### Level-Appropriate Detail
+### Track-Appropriate Detail
 
-**If Level 2:**
-
-- [ ] PRD supports lightweight tech-spec workflow
-- [ ] 5-15 story scope reasonable for project size
-- [ ] Complexity appropriate for small team/solo dev
-
-**If Level 3-4:**
+**If BMad Method:**
 
 - [ ] PRD supports full architecture workflow
 - [ ] Epic structure supports phased delivery
-- [ ] Scope appropriate for team-based development
+- [ ] Scope appropriate for product/platform development
 - [ ] Clear value delivery through epic sequence
 
+**If Enterprise Method:**
+
+- [ ] PRD addresses enterprise requirements (security, compliance, multi-tenancy)
+- [ ] Epic structure supports extended planning phases
+- [ ] Scope includes security, devops, and test strategy considerations
+- [ ] Clear value delivery with enterprise gates
+
 ---
 
 ## 10. Quality and Polish

package/bmad/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md

@@ -9,55 +9,44 @@
 
 ## Overview
 
-This document provides the detailed epic breakdown for {{project_name}}, expanding on the high-level epic list in the [PRD](./PRD.md).
+This document provides the complete epic and story breakdown for {{project_name}}, decomposing the requirements from the [PRD](./PRD.md) into implementable stories.
 
-Each epic includes:
+{{epics_summary}}
 
-- Expanded goal and value proposition
-- Complete story breakdown with user stories
-- Acceptance criteria for each story
-- Story sequencing and dependencies
+---
 
-**Epic Sequencing Principles:**
+<!-- Repeat for each epic (N = 1, 2, 3...) -->
 
-- Epic 1 establishes foundational infrastructure and initial functionality
-- Subsequent epics build progressively, each delivering significant end-to-end value
-- Stories within epics are vertically sliced and sequentially ordered
-- No forward dependencies - each story builds only on previous work
+## Epic {{N}}: {{epic_title_N}}
 
----
+{{epic_goal_N}}
 
-{{epic_details}}
+<!-- Repeat for each story (M = 1, 2, 3...) within epic N -->
 
----
+### Story {{N}}.{{M}}: {{story_title_N_M}}
 
-## Story Guidelines Reference
+As a {{user_type}},
+I want {{capability}},
+So that {{value_benefit}}.
 
-**Story Format:**
+**Acceptance Criteria:**
 
-```
-**Story [EPIC.N]: [Story Title]**
+**Given** {{precondition}}
+**When** {{action}}
+**Then** {{expected_outcome}}
 
-As a [user type],
-I want [goal/desire],
-So that [benefit/value].
+**And** {{additional_criteria}}
 
-**Acceptance Criteria:**
-1. [Specific testable criterion]
-2. [Another specific criterion]
-3. [etc.]
+**Prerequisites:** {{dependencies_on_previous_stories}}
+
+**Technical Notes:** {{implementation_guidance}}
 
-**Prerequisites:** [Dependencies on previous stories, if any]
-```
+<!-- End story repeat -->
 
-**Story Requirements:**
+---
 
-- **Vertical slices** - Complete, testable functionality delivery
-- **Sequential ordering** - Logical progression within epic
-- **No forward dependencies** - Only depend on previous work
-- **AI-agent sized** - Completable in 2-4 hour focused session
-- **Value-focused** - Integrate technical enablers into value-delivering stories
+<!-- End epic repeat -->
 
 ---
 
-**For implementation:** Use the `create-story` workflow to generate individual story implementation plans from this epic breakdown.
+_For implementation: Use the `create-story` workflow to generate individual story implementation plans from this epic breakdown._