diff --git a/.gitignore b/.gitignore
index 3fdf28c4..aed5f2dc 100644
--- a/.gitignore
+++ b/.gitignore
@@ -63,4 +63,7 @@ src/modules/bmb/sub-modules/
src/modules/cis/sub-modules/
src/modules/bmgd/sub-modules/
-z*/
\ No newline at end of file
+z*/
+
+.bmad
+.claude
diff --git a/.prettierignore b/.prettierignore
index a2891ff2..24d5d69f 100644
--- a/.prettierignore
+++ b/.prettierignore
@@ -1,2 +1,6 @@
# Test fixtures with intentionally broken/malformed files
test/fixtures/**
+
+# BMAD runtime folders (user-specific, not in repo)
+.bmad/
+.bmad*/
diff --git a/eslint.config.mjs b/eslint.config.mjs
index f9f161b1..23530940 100644
--- a/eslint.config.mjs
+++ b/eslint.config.mjs
@@ -16,6 +16,8 @@ export default [
'test/template-test-generator/**/*.md',
'test/fixtures/**',
'test/fixtures/**/*.yaml',
+ '.bmad/**',
+ '.bmad*/**',
],
},
diff --git a/src/core/workflows/brainstorming/workflow.yaml b/src/core/workflows/brainstorming/workflow.yaml
index 38dff0ad..4697f4d4 100644
--- a/src/core/workflows/brainstorming/workflow.yaml
+++ b/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
diff --git a/src/modules/bmb/workflows/convert-legacy/workflow.yaml b/src/modules/bmb/workflows/convert-legacy/workflow.yaml
index 48229803..c2cc40a5 100644
--- a/src/modules/bmb/workflows/convert-legacy/workflow.yaml
+++ b/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
diff --git a/src/modules/bmb/workflows/create-agent/instructions.md b/src/modules/bmb/workflows/create-agent/instructions.md
index 793ac936..158b6f9f 100644
--- a/src/modules/bmb/workflows/create-agent/instructions.md
+++ b/src/modules/bmb/workflows/create-agent/instructions.md
@@ -2,7 +2,8 @@
The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml
You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/create-agent/workflow.yaml
-Study YAML agent examples in: {project-root}/{bmad_folder}/bmm/agents/ for patterns
+Study YAML agent examples in: {example_agents_dir} for patterns
+Reference activation conventions from: {agent_activation_rules}
Communicate in {communication_language} throughout the agent creation process
diff --git a/src/modules/bmb/workflows/create-agent/workflow.yaml b/src/modules/bmb/workflows/create-agent/workflow.yaml
index 14b4c53a..b73cc4ba 100644
--- a/src/modules/bmb/workflows/create-agent/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmb/workflows/create-module/workflow.yaml b/src/modules/bmb/workflows/create-module/workflow.yaml
index 0d4d3c3d..a47bdbfb 100644
--- a/src/modules/bmb/workflows/create-module/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmb/workflows/create-workflow/workflow-template/workflow.yaml b/src/modules/bmb/workflows/create-workflow/workflow-template/workflow.yaml
index b43dea0f..7792e61e 100644
--- a/src/modules/bmb/workflows/create-workflow/workflow-template/workflow.yaml
+++ b/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
diff --git a/src/modules/bmb/workflows/create-workflow/workflow.yaml b/src/modules/bmb/workflows/create-workflow/workflow.yaml
index c5ed1bec..45b0f165 100644
--- a/src/modules/bmb/workflows/create-workflow/workflow.yaml
+++ b/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}}
diff --git a/src/modules/bmb/workflows/edit-agent/workflow.yaml b/src/modules/bmb/workflows/edit-agent/workflow.yaml
index 4c6d8f67..11d68a09 100644
--- a/src/modules/bmb/workflows/edit-agent/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmb/workflows/edit-module/instructions.md b/src/modules/bmb/workflows/edit-module/instructions.md
index d580e164..07f99156 100644
--- a/src/modules/bmb/workflows/edit-module/instructions.md
+++ b/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**
diff --git a/src/modules/bmb/workflows/edit-module/workflow.yaml b/src/modules/bmb/workflows/edit-module/workflow.yaml
index bab6aa7a..ae1d2868 100644
--- a/src/modules/bmb/workflows/edit-module/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmb/workflows/edit-workflow/instructions.md b/src/modules/bmb/workflows/edit-workflow/instructions.md
index d2ca8c28..e0d32bac 100644
--- a/src/modules/bmb/workflows/edit-workflow/instructions.md
+++ b/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}
Analyze the workflow deeply:
diff --git a/src/modules/bmb/workflows/edit-workflow/workflow.yaml b/src/modules/bmb/workflows/edit-workflow/workflow.yaml
index 6b4877ae..e49c6c93 100644
--- a/src/modules/bmb/workflows/edit-workflow/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmb/workflows/module-brief/workflow.yaml b/src/modules/bmb/workflows/module-brief/workflow.yaml
index 2386eed7..fad6e479 100644
--- a/src/modules/bmb/workflows/module-brief/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml b/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml
index 1bdcec88..13db2b3c 100644
--- a/src/modules/bmgd/workflows/1-preproduction/game-brief/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml b/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml
index 9b4cdb82..177136e3 100644
--- a/src/modules/bmgd/workflows/2-design/gdd/workflow.yaml
+++ b/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
diff --git a/src/modules/bmgd/workflows/2-design/narrative/workflow.yaml b/src/modules/bmgd/workflows/2-design/narrative/workflow.yaml
index 2853b51d..2bfd7991 100644
--- a/src/modules/bmgd/workflows/2-design/narrative/workflow.yaml
+++ b/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:
diff --git a/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml b/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml
index 29034e8f..7dac2f20 100644
--- a/src/modules/bmgd/workflows/3-technical/game-architecture/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml b/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml
index bf7a6cc6..da31b928 100644
--- a/src/modules/bmgd/workflows/4-production/code-review/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml b/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml
index 723caa5c..220da682 100644
--- a/src/modules/bmgd/workflows/4-production/correct-course/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml b/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml
index ed62858b..6846d9ed 100644
--- a/src/modules/bmgd/workflows/4-production/create-story/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml b/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml
index 9f6e6537..b3382266 100644
--- a/src/modules/bmgd/workflows/4-production/dev-story/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml b/src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml
index 6fd56b16..b9119098 100644
--- a/src/modules/bmgd/workflows/4-production/epic-tech-context/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml b/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml
index 9584f3b1..797564ac 100644
--- a/src/modules/bmgd/workflows/4-production/retrospective/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml b/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml
index e1e8624a..f0c2a6f5 100644
--- a/src/modules/bmgd/workflows/4-production/sprint-planning/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml b/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml
index f8b0e618..4d187730 100644
--- a/src/modules/bmgd/workflows/4-production/story-context/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/agents/pm.agent.yaml b/src/modules/bmm/agents/pm.agent.yaml
index 359f6103..dd4ba056 100644
--- a/src/modules/bmm/agents/pm.agent.yaml
+++ b/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
diff --git a/src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml b/src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml
index 13524981..faa51958 100644
--- a/src/modules/bmm/workflows/1-analysis/product-brief/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md b/src/modules/bmm/workflows/2-plan-workflows/create-epics-and-stories/epics-template.md
similarity index 100%
rename from src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/epics-template.md
rename to src/modules/bmm/workflows/2-plan-workflows/create-epics-and-stories/epics-template.md
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md b/src/modules/bmm/workflows/2-plan-workflows/create-epics-and-stories/instructions.md
similarity index 100%
rename from src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/instructions.md
rename to src/modules/bmm/workflows/2-plan-workflows/create-epics-and-stories/instructions.md
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml b/src/modules/bmm/workflows/2-plan-workflows/create-epics-and-stories/workflow.yaml
similarity index 72%
rename from src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml
rename to src/modules/bmm/workflows/2-plan-workflows/create-epics-and-stories/workflow.yaml
index f3ac0224..cf38969d 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/create-epics-and-stories/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml b/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml
index f7a082a1..b6c71d79 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.yaml b/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.yaml
index 5e23a621..a80370d8 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml b/src/modules/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml
index a96a01b6..daec644c 100644
--- a/src/modules/bmm/workflows/2-plan-workflows/tech-spec/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/3-solutioning/architecture/workflow.yaml b/src/modules/bmm/workflows/3-solutioning/architecture/workflow.yaml
index f3920b19..5e8dc42c 100644
--- a/src/modules/bmm/workflows/3-solutioning/architecture/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml b/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml
index cb3fb2d7..13c26482 100644
--- a/src/modules/bmm/workflows/3-solutioning/solutioning-gate-check/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml b/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml
index 21621887..e725b0a3 100644
--- a/src/modules/bmm/workflows/4-implementation/code-review/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml b/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml
index 6b4bbcb4..8b6fe757 100644
--- a/src/modules/bmm/workflows/4-implementation/correct-course/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml b/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml
index a7732379..f1a1dcc8 100644
--- a/src/modules/bmm/workflows/4-implementation/create-story/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml b/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml
index 3cc85e25..74ab5728 100644
--- a/src/modules/bmm/workflows/4-implementation/dev-story/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml b/src/modules/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml
index 1594aeec..91a8b593 100644
--- a/src/modules/bmm/workflows/4-implementation/epic-tech-context/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml b/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml
index 9fa92bcd..716bb544 100644
--- a/src/modules/bmm/workflows/4-implementation/retrospective/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml b/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml
index fa635951..e0309e68 100644
--- a/src/modules/bmm/workflows/4-implementation/sprint-planning/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml b/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml
index f673d62d..c40b84c8 100644
--- a/src/modules/bmm/workflows/4-implementation/story-context/workflow.yaml
+++ b/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"
diff --git a/src/modules/bmm/workflows/document-project/workflow.yaml b/src/modules/bmm/workflows/document-project/workflow.yaml
index 785ea831..7249d969 100644
--- a/src/modules/bmm/workflows/document-project/workflow.yaml
+++ b/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
diff --git a/src/modules/bmm/workflows/testarch/atdd/workflow.yaml b/src/modules/bmm/workflows/testarch/atdd/workflow.yaml
index b05c632c..4e6991f2 100644
--- a/src/modules/bmm/workflows/testarch/atdd/workflow.yaml
+++ b/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
diff --git a/src/modules/bmm/workflows/testarch/automate/workflow.yaml b/src/modules/bmm/workflows/testarch/automate/workflow.yaml
index 2e651a7b..c2704542 100644
--- a/src/modules/bmm/workflows/testarch/automate/workflow.yaml
+++ b/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
diff --git a/src/modules/bmm/workflows/testarch/ci/workflow.yaml b/src/modules/bmm/workflows/testarch/ci/workflow.yaml
index a8d9fc75..03b09493 100644
--- a/src/modules/bmm/workflows/testarch/ci/workflow.yaml
+++ b/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
diff --git a/src/modules/bmm/workflows/testarch/framework/workflow.yaml b/src/modules/bmm/workflows/testarch/framework/workflow.yaml
index 5ef332a0..3ccefdfa 100644
--- a/src/modules/bmm/workflows/testarch/framework/workflow.yaml
+++ b/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
diff --git a/src/modules/bmm/workflows/testarch/nfr-assess/workflow.yaml b/src/modules/bmm/workflows/testarch/nfr-assess/workflow.yaml
index f4fab200..66754945 100644
--- a/src/modules/bmm/workflows/testarch/nfr-assess/workflow.yaml
+++ b/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
diff --git a/src/modules/bmm/workflows/testarch/test-design/workflow.yaml b/src/modules/bmm/workflows/testarch/test-design/workflow.yaml
index 202551ba..2915ae40 100644
--- a/src/modules/bmm/workflows/testarch/test-design/workflow.yaml
+++ b/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
diff --git a/src/modules/bmm/workflows/testarch/test-review/workflow.yaml b/src/modules/bmm/workflows/testarch/test-review/workflow.yaml
index 0fb8ac71..86a8b297 100644
--- a/src/modules/bmm/workflows/testarch/test-review/workflow.yaml
+++ b/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
diff --git a/src/modules/bmm/workflows/testarch/trace/workflow.yaml b/src/modules/bmm/workflows/testarch/trace/workflow.yaml
index 369c272c..cbd35e0c 100644
--- a/src/modules/bmm/workflows/testarch/trace/workflow.yaml
+++ b/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
diff --git a/src/modules/cis/workflows/design-thinking/workflow.yaml b/src/modules/cis/workflows/design-thinking/workflow.yaml
index 7159aa2e..5befcde1 100644
--- a/src/modules/cis/workflows/design-thinking/workflow.yaml
+++ b/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
diff --git a/src/modules/cis/workflows/innovation-strategy/workflow.yaml b/src/modules/cis/workflows/innovation-strategy/workflow.yaml
index 55d35db3..5cd86b87 100644
--- a/src/modules/cis/workflows/innovation-strategy/workflow.yaml
+++ b/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
diff --git a/src/modules/cis/workflows/problem-solving/workflow.yaml b/src/modules/cis/workflows/problem-solving/workflow.yaml
index 2fca13ca..18d36dd2 100644
--- a/src/modules/cis/workflows/problem-solving/workflow.yaml
+++ b/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
diff --git a/src/modules/cis/workflows/storytelling/workflow.yaml b/src/modules/cis/workflows/storytelling/workflow.yaml
index ad71f59a..4e3bff42 100644
--- a/src/modules/cis/workflows/storytelling/workflow.yaml
+++ b/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