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

.gitignore

@@ -63,4 +63,7 @@ src/modules/bmb/sub-modules/
 src/modules/cis/sub-modules/
 src/modules/bmgd/sub-modules/
 
-z*/
+z*/
+
+.bmad
+.claude

.prettierignore

@@ -1,2 +1,6 @@
 # Test fixtures with intentionally broken/malformed files
 test/fixtures/**
+
+# BMAD runtime folders (user-specific, not in repo)
+.bmad/
+.bmad*/

eslint.config.mjs

@@ -16,6 +16,8 @@ export default [
       'test/template-test-generator/**/*.md',
       'test/fixtures/**',
       'test/fixtures/**/*.yaml',
+      '.bmad/**',
+      '.bmad*/**',
     ],
   },
 

src/core/workflows/brainstorming/workflow.yaml

@@ -9,11 +9,6 @@ output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 date: system-generated
 
-# Optional inputs for guided brainstorming
-recommended_inputs:
-  - session_context: "Context document passed via data attribute"
-  - previous_results: "{output_folder}/brainstorming-*.md"
-
 # Context can be provided via data attribute when invoking
 # Example: data="{path}/context.md" provides domain-specific guidance
 

src/modules/bmb/workflows/convert-legacy/workflow.yaml

@@ -10,10 +10,6 @@ user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
 date: system-generated
 
-# Optional docs that can be provided as input
-recommended_inputs:
-  - legacy_file: "Path to v4 agent, workflow, or module to convert"
-
 # Module path and component files
 installed_path: "{project-root}/{bmad_folder}/bmb/workflows/convert-legacy"
 template: false # This is an action/meta workflow - no template needed

src/modules/bmb/workflows/create-agent/instructions.md

@@ -2,7 +2,8 @@
 
 <critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/create-agent/workflow.yaml</critical>
-<critical>Study YAML agent examples in: {project-root}/{bmad_folder}/bmm/agents/ for patterns</critical>
+<critical>Study YAML agent examples in: {example_agents_dir} for patterns</critical>
+<critical>Reference activation conventions from: {agent_activation_rules}</critical>
 <critical>Communicate in {communication_language} throughout the agent creation process</critical>
 
 <workflow>

src/modules/bmb/workflows/create-agent/workflow.yaml

@@ -15,10 +15,9 @@ agent_architecture: "{installed_path}/agent-architecture.md"
 agent_commands: "{installed_path}/agent-command-patterns.md"
 communication_styles: "{installed_path}/communication-styles.md"
 
-# Optional docs that help understand agent patterns
-recommended_inputs:
-  - example_agents: "{project-root}/{bmad_folder}/bmm/agents/"
-  - agent_activation_rules: "{project-root}/src/utility/models/agent-activation-ide.xml"
+# Reference examples and conventions
+example_agents_dir: "{project-root}/{bmad_folder}/bmm/agents/"
+agent_activation_rules: "{project-root}/src/utility/models/agent-activation-ide.xml"
 
 # Module path and component files
 installed_path: "{project-root}/{bmad_folder}/bmb/workflows/create-agent"

src/modules/bmb/workflows/create-module/workflow.yaml

@@ -19,14 +19,22 @@ workflow_builder: "{project-root}/{bmad_folder}/bmb/workflows/create-workflow/wo
 brainstorming_workflow: "{project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml"
 brainstorming_context: "{installed_path}/brainstorm-context.md"
 
-# Optional docs that help understand module patterns
-recommended_inputs:
-  - module_brief: "{output_folder}/module-brief-*.md"
-  - brainstorming_results: "{output_folder}/brainstorming-*.md"
-  - bmm_module: "{project-root}/{bmad_folder}/bmm/"
-  - cis_module: "{project-root}/{bmad_folder}/cis/"
-  - existing_agents: "{project-root}/{bmad_folder}/*/agents/"
-  - existing_workflows: "{project-root}/{bmad_folder}/*/workflows/"
+# Reference examples - for learning patterns
+bmm_module_dir: "{project-root}/{bmad_folder}/bmm/"
+cis_module_dir: "{project-root}/{bmad_folder}/cis/"
+existing_agents_dir: "{project-root}/{bmad_folder}/*/agents/"
+existing_workflows_dir: "{project-root}/{bmad_folder}/*/workflows/"
+
+# Optional user inputs - discovered if they exist
+input_file_patterns:
+  module_brief:
+    description: "Module brief with vision and requirements (optional)"
+    whole: "{output_folder}/module-brief-*.md"
+    load_strategy: "FULL_LOAD"
+  brainstorming:
+    description: "Brainstorming session outputs (optional)"
+    whole: "{output_folder}/brainstorming-*.md"
+    load_strategy: "FULL_LOAD"
 
 # Module path and component files
 installed_path: "{project-root}/{bmad_folder}/bmb/workflows/create-module"

src/modules/bmb/workflows/create-workflow/workflow-template/workflow.yaml

@@ -15,10 +15,6 @@ date: system-generated
 # optional, can be omitted
 brain_techniques: "{installed_path}/{critical-data-file.csv}" # example, can be other formats or URLs
 
-# Optional docs that if loaded on start to kickstart this workflow or used at some point, these are meant to be suggested inputs for the user
-recommended_inputs: # optional, can be omitted
-  - example_input: "{project-root}/{path/to/file.md}"
-
 # Module path and component files
 installed_path: "{project-root}/{bmad_folder}/{module-code}/workflows/{workflow-code}"
 template: "{installed_path}/template.md" # optional, can be omitted

src/modules/bmb/workflows/create-workflow/workflow.yaml

@@ -15,11 +15,6 @@ template_instructions: "{workflow_template_path}/instructions.md"
 template_template: "{workflow_template_path}/template.md"
 template_checklist: "{workflow_template_path}/checklist.md"
 
-# Optional input docs
-recommended_inputs:
-  - existing_workflows: "{project-root}/{bmad_folder}/*/workflows/"
-  - bmm_workflows: "{project-root}/{bmad_folder}/bmm/workflows/"
-
 # Module path and component files
 installed_path: "{project-root}/{bmad_folder}/bmb/workflows/create-workflow"
 template: false # This is an action workflow - no template needed
@@ -30,6 +25,10 @@ validation: "{installed_path}/checklist.md"
 workflow_creation_guide: "{installed_path}/workflow-creation-guide.md"
 workflow_template_path: "{installed_path}/workflow-template"
 
+# Reference examples - for learning patterns
+existing_workflows_dir: "{project-root}/{bmad_folder}/*/workflows/"
+bmm_workflows_dir: "{project-root}/{bmad_folder}/bmm/workflows/"
+
 # Output configuration - Creates the new workflow folder with all files
 # If workflow belongs to a module: Save to module's workflows folder
 # If standalone workflow: Save to custom_workflow_location/{{workflow_name}}

src/modules/bmb/workflows/edit-agent/workflow.yaml

@@ -17,11 +17,9 @@ communication_styles: "{project-root}/{bmad_folder}/bmb/workflows/create-agent/c
 # Workflow execution engine reference
 workflow_execution_engine: "{project-root}/{bmad_folder}/core/tasks/workflow.xml"
 
-# Optional docs that can be used to understand the target agent
-recommended_inputs:
-  - target_agent: "Path to the agent.yaml or agent.md file to edit"
-  - example_agents: "{project-root}/{bmad_folder}/bmm/agents/"
-  - agent_activation_rules: "{project-root}/src/utility/models/agent-activation-ide.xml"
+# Reference examples and conventions
+example_agents_dir: "{project-root}/{bmad_folder}/bmm/agents/"
+agent_activation_rules: "{project-root}/src/utility/models/agent-activation-ide.xml"
 
 # Module path and component files
 installed_path: "{project-root}/{bmad_folder}/bmb/workflows/edit-agent"

src/modules/bmb/workflows/edit-module/instructions.md

@@ -123,7 +123,9 @@ Let the conversation flow naturally. Build a shared vision of what "better" look
 2. **Propose improvements with rationale**
    - Suggest specific changes that align with best practices
    - Explain WHY each change helps
-   - Provide examples from reference modules when helpful
+   - Provide examples from reference modules: {bmm_module_dir}, {bmb_module_dir}, {cis_module_dir}
+   - Reference agents from: {existing_agents_dir}
+   - Reference workflows from: {existing_workflows_dir}
    - Reference the structure guide's patterns naturally
 
 3. **Collaborate on the approach**

src/modules/bmb/workflows/edit-module/workflow.yaml

@@ -15,14 +15,12 @@ module_structure_guide: "{project-root}/{bmad_folder}/bmb/workflows/create-modul
 agent_editor: "{project-root}/{bmad_folder}/bmb/workflows/edit-agent/workflow.yaml"
 workflow_editor: "{project-root}/{bmad_folder}/bmb/workflows/edit-workflow/workflow.yaml"
 
-# Optional docs that can be used to understand the target module
-recommended_inputs:
-  - target_module: "Path to the module directory to edit"
-  - bmm_module: "{project-root}/{bmad_folder}/bmm/"
-  - bmb_module: "{project-root}/{bmad_folder}/bmb/"
-  - cis_module: "{project-root}/{bmad_folder}/cis/"
-  - existing_agents: "{project-root}/{bmad_folder}/*/agents/"
-  - existing_workflows: "{project-root}/{bmad_folder}/*/workflows/"
+# Reference examples - for learning patterns
+bmm_module_dir: "{project-root}/{bmad_folder}/bmm/"
+bmb_module_dir: "{project-root}/{bmad_folder}/bmb/"
+cis_module_dir: "{project-root}/{bmad_folder}/cis/"
+existing_agents_dir: "{project-root}/{bmad_folder}/*/agents/"
+existing_workflows_dir: "{project-root}/{bmad_folder}/*/workflows/"
 
 # Module path and component files
 installed_path: "{project-root}/{bmad_folder}/bmb/workflows/edit-module"

src/modules/bmb/workflows/edit-workflow/instructions.md

@@ -24,7 +24,7 @@
 
 - Workflow creation guide: {workflow_creation_guide}
 - Workflow execution engine: {workflow_execution_engine}
-- Study example workflows from: {project-root}/{bmad_folder}/bmm/workflows/
+- Study example workflows from: {workflow_examples_dir}
   </action>
 
 <action>Analyze the workflow deeply:

src/modules/bmb/workflows/edit-workflow/workflow.yaml

@@ -12,10 +12,8 @@ user_name: "{config_source}:user_name"
 workflow_creation_guide: "{project-root}/{bmad_folder}/bmb/workflows/create-workflow/workflow-creation-guide.md"
 workflow_execution_engine: "{project-root}/{bmad_folder}/core/tasks/workflow.xml"
 
-# Optional docs that can be used to understand the target workflow
-recommended_inputs:
-  - target_workflow: "Path to the workflow.yaml file to edit"
-  - workflow_examples: "{project-root}/{bmad_folder}/bmm/workflows/"
+# Reference examples
+workflow_examples_dir: "{project-root}/{bmad_folder}/bmm/workflows/"
 
 # Module path and component files
 installed_path: "{project-root}/{bmad_folder}/bmb/workflows/edit-workflow"

src/modules/bmb/workflows/module-brief/workflow.yaml

@@ -10,11 +10,16 @@ user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
 date: system-generated
 
-# Optional input docs that enhance module planning
-recommended_inputs:
-  - brainstorming_results: "{output_folder}/brainstorming-*.md"
-  - existing_modules: "{project-root}/{bmad_folder}/"
-  - module_examples: "{project-root}/{bmad_folder}/bmb/workflows/create-module/module-structure.md"
+# Reference examples and documentation
+existing_modules_dir: "{project-root}/{bmad_folder}/"
+module_structure_guide: "{project-root}/{bmad_folder}/bmb/workflows/create-module/module-structure.md"
+
+# Optional user inputs - discovered if they exist
+input_file_patterns:
+  brainstorming:
+    description: "Brainstorming session outputs (optional)"
+    whole: "{output_folder}/brainstorming-*.md"
+    load_strategy: "FULL_LOAD"
 
 # Module path and component files
 installed_path: "{project-root}/{bmad_folder}/bmb/workflows/module-brief"

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"
 

src/modules/bmm/agents/pm.agent.yaml

@@ -29,7 +29,7 @@ agent:
       description: Create Product Requirements Document (PRD) for Level 2-4 projects
 
     - trigger: create-epics-and-stories
-      workflow: "{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml"
+      workflow: "{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/create-epics-and-stories/workflow.yaml"
       description: Break PRD requirements into implementable epics and stories
 
     - trigger: validate-prd

src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml

@@ -12,28 +12,24 @@ document_output_language: "{config_source}:document_output_language"
 user_skill_level: "{config_source}:user_skill_level"
 date: system-generated
 
-# Optional input documents
-recommended_inputs:
-  - market_research: "Market research document (optional)"
-  - brainstorming_results: "Brainstorming session outputs (optional)"
-  - competitive_analysis: "Competitive analysis (optional)"
-  - initial_ideas: "Initial product ideas or notes (optional)"
-
 # Smart input file references - handles both whole docs and sharded docs
 # Priority: Whole document first, then sharded version
 # Strategy: How to load sharded documents (FULL_LOAD, SELECTIVE_LOAD, INDEX_GUIDED)
 input_file_patterns:
   research:
+    description: "Market research or competitive analysis (optional)"
     whole: "{output_folder}/*research*.md"
     sharded: "{output_folder}/*research*/index.md"
     load_strategy: "FULL_LOAD"
 
   brainstorming:
+    description: "Brainstorming session outputs (optional)"
     whole: "{output_folder}/*brainstorm*.md"
     sharded: "{output_folder}/*brainstorm*/index.md"
     load_strategy: "FULL_LOAD"
 
   document_project:
+    description: "Brownfield project documentation (optional)"
     sharded: "{output_folder}/docs/index.md"
     load_strategy: "INDEX_GUIDED"
 

src/modules/bmm/workflows/2-plan-workflows/create-epics-and-stories/workflow.yaml

@@ -13,27 +13,27 @@ document_output_language: "{config_source}:document_output_language"
 user_skill_level: "{config_source}:user_skill_level"
 date: system-generated
 
-# Input requirements
-recommended_inputs:
-  - prd: "Product Requirements Document with FRs and NFRs"
-  - product_brief: "Product Brief with vision and goals (optional)"
-  - domain_brief: "Domain-specific requirements and context (optional)"
-
 # Smart input file references - handles both whole docs and sharded docs
 # Priority: Whole document first, then sharded version
 input_file_patterns:
   prd:
+    description: "Product Requirements Document with FRs and NFRs"
     whole: "{output_folder}/*prd*.md"
     sharded: "{output_folder}/*prd*/index.md"
+    load_strategy: "INDEX_GUIDED"
   product_brief:
+    description: "Product vision and goals (optional)"
     whole: "{output_folder}/*product*brief*.md"
     sharded: "{output_folder}/*product*brief*/index.md"
+    load_strategy: "INDEX_GUIDED"
   domain_brief:
+    description: "Domain-specific requirements and context (optional)"
     whole: "{output_folder}/*domain*brief*.md"
     sharded: "{output_folder}/*domain*brief*/index.md"
+    load_strategy: "INDEX_GUIDED"
 
 # Module path and component files
-installed_path: "{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories"
+installed_path: "{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/create-epics-and-stories"
 instructions: "{installed_path}/instructions.md"
 template: "{installed_path}/epics-template.md"
 
@@ -46,8 +46,8 @@ web_bundle:
   name: "create-epics-and-stories"
   description: "Transform PRD requirements into bite-sized stories organized in epics for 200k context dev agents"
   author: "BMad"
-  instructions: "{bmad_folder}/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md"
-  template: "{bmad_folder}/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md"
+  instructions: "{bmad_folder}/bmm/workflows/2-plan-workflows/create-epics-and-stories/instructions.md"
+  template: "{bmad_folder}/bmm/workflows/2-plan-workflows/create-epics-and-stories/epics-template.md"
   web_bundle_files:
-    - "{bmad_folder}/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md"
-    - "{bmad_folder}/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md"
+    - "{bmad_folder}/bmm/workflows/2-plan-workflows/create-epics-and-stories/instructions.md"
+    - "{bmad_folder}/bmm/workflows/2-plan-workflows/create-epics-and-stories/epics-template.md"

src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml

@@ -12,42 +12,36 @@ document_output_language: "{config_source}:document_output_language"
 user_skill_level: "{config_source}:user_skill_level"
 date: system-generated
 
-# Input requirements - We work from PRD, Brief, or Brainstorming docs
-recommended_inputs:
-  - prd: "Product Requirements Document with features and user journeys"
-  - product_brief: "Product brief with vision and target users"
-  - brainstorming: "Brainstorming documents with ideas and concepts"
-
-# Input file references (fuzzy matched from output folder)
-prd_file: "{output_folder}/bmm-PRD.md or PRD.md or product-requirements.md"
-brief_file: "{output_folder}/product-brief.md or brief.md or project-brief.md"
-brainstorm_file: "{output_folder}/brainstorming.md or brainstorm.md or ideation.md"
-
 # Smart input file references - handles both whole docs and sharded docs
 # Priority: Whole document first, then sharded version
 # Strategy: How to load sharded documents (FULL_LOAD, SELECTIVE_LOAD, INDEX_GUIDED)
 input_file_patterns:
   prd:
+    description: "Features and user journeys (optional)"
     whole: "{output_folder}/*prd*.md"
     sharded: "{output_folder}/*prd*/index.md"
     load_strategy: "FULL_LOAD"
 
   product_brief:
+    description: "Product vision and target users (optional)"
     whole: "{output_folder}/*brief*.md"
     sharded: "{output_folder}/*brief*/index.md"
     load_strategy: "FULL_LOAD"
 
   epics:
+    description: "Epic and story breakdown (optional)"
     whole: "{output_folder}/*epic*.md"
     sharded: "{output_folder}/*epic*/index.md"
     load_strategy: "FULL_LOAD"
 
   brainstorming:
+    description: "Brainstorming ideas and concepts (optional)"
     whole: "{output_folder}/*brainstorm*.md"
     sharded: "{output_folder}/*brainstorm*/index.md"
     load_strategy: "FULL_LOAD"
 
   document_project:
+    description: "Brownfield project documentation (optional)"
     sharded: "{output_folder}/docs/index.md"
     load_strategy: "INDEX_GUIDED"
 

src/modules/bmm/workflows/2-plan-workflows/prd/workflow.yaml

@@ -28,26 +28,24 @@ domain_complexity_data: "{installed_path}/domain-complexity.csv"
 status_file: "{output_folder}/bmm-workflow-status.yaml"
 default_output_file: "{output_folder}/prd.md"
 
-# Recommended input documents
-recommended_inputs:
-  - product_brief: "{output_folder}/product-brief*.md"
-  - research: "{output_folder}/*research*.md"
-
 # Smart input file references - handles both whole docs and sharded docs
 # Priority: Whole document first, then sharded version
 # Strategy: How to load sharded documents (FULL_LOAD, SELECTIVE_LOAD, INDEX_GUIDED)
 input_file_patterns:
   product_brief:
+    description: "Product vision and goals (optional)"
     whole: "{output_folder}/*brief*.md"
     sharded: "{output_folder}/*brief*/index.md"
     load_strategy: "FULL_LOAD"
 
   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"
 
@@ -68,13 +66,13 @@ web_bundle:
     - "{bmad_folder}/bmm/workflows/2-plan-workflows/prd/checklist.md"
 
     # Child workflow and its files
-    - "{bmad_folder}/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml"
-    - "{bmad_folder}/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md"
-    - "{bmad_folder}/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md"
+    - "{bmad_folder}/bmm/workflows/2-plan-workflows/create-epics-and-stories/workflow.yaml"
+    - "{bmad_folder}/bmm/workflows/2-plan-workflows/create-epics-and-stories/instructions.md"
+    - "{bmad_folder}/bmm/workflows/2-plan-workflows/create-epics-and-stories/epics-template.md"
 
     # Task dependencies (referenced in instructions.md)
     - "{bmad_folder}/core/tasks/workflow.xml"
     - "{bmad_folder}/core/tasks/advanced-elicitation.xml"
     - "{bmad_folder}/core/tasks/advanced-elicitation-methods.csv"
   child_workflows:
-    - create-epics-and-stories: "{bmad_folder}/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml"
+    - create-epics-and-stories: "{bmad_folder}/bmm/workflows/2-plan-workflows/create-epics-and-stories/workflow.yaml"

src/modules/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml

@@ -41,14 +41,17 @@ sprint_artifacts: "{output_folder}/sprint_artifacts"
 # Strategy: How to load sharded documents (FULL_LOAD, SELECTIVE_LOAD, INDEX_GUIDED)
 input_file_patterns:
   product_brief:
+    description: "Product vision and goals (optional)"
     whole: "{output_folder}/*brief*.md"
     sharded: "{output_folder}/*brief*/index.md"
     load_strategy: "FULL_LOAD"
   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"
 

src/modules/bmm/workflows/3-solutioning/architecture/workflow.yaml

@@ -17,18 +17,22 @@ date: system-generated
 # Strategy: How to load sharded documents (FULL_LOAD, SELECTIVE_LOAD, INDEX_GUIDED)
 input_file_patterns:
   prd:
+    description: "Product requirements and features"
     whole: "{output_folder}/*prd*.md"
     sharded: "{output_folder}/*prd*/index.md"
     load_strategy: "FULL_LOAD"
   epics:
+    description: "Epic and story breakdown"
     whole: "{output_folder}/*epic*.md"
     sharded: "{output_folder}/*epic*/index.md"
     load_strategy: "FULL_LOAD"
   ux_design:
+    description: "UX design specification (optional)"
     whole: "{output_folder}/*ux*.md"
     sharded: "{output_folder}/*ux*/index.md"
     load_strategy: "FULL_LOAD"
   document_project:
+    description: "Brownfield project documentation (optional)"
     sharded: "{output_folder}/index.md"
     load_strategy: "INDEX_GUIDED"
 

src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml

@@ -25,39 +25,37 @@ validation: "{installed_path}/checklist.md"
 # Output configuration
 default_output_file: "{output_folder}/implementation-readiness-report-{{date}}.md"
 
-# Input requirements
-recommended_inputs:
-  - prd: "Product Requirements Document with FRs and NFRs"
-  - architecture: "System Architecture with decisions and patterns"
-  - tech_spec: "Technical Specification (for Quick Flow track)"
-  - epics: "Epic breakdown with user stories"
-  - ux_design: "UX design specification (if UI components)"
-
 # Smart input file references - handles both whole docs and sharded docs
 # Priority: Whole document first, then sharded version
 # Strategy: How to load sharded documents (FULL_LOAD, SELECTIVE_LOAD, INDEX_GUIDED)
 input_file_patterns:
   prd:
+    description: "Product Requirements with FRs and NFRs"
     whole: "{output_folder}/*prd*.md"
     sharded: "{output_folder}/*prd*/index.md"
     load_strategy: "FULL_LOAD"
   epics:
+    description: "Epic breakdown with user stories"
     whole: "{output_folder}/*epic*.md"
     sharded: "{output_folder}/*epic*/index.md"
     load_strategy: "FULL_LOAD"
   architecture:
+    description: "System architecture with decisions and patterns"
     whole: "{output_folder}/*architecture*.md"
     sharded: "{output_folder}/*architecture*/index.md"
     load_strategy: "FULL_LOAD"
   ux_design:
+    description: "UX design specification (if UI components)"
     whole: "{output_folder}/*ux*.md"
     sharded: "{output_folder}/*ux*/index.md"
     load_strategy: "FULL_LOAD"
   tech_spec:
+    description: "Technical specification (for Quick Flow track)"
     whole: "{output_folder}/*tech-spec*.md"
     sharded: "{output_folder}/*tech-spec*/index.md"
     load_strategy: "FULL_LOAD"
   document_project:
+    description: "Brownfield project documentation (optional)"
     sharded: "{output_folder}/docs/index.md"
     load_strategy: "INDEX_GUIDED"
 

src/modules/bmm/workflows/4-implementation/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 for review context"
     whole: "{output_folder}/*architecture*.md"
     sharded: "{output_folder}/*architecture*/*.md"
     load_strategy: "FULL_LOAD"
   ux_design:
+    description: "UX design specification (if UI review)"
     whole: "{output_folder}/*ux*.md"
     sharded: "{output_folder}/*ux*/*.md"
     load_strategy: "FULL_LOAD"
   epics:
+    description: "Epic containing story being reviewed"
     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/bmm/workflows/4-implementation/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 for impact analysis"
     whole: "{output_folder}/*prd*.md"
     sharded: "{output_folder}/*prd*/*.md"
     load_strategy: "FULL_LOAD"
   epics:
+    description: "All epics to analyze change impact"
     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 impacts)"
     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/bmm/workflows/4-implementation/create-story/workflow.yaml

@@ -40,21 +40,26 @@ 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 (Quick Flow track)"
     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: "Epic containing this story"
     whole: "{output_folder}/*epic*.md"
     sharded_index: "{output_folder}/*epic*/index.md"
     sharded_single: "{output_folder}/*epic*/epic-{{epic_num}}.md"

src/modules/bmm/workflows/4-implementation/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 for this epic"
     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: "Epic containing this story"
     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/bmm/workflows/4-implementation/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 (for game projects)"
     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: "Specific epic for tech spec generation"
     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/bmm/workflows/4-implementation/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: "The completed epic for retrospective"
     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 epic's retrospective (optional)"
     pattern: "{sprint_artifacts}/**/epic-{{prev_epic_num}}-retro-*.md"
     load_strategy: "SELECTIVE_LOAD"
   architecture:
+    description: "System architecture for context"
     whole: "{output_folder}/*architecture*.md"
     sharded: "{output_folder}/*architecture*/*.md"
     load_strategy: "FULL_LOAD"
   prd:
+    description: "Product requirements for context"
     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/bmm/workflows/4-implementation/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/bmm/workflows/4-implementation/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 (Quick Flow track)"
     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: "Epic containing this story"
     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/bmm/workflows/document-project/workflow.yaml

@@ -22,11 +22,6 @@ validation: "{installed_path}/checklist.md"
 # Required data files - CRITICAL for project type detection and documentation requirements
 documentation_requirements_csv: "{installed_path}/documentation-requirements.csv"
 
-# Optional input - project root to scan (defaults to current working directory)
-recommended_inputs:
-  - project_root: "User will specify or use current directory"
-  - existing_readme: "README.md at project root (if exists)"
-  - project_config: "package.json, go.mod, requirements.txt, etc. (auto-detected)"
 # Output configuration - Multiple files generated in output folder
 # Primary output: {output_folder}/index.md
 # Additional files generated by sub-workflows based on project structure

src/modules/bmm/workflows/testarch/atdd/workflow.yaml

@@ -32,13 +32,6 @@ required_tools:
   - list_files # Find existing fixtures and helpers
   - search_repo # Search for similar test patterns
 
-# Recommended inputs
-recommended_inputs:
-  - story: "Story markdown with acceptance criteria (required)"
-  - framework_config: "Test framework configuration (playwright.config.ts, cypress.config.ts)"
-  - existing_fixtures: "Current fixture patterns for consistency"
-  - test_design: "Test design document (optional, for risk/priority context)"
-
 tags:
   - qa
   - atdd

src/modules/bmm/workflows/testarch/automate/workflow.yaml

@@ -39,15 +39,6 @@ required_tools:
   - search_repo # Find coverage gaps and patterns
   - glob # Find test files and source files
 
-# Recommended inputs (optional - depends on mode)
-recommended_inputs:
-  - story: "Story markdown with acceptance criteria (optional - BMad mode only)"
-  - tech_spec: "Technical specification (optional - BMad mode only)"
-  - test_design: "Test design document with risk/priority (optional - BMad mode only)"
-  - source_code: "Feature implementation to analyze (required for standalone mode)"
-  - existing_tests: "Current test suite for gap analysis (always helpful)"
-  - framework_config: "Test framework configuration (playwright.config.ts, cypress.config.ts)"
-
 tags:
   - qa
   - automation

src/modules/bmm/workflows/testarch/ci/workflow.yaml

@@ -32,14 +32,6 @@ required_tools:
   - list_files # Detect existing CI configuration
   - search_repo # Find test files for selective testing
 
-# Recommended inputs
-recommended_inputs:
-  - framework_config: "Framework configuration (playwright.config.ts, cypress.config.ts)"
-  - package_json: "Project dependencies and scripts"
-  - nvmrc: ".nvmrc for Node version (optional, defaults to LTS)"
-  - existing_ci: "Existing CI configuration to update (optional)"
-  - git_info: "Git repository information for platform detection"
-
 tags:
   - qa
   - ci-cd

src/modules/bmm/workflows/testarch/framework/workflow.yaml

@@ -34,12 +34,6 @@ required_tools:
   - list_files # Check for existing framework
   - search_repo # Find architecture docs
 
-# Recommended inputs
-recommended_inputs:
-  - package_json: "package.json with project dependencies and scripts"
-  - architecture_docs: "Architecture or tech stack documentation (optional)"
-  - existing_tests: "Existing test files to detect current framework (optional)"
-
 tags:
   - qa
   - setup

src/modules/bmm/workflows/testarch/nfr-assess/workflow.yaml

@@ -33,15 +33,6 @@ required_tools:
   - search_repo # Find NFR-related tests and evidence
   - glob # Find result files matching patterns
 
-# Recommended inputs
-recommended_inputs:
-  - story: "Story markdown with NFR requirements (optional)"
-  - tech_spec: "Technical specification with NFR targets (recommended)"
-  - test_results: "Test execution results (performance, security, etc.)"
-  - metrics: "Application metrics (response times, error rates, etc.)"
-  - logs: "Application logs for reliability analysis"
-  - ci_results: "CI/CD pipeline results for burn-in validation"
-
 tags:
   - qa
   - nfr

src/modules/bmm/workflows/testarch/test-design/workflow.yaml

@@ -35,14 +35,6 @@ required_tools:
   - list_files # Find related documentation
   - search_repo # Search for existing tests and patterns
 
-# Recommended inputs
-recommended_inputs:
-  - prd: "Product Requirements Document for context"
-  - epics: "Epic documentation (epics.md or specific epic)"
-  - story: "Story markdown with acceptance criteria"
-  - architecture: "Architecture documents (architecture.md, tech-spec)"
-  - existing_tests: "Current test coverage for gap analysis"
-
 tags:
   - qa
   - planning

src/modules/bmm/workflows/testarch/test-review/workflow.yaml

@@ -33,13 +33,6 @@ required_tools:
   - search_repo # Find tests by patterns
   - glob # Find test files matching patterns
 
-# Recommended inputs
-recommended_inputs:
-  - test_file: "Test file to review (single file mode)"
-  - test_dir: "Directory of tests to review (directory mode)"
-  - story: "Related story for acceptance criteria context (optional)"
-  - test_design: "Test design for priority context (optional)"
-
 tags:
   - qa
   - test-architect

src/modules/bmm/workflows/testarch/trace/workflow.yaml

@@ -39,17 +39,6 @@ required_tools:
   - search_repo # Find tests by test ID, describe blocks
   - glob # Find test files matching patterns
 
-# Recommended inputs
-recommended_inputs:
-  - story: "Story markdown with acceptance criteria (required for BMad mode)"
-  - test_files: "Test suite for the feature (auto-discovered if not provided)"
-  - test_design: "Test design with risk/priority assessment (required for Phase 2 gate)"
-  - tech_spec: "Technical specification (optional)"
-  - existing_tests: "Current test suite for analysis"
-  - test_results: "CI/CD test execution results (required for Phase 2 gate)"
-  - nfr_assess: "Non-functional requirements validation (recommended for release gates)"
-  - code_coverage: "Code coverage report (optional)"
-
 tags:
   - qa
   - traceability

src/modules/cis/workflows/design-thinking/workflow.yaml

@@ -10,11 +10,6 @@ user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
 date: system-generated
 
-# Optional inputs for context
-recommended_inputs:
-  - design_context: "Context document passed via data attribute"
-  - user_research: "{output_folder}/research-*.md"
-
 # Context can be provided via data attribute when invoking
 # Example: data="{path}/product-context.md" provides project context
 

src/modules/cis/workflows/innovation-strategy/workflow.yaml

@@ -10,11 +10,6 @@ user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
 date: system-generated
 
-# Optional inputs for context
-recommended_inputs:
-  - market_context: "Context document passed via data attribute"
-  - competitive_intel: "{output_folder}/market-*.md"
-
 # Context can be provided via data attribute when invoking
 # Example: data="{path}/industry-analysis.md" provides market context
 

src/modules/cis/workflows/problem-solving/workflow.yaml

@@ -10,11 +10,6 @@ user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
 date: system-generated
 
-# Optional inputs for context
-recommended_inputs:
-  - problem_context: "Context document passed via data attribute"
-  - previous_attempts: "{output_folder}/problem-*.md"
-
 # Context can be provided via data attribute when invoking
 # Example: data="{path}/problem-brief.md" provides context
 

src/modules/cis/workflows/storytelling/workflow.yaml

@@ -10,11 +10,6 @@ user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
 date: system-generated
 
-# Optional inputs for context
-recommended_inputs:
-  - story_context: "Context document passed via data attribute"
-  - previous_stories: "{output_folder}/story-*.md"
-
 # Context can be provided via data attribute when invoking
 # Example: data="{path}/brand-info.md" provides brand context