External/BMAD-METHOD
1
0
Fork 0
mirror of https://github.com/bmadcode/BMAD-METHOD.git synced 2025-12-29 16:14:59 +00:00
Code Issues Packages Projects Releases Wiki Activity
BMAD-METHOD/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml
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

102 lines
5.0 KiB
YAML
Raw Blame History

# Game Design Document (GDD) Workflow
name: gdd
description: "Game Design Document workflow for all game project levels - from small prototypes to full AAA games. Generates comprehensive GDD with game mechanics, systems, progression, and implementation guidance."
author: "BMad"
# Critical variables from config
config_source: "{project-root}/_bmad/bmgd/config.yaml"
output_folder: "{config_source}:output_folder"
user_name: "{config_source}:user_name"
communication_language: "{config_source}:communication_language"
document_output_language: "{config_source}:document_output_language"
game_dev_experience: "{config_source}:game_dev_experience"
date: system-generated
# Workflow components - Step-file architecture
installed_path: "{project-root}/_bmad/bmgd/workflows/2-design/gdd"
instructions: "{installed_path}/workflow.md"
template: "{installed_path}/templates/gdd-template.md"
game_types_csv: "{installed_path}/game-types.csv"
# Output configuration
default_output_file: "{output_folder}/gdd.md"
# Game type references (loaded based on game type selection)
game_type_guides: "{installed_path}/game-types/"
# Smart input file references - handles both whole docs and sharded docs
# Priority: Whole document first, then sharded version
input_file_patterns:
game_brief:
description: "Game vision and core concept (optional)"
whole: "{output_folder}/*game-brief*.md"
sharded: "{output_folder}/*game-brief*/index.md"
load_strategy: "INDEX_GUIDED"
research:
description: "Market or domain research (optional)"
whole: "{output_folder}/*research*.md"
sharded: "{output_folder}/*research*/index.md"
load_strategy: "FULL_LOAD"
document_project:
description: "Brownfield project documentation (optional)"
sharded: "{output_folder}/index.md"
load_strategy: "INDEX_GUIDED"
standalone: true
web_bundle:
name: "gdd"
description: "Game Design Document workflow for all game project levels - from small prototypes to full AAA games. Generates comprehensive GDD with game mechanics, systems, progression, and implementation guidance."
author: "BMad"
instructions: "_bmad/bmgd/workflows/2-design/gdd/workflow.md"
web_bundle_files:
# Main workflow file
- "_bmad/bmgd/workflows/2-design/gdd/workflow.md"
# Step files
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-01-init.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-01b-continue.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-02-context.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-03-platforms.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-04-vision.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-05-core-gameplay.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-06-mechanics.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-07-game-type.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-08-progression.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-09-levels.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-10-art-audio.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-11-technical.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-12-epics.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-13-metrics.md"
- "_bmad/bmgd/workflows/2-design/gdd/steps/step-14-complete.md"
# Template
- "_bmad/bmgd/workflows/2-design/gdd/templates/gdd-template.md"
# Data files
- "_bmad/bmgd/workflows/2-design/gdd/game-types.csv"
# Game type guides
- "_bmad/bmgd/workflows/2-design/gdd/game-types/action-platformer.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/adventure.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/card-game.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/fighting.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/horror.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/idle-incremental.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/metroidvania.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/moba.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/party-game.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/puzzle.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/racing.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/rhythm.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/roguelike.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/rpg.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/sandbox.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/shooter.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/simulation.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/sports.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/strategy.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/survival.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/text-based.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/tower-defense.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/turn-based-tactics.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types/visual-novel.md"
Reference in New Issue View Git Blame Copy Permalink