2025-11-05 20:44:22 -06:00
# 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
2025-12-13 16:22:34 +08:00
config_source : "{project-root}/_bmad/bmgd/config.yaml"
2025-11-05 20:44:22 -06:00
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
2025-12-13 16:22:34 +08:00
installed_path : "{project-root}/_bmad/bmgd/workflows/2-design/gdd"
2025-11-05 20:44:22 -06:00
instructions : "{installed_path}/instructions-gdd.md"
template : "{installed_path}/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 :
2025-11-14 20:43:15 -06:00
description : "Game vision and core concept (optional)"
2025-11-05 20:44:22 -06:00
whole : "{output_folder}/*game-brief*.md"
sharded : "{output_folder}/*game-brief*/index.md"
2025-11-14 20:43:15 -06:00
load_strategy : "INDEX_GUIDED"
2025-11-05 20:44:22 -06:00
research :
2025-11-14 20:43:15 -06:00
description : "Market or domain research (optional)"
2025-11-05 20:44:22 -06:00
whole : "{output_folder}/*research*.md"
sharded : "{output_folder}/*research*/index.md"
2025-11-14 20:43:15 -06:00
load_strategy : "FULL_LOAD"
2025-11-05 20:44:22 -06:00
document_project :
2025-11-14 20:43:15 -06:00
description : "Brownfield project documentation (optional)"
refactor: Major v6 epic creation improvements and documentation overhaul
## Key Changes
### 1. Epic Creation Workflow Enhancements
- Added user-value focused epic structure principles (NO technical layer breakdown)
- Implemented multi-mode detection: CONTINUE, REPLACE, or UPDATE existing epics
- Added comprehensive anti-pattern examples showing wrong vs right epic breakdown
- Epics now created AFTER architecture for technically-informed story breakdown
- Added checkpoint protocol for interactive workflow progression
### 2. Removed Deprecated Solutioning Gate Check
- Deleted entire solutioning-gate-check workflow (682 lines)
- Replaced by new implementation-readiness workflow
- Cleaner separation of concerns in solutioning phase
### 3. PRD Template Simplification
- Removed hardcoded "Implementation Planning", "References", and "Next Steps" sections
- PRD now focuses purely on requirements, not workflow orchestration
- Epics/stories created as separate step after architecture
### 4. Documentation Overhaul (15+ docs updated)
- Updated quick-start guide with v6 workflow sequence
- Clarified that epics are created AFTER architecture, not during PRD
- Updated solutioning docs to reflect implementation-readiness pattern
- Improved agents-guide, brownfield-guide, enterprise docs
- Enhanced glossary, FAQ, and workflow reference documentation
### 5. Workflow Path Adjustments
- All 4 paths updated (enterprise/method × brownfield/greenfield)
- Version bumps across BMGD, BMM, and CIS workflow YAMLs
- Minor instruction file updates for consistency
### Files Changed
- 65 files total: 468 insertions, 978 deletions (net reduction of 510 lines)
- 4 files deleted (entire solutioning-gate-check workflow)
- 1 new directory added (implementation-readiness placeholder)
2025-11-16 00:23:47 -06:00
sharded : "{output_folder}/index.md"
2025-11-14 20:43:15 -06:00
load_strategy : "INDEX_GUIDED"
2025-11-05 20:44:22 -06:00
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"
2025-12-13 16:22:34 +08:00
instructions : "_bmad/bmgd/workflows/2-design/gdd/instructions-gdd.md"
2025-11-05 20:44:22 -06:00
web_bundle_files :
2025-12-13 16:22:34 +08:00
- "_bmad/bmgd/workflows/2-design/gdd/instructions-gdd.md"
- "_bmad/bmgd/workflows/2-design/gdd/gdd-template.md"
- "_bmad/bmgd/workflows/2-design/gdd/game-types.csv"
- "_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"