bmad-method 6.0.0-alpha.22 → 6.0.0-alpha.23

package/docs/{modules/bmm-bmad-method → explanation/bmm}/index.md

@@ -1,4 +1,7 @@
-# BMM Documentation
+---
+title: "BMM Documentation"
+---
+
 
 Complete guides for the BMad Method Module (BMM) - AI-powered agile development workflows that adapt to your project's complexity.
 
@@ -8,7 +11,7 @@ Complete guides for the BMad Method Module (BMM) - AI-powered agile development
 
 **New to BMM?** Start here:
 
-- **[Quick Start Guide](./quick-start.md)** - Step-by-step guide to building your first project
+- **[Quick Start Guide](/docs/tutorials/getting-started/getting-started-bmadv6.md)** - Step-by-step guide to building your first project
   - Installation and setup
   - Understanding the four phases
   - Running your first workflows
@@ -18,7 +21,7 @@ Complete guides for the BMad Method Module (BMM) - AI-powered agile development
 
 ### 📊 Visual Overview
 
-**[Complete Workflow Diagram](./images/workflow-method-greenfield.svg)** - Visual flowchart showing all phases, agents (color-coded), and decision points for the BMad Method standard greenfield track.
+**[Complete Workflow Diagram](../../tutorials/getting-started/images/workflow-method-greenfield.svg)** - Visual flowchart showing all phases, agents (color-coded), and decision points for the BMad Method standard greenfield track.
 
 ## 📖 Core Concepts
 
@@ -26,31 +29,33 @@ The BMad Method is meant to be adapted and customized to your specific needs. In
 
 First know there is the full BMad Method Process and then there is a Quick Flow for those quicker smaller efforts.
 
-- **[Full Adaptive BMad Method](#-workflow-guides)** - Full planning and scope support through extensive development and testing.
+- **[Full Adaptive BMad Method](#workflow-guides)** - Full planning and scope support through extensive development and testing.
   - Broken down into 4 phases, all of which are comprised of both required and optional phases
     - Phases 1-3 are all about progressive idea development through planning and preparations to build your project.
-    - Phase 4 is the implementation cycle where you will Just In Time (JIT) produce the contextual stories needed for the dev agent based on the extensive planing completed
+    - Phase 4 is the implementation cycle where you will Just In Time (JIT) produce the contextual stories needed for the dev agent based on the extensive planning completed
     - All 4 phases have optional steps in them, depending on how rigorous you want to go with planning, research ideation, validation, testing and traceability.
   - While there is a lot here, know that even this can be distilled down to a simple PRD, Epic and Story list and then jump into the dev cycle. But if that is all you want, you might be better off with the BMad Quick Flow described next
 
-- **[BMAD Quick Flow](./bmad-quick-flow.md)** - Fast-track development workflow
+- **[BMad Quick Flow](/docs/explanation/features/quick-flow.md)** - Fast-track development workflow
   - 3-step process: spec → dev → optional review
   - Perfect for bug fixes and small features
   - Rapid prototyping with production quality
   - Implementation in minutes, not days
-  - Has a specialized single agent that does all of this: **[Quick Flow Solo Dev Agent](./quick-flow-solo-dev.md)**
+  - Has a specialized single agent that does all of this: **[Quick Flow Solo Dev Agent](/docs/explanation/agents/barry-quick-flow.md)**
+
+- **TEA engagement (optional)** - Choose TEA engagement: none, TEA-only (standalone), or integrated by track. See **[Test Architect Guide](/docs/explanation/features/tea-overview.md)**.
 
 ## 🤖 Agents and Collaboration
 
 Complete guide to BMM's AI agent team:
 
-- **[Agents Guide](./agents-guide.md)** - Comprehensive agent reference
+- **[Agents Guide](/docs/explanation/core-concepts/agent-roles.md)** - Comprehensive agent reference
   - 12 specialized BMM agents + BMad Master
   - Agent roles, workflows, and when to use them
   - Agent customization system
   - Best practices and common patterns
 
-- **[Party Mode Guide](./party-mode.md)** - Multi-agent collaboration
+- **[Party Mode Guide](/docs/explanation/features/party-mode.md)** - Multi-agent collaboration
   - How party mode works (19+ agents collaborate in real-time)
   - When to use it (strategic, creative, cross-functional, complex)
   - Example party compositions
@@ -62,7 +67,7 @@ Complete guide to BMM's AI agent team:
 
 Comprehensive guide for brownfield development:
 
-- **[Brownfield Development Guide](./brownfield-guide.md)** - Complete guide for existing codebases
+- **[Brownfield Development Guide](/docs/how-to/brownfield/index.md)** - Complete guide for existing codebases
   - Documentation phase strategies
   - Track selection for brownfield
   - Integration with existing patterns
@@ -73,49 +78,49 @@ Comprehensive guide for brownfield development:
 
 Essential reference materials:
 
-- **[Glossary](./glossary.md)** - Key terminology and concepts
-- **[FAQ](./faq.md)** - Frequently asked questions across all topics
+- **[Glossary](/docs/reference/glossary/index.md)** - Key terminology and concepts
+- **[FAQ](/docs/explanation/faq/index.md)** - Frequently asked questions across all topics
 
 ## 🎯 Choose Your Path
 
 ### I need to...
 
 **Build something new (greenfield)**
-→ Start with [Quick Start Guide](./quick-start.md)
+→ Start with [Quick Start Guide](/docs/tutorials/getting-started/getting-started-bmadv6.md)
 
 **Fix a bug or add small feature**
-→ User the [Quick Flow Solo Dev](./quick-flow-solo-dev.md) directly with its dedicated stand alone [Quick Bmad Spec Flow](./quick-spec-flow.md) process
+→ Use the [Quick Flow Solo Dev](/docs/explanation/agents/barry-quick-flow.md) directly with its dedicated stand alone [Quick Bmad Spec Flow](/docs/explanation/features/quick-flow.md) process
 
 **Work with existing codebase (brownfield)**
-→ Read [Brownfield Development Guide](./brownfield-guide.md)
+→ Read [Brownfield Development Guide](/docs/how-to/brownfield/index.md)
 → Pay special attention to documentation requirements for brownfield projects
 
 ## 📋 Workflow Guides
 
 Comprehensive documentation for all BMM workflows organized by phase:
 
-- **[Phase 1: Analysis Workflows](./workflows-analysis.md)** - Optional exploration and research workflows (595 lines)
+- **[Phase 1: Analysis Workflows](/docs/how-to/workflows/run-brainstorming-session.md)** - Optional exploration and research workflows (595 lines)
   - brainstorm-project, product-brief, research, and more
   - When to use analysis workflows
   - Creative and strategic tools
 
-- **[Phase 2: Planning Workflows](./workflows-planning.md)** - Scale-adaptive planning (967 lines)
+- **[Phase 2: Planning Workflows](/docs/how-to/workflows/create-prd.md)** - Scale-adaptive planning (967 lines)
   - prd, tech-spec, gdd, narrative, ux
   - Track-based planning approach (Quick Flow, BMad Method, Enterprise Method)
   - Which planning workflow to use
 
-- **[Phase 3: Solutioning Workflows](./workflows-solutioning.md)** - Architecture and validation (638 lines)
+- **[Phase 3: Solutioning Workflows](/docs/how-to/workflows/create-architecture.md)** - Architecture and validation (638 lines)
   - architecture, create-epics-and-stories, implementation-readiness
   - V6: Epics created AFTER architecture for better quality
   - Required for BMad Method and Enterprise Method tracks
   - Preventing agent conflicts
 
-- **[Phase 4: Implementation Workflows](./workflows-implementation.md)** - Sprint-based development (1,634 lines)
+- **[Phase 4: Implementation Workflows](/docs/how-to/workflows/run-sprint-planning.md)** - Sprint-based development (1,634 lines)
   - sprint-planning, create-story, dev-story, code-review
   - Complete story lifecycle
   - One-story-at-a-time discipline
 
-- **[Testing & QA Workflows](./test-architecture.md)** - Comprehensive quality assurance (1,420 lines)
+- **[Testing & QA Workflows](/docs/explanation/features/tea-overview.md)** - Comprehensive quality assurance (1,420 lines)
   - Test strategy, automation, quality gates
   - TEA agent and test healing
 
@@ -123,8 +128,8 @@ Comprehensive documentation for all BMM workflows organized by phase:
 
 ### Community and Support
 
-- **[Discord Community](https://discord.gg/gk8jAdXWmj)** - Get help from the community (#general-dev, #bugs-issues)
+- **[Discord Community](https://discord.gg/gk8jAdXWmj)** - Get help from the community (#bmad-method-help, #report-bugs-and-issues)
 - **[GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Report bugs or request features
 - **[YouTube Channel](https://www.youtube.com/@BMadCode)** - Video tutorials and walkthroughs
 
-**Ready to begin?** → [Start with the Quick Start Guide](./quick-start.md)
+**Ready to begin?** → [Start with the Quick Start Guide](/docs/tutorials/getting-started/getting-started-bmadv6.md)

package/docs/explanation/core/index.md

@@ -0,0 +1,18 @@
+---
+title: "Core Module"
+---
+
+
+The Core Module is installed with all installations of BMad modules and provides common functionality that any module, workflow, or agent can take advantage of.
+
+## Core Module Components
+
+- **[Global Core Config](/docs/reference/configuration/global-config.md)** — Inheritable configuration that impacts all modules and custom content
+- **[Core Workflows](/docs/reference/workflows/core-workflows.md)** — Domain-agnostic workflows usable by any module
+  - [Party Mode](/docs/explanation/features/party-mode.md) — Multi-agent conversation orchestration
+  - [Brainstorming](/docs/explanation/features/brainstorming-techniques.md) — Structured creative sessions with 60+ techniques
+  - [Advanced Elicitation](/docs/explanation/features/advanced-elicitation.md) — LLM rethinking with 50+ reasoning methods
+- **[Core Tasks](/docs/reference/configuration/core-tasks.md)** — Common tasks available across modules
+  - [Index Docs](/docs/reference/configuration/core-tasks.md#index-docs) — Generate directory index files
+  - [Adversarial Review](/docs/reference/configuration/core-tasks.md#adversarial-review-general) — Critical content review
+  - [Shard Document](/docs/reference/configuration/core-tasks.md#shard-document) — Split large documents into sections

package/docs/explanation/core-concepts/agent-roles.md

@@ -0,0 +1,204 @@
+---
+title: "Agent Roles in BMad Method"
+description: Understanding the different agent roles in BMad Method
+---
+
+
+BMad Method uses specialized AI agents, each with a distinct role, expertise, and personality. Understanding these roles helps you know which agent to use for each task.
+
+---
+
+## Core Agents Overview
+
+| Agent | Role | Primary Phase |
+|-------|------|---------------|
+| **Analyst** | Research and discovery | Phase 1 (Analysis) |
+| **PM** | Requirements and planning | Phase 2 (Planning) |
+| **Architect** | Technical design | Phase 3 (Solutioning) |
+| **SM** | Sprint orchestration | Phase 4 (Implementation) |
+| **DEV** | Code implementation | Phase 4 (Implementation) |
+| **TEA** | Test architecture | Phases 3-4 (Cross-phase) |
+| **UX Designer** | User experience | Phase 2-3 |
+| **Quick Flow Solo Dev** | Fast solo development | All phases (Quick Flow) |
+
+---
+
+## Phase 1: Analysis
+
+### Analyst (Mary)
+
+Business analysis and research specialist.
+
+**Responsibilities:**
+- Brainstorming and ideation
+- Market, domain, and competitive research
+- Product brief creation
+- Brownfield project documentation
+
+**Key Workflows:**
+- `*brainstorm-project`
+- `*research`
+- `*product-brief`
+- `*document-project`
+
+**When to use:** Starting new projects, exploring ideas, validating market fit, documenting existing codebases.
+
+---
+
+## Phase 2: Planning
+
+### PM (John)
+
+Product requirements and planning expert.
+
+**Responsibilities:**
+- Creating Product Requirements Documents
+- Defining functional and non-functional requirements
+- Breaking requirements into epics and stories
+- Validating implementation readiness
+
+**Key Workflows:**
+- `*create-prd`
+- `*create-epics-and-stories`
+- `*implementation-readiness`
+
+**When to use:** Defining what to build, creating PRDs, organizing work into stories.
+
+### UX Designer (Sally)
+
+User experience and UI design specialist.
+
+**Responsibilities:**
+- UX specification creation
+- User journey mapping
+- Wireframe and mockup design
+- Design system documentation
+
+**Key Workflows:**
+- `*create-ux-design`
+- `*validate-design`
+
+**When to use:** When UX is a primary differentiator, complex user workflows, design system creation.
+
+---
+
+## Phase 3: Solutioning
+
+### Architect (Winston)
+
+System architecture and technical design expert.
+
+**Responsibilities:**
+- System architecture design
+- Architecture Decision Records (ADRs)
+- Technical standards definition
+- Implementation readiness validation
+
+**Key Workflows:**
+- `*create-architecture`
+- `*implementation-readiness`
+
+**When to use:** Multi-epic projects, cross-cutting technical decisions, preventing agent conflicts.
+
+---
+
+## Phase 4: Implementation
+
+### SM (Bob)
+
+Sprint planning and story preparation orchestrator.
+
+**Responsibilities:**
+- Sprint planning and tracking
+- Story preparation for development
+- Course correction handling
+- Epic retrospectives
+
+**Key Workflows:**
+- `*sprint-planning`
+- `*create-story`
+- `*correct-course`
+- `*epic-retrospective`
+
+**When to use:** Organizing work, preparing stories, tracking progress.
+
+### DEV (Amelia)
+
+Story implementation and code review specialist.
+
+**Responsibilities:**
+- Story implementation with tests
+- Code review
+- Following architecture patterns
+- Quality assurance
+
+**Key Workflows:**
+- `*dev-story`
+- `*code-review`
+
+**When to use:** Writing code, implementing stories, reviewing quality.
+
+---
+
+## Cross-Phase Agents
+
+### TEA (Murat)
+
+Test architecture and quality strategy expert.
+
+**Responsibilities:**
+- Test framework setup
+- Test design and planning
+- ATDD and automation
+- Quality gate decisions
+
+**Key Workflows:**
+- `*framework`, `*ci`
+- `*test-design`, `*atdd`, `*automate`
+- `*test-review`, `*trace`, `*nfr-assess`
+
+**When to use:** Setting up testing, creating test plans, quality gates.
+
+---
+
+## Quick Flow
+
+### Quick Flow Solo Dev (Barry)
+
+Fast solo development without handoffs.
+
+**Responsibilities:**
+- Technical specification
+- End-to-end implementation
+- Code review
+
+**Key Workflows:**
+- `*quick-spec`
+- `*quick-dev`
+- `*code-review`
+
+**When to use:** Bug fixes, small features, rapid prototyping.
+
+---
+
+## Choosing the Right Agent
+
+| Task | Agent |
+|------|-------|
+| Brainstorming ideas | Analyst |
+| Market research | Analyst |
+| Creating PRD | PM |
+| Designing UX | UX Designer |
+| System architecture | Architect |
+| Preparing stories | SM |
+| Writing code | DEV |
+| Setting up tests | TEA |
+| Quick bug fix | Quick Flow Solo Dev |
+
+---
+
+## Related
+
+- [What Are Agents](/docs/explanation/core-concepts/what-are-agents.md) - Foundational concepts
+- [Agent Reference](/docs/reference/agents/index.md) - Complete command reference
+- [Quick Start Guide](/docs/tutorials/getting-started/getting-started-bmadv6.md)

package/docs/explanation/core-concepts/index.md

@@ -0,0 +1,40 @@
+---
+title: "BMad Core Concepts"
+---
+
+
+Understanding the fundamental building blocks of the BMad Method.
+
+## The Essentials
+
+| Concept | Description | Guide |
+|---------|-------------|-------|
+| **Agents** | AI assistants with personas, capabilities, and menus | [Agents Guide](/docs/explanation/core-concepts/what-are-agents.md) |
+| **Workflows** | Structured processes for achieving specific outcomes | [Workflows Guide](/docs/explanation/core-concepts/what-are-workflows.md) |
+| **Modules** | Packaged collections of agents and workflows | [Modules Guide](/docs/explanation/core-concepts/what-are-modules.md) |
+
+## Getting Started
+
+### New to BMad?
+Start here to understand what BMad is and how it works:
+
+1. **[Agents Guide](/docs/explanation/core-concepts/what-are-agents.md)** - Learn about Simple and Expert agents
+2. **[Workflows Guide](/docs/explanation/core-concepts/what-are-workflows.md)** - Understand how workflows orchestrate tasks
+3. **[Modules Guide](/docs/explanation/core-concepts/what-are-modules.md)** - See how modules organize functionality
+
+### Installing BMad
+
+- **[Installation Guide](/docs/how-to/installation/index.md)** - Set up BMad in your project
+- **[Upgrading from v4](/docs/how-to/installation/upgrade-to-v6.md)** - Migrate from earlier versions
+
+### Configuration
+
+- **[BMad Customization](/docs/how-to/customization/index.md)** - Personalize agents and workflows
+
+### Advanced
+
+- **[Web Bundles](/docs/explanation/features/web-bundles.md)** - Use BMad in Gemini Gems and Custom GPTs
+
+---
+
+**Next:** Read the [Agents Guide](/docs/explanation/core-concepts/what-are-agents.md) to understand the core building block of BMad.

package/docs/{bmad-core-concepts/agents.md → explanation/core-concepts/what-are-agents.md}

@@ -1,10 +1,13 @@
-# Agents
+---
+title: "Agents"
+---
+
 
 Agents are AI assistants that help you accomplish tasks. Each agent has a unique personality, specialized capabilities, and an interactive menu.
 
 ## Agent Types
 
-BMAD has two primary agent types, designed for different use cases:
+BMad has two primary agent types, designed for different use cases:
 
 ### Simple Agents
 
@@ -82,12 +85,12 @@ All agents share these building blocks:
 
 ## Creating Custom Agents
 
-BMAD provides the **BMAD Builder (BMB)** module for creating your own agents. See the [Agent Creation Guide](../modules/bmb-bmad-builder/agent-creation-guide.md) for step-by-step instructions.
+BMad provides the **BMad Builder (BMB)** module for creating your own agents. See the [Agent Creation Guide](/docs/tutorials/advanced/create-custom-agent.md) for step-by-step instructions.
 
 ## Customizing Existing Agents
 
-You can modify any agent's behavior without editing core files. See [BMAD Customization](./bmad-customization/) for details. It is critical to never modify an installed agents .md file directly and follow the customization process, this way future updates to the agent or module its part of will continue to be updated and recompiled with the installer tool, and your customizations will still be retained.
+You can modify any agent's behavior without editing core files. See [BMad Customization](/docs/how-to/customization/index.md) for details. It is critical to never modify an installed agents .md file directly and follow the customization process, this way future updates to the agent or module its part of will continue to be updated and recompiled with the installer tool, and your customizations will still be retained.
 
 ---
 
-**Next:** Learn about [Workflows](./workflows.md) to see how agents accomplish complex tasks.
+**Next:** Learn about [Workflows](/docs/explanation/core-concepts/what-are-workflows.md) to see how agents accomplish complex tasks.

package/docs/{bmad-core-concepts/modules.md → explanation/core-concepts/what-are-modules.md}

@@ -1,4 +1,7 @@
-# Modules
+---
+title: "Modules"
+---
+
 
 Modules are organized collections of agents and workflows that solve specific problems or address particular domains.
 
@@ -19,13 +22,13 @@ Always installed, provides shared functionality:
 - Core workflows (Party Mode, Advanced Elicitation, Brainstorming)
 - Common tasks (document indexing, sharding, review)
 
-### BMAD Method (BMM)
+### BMad Method (BMM)
 Software and game development:
 - Project planning workflows
 - Implementation agents (Dev, PM, QA, Scrum Master)
 - Testing and architecture guidance
 
-### BMAD Builder (BMB)
+### BMad Builder (BMB)
 Create custom solutions:
 - Agent creation workflows
 - Workflow authoring tools
@@ -37,7 +40,7 @@ Innovation and creativity:
 - Innovation strategy workflows
 - Storytelling and ideation
 
-### BMAD Game Dev (BMGD)
+### BMad Game Dev (BMGD)
 Game development specialization:
 - Game design workflows
 - Narrative development
@@ -50,8 +53,8 @@ Installed modules follow this structure:
 ```
 _bmad/
 ├── core/           # Always present
-├── bmm/            # BMAD Method (if installed)
-├── bmb/            # BMAD Builder (if installed)
+├── bmm/            # BMad Method (if installed)
+├── bmb/            # BMad Builder (if installed)
 ├── cis/            # Creative Intelligence (if installed)
 └── bmgd/           # Game Dev (if installed)
 ```
@@ -67,10 +70,10 @@ Custom modules are installed the same way as official modules.
 
 ## Installing Modules
 
-During BMAD installation, you choose which modules to install. You can also add or remove modules later by re-running the installer.
+During BMad installation, you choose which modules to install. You can also add or remove modules later by re-running the installer.
 
-See [Installation Guide](./installing/) for details.
+See [Installation Guide](/docs/how-to/installation/index.md) for details.
 
 ---
 
-**Next:** Read the [Installation Guide](./installing/) to set up BMAD with the modules you need.
+**Next:** Read the [Installation Guide](/docs/how-to/installation/index.md) to set up BMad with the modules you need.