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

package/src/modules/bmgd/docs/index.md

@@ -1,180 +0,0 @@
-# BMGD Documentation
-
-Complete guides for the BMad Game Development Module (BMGD) - AI-powered workflows for game design and development that adapt to your project's needs.
-
----
-
-## Getting Started
-
-**New to BMGD?** Start here:
-
-- **[Quick Start Guide](./quick-start.md)** - Get started building your first game
-  - Installation and setup
-  - Understanding the game development phases
-  - Running your first workflows
-  - Agent-based development flow
-
-**Quick Path:** Install BMGD module → Game Brief → GDD → Architecture → Build
-
----
-
-## Core Concepts
-
-Understanding how BMGD works:
-
-- **[Agents Guide](./agents-guide.md)** - Complete reference for game development agents
-  - Game Designer, Game Developer, Game Architect, Game Scrum Master, Game QA, Game Solo Dev
-  - Agent roles and when to use them
-  - Agent workflows and menus
-
-- **[Workflows Guide](./workflows-guide.md)** - Complete workflow reference
-  - Phase 1: Preproduction (Brainstorm, Game Brief)
-  - Phase 2: Design (GDD, Narrative)
-  - Phase 3: Technical (Architecture)
-  - Phase 4: Production (Sprint-based development)
-
-- **[Game Types Guide](./game-types-guide.md)** - Selecting and using game type templates
-  - 24 supported game types
-  - Genre-specific GDD sections
-  - Hybrid game type handling
-
-- **[Quick-Flow Guide](./quick-flow-guide.md)** - Fast-track workflows for rapid development
-  - Quick-Prototype for testing ideas
-  - Quick-Dev for flexible implementation
-  - When to use quick-flow vs full BMGD
-
----
-
-## Quick References
-
-Essential reference materials:
-
-- **[Glossary](./glossary.md)** - Key game development terminology
-- **[Troubleshooting](./troubleshooting.md)** - Common issues and solutions
-
----
-
-## Choose Your Path
-
-### I need to...
-
-**Start a new game project**
-→ Start with [Quick Start Guide](./quick-start.md)
-→ Run `brainstorm-game` for ideation
-→ Create a Game Brief with `create-brief`
-
-**Design my game**
-→ Create a GDD with `create-gdd`
-→ If story-heavy, add Narrative Design with `create-narrative`
-
-**Plan the technical architecture**
-→ Run `create-architecture` with the Game Architect
-
-**Build my game**
-→ Use Phase 4 production workflows
-→ Follow the sprint-based development cycle
-
-**Quickly test an idea or implement a feature**
-→ Use [Quick-Flow](./quick-flow-guide.md) for rapid prototyping and development
-→ `quick-prototype` to test mechanics, `quick-dev` to implement
-
-**Set up testing and QA**
-→ Use Game QA agent for test framework setup
-→ Run `test-framework` to initialize testing for Unity/Unreal/Godot
-→ Use `test-design` to create test scenarios
-→ Plan playtests with `playtest-plan`
-
-**Understand game type templates**
-→ See [Game Types Guide](./game-types-guide.md)
-
----
-
-## Game Development Phases
-
-BMGD follows four phases aligned with game development:
-
-![BMGD Workflow Overview](./workflow-overview.jpg)
-
-### Phase 1: Preproduction
-
-- **Brainstorm Game** - Ideation with game-specific techniques
-- **Game Brief** - Capture vision, market, and fundamentals
-
-### Phase 2: Design
-
-- **GDD (Game Design Document)** - Comprehensive game design
-- **Narrative Design** - Story, characters, world (for story-driven games)
-
-### Phase 3: Technical
-
-- **Game Architecture** - Engine, systems, patterns, structure
-
-### Phase 4: Production
-
-- **Sprint Planning** - Epic and story management
-- **Story Development** - Implementation workflow
-- **Code Review** - Quality assurance
-- **Testing** - Automated tests, playtesting, performance
-- **Retrospective** - Continuous improvement
-
----
-
-## BMGD vs BMM
-
-BMGD extends BMM with game-specific capabilities:
-
-| Aspect         | BMM                                   | BMGD                                                                     |
-| -------------- | ------------------------------------- | ------------------------------------------------------------------------ |
-| **Focus**      | General software                      | Game development                                                         |
-| **Agents**     | PM, Architect, Dev, SM, TEA, Solo Dev | Game Designer, Game Dev, Game Architect, Game SM, Game QA, Game Solo Dev |
-| **Planning**   | PRD, Tech Spec                        | Game Brief, GDD                                                          |
-| **Types**      | N/A                                   | 24 game type templates                                                   |
-| **Narrative**  | N/A                                   | Full narrative workflow                                                  |
-| **Testing**    | Web-focused testarch                  | Engine-specific (Unity, Unreal, Godot)                                   |
-| **Production** | Inherited from BMM                    | BMM workflows with game overrides                                        |
-
-BMGD production workflows inherit from BMM and add game-specific checklists and templates.
-
----
-
-## Documentation Map
-
-```
-BMGD Documentation
-├── README.md (this file)
-├── quick-start.md          # Getting started
-├── agents-guide.md         # Agent reference
-├── workflows-guide.md      # Workflow reference
-├── quick-flow-guide.md     # Rapid prototyping and development
-├── game-types-guide.md     # Game type templates
-├── glossary.md             # Terminology
-└── troubleshooting.md      # Common issues
-```
-
----
-
-## External Resources
-
-### Community and Support
-
-- **[Discord Community](https://discord.gg/gk8jAdXWmj)** - Get help from the community
-- **[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
-
-### Related Documentation
-
-- **[BMM Documentation](../../bmm/docs/index.md)** - Core BMad Method documentation
-- **[IDE Guides](../../ide-info/)** - Configure your development environment
-
----
-
-## Tips for Using This Documentation
-
-1. **Start with Quick Start** if you're new to BMGD
-2. **Check Game Types Guide** when creating your GDD
-3. **Reference Glossary** for game development terminology
-4. **Use Troubleshooting** when you encounter issues
-
----
-
-**Ready to make games?** → [Start with the Quick Start Guide](./quick-start.md)

package/src/modules/bmgd/docs/quick-start.md

@@ -1,250 +0,0 @@
-# BMGD Quick Start Guide
-
-Get started building games with the BMad Game Development Module.
-
----
-
-## Prerequisites
-
-Before starting with BMGD, ensure you have:
-
-1. **BMAD-METHOD installed** - Follow the main installation guide
-2. **A game idea** - Even a rough concept is enough to start
-3. **Your preferred AI tool** - Claude Code, Cursor, or web-based chat
-
----
-
-## Installation
-
-BMGD is a custom module that extends BMM. Install it using the BMAD installer:
-
-```bash
-# During installation, select BMGD when prompted for custom modules
-npx bmad-cli install
-```
-
-Or add to an existing installation:
-
-```bash
-npx bmad-cli install --add-module bmgd
-```
-
----
-
-## Understanding the Phases
-
-BMGD follows four game development phases:
-
-![BMGD Workflow Overview](./workflow-overview.jpg)
-
-### Phase 1: Preproduction
-
-**What happens:** Capture your game vision and core concept.
-
-**Workflows:**
-
-- `brainstorm-game` - Guided ideation with game-specific techniques
-- `create-game-brief` - Document vision, market, pillars, and fundamentals
-
-**Output:** Game Brief document
-
-### Phase 2: Design
-
-**What happens:** Detail your game's mechanics, systems, and (optionally) narrative.
-
-**Workflows:**
-
-- `create-gdd` - Create comprehensive Game Design Document
-- `narrative` - Create Narrative Design Document (for story-driven games)
-
-**Output:** GDD (and Narrative Design document if applicable)
-
-### Phase 3: Technical
-
-**What happens:** Plan how you'll build the game.
-
-**Workflows:**
-
-- `create-architecture` - Define engine, systems, patterns, and structure
-
-**Output:** Game Architecture document
-
-### Phase 4: Production
-
-**What happens:** Build your game in sprints.
-
-**Workflows:**
-
-- `sprint-planning` - Plan and track sprints
-- `sprint-status` - View progress and get recommendations
-- `create-story` - Create implementable stories
-- `dev-story` - Implement stories
-- `code-review` - Quality assurance
-- `retrospective` - Learn and improve after epics
-
-**Output:** Working game code
-
----
-
-## Your First Game Project
-
-### Step 1: Start with Brainstorming (Optional)
-
-If you have a vague idea and want help developing it:
-
-```
-You: brainstorm-game
-Agent: [Guides you through game-specific ideation techniques]
-```
-
-### Step 2: Create Your Game Brief
-
-Capture your game's core vision:
-
-```
-You: create-game-brief
-Agent: [Walks you through game concept, pillars, market, and fundamentals]
-```
-
-**Output:** `{output_folder}/game-brief.md`
-
-### Step 3: Create Your GDD
-
-Detail your game's design:
-
-```
-You: create-gdd
-Agent: [Guides you through mechanics, systems, and game-type-specific sections]
-```
-
-**Output:** `{output_folder}/gdd.md` (or sharded into `{output_folder}/gdd/`)
-
-### Step 4: Add Narrative Design (If Story-Driven)
-
-For games with significant story:
-
-```
-You: narrative
-Agent: [Facilitates story, characters, world, and dialogue design]
-```
-
-**Output:** `{output_folder}/narrative-design.md`
-
-### Step 5: Create Architecture
-
-Plan your technical implementation:
-
-```
-You: create-architecture
-Agent: [Guides engine selection, system design, and technical decisions]
-```
-
-**Output:** `{output_folder}/game-architecture.md`
-
-### Step 6: Start Building
-
-Begin sprint-based development:
-
-```
-You: sprint-planning
-Agent: [Sets up sprint tracking and epic management]
-```
-
----
-
-## Choosing Your Agent
-
-BMGD provides six specialized agents:
-
-| Agent                 | Icon | When to Use                               |
-| --------------------- | ---- | ----------------------------------------- |
-| **Game Designer**     | 🎲   | Brainstorming, Game Brief, GDD, Narrative |
-| **Game Architect**    | 🏛️   | Architecture, technical decisions         |
-| **Game Developer**    | 🕹️   | Implementation, code reviews              |
-| **Game Scrum Master** | 🎯   | Sprint planning, story management         |
-| **Game QA**           | 🧪   | Test framework, test design, automation   |
-| **Game Solo Dev**     | 🎮   | Quick prototyping, indie development      |
-
-### Typical Flow
-
-1. **Game Designer** (Phases 1-2): Brainstorm → Brief → GDD → Narrative
-2. **Game Architect** (Phase 3): Architecture
-3. **Game Scrum Master** (Phase 4): Sprint planning, story creation
-4. **Game Developer** (Phase 4): Implementation, code reviews
-
----
-
-## Quick Command Reference
-
-### Phase 1: Preproduction
-
-- `brainstorm-game` - Ideation session
-- `create-game-brief` - Create Game Brief
-
-### Phase 2: Design
-
-- `create-gdd` - Create GDD
-- `narrative` - Create Narrative Design
-
-### Phase 3: Technical
-
-- `create-architecture` - Create Architecture
-
-### Phase 4: Production
-
-- `sprint-planning` - Plan sprints
-- `sprint-status` - View progress and recommendations
-- `create-story` - Create story
-- `dev-story` - Implement story
-- `code-review` - Review code
-- `retrospective` - Team retrospective
-- `correct-course` - Handle sprint changes
-
-### Quick-Flow (Fast-Track)
-
-- `quick-prototype` - Rapid prototyping (IDE only)
-- `quick-dev` - Flexible development (IDE only)
-
-### Utility
-
-- `workflow-status` - Check project status
-- `party-mode` - Multi-agent collaboration
-- `advanced-elicitation` - Deep exploration
-
----
-
-## Tips for Success
-
-### 1. Start Small
-
-Begin with a simple game concept. You can always expand later.
-
-### 2. Use Game Type Templates
-
-When creating your GDD, BMGD offers 24 game type templates that provide genre-specific sections.
-
-### 3. Iterate
-
-Documents are living artifacts. Return to update them as your vision evolves.
-
-### 4. Trust the Process
-
-Each workflow builds on previous outputs. The Game Brief informs the GDD, which informs the Architecture, which informs implementation.
-
-### 5. Collaborate with Agents
-
-Use `party-mode` to get perspectives from multiple agents when facing complex decisions.
-
----
-
-## Next Steps
-
-- **[Agents Guide](./agents-guide.md)** - Learn about each agent's capabilities
-- **[Workflows Guide](./workflows-guide.md)** - Detailed workflow reference
-- **[Quick-Flow Guide](./quick-flow-guide.md)** - Rapid prototyping and development
-- **[Game Types Guide](./game-types-guide.md)** - Understand game type templates
-- **[Glossary](./glossary.md)** - Game development terminology
-
----
-
-**Ready to start?** Chat with the **Game Designer** agent and say `brainstorm-game` or `create-game-brief`!

package/src/modules/bmm/README.md

@@ -1,127 +0,0 @@
-# BMM - BMad Method Module
-
-Core orchestration system for AI-driven agile development, providing comprehensive lifecycle management through specialized agents and workflows.
-
----
-
-## 📚 Complete Documentation
-
-👉 **[BMM Documentation Hub](./docs/index.md)** - Start here for complete guides, tutorials, and references
-
-**Quick Links:**
-
-- **[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
-
----
-
-## 🏗️ Module Structure
-
-This module contains:
-
-```
-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
-```
-
-### Agent Roster
-
-**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)
-
-👉 **[Full Agents Guide](./docs/agents-guide.md)** - Roles, workflows, and when to use each agent
-
-### Workflow Phases
-
-**Phase 0:** Documentation (brownfield only)
-**Phase 1:** Analysis (optional) - 5 workflows
-**Phase 2:** Planning (required) - 2 workflows
-**Phase 3:** Solutioning (required) - 3 workflows
-**Phase 4:** Implementation (iterative) - 7 workflows
-
-👉 **[Workflow Guides](./docs/index.md#-workflow-guides)** - Detailed documentation for each phase
-
----
-
-## 🚀 Getting Started
-
-**New Project:**
-
-```bash
-# Install BMM
-npx bmad-method@alpha install
-
-# Load Analyst agent in your IDE, then:
-*workflow-init
-```
-
-**Existing Project (Brownfield):**
-
-```bash
-# Document your codebase first
-*document-project
-
-# Then initialize
-*workflow-init
-```
-
-👉 **[Quick Start Guide](./docs/quick-start.md)** - Complete setup and first project walkthrough
-
----
-
-## 🎯 Key Concepts
-
-### Scale-Adaptive Design
-
-BMM automatically adjusts to project complexity (Levels 0-4):
-
-- **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
-
-👉 **[Scale Adaptive System](./docs/scale-adaptive-system.md)** - Complete level breakdown
-
-### Story-Centric Implementation
-
-Stories move through a defined lifecycle: `backlog → ready-for-dev → in-progress → review → done`
-
-Just-in-time epic context and story context provide exact expertise when needed.
-
-👉 **[Implementation Workflows](./docs/workflows-implementation.md)** - Complete story lifecycle guide
-
-### Multi-Agent Collaboration
-
-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.
-
-👉 **[Party Mode Guide](./docs/party-mode.md)** - How to orchestrate multi-agent collaboration
-
----
-
-## 📖 Additional Resources
-
-- **[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.
-
----
-
-## 🤝 Community
-
-- **[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
-
----
-
-**Ready to build?** → [Start with the Quick Start Guide](./docs/quick-start.md)