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>
ccb64623bc