npm - bmad-method - Versions diffs - 6.0.0-alpha.22 → 6.0.0-alpha.23 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (668) hide show

package/docs/index.md CHANGED Viewed

@@ -1,111 +1,63 @@
-# BMAD Documentation
-Complete documentation for the BMAD Method.
-## Getting Started
-### New to BMAD?
-Start with the core concepts to understand how BMAD works:
-- **[Core Concepts](./bmad-core-concepts/)** - Agents, workflows, and modules explained
-- **[Installation Guide](./bmad-core-concepts/installing/)** - Set up BMAD in your project
-- **[Quick Start Guide](./modules/bmm-bmad-method/quick-start)** - Build your first feature
-### Upgrading from v4?
-- **[v4 to v6 Upgrade Guide](./bmad-core-concepts/installing/upgrading.md)** - Migration path for v4 users
+---
+title: Welcome to the BMad Method
 ---
-## Module Documentation
-### BMAD Method (BMM) - Software & Game Development
-The flagship module for agile AI-driven development.
-- **[BMM Module Index](./modules/bmm-bmad-method/index)** - Module overview, agents, and documentation
-  - [Quick Start Guide](./modules/bmm-bmad-method/quick-start) - Step-by-step guide
-  - [Quick Spec Flow](./modules/bmm-bmad-method/quick-spec-flow) - Rapid Level 0-1 development
-  - [Brownfield Guide](./modules/bmm-bmad-method/brownfield-guide) - Working with existing codebases
-- **[BMM Workflows Guide](./modules/bmm-bmad-method/index#-workflow-guides)** - Essential reading
-### BMAD Builder (BMB) - Create Custom Solutions
+The BMad Method (**B**reakthrough **M**ethod of **A**gile AI **D**riven Development) is an AI-driven development framework that helps you build software faster and smarter. It provides specialized AI agents, guided workflows, and intelligent planning that adapts to your project's complexity—whether you're fixing a bug or building an enterprise platform.
-Build your own agents, workflows, and modules.
+If you're comfortable working with AI coding assistants like Claude, Cursor, or GitHub Copilot, you're ready to get started.
-- **[BMB Module Overview](./modules/bmb-bmad-builder/index)** - Module overview and capabilities
-- **[Agent Creation Guide](./modules/bmb-bmad-builder/agent-creation-guide.md)** - Create custom agents
-- **[Custom Content Installation](./modules/bmb-bmad-builder/custom-content-installation.md)** - Share and install custom creations
+---
-### Creative Intelligence Suite (CIS) - Innovation & Creativity
+## New Here? Start with a Tutorial
-- **[CIS Documentation](./modules/cis-creative-intelligence-suite/index)**
+The fastest way to understand BMad is to try it. Choose a tutorial to walk through your first project in about 10 minutes.
-### BMAD Game Dev (BMGD)
+- **[Get Started with BMad](/docs/tutorials/getting-started/getting-started-bmadv6.md)** — Latest features, still in active development
-- **[BMGD Documentation](./modules/bmgd-bmad-game-dev/index)** - Game development workflows
+:::tip[Already familiar with AI-assisted development?]
+Feel free to skip around. Use the sidebar to jump to any topic, or check out [What Are Agents?](/docs/explanation/core-concepts/what-are-agents.md) to understand how BMad organizes its AI personas.
+:::
 ---
-## Core Module
+## How to Use These Docs
-### Global Core Entities
+These docs are organized into four sections based on what you're trying to do:
-- **[Core Module Index](./modules/core/index)** - Shared functionality available to all modules
-  - [Global Core Config](./modules/core/global-core-config.md) - Inheritable configuration
-  - [Core Workflows](./modules/core/core-workflows.md) - Domain-agnostic workflows
-    - [Party Mode](./modules/core/party-mode.md) - Multi-agent conversations
-    - [Brainstorming](./modules/core/brainstorming.md) - Structured creative sessions
-    - [Advanced Elicitation](./modules/core/advanced-elicitation.md) - LLM reasoning techniques
-  - [Core Tasks](./modules/core/core-tasks.md) - Common tasks across modules
+| Section           | Purpose                                                                                                    |
+| ----------------- | ---------------------------------------------------------------------------------------------------------- |
+| **Tutorials**     | Learning-oriented. Step-by-step guides that walk you through building something. Start here if you're new. |
+| **How-To Guides** | Task-oriented. Practical guides for solving specific problems. "How do I customize an agent?" lives here.  |
+| **Explanation**   | Understanding-oriented. Deep dives into concepts and architecture. Read when you want to know *why*.       |
+| **Reference**     | Information-oriented. Technical specifications for agents, workflows, and configuration.                   |
 ---
-## Advanced Topics
-### Customization
+## What You'll Need
-- **[BMAD Customization](./bmad-core-concepts/bmad-customization/)** - Modify agents and workflows
+BMad works with any AI coding assistant that supports custom system prompts or project context. Popular options include:
-### Platform Guides
+- **[Claude Code](https://code.claude.com)** — Anthropic's CLI tool (recommended)
+- **[Cursor](https://cursor.sh)** — AI-first code editor
+- **[Windsurf](https://codeium.com/windsurf)** — Codeium's AI IDE
+- **[Roo Code](https://roocode.com)** — VS Code extension
-- **[Web Bundles](./bmad-core-concepts/web-bundles/)** - Use BMAD in Gemini Gems and Custom GPTs
+You should be comfortable with basic software development concepts like version control, project structure, and agile workflows. No prior experience with BMad-style agent systems is required—that's what these docs are for.
 ---
-## Recommended Reading Paths
-### Path 1: Brand New to BMAD (Software Project)
-1. [Core Concepts](./bmad-core-concepts/) - Understand agents and workflows
-2. [Installation Guide](./bmad-core-concepts/installing/) - Set up BMAD
-3. [Quick Start Guide](./modules/bmm-bmad-method/quick-start) - Get hands-on
-4. [BMM Workflows Guide](./modules/bmm-bmad-method/index#-workflow-guides) - Master the methodology
+## Join the Community
-### Path 2: Game Development Project
+Get help, share what you're building, or contribute to BMad:
-1. [Core Concepts](./bmad-core-concepts/) - Understand agents and workflows
-2. [Installation Guide](./bmad-core-concepts/installing/) - Set up BMAD
-3. [BMGD Workflows Guide](./modules/bmgd-bmad-game-dev/workflows-guide) - Game-specific workflows
+- **[Discord](https://discord.gg/gk8jAdXWmj)** — Chat with other BMad users, ask questions, share ideas
+- **[GitHub](https://github.com/bmad-code-org/BMAD-METHOD)** — Source code, issues, and contributions
+- **[YouTube](https://www.youtube.com/@BMadCode)** — Video tutorials and walkthroughs
-### Path 3: Upgrading from v4
-1. [v4 to v6 Upgrade Guide](./bmad-core-concepts/installing/upgrading.md) - Understand what changed
-2. [Quick Start Guide](./modules/bmm-bmad-method/quick-start) - Reorient yourself
-3. [BMM Workflows Guide](./modules/bmm-bmad-method/index#-workflow-guides) - Learn new v6 workflows
-### Path 4: Working with Existing Codebase (Brownfield)
-1. [Brownfield Guide](./modules/bmm-bmad-method/brownfield-guide) - Approach for legacy code
-2. [Quick Start Guide](./modules/bmm-bmad-method/quick-start) - Follow the process
-3. [BMM Workflows Guide](./modules/bmm-bmad-method/index#-workflow-guides) - Master the methodology
-### Path 5: Building Custom Agents
+---
-1. [Core Concepts: Agents](./bmad-core-concepts/agents.md) - Understand Simple vs Expert
-2. [Agent Creation Guide](./modules/bmb-bmad-builder/agent-creation-guide.md) - Build your first agent
-3. [Agent Architecture](./modules/bmb-bmad-builder/index) - Deep technical details
+## Next Step
-### Path 6: Contributing to BMAD
+Ready to dive in? Pick a tutorial and start building.
-1. [CONTRIBUTING.md](https://github.com/bmad-code-org/BMAD-METHOD/blob/main/CONTRIBUTING.md) - Contribution guidelines
-2. Relevant module README - Understand the area you're contributing to
+- **[Get Started with BMad](/docs/tutorials/getting-started/getting-started-bmadv6.md)** — Explore the latest features

package/docs/{modules/bmm-bmad-method/agents-guide.md → reference/agents/index.md} RENAMED Viewed

@@ -1,98 +1,91 @@
-# BMM Agents Reference
+---
+title: "Agents Reference"
+description: Complete reference for BMad Method agents and their commands
+---
-Quick reference of what each agent can do based on their available commands.
+Quick reference of all BMad Method agents and their available commands.
 ---
-## Analyst (Mary) | `/bmad:bmm:agents:analyst`
+## Analyst (Mary)
 Business analysis and research.
-**Capabilities:**
+**Commands:**
 - `*workflow-status` - Get workflow status or initialize tracking
 - `*brainstorm-project` - Guided brainstorming session
 - `*research` - Market, domain, competitive, or technical research
 - `*product-brief` - Create a product brief (input for PRD)
 - `*document-project` - Document existing brownfield projects
-- Party mode and advanced elicitation
 ---
-## PM (John) | `/bmad:bmm:agents:pm`
+## PM (John)
 Product requirements and planning.
-**Capabilities:**
+**Commands:**
 - `*workflow-status` - Get workflow status or initialize tracking
 - `*create-prd` - Create Product Requirements Document
 - `*create-epics-and-stories` - Break PRD into epics and user stories (after Architecture)
 - `*implementation-readiness` - Validate PRD, UX, Architecture, Epics alignment
 - `*correct-course` - Course correction during implementation
-- Party mode and advanced elicitation
 ---
-## Architect (Winston) | `/bmad:bmm:agents:architect`
+## Architect (Winston)
 System architecture and technical design.
-**Capabilities:**
+**Commands:**
 - `*workflow-status` - Get workflow status or initialize tracking
 - `*create-architecture` - Create architecture document to guide development
 - `*implementation-readiness` - Validate PRD, UX, Architecture, Epics alignment
 - `*create-excalidraw-diagram` - System architecture or technical diagrams
 - `*create-excalidraw-dataflow` - Data flow diagrams
-- Party mode and advanced elicitation
 ---
-## SM (Bob) | `/bmad:bmm:agents:sm`
+## SM (Bob)
 Sprint planning and story preparation.
-**Capabilities:**
+**Commands:**
 - `*sprint-planning` - Generate sprint-status.yaml from epic files
 - `*create-story` - Create story from epic (prep for development)
 - `*validate-create-story` - Validate story quality
 - `*epic-retrospective` - Team retrospective after epic completion
 - `*correct-course` - Course correction during implementation
-- Party mode and advanced elicitation
 ---
-## DEV (Amelia) | `/bmad:bmm:agents:dev`
+## DEV (Amelia)
 Story implementation and code review.
-**Capabilities:**
+**Commands:**
 - `*dev-story` - Execute story workflow (implementation with tests)
 - `*code-review` - Thorough code review
 ---
-## Quick Flow Solo Dev (Barry) | `/bmad:bmm:agents:quick-flow-solo-dev`
+## Quick Flow Solo Dev (Barry)
 Fast solo development without handoffs.
-**Capabilities:**
-- `*create-tech-spec` - Architect technical spec with implementation-ready stories
+**Commands:**
+- `*quick-spec` - Architect technical spec with implementation-ready stories
 - `*quick-dev` - Implement tech spec end-to-end solo
 - `*code-review` - Review and improve code
 ---
-## TEA (Murat) | `/bmad:bmm:agents:tea`
+## TEA (Murat)
 Test architecture and quality strategy.
-**Capabilities:**
+**Commands:**
 - `*framework` - Initialize production-ready test framework
 - `*atdd` - Generate E2E tests first (before implementation)
 - `*automate` - Comprehensive test automation
@@ -104,33 +97,31 @@ Test architecture and quality strategy.
 ---
-## UX Designer (Sally) | `/bmad:bmm:agents:ux-designer`
+## UX Designer (Sally)
 User experience and UI design.
-**Capabilities:**
+**Commands:**
 - `*create-ux-design` - Generate UX design and UI plan from PRD
 - `*validate-design` - Validate UX specification and design artifacts
 - `*create-excalidraw-wireframe` - Create website or app wireframe
 ---
-## Technical Writer (Paige) | `/bmad:bmm:agents:tech-writer`
+## Technical Writer (Paige)
 Technical documentation and diagrams.
-**Capabilities:**
-- `*document-project` - Comprehensive project documentation (brownfield analysis)
-- `*generate-mermaid` - Generate Mermaid diagrams (architecture, sequence, flow, ER, class, state)
+**Commands:**
+- `*document-project` - Comprehensive project documentation
+- `*generate-mermaid` - Generate Mermaid diagrams
 - `*create-excalidraw-flowchart` - Process and logic flow visualizations
 - `*create-excalidraw-diagram` - System architecture or technical diagrams
 - `*create-excalidraw-dataflow` - Data flow visualizations
 - `*validate-doc` - Review documentation against standards
 - `*improve-readme` - Review and improve README files
-- `*explain-concept` - Create clear technical explanations with examples
-- `*standards-guide` - Show BMAD documentation standards reference
+- `*explain-concept` - Create clear technical explanations
+- `*standards-guide` - Show BMad documentation standards
 ---
@@ -140,5 +131,11 @@ Available to all agents:
 - `*menu` - Redisplay menu options
 - `*dismiss` - Dismiss agent
+- `*party-mode` - Multi-agent collaboration (most agents)
+---
+## Related
-Party mode is available to most agents for multi-agent collaboration.
+- [Agent Roles](/docs/explanation/core-concepts/agent-roles.md) - Understanding agent responsibilities
+- [What Are Agents](/docs/explanation/core-concepts/what-are-agents.md) - Foundational concepts

package/docs/{modules/core → reference/configuration}/core-tasks.md RENAMED Viewed

@@ -1,6 +1,9 @@
-# Core Tasks
+---
+title: "Core Tasks"
+---
-Core Tasks are reusable task definitions that can be invoked by any BMAD module, workflow, or agent. These tasks provide standardized functionality for common operations.
+Core Tasks are reusable task definitions that can be invoked by any BMad module, workflow, or agent. These tasks provide standardized functionality for common operations.
 ## Table of Contents

package/docs/{modules/core/global-core-config.md → reference/configuration/global-config.md} RENAMED Viewed

@@ -1,4 +1,7 @@
-# Core Module Global Inheritable Config
+---
+title: "Core Module Global Inheritable Config"
+---
 The Core Modules module.yaml file defines configuration values that are useful and unique for all other modules to utilize, and by default all other modules installed will clone the values defined in the core module yaml.config into their own. It is possible for other modules to override these values, but the general intent it to accept the core module values and define their own values as needed, or extend the core values.

package/docs/{modules/bmm-bmad-method/glossary.md → reference/glossary/index.md} RENAMED Viewed

@@ -1,6 +1,9 @@
-# BMM Glossary
+---
+title: "BMad Glossary"
+---
-Comprehensive terminology reference for the BMad Method Module.
+Comprehensive terminology reference for the BMad Method.
 ---
@@ -14,11 +17,16 @@ Comprehensive terminology reference for the BMad Method Module.
 - [Status and Tracking](#status-and-tracking)
 - [Project Types](#project-types)
 - [Implementation Terms](#implementation-terms)
+- [Game Development Terms](#game-development-terms)
 ---
 ## Core Concepts
+### BMad (Breakthrough Method of Agile AI Driven Development)
+AI-driven agile development framework with specialized agents, guided workflows, and scale-adaptive intelligence.
 ### BMM (BMad Method Module)
 Core orchestration system for AI-driven agile development, providing comprehensive lifecycle management through specialized agents and workflows.
@@ -89,7 +97,11 @@ Optional strategic planning document created in Phase 1 (Analysis) that captures
 ### GDD (Game Design Document)
-Game development equivalent of PRD, created by Game Designer agent for game projects.
+Game development equivalent of PRD, created by Game Designer agent for game projects. Comprehensive document detailing all aspects of game design: mechanics, systems, content, and more.
+### Game Brief
+Document capturing the game's core vision, pillars, target audience, and scope. Foundation for the GDD.
 ---
@@ -115,10 +127,6 @@ Architecture design phase. Required for BMad Method and Enterprise Method tracks
 Sprint-based development through story-by-story iteration. Uses sprint-planning, create-story, dev-story, code-review, and retrospective workflows.
-### Documentation (Prerequisite for Brownfield)
-**Conditional prerequisite for brownfield projects.** Creates comprehensive codebase documentation before planning. Only required if existing documentation is insufficient for AI agents. Uses the `document-project` workflow.
 ### Quick Spec Flow
 Fast-track workflow system for Quick Flow track projects that goes straight from idea to tech-spec to implementation, bypassing heavy planning. Designed for bug fixes, small features, and rapid prototyping.
@@ -153,7 +161,7 @@ Agent responsible for test strategy, quality gates, NFR assessment, and comprehe
 ### Technical Writer
-Agent specialized in creating and maintaining high-quality technical documentation. Expert in documentation standards, information architecture, and professional technical writing. The agent's internal name is "paige" but is presented as "Technical Writer" to users.
+Agent specialized in creating and maintaining high-quality technical documentation. Expert in documentation standards, information architecture, and professional technical writing.
 ### UX Designer
@@ -163,13 +171,17 @@ Agent that creates UX design documents, interaction patterns, and visual specifi
 Specialized agent for game development projects. Creates game design documents (GDD) and game-specific workflows.
+### Game Architect
+Agent that designs game system architecture, creates technical architecture for games, and validates game-specific designs.
 ### BMad Master
 Meta-level orchestrator agent from BMad Core. Facilitates party mode, lists available tasks and workflows, and provides high-level guidance across all modules.
 ### Party Mode
-Multi-agent collaboration feature where all installed agents (19+ from BMM, CIS, BMB, custom modules) discuss challenges together in real-time. BMad Master orchestrates, selecting 2-3 relevant agents per message for natural cross-talk and debate. Best for strategic decisions, creative brainstorming, cross-functional alignment, and complex problem-solving. See [Party Mode Guide](./party-mode.md).
+Multi-agent collaboration feature where all installed agents discuss challenges together in real-time. BMad Master orchestrates, selecting 2-3 relevant agents per message for natural cross-talk and debate. Best for strategic decisions, creative brainstorming, cross-functional alignment, and complex problem-solving.
 ---
@@ -190,7 +202,7 @@ backlog → ready-for-dev → in-progress → review → done
 ```
 - **backlog** - Story exists in epic but not yet created
-- **ready-for-dev** - Story file created via create-story; validation is optional (run `validate-create-story` for quality check before dev picks it up)
+- **ready-for-dev** - Story file created via create-story; validation is optional
 - **in-progress** - DEV is implementing via dev-story
 - **review** - Implementation complete, awaiting code-review
 - **done** - Completed with DoD met
@@ -247,6 +259,10 @@ Implementation guidance embedded within story files during the create-story work
 Workflow that initializes Phase 4 implementation by creating sprint-status.yaml, extracting all epics/stories from planning docs, and setting up tracking infrastructure.
+### Sprint
+Time-boxed period of development work, typically 1-2 weeks.
 ### Gate Check
 Validation workflow (implementation-readiness) run before Phase 4 to ensure PRD + Architecture + Epics + UX (optional) are aligned with no gaps or contradictions. Required for BMad Method and Enterprise Method tracks.
@@ -261,6 +277,66 @@ Criteria that must be met before marking a story as done. Typically includes: im
 ---
+## Game Development Terms
+### Core Fantasy
+The emotional experience players seek from your game. What they want to FEEL.
+### Core Loop
+The fundamental cycle of actions players repeat throughout gameplay. The heart of your game.
+### Design Pillar
+Core principle that guides all design decisions. Typically 3-5 pillars define a game's identity.
+### Game Type
+Genre classification that determines which specialized GDD sections are included.
+### Narrative Complexity
+How central story is to the game experience:
+- **Critical** - Story IS the game (visual novels)
+- **Heavy** - Deep narrative with gameplay (RPGs)
+- **Moderate** - Meaningful story supporting gameplay
+- **Light** - Minimal story, gameplay-focused
+### Environmental Storytelling
+Narrative communicated through the game world itself—visual details, audio, found documents—rather than explicit dialogue.
+### MDA Framework
+Mechanics → Dynamics → Aesthetics. Framework for analyzing and designing games.
+### Procedural Generation
+Algorithmic creation of game content (levels, items, characters) rather than hand-crafted.
+### Roguelike
+Genre featuring procedural generation, permadeath, and run-based progression.
+### Metroidvania
+Genre featuring interconnected world exploration with ability-gated progression.
+### Meta-Progression
+Persistent progression that carries between individual runs or sessions.
+### Permadeath
+Game mechanic where character death is permanent, typically requiring a new run.
+### Player Agency
+The degree to which players can make meaningful choices that affect outcomes.
+---
 ## Additional Terms
 ### Workflow Status
@@ -279,10 +355,6 @@ Automatic analysis by workflow-init that uses keyword analysis, complexity indic
 Workflow run during Phase 4 when significant changes or issues arise. Analyzes impact, proposes solutions, and routes to appropriate remediation workflows.
-### Migration Strategy
-Plan for handling changes to existing data, schemas, APIs, or patterns during brownfield development. Critical for ensuring backward compatibility and smooth rollout.
 ### Feature Flags
 Implementation technique for brownfield projects that allows gradual rollout of new functionality, easy rollback, and A/B testing. Recommended for BMad Method and Enterprise brownfield changes.
@@ -291,16 +363,10 @@ Implementation technique for brownfield projects that allows gradual rollout of
 Specific locations where new code connects with existing systems. Must be documented explicitly in brownfield tech-specs and architectures.
-### Convention Detection
-Quick Spec Flow feature that automatically detects existing code style, naming conventions, patterns, and frameworks from brownfield codebases, then asks user to confirm before proceeding.
+### Context Engineering
----
+Loading domain-specific standards and patterns into AI context automatically, rather than relying on prompts alone. In TEA, this means the `tea-index.csv` manifest loads relevant knowledge fragments so the AI doesn't relearn testing patterns each session. This approach ensures consistent, production-ready outputs regardless of prompt variation.
-## Related Documentation
+### Convention Detection
-- [Quick Start Guide](./quick-start.md) - Learn BMM basics
-- [Scale Adaptive System](./scale-adaptive-system.md) - Deep dive on tracks and complexity
-- [Brownfield Guide](./brownfield-guide.md) - Working with existing codebases
-- [Quick Spec Flow](./quick-spec-flow.md) - Fast-track for Quick Flow track
-- [FAQ](./faq.md) - Common questions
+Quick Spec Flow feature that automatically detects existing code style, naming conventions, patterns, and frameworks from brownfield codebases, then asks user to confirm before proceeding.

package/docs/{modules/bmgd-bmad-game-dev/workflows-guide.md → reference/workflows/bmgd-workflows.md} RENAMED Viewed

@@ -1,4 +1,7 @@
-# BMGD Workflows Guide
+---
+title: "BMGD Workflows Guide"
+---
 Complete reference for all BMGD workflows organized by development phase.
@@ -8,7 +11,7 @@ Complete reference for all BMGD workflows organized by development phase.
 BMGD workflows are organized into four phases:
-![BMGD Workflow Overview](../../../../docs/modules/bmgd-bmad-game-dev/workflow-overview.jpg)
+![BMGD Workflow Overview](../../tutorials/getting-started/images/workflow-overview.jpg)
 ---
@@ -161,7 +164,7 @@ Production workflows inherit from BMM and add game-specific overrides.
 **Command:** `sprint-planning`
 **Agent:** Game Scrum Master
 **Input:** GDD with epics
-**Output:** `{output_folder}/sprint-status.yaml`
+**Output:** `{implementation_artifacts}/sprint-status.yaml`
 **Description:**
 Generates or updates sprint tracking from epic files. Sets up the sprint backlog and tracking.
@@ -259,7 +262,7 @@ Checks current project status across all phases. Shows completed documents, curr
 ## Quick-Flow Workflows
-Fast-track workflows that skip full planning phases. See **[Quick-Flow Guide](../../../../docs/modules/bmgd-bmad-game-dev/quick-flow-guide.md)** for detailed usage.
+Fast-track workflows that skip full planning phases. See **[Quick-Flow Guide](/docs/how-to/workflows/bmgd-quick-flow.md)** for detailed usage.
 ### Quick-Prototype
@@ -457,7 +460,7 @@ This means:
 ## Next Steps
-- **[Quick Start Guide](../../../../docs/modules/bmgd-bmad-game-dev/quick-start.md)** - Get started with BMGD
-- **[Quick-Flow Guide](../../../../docs/modules/bmgd-bmad-game-dev/quick-flow-guide.md)** - Rapid prototyping and development
-- **[Agents Guide](../../../../docs/modules/bmgd-bmad-game-dev/agents-guide.md)** - Agent reference
-- **[Game Types Guide](../../../../docs/modules/bmgd-bmad-game-dev/game-types-guide.md)** - Game type templates
+- **[Quick Start Guide](/docs/tutorials/getting-started/quick-start-bmgd.md)** - Get started with BMGD
+- **[Quick-Flow Guide](/docs/how-to/workflows/bmgd-quick-flow.md)** - Rapid prototyping and development
+- **[Agents Guide](/docs/explanation/game-dev/agents.md)** - Agent reference
+- **[Game Types Guide](/docs/explanation/game-dev/game-types.md)** - Game type templates

package/docs/{modules/core → reference/workflows}/core-workflows.md RENAMED Viewed

@@ -1,18 +1,21 @@
-# Core Workflows
+---
+title: "Core Workflows"
+---
-Core Workflows are domain-agnostic workflows that can be utilized by any BMAD-compliant module, workflow, or agent. These workflows are installed by default and available at any time.
+Core Workflows are domain-agnostic workflows that can be utilized by any BMad-compliant module, workflow, or agent. These workflows are installed by default and available at any time.
 ## Available Core Workflows
-### [Party Mode](party-mode.md)
+### [Party Mode](/docs/explanation/features/party-mode.md)
-Orchestrate dynamic multi-agent conversations with your entire BMAD team. Engage with multiple specialized perspectives simultaneously—each agent maintaining their unique personality, expertise, and communication style.
+Orchestrate dynamic multi-agent conversations with your entire BMad team. Engage with multiple specialized perspectives simultaneously—each agent maintaining their unique personality, expertise, and communication style.
-### [Brainstorming](brainstorming.md)
+### [Brainstorming](/docs/explanation/features/brainstorming-techniques.md)
 Facilitate structured creative sessions using 60+ proven ideation techniques. The AI acts as coach and guide, using proven creativity methods to draw out ideas and insights that are already within you.
-### [Advanced Elicitation](advanced-elicitation.md)
+### [Advanced Elicitation](/docs/explanation/features/advanced-elicitation.md)
 Push the LLM to rethink its work through 50+ reasoning methods—the inverse of brainstorming. The LLM applies sophisticated techniques to re-examine and enhance content it has just generated, essentially "LLM brainstorming" to find better approaches and uncover improvements.

package/docs/{modules/bmm-bmad-method/workflow-document-project-reference.md → reference/workflows/document-project.md} RENAMED Viewed

@@ -1,6 +1,9 @@
-# Document Project Workflow - Technical Reference
+---
+title: "Document Project Workflow - Technical Reference"
+---
-**Module:** BMM (BMAD Method Module)
+**Module:** BMM (BMad Method Module)
 ## Purpose
@@ -67,5 +70,5 @@ The workflow can be interrupted and resumed without losing progress:
 **Related Documentation:**
-- [Brownfield Development Guide](./brownfield-guide.md)
-- [Implementation Workflows](./workflows-implementation.md)
+- [Brownfield Development Guide](/docs/how-to/brownfield/index.md)
+- [Implementation Workflows](/docs/how-to/workflows/run-sprint-planning.md)

package/docs/reference/workflows/index.md ADDED Viewed

@@ -0,0 +1,16 @@
+---
+title: "Workflows Reference"
+description: Reference documentation for BMad Method workflows
+---
+Complete reference documentation for all BMad Method workflows.
+## Core Workflows
+- [Core Workflows](/docs/reference/workflows/core-workflows.md) - Domain-agnostic workflows available to all modules
+- [Document Project](/docs/reference/workflows/document-project.md) - Brownfield project documentation workflow
+## Module-Specific Workflows
+- [BMGD Workflows](/docs/reference/workflows/bmgd-workflows.md) - Game development workflows