BMAD-METHOD/src/modules/bmgd
sjennings ccb64623bc
feat(bmgd): comprehensive BMGD module upgrade (#1151)
* feat(bmgd): comprehensive BMGD module upgrade

## New Agents
- **Game QA (GLaDOS)**: Game QA Architect + Test Automation Specialist
  - Engine-specific testing (Unity, Unreal, Godot)
  - Knowledge base with 15+ testing topics
  - Workflows: test-framework, test-design, automate, playtest-plan, performance-test, test-review

- **Game Solo Dev (Indie)**: Elite Indie Game Developer + Quick Flow Specialist
  - Rapid prototyping and iteration focused
  - Quick-flow workflows for solo/small team development

## Production Workflow Alignment
Aligned BMGD 4-production workflows with BMM 4-implementation:

### Removed Obsolete Workflows
- story-done (merged into dev-story)
- story-ready (merged into create-story)
- story-context (merged into create-story)
- epic-tech-context (no longer separate workflow)

### Added Workflows
- sprint-status: View sprint progress, surface risks, recommend next action

### Updated Workflows (now standalone, copied from BMM)
- code-review: Adversarial review with instructions.xml
- correct-course: Sprint change management
- create-story: Direct ready-for-dev marking
- dev-story: TDD implementation with instructions.xml
- retrospective: Epic completion review
- sprint-planning: Sprint status generation

## Game Testing Architecture (gametest/)
New knowledge base for game-specific testing:
- qa-index.csv: Knowledge fragment index
- 15 knowledge files covering:
  - Engine-specific: Unity, Unreal, Godot testing
  - Game-specific: Playtesting, balance, save systems, multiplayer
  - Platform: Certification (TRC/XR), localization, input
  - General QA: Automation, performance, regression, smoke tests

## Quick-Flow Workflows (bmgd-quick-flow/)
- quick-prototype: Rapid mechanic testing
- quick-dev: Flexible feature implementation

## Documentation
Complete documentation suite in docs/:
- README.md: Documentation index
- quick-start.md: Getting started guide
- agents-guide.md: All 6 agents reference
- workflows-guide.md: Complete workflow reference
- quick-flow-guide.md: Rapid development guide
- game-types-guide.md: 24 game type templates
- glossary.md: Game dev terminology
- troubleshooting.md: Common issues

## Teams & Installer
- Updated team-gamedev.yaml with all 6 agents and workflows
- Updated default-party.csv with Game QA and Game Solo Dev
- Created _module-installer/ with:
  - installer.js: Creates directories, logs engine selection
  - platform-specifics/: Claude Code and Windsurf handlers

## Agent Updates
All agents now reference standalone BMGD workflows:
- game-architect: correct-course → BMGD
- game-dev: dev-story, code-review → BMGD
- game-scrum-master: All production workflows → BMGD
- game-solo-dev: code-review → BMGD

## Module Configuration
- Added sprint_artifacts alias for workflow compatibility
- All workflows use bmgd/config.yaml

* fix(bmgd): update sprint-status workflow to reference bmgd instead of bmm

Replace all /bmad:bmm:workflows references with /bmad:bmgd:workflows
in the sprint-status workflow instructions.

* feat(bmgd): add workflow-status and create-tech-spec workflows

Add BMGD-native workflow-status and create-tech-spec workflows,
replacing all BMM references with BMGD paths.

## New Workflows

### workflow-status
- Multi-mode status checker for game projects
- Game-specific project levels (Game Jam → AAA)
- Workflow paths: gamedev-greenfield, gamedev-brownfield,
  quickflow-greenfield, quickflow-brownfield
- Init workflow for new game project setup

### create-tech-spec
- Game-focused spec engineering workflow
- Engine-aware (Unity/Unreal/Godot)
- Performance and gameplay feel considerations

## Agent Updates
Updated all BMGD agents to reference BMGD workflows:
- game-architect, game-designer, game-dev, game-qa,
  game-scrum-master, game-solo-dev

All agents now use /bmad:bmgd:workflows instead of /bmad:bmm:workflows

* fix(bmgd): address PR review findings and enhance playtesting docs

## PR Review Fixes (F1-F20)

### Configuration & Naming
- F1: Changed user_skill_level to game_dev_experience in module.yaml
- F3: Renamed gametest/framework to gametest/test-framework

### Cleanup
- F2: Deleted 4 orphaned root-level template files
- F6: Removed duplicate code block in create-story/instructions.xml
- F9: Removed trailing empty line from qa-index.csv
- F20: Deleted orphaned docs/unnamed.jpg

### Installer Improvements
- F7: Simplified platform handler stubs (removed unused code)
- F8: Added return value checking for platform handlers
- F13: Added path traversal validation (isWithinProjectRoot)
- F18: Added type validation for config string values

### Agent Fixes
- F10: Added workflow-status and advanced-elicitation to game-solo-dev
- F12: Fixed "GOTO step 2a" → "GOTO step 2" references
- F14: Removed duplicate project-context.md from principles in 5 agents

### Workflow Updates
- F17: Added input_file_patterns to playtest-plan workflow

### Documentation
- F4-F5: Updated quick-start.md with 6 agents and fixed table
- Updated workflows-guide.md with test-framework reference

### Knowledge Base Updates (from earlier CodeRabbit comments)
- Updated unity-testing.md to Test Framework 1.6.0
- Fixed unreal-testing.md (MarkAsGarbage, UnrealEditor.exe)
- Added FVerifyPlayerMoved note to smoke-testing.md
- Fixed certification-testing.md table formatting

### Playtesting Documentation Enhancement
- Added "Playtesting by Game Type" section (7 genres)
- Added "Processing Feedback Effectively" section
- Expanded from ~138 to ~340 lines

* refactor(bmgd): use exec for step-file workflows and multi format

Update agent menu items to use correct notation for step-file workflows:

**game-designer.agent.yaml:**
- Convert 4 step-file workflows to multi format with shortcodes:
  - [BG] brainstorm-game
  - [GB] create-game-brief
  - [GDD] create-gdd
  - [ND] narrative
- Changed from workflow: .yaml to exec: .md

**game-architect.agent.yaml:**
- Changed create-architecture from workflow: to exec: with workflow.md

---------

Co-authored-by: Scott Jennings <scott.jennings+CIGINT@cloudimperiumgames.com>
2025-12-17 14:33:22 +08:00
..
_module-installer feat(bmgd): comprehensive BMGD module upgrade (#1151) 2025-12-17 14:33:22 +08:00
agents feat(bmgd): comprehensive BMGD module upgrade (#1151) 2025-12-17 14:33:22 +08:00
docs feat(bmgd): comprehensive BMGD module upgrade (#1151) 2025-12-17 14:33:22 +08:00
gametest feat(bmgd): comprehensive BMGD module upgrade (#1151) 2025-12-17 14:33:22 +08:00
teams feat(bmgd): comprehensive BMGD module upgrade (#1151) 2025-12-17 14:33:22 +08:00
workflows feat(bmgd): comprehensive BMGD module upgrade (#1151) 2025-12-17 14:33:22 +08:00
README.md folder rename from .bmad to _bmad 2025-12-13 16:22:34 +08:00
module.yaml feat(bmgd): comprehensive BMGD module upgrade (#1151) 2025-12-17 14:33:22 +08:00

README.md

BMad Game Development (BMGD)

A comprehensive game development toolkit providing specialized agents and workflows for creating games from initial concept through production.

Overview

The BMGD module brings together game-specific development workflows organized around industry-standard development phases:

  • Preproduction - Concept development, brainstorming, game brief creation
  • Design - Game Design Document (GDD) and narrative design
  • Technical - Game architecture and technical specifications
  • Production - Sprint-based implementation using BMM workflows

Installation

bmad install bmgd

During installation, you'll be asked to configure:

  • Game project name
  • Document storage locations
  • Development experience level
  • Primary target platform

Components

Agents (4)

Game Designer 🎨 Creative vision and game design documentation specialist. Creates compelling GDDs and defines game mechanics.

Game Developer 🕹️ Senior implementation specialist with expertise across Unity, Unreal, and custom engines. Handles gameplay programming, physics, AI, and optimization.

Game Architect 🏗️ Technical systems and infrastructure expert. Designs scalable game architecture and engine-level solutions.

Game Dev Scrum Master 🎯 Sprint orchestrator specialized in game development workflows. Coordinates multi-disciplinary teams and translates GDDs into actionable development stories.

Team Bundle

Team Game Development 🎮 Pre-configured team including Game Designer, Game Developer, and Game Architect for comprehensive game projects.

Workflows

Phase 1: Preproduction

  • brainstorm-game - Interactive game concept brainstorming
  • game-brief - Create focused game brief document

Phase 2: Design

  • gdd - Generate comprehensive Game Design Document
  • narrative - Design narrative structure and story elements

Phase 3: Technical

  • game-architecture - Define technical architecture (adapted from BMM architecture workflow)

Phase 4: Production

Production workflows are provided by the BMM module and accessible through the Game Dev Scrum Master agent:

  • Sprint planning
  • Story creation and management
  • Epic technical specifications
  • Code review and retrospectives

Quick Start

1. Start with Concept Development

Load agent: game-designer
Run workflow: brainstorm-game

2. Create Game Brief

Run workflow: game-brief

3. Develop Game Design Document

Run workflow: gdd

4. Define Technical Architecture

Load agent: game-architect
Run workflow: game-architecture

5. Begin Production Sprints

Load agent: game-scrum-master
Run: *sprint-planning

Module Structure

bmgd/
├── agents/
│   ├── game-designer.agent.yaml
│   ├── game-dev.agent.yaml
│   ├── game-architect.agent.yaml
│   └── game-scrum-master.agent.yaml
├── teams/
│   └── team-gamedev.yaml
├── workflows/
│   ├── 1-preproduction/
│   │   ├── brainstorm-game/
│   │   └── game-brief/
│   ├── 2-design/
│   │   ├── gdd/
│   │   └── narrative/
│   ├── 3-technical/
│   │   └── game-architecture/
│   └── 4-production/
│       (Uses BMM workflows via cross-module references)
├── templates/
├── data/
├── module.yaml
└── _module-installer/
    └── installer.js (optional)

Configuration

After installation, configure the module in _bmad/bmgd/config.yaml

Key settings:

  • game_project_name - Your game's working title
  • game_design_docs - Location for GDD and design documents
  • game_tech_docs - Location for technical documentation
  • game_story_location - Location for development user stories
  • game_dev_experience - Your experience level (affects agent communication)
  • primary_platform - Target platform (PC, mobile, console, web, multi-platform)

Workflow Integration

BMGD leverages the BMM module for production/implementation workflows. The Game Dev Scrum Master agent provides access to:

  • Sprint planning and management
  • Story creation from GDD specifications
  • Epic technical context generation
  • Code review workflows
  • Retrospectives and course correction

This separation allows BMGD to focus on game-specific design and architecture while using battle-tested agile implementation workflows.

Example: Creating a 2D Platformer

  1. Brainstorm concepts with brainstorm-game workflow
  2. Define the vision with game-brief workflow
  3. Design mechanics and progression with gdd workflow
  4. Craft character arcs and story with narrative workflow
  5. Architect technical systems with game-architecture workflow
  6. Implement via Game Dev Scrum Master sprint workflows

Development Roadmap

Phase 1: Core Enhancement

  • Customize game-architecture workflow for game-specific patterns
  • Add game-specific templates (level design, character sheets, etc.)
  • Create asset pipeline workflows

Phase 2: Expanded Features

  • Add monetization planning workflows
  • Create playtesting and feedback workflows
  • Develop game balancing tools

Phase 3: Platform Integration

  • Add platform-specific deployment workflows
  • Create build and release automation
  • Develop live ops workflows

Contributing

To extend this module:

  1. Add new agents using /bmad:bmb:workflows:create-agent
  2. Add new workflows using /bmad:bmb:workflows:create-workflow
  3. Submit improvements via pull request

Dependencies

  • BMM Module - Required for production/implementation workflows

Author

Extracted and refined from BMM module on 2025-11-05

License

Part of the BMAD Method ecosystem