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/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"