* 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> |
||
|---|---|---|
| .. | ||
| _module-installer | ||
| agents | ||
| docs | ||
| gametest | ||
| teams | ||
| workflows | ||
| README.md | ||
| module.yaml | ||
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
- Brainstorm concepts with
brainstorm-gameworkflow - Define the vision with
game-briefworkflow - Design mechanics and progression with
gddworkflow - Craft character arcs and story with
narrativeworkflow - Architect technical systems with
game-architectureworkflow - 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:
- Add new agents using
/bmad:bmb:workflows:create-agent - Add new workflows using
/bmad:bmb:workflows:create-workflow - 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