ccb64623bc
* 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>
BMad Method & BMad Core
🎉 NEW: BMAD V6 Installer - Create & Share Custom Content!
The completely revamped BMAD V6 installer now includes built-in support for creating, installing, and sharing custom modules, agents, workflows, templates, and tools! Build your own AI solutions or share them with your team - and real soon, with the whole BMad Community througha verified community sharing portal!
✨ What's New:
- 📦 Streamlined Custom Module Installation - Package your custom content as installable modules
- 🤖 Agent & Workflow Sharing - Distribute standalone agents and workflows
- 🔄 Unitary Module Support - Install individual components without full modules
- ⚙️ Dependency Management - Automatic handling of module dependencies
- 🛡️ Update-Safe Customization - Your custom content persists through updates
📚 Learn More:
- Custom Content Overview - Discover all supported content types
- Installation Guide - Learn to create and install custom content
- Detail Content Docs - Reference details for agents, modules, workflows and the bmad builder
- 2 Very simple Custom Modules of questionable quality - if you want to download and try to install a custom shared module, get an idea of how to bundle and share your own, or create your own personal agents, workflows and modules.
AI-Driven Agile Development That Scales From Bug Fixes to Enterprise
Build More, Architect Dreams (BMAD) with 21 specialized AI agents across 4 official modules, and 50+ guided workflows that adapt to your project's complexity—from quick bug fixes to enterprise platforms, and new step file workflows that allow for incredibly long workflows to stay on the rails longer than ever before!
Additionally - when we say 'Build More, Architect Dreams' - we mean it! The BMad Builder has landed, and now as of Alpha.15 is fully supported in the installation flow via NPX - custom stand along agents, workflows and the modules of your dreams! The community forge will soon open, endless possibility awaits!
🚀 v6 is a MASSIVE upgrade from v4! Complete architectural overhaul, scale-adaptive intelligence, visual workflows, and the powerful BMad Core framework. v4 users: this changes everything. See what's new →
📌 v6 Alpha Status: Near-beta quality with vastly improved stability. Documentation is being finalized. New videos coming soon to BMadCode YouTube.
🎯 Why BMad Method?
Unlike generic AI coding assistants, BMad Method provides structured, battle-tested workflows powered by specialized agents who understand agile development. Each agent has deep domain expertise—from product management to architecture to testing—working together seamlessly.
✨ Key Benefits:
- Scale-Adaptive Intelligence - Automatically adjusts planning depth from bug fixes to enterprise systems
- Complete Development Lifecycle - Analysis → Planning → Architecture → Implementation
- Specialized Expertise - 19 agents with specific roles (PM, Architect, Developer, UX Designer, etc.)
- Proven Methodologies - Built on agile best practices with AI amplification
- IDE Integration - Works with Claude Code, Cursor, Windsurf, VS Code
🏗️ The Power of BMad Core
BMad Method is actually a sophisticated module built on top of BMad Core (Collaboration Optimized Reflection Engine). This revolutionary architecture means:
- BMad Core provides the universal framework for human-AI collaboration
- BMad Method leverages Core to deliver agile development workflows
- BMad Builder lets YOU create custom modules as powerful as BMad Method itself
With BMad Builder, you can architect both simple agents and vastly complex domain-specific modules (legal, medical, finance, education, creative) that will soon be sharable in an official community marketplace. Imagine building and sharing your own specialized AI team!
📊 See It In Action
Complete BMad Method workflow showing all phases, agents, and decision points
🚀 Get Started in 3 Steps
1. Install BMad Method
# Install v6 Alpha (recommended)
npx bmad-method@alpha install
# Or stable v4 for production
npx bmad-method install
2. Initialize Your Project
Load any agent in your IDE and run:
*workflow-init
This analyzes your project and recommends the right workflow track.
3. Choose Your Track
BMad Method adapts to your needs with three intelligent tracks:
| Track | Use For | Planning | Time to Start |
|---|---|---|---|
| ⚡ Quick Flow | Bug fixes, small features | Tech spec only | < 5 minutes |
| 📋 BMad Method | Products, platforms | PRD + Architecture + UX | < 15 minutes |
| 🏢 Enterprise | Compliance, scale | Full governance suite | < 30 minutes |
Not sure? Run
*workflow-initand let BMad analyze your project goal.
🔄 How It Works: 4-Phase Methodology
BMad Method guides you through a proven development lifecycle:
- 📊 Analysis (Optional) - Brainstorm, research, and explore solutions
- 📝 Planning - Create PRDs, tech specs, or game design documents
- 🏗️ Solutioning - Design architecture, UX, and technical approach
- ⚡ Implementation - Story-driven development with continuous validation
Each phase has specialized workflows and agents working together to deliver exceptional results.
🤖 Meet Your Team
12 Specialized Agents working in concert:
| Development | Architecture | Product | Leadership |
|---|---|---|---|
| Developer | Architect | PM | Scrum Master |
| UX Designer | Test Architect | Analyst | BMad Master |
| Tech Writer | Game Architect | Game Designer | Game Developer |
Test Architect integrates with @seontechnologies/playwright-utils for production-ready fixture-based utilities.
Each agent brings deep expertise and can be customized to match your team's style.
📦 What's Included
Core Modules
-
BMad Method (BMM) - Complete agile development framework
- 12 specialized agents
- 34 workflows across 4 phases
- Scale-adaptive planning
- → Documentation Hub
-
BMad Builder (BMB) - Create custom agents and workflows
- Build anything from simple agents to complex modules
- Create domain-specific solutions (legal, medical, finance, education)
- → Builder Guide marketplace
- → Builder Guide
-
Creative Intelligence Suite (CIS) - Innovation & problem-solving
- Brainstorming, design thinking, storytelling
- 5 creative facilitation workflows
- → Creative Workflows
Key Features
- 🎨 Customizable Agents - Modify personalities, expertise, and communication styles
- 🌐 Multi-Language Support - Separate settings for communication and code output
- 📄 Document Sharding - 90% token savings for large projects
- 🔄 Update-Safe - Your customizations persist through updates
- 🚀 Web Bundles - Use in ChatGPT, Claude Projects, or Gemini Gems
📚 Documentation
Quick Links
- Quick Start Guide - 15-minute introduction
- Complete BMM Documentation - All guides and references
- Agent Customization - Personalize your agents
- All Documentation - Complete documentation index
For v4 Users
💬 Community & Support
- Discord Community - Get help, share projects
- GitHub Issues - Report bugs, request features
- YouTube Channel - Video tutorials and demos
- Web Bundles - Pre-built agent bundles
- Code of Conduct - Community guidelines
🛠️ Development
For contributors working on the BMad codebase:
# Run all quality checks
npm test
# Development commands
npm run lint:fix # Fix code style
npm run format:fix # Auto-format code
npm run bundle # Build web bundles
See CONTRIBUTING.md for full development guidelines.
What's New in v6
v6 represents a complete architectural revolution from v4:
🚀 Major Upgrades
- BMad Core Framework - Modular architecture enabling custom domain solutions
- Scale-Adaptive Intelligence - Automatic adjustment from bug fixes to enterprise
- Visual Workflows - Beautiful SVG diagrams showing complete methodology
- BMad Builder Module - Create and share your own AI agent teams
- 50+ Workflows - Up from 20 in v4, covering every development scenario
- 19 Specialized Agents - Enhanced with customizable personalities and expertise
- Update-Safe Customization - Your configs persist through all updates
- Web Bundles - Use agents in ChatGPT, Claude, and Gemini
- Multi-Language Support - Separate settings for communication and code
- Document Sharding - 90% token savings for large projects
🔄 For v4 Users
- Comprehensive Upgrade Guide - Step-by-step migration
- v4 Documentation Archive - Legacy reference
- Backwards compatibility where possible
- Smooth migration path with installer detection
📄 License
MIT License - See LICENSE for details.
Trademarks: BMad™ and BMAD-METHOD™ are trademarks of BMad Code, LLC.
Built with ❤️ for the human-AI collaboration community