Summary of changes:

- Removed 32 recommended_inputs: sections
  - Added description: fields to all input_file_patterns (25 workflows)
  - Added missing load_strategy fields (5 workflows)
  - Fixed BMB workflows with proper reference doc variables
  - Updated BMB instructions to use new variables

src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml

@@ -12,14 +12,6 @@ document_output_language: "{config_source}:document_output_language"
 game_dev_experience: "{config_source}:game_dev_experience"
 date: system-generated
 
-# Optional input documents
-recommended_inputs:
-  - market_research: "Market research document (optional)"
-  - brainstorming_results: "Brainstorming session outputs (optional)"
-  - competitive_analysis: "Competitive game analysis (optional)"
-  - initial_ideas: "Initial game ideas or notes (optional)"
-  - reference_games: "List of inspiration games (optional)"
-
 # Module path and component files
 installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/1-preproduction/game-brief"
 template: "{installed_path}/template.md"

src/modules/bmgd/workflows/2-design/gdd/workflow.yaml

@@ -24,25 +24,25 @@ default_output_file: "{output_folder}/GDD.md"
 # Game type references (loaded based on game type selection)
 game_type_guides: "{installed_path}/game-types/"
 
-# Recommended input documents
-recommended_inputs:
-  - game_brief: "{output_folder}/game-brief.md"
-  - narrative_design: "{output_folder}/narrative-design.md"
-  - market_research: "{output_folder}/market-research.md"
-
 # 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}/docs/index.md"
+    load_strategy: "INDEX_GUIDED"
 
 standalone: true
 

src/modules/bmgd/workflows/2-design/narrative/workflow.yaml

@@ -20,12 +20,6 @@ template: "{installed_path}/narrative-template.md"
 # Output configuration
 default_output_file: "{output_folder}/narrative-design.md"
 
-# Recommended input documents
-recommended_inputs:
-  - game_brief: "{output_folder}/game-brief.md"
-  - gdd: "{output_folder}/GDD.md"
-  - product_brief: "{output_folder}/product-brief.md"
-
 standalone: true
 
 web_bundle:

src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml

@@ -12,29 +12,31 @@ document_output_language: "{config_source}:document_output_language"
 game_dev_experience: "{config_source}:game_dev_experience"
 date: system-generated
 
-# Input requirements - We work from GDD, Epics, and optionally Narrative Design
-recommended_inputs:
-  - gdd: "Game Design Document with mechanics, systems, and features"
-  - epics: "Epic definitions with user stories and acceptance criteria"
-  - narrative: "Narrative design document with story and character systems (optional)"
-
 # Smart input file references - handles both whole docs and sharded docs
 # Priority: Whole document first, then sharded version
 input_file_patterns:
   gdd:
+    description: "Game Design Document with mechanics and systems"
     whole: "{output_folder}/*gdd*.md"
     sharded: "{output_folder}/*gdd*/index.md"
+    load_strategy: "INDEX_GUIDED"
 
   epics:
+    description: "Epic definitions with user stories"
     whole: "{output_folder}/*epic*.md"
     sharded: "{output_folder}/*epic*/index.md"
+    load_strategy: "FULL_LOAD"
 
   narrative:
+    description: "Narrative design with story and characters (optional)"
     whole: "{output_folder}/*narrative*.md"
     sharded: "{output_folder}/*narrative*/index.md"
+    load_strategy: "INDEX_GUIDED"
 
   document_project:
+    description: "Brownfield project documentation (optional)"
     sharded: "{output_folder}/docs/index.md"
+    load_strategy: "INDEX_GUIDED"
 
 # Module path and component files
 installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/3-technical/game-architecture"

src/modules/bmgd/workflows/4-production/code-review/workflow.yaml

@@ -37,19 +37,23 @@ variables:
 # Strategy: SELECTIVE LOAD - only load the specific epic needed for this story review
 input_file_patterns:
   architecture:
+    description: "System architecture and decisions"
     whole: "{output_folder}/*architecture*.md"
     sharded: "{output_folder}/*architecture*/*.md"
     load_strategy: "FULL_LOAD"
   ux_design:
+    description: "UX design specification (if UI)"
     whole: "{output_folder}/*ux*.md"
     sharded: "{output_folder}/*ux*/*.md"
     load_strategy: "FULL_LOAD"
   epics:
+    description: "All epics with user stories"
     whole: "{output_folder}/*epic*.md"
     sharded_index: "{output_folder}/*epic*/index.md"
     sharded_single: "{output_folder}/*epic*/epic-{{epic_num}}.md"
     load_strategy: "SELECTIVE_LOAD"
   document_project:
+    description: "Brownfield project documentation (optional)"
     sharded: "{output_folder}/docs/index.md"
     load_strategy: "INDEX_GUIDED"
 

src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml

@@ -18,25 +18,31 @@ sprint_status: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-
 # Strategy: Load project context for impact analysis
 input_file_patterns:
   prd:
+    description: "Product requirements (optional)"
     whole: "{output_folder}/*prd*.md"
     sharded: "{output_folder}/*prd*/*.md"
     load_strategy: "FULL_LOAD"
   epics:
+    description: "All epics with user stories"
     whole: "{output_folder}/*epic*.md"
     sharded: "{output_folder}/*epic*/*.md"
     load_strategy: "FULL_LOAD"
   architecture:
+    description: "System architecture and decisions"
     whole: "{output_folder}/*architecture*.md"
     sharded: "{output_folder}/*architecture*/*.md"
     load_strategy: "FULL_LOAD"
   ux_design:
+    description: "UX design specification (if UI)"
     whole: "{output_folder}/*ux*.md"
     sharded: "{output_folder}/*ux*/*.md"
     load_strategy: "FULL_LOAD"
   tech_spec:
+    description: "Technical specification"
     whole: "{output_folder}/tech-spec*.md"
     load_strategy: "FULL_LOAD"
   document_project:
+    description: "Brownfield project documentation (optional)"
     sharded: "{output_folder}/docs/index.md"
     load_strategy: "INDEX_GUIDED"
 

src/modules/bmgd/workflows/4-production/create-story/workflow.yaml

@@ -40,26 +40,32 @@ default_output_file: "{story_dir}/{{story_key}}.md"
 # Strategy: SELECTIVE LOAD - only load the specific epic needed for this story
 input_file_patterns:
   prd:
+    description: "Product requirements (optional)"
     whole: "{output_folder}/*prd*.md"
     sharded: "{output_folder}/*prd*/*.md"
     load_strategy: "FULL_LOAD"
   tech_spec:
+    description: "Technical specification"
     whole: "{output_folder}/tech-spec.md"
     load_strategy: "FULL_LOAD"
   architecture:
+    description: "System architecture and decisions"
     whole: "{output_folder}/*architecture*.md"
     sharded: "{output_folder}/*architecture*/*.md"
     load_strategy: "FULL_LOAD"
   ux_design:
+    description: "UX design specification (if UI)"
     whole: "{output_folder}/*ux*.md"
     sharded: "{output_folder}/*ux*/*.md"
     load_strategy: "FULL_LOAD"
   epics:
+    description: "All epics with user stories"
     whole: "{output_folder}/*epic*.md"
     sharded_index: "{output_folder}/*epic*/index.md"
     sharded_single: "{output_folder}/*epic*/epic-{{epic_num}}.md"
     load_strategy: "SELECTIVE_LOAD"
   document_project:
+    description: "Brownfield project documentation (optional)"
     sharded: "{output_folder}/index.md"
     load_strategy: "INDEX_GUIDED"
 

src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml

@@ -23,23 +23,28 @@ sprint_status: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-
 # Strategy: Load necessary context for story implementation
 input_file_patterns:
   architecture:
+    description: "System architecture and decisions"
     whole: "{output_folder}/*architecture*.md"
     sharded: "{output_folder}/*architecture*/*.md"
     load_strategy: "FULL_LOAD"
   tech_spec:
+    description: "Technical specification"
     whole: "{output_folder}/tech-spec*.md"
     sharded: "{sprint_artifacts}/tech-spec-epic-*.md"
     load_strategy: "SELECTIVE_LOAD"
   ux_design:
+    description: "UX design specification (if UI)"
     whole: "{output_folder}/*ux*.md"
     sharded: "{output_folder}/*ux*/*.md"
     load_strategy: "FULL_LOAD"
   epics:
+    description: "All epics with user stories"
     whole: "{output_folder}/*epic*.md"
     sharded_index: "{output_folder}/*epic*/index.md"
     sharded_single: "{output_folder}/*epic*/epic-{{epic_num}}.md"
     load_strategy: "SELECTIVE_LOAD"
   document_project:
+    description: "Brownfield project documentation (optional)"
     sharded: "{output_folder}/docs/index.md"
     load_strategy: "INDEX_GUIDED"
 

src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml

@@ -16,27 +16,33 @@ sprint_status: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-
 # Strategy: SELECTIVE LOAD - only load the specific epic needed (epic_num from context)
 input_file_patterns:
   prd:
+    description: "Product requirements (optional)"
     whole: "{output_folder}/*prd*.md"
     sharded: "{output_folder}/*prd*/*.md"
     load_strategy: "FULL_LOAD"
   gdd:
+    description: "Game Design Document (optional)"
     whole: "{output_folder}/*gdd*.md"
     sharded: "{output_folder}/*gdd*/*.md"
     load_strategy: "FULL_LOAD"
   architecture:
+    description: "System architecture and decisions"
     whole: "{output_folder}/*architecture*.md"
     sharded: "{output_folder}/*architecture*/*.md"
     load_strategy: "FULL_LOAD"
   ux_design:
+    description: "UX design specification (if UI)"
     whole: "{output_folder}/*ux*.md"
     sharded: "{output_folder}/*ux*/*.md"
     load_strategy: "FULL_LOAD"
   epics:
+    description: "All epics with user stories"
     whole: "{output_folder}/*epic*.md"
     sharded_index: "{output_folder}/*epic*/index.md"
     sharded_single: "{output_folder}/*epic*/epic-{{epic_num}}.md"
     load_strategy: "SELECTIVE_LOAD"
   document_project:
+    description: "Brownfield project documentation (optional)"
     sharded: "{output_folder}/index.md"
     load_strategy: "INDEX_GUIDED"
 

src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml

@@ -24,22 +24,27 @@ required_inputs:
 # Strategy: SELECTIVE LOAD - only load the completed epic and relevant retrospectives
 input_file_patterns:
   epics:
+    description: "All epics with user stories"
     whole: "{output_folder}/*epic*.md"
     sharded_index: "{output_folder}/*epic*/index.md"
     sharded_single: "{output_folder}/*epic*/epic-{{epic_num}}.md"
     load_strategy: "SELECTIVE_LOAD"
   previous_retrospective:
+    description: "Previous retrospective (optional)"
     pattern: "{sprint_artifacts}/**/epic-{{prev_epic_num}}-retro-*.md"
     load_strategy: "SELECTIVE_LOAD"
   architecture:
+    description: "System architecture and decisions"
     whole: "{output_folder}/*architecture*.md"
     sharded: "{output_folder}/*architecture*/*.md"
     load_strategy: "FULL_LOAD"
   prd:
+    description: "Product requirements (optional)"
     whole: "{output_folder}/*prd*.md"
     sharded: "{output_folder}/*prd*/*.md"
     load_strategy: "FULL_LOAD"
   document_project:
+    description: "Brownfield project documentation (optional)"
     sharded: "{output_folder}/*.md"
     load_strategy: "INDEX_GUIDED"
 

src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml

@@ -38,6 +38,7 @@ variables:
 # Strategy: FULL LOAD - sprint planning needs ALL epics to build complete status
 input_file_patterns:
   epics:
+    description: "All epics with user stories"
     whole: "{output_folder}/*epic*.md"
     sharded: "{output_folder}/*epic*/*.md"
     load_strategy: "FULL_LOAD"

src/modules/bmgd/workflows/4-production/story-context/workflow.yaml

@@ -25,26 +25,32 @@ validation: "{installed_path}/checklist.md"
 # Strategy: SELECTIVE LOAD - only load the specific epic needed for this story
 input_file_patterns:
   prd:
+    description: "Product requirements (optional)"
     whole: "{output_folder}/*prd*.md"
     sharded: "{output_folder}/*prd*/*.md"
     load_strategy: "FULL_LOAD"
   tech_spec:
+    description: "Technical specification"
     whole: "{output_folder}/tech-spec.md"
     load_strategy: "FULL_LOAD"
   architecture:
+    description: "System architecture and decisions"
     whole: "{output_folder}/*architecture*.md"
     sharded: "{output_folder}/*architecture*/*.md"
     load_strategy: "FULL_LOAD"
   ux_design:
+    description: "UX design specification (if UI)"
     whole: "{output_folder}/*ux*.md"
     sharded: "{output_folder}/*ux*/*.md"
     load_strategy: "FULL_LOAD"
   epics:
+    description: "All epics with user stories"
     whole: "{output_folder}/*epic*.md"
     sharded_index: "{output_folder}/*epic*/index.md"
     sharded_single: "{output_folder}/*epic*/epic-{{epic_num}}.md"
     load_strategy: "SELECTIVE_LOAD"
   document_project:
+    description: "Brownfield project documentation (optional)"
     sharded: "{output_folder}/docs/index.md"
     load_strategy: "INDEX_GUIDED"