bmad-method 6.0.0-alpha.15 → 6.0.0-alpha.16

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

@@ -4,7 +4,7 @@ description: "Facilitate game brainstorming sessions by orchestrating the CIS br
 author: "BMad"
 
 # Critical variables from config
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ game_dev_experience: "{config_source}:game_dev_experience"
 date: system-generated
 
 # Module path and component files
-installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/1-preproduction/brainstorm-game"
+installed_path: "{project-root}/.bmad/bmgd/workflows/1-preproduction/brainstorm-game"
 template: false
 instructions: "{installed_path}/instructions.md"
 
@@ -22,7 +22,7 @@ game_context: "{installed_path}/game-context.md"
 game_brain_methods: "{installed_path}/game-brain-methods.csv"
 
 # CORE brainstorming workflow to invoke
-core_brainstorming: "{project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml"
+core_brainstorming: "{project-root}/.bmad/core/workflows/brainstorming/workflow.yaml"
 
 standalone: true
 
@@ -30,12 +30,12 @@ web_bundle:
   name: "brainstorm-game"
   description: "Facilitate game brainstorming sessions by orchestrating the CIS brainstorming workflow with game-specific context, guidance, and additional game design techniques."
   author: "BMad"
-  instructions: "{bmad_folder}/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md"
+  instructions: ".bmad/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md"
   template: false
   web_bundle_files:
-    - "{bmad_folder}/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md"
-    - "{bmad_folder}/bmgd/workflows/1-preproduction/brainstorm-game/game-context.md"
-    - "{bmad_folder}/bmgd/workflows/1-preproduction/brainstorm-game/game-brain-methods.csv"
-    - "{bmad_folder}/core/workflows/brainstorming/workflow.yaml"
+    - ".bmad/bmgd/workflows/1-preproduction/brainstorm-game/instructions.md"
+    - ".bmad/bmgd/workflows/1-preproduction/brainstorm-game/game-context.md"
+    - ".bmad/bmgd/workflows/1-preproduction/brainstorm-game/game-brain-methods.csv"
+    - ".bmad/core/workflows/brainstorming/workflow.yaml"
   existing_workflows:
-    - core_brainstorming: "{bmad_folder}/core/workflows/brainstorming/workflow.yaml"
+    - core_brainstorming: ".bmad/core/workflows/brainstorming/workflow.yaml"

package/src/modules/bmgd/workflows/1-preproduction/game-brief/instructions.md

@@ -1,6 +1,6 @@
 # Game Brief - Interactive Workflow Instructions
 
-<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
+<critical>The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
 <critical>Generate all documents in {document_output_language}</critical>

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

@@ -4,7 +4,7 @@ description: "Interactive game brief creation workflow that guides users through
 author: "BMad"
 
 # Critical variables from config
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ game_dev_experience: "{config_source}:game_dev_experience"
 date: system-generated
 
 # Module path and component files
-installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/1-preproduction/game-brief"
+installed_path: "{project-root}/.bmad/bmgd/workflows/1-preproduction/game-brief"
 template: "{installed_path}/template.md"
 instructions: "{installed_path}/instructions.md"
 validation: "{installed_path}/checklist.md"
@@ -27,10 +27,10 @@ web_bundle:
   name: "game-brief"
   description: "Interactive game brief creation workflow that guides users through defining their game vision with multiple input sources and conversational collaboration"
   author: "BMad"
-  instructions: "{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/instructions.md"
-  validation: "{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/checklist.md"
-  template: "{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/template.md"
+  instructions: ".bmad/bmgd/workflows/1-preproduction/game-brief/instructions.md"
+  validation: ".bmad/bmgd/workflows/1-preproduction/game-brief/checklist.md"
+  template: ".bmad/bmgd/workflows/1-preproduction/game-brief/template.md"
   web_bundle_files:
-    - "{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/instructions.md"
-    - "{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/checklist.md"
-    - "{bmad_folder}/bmgd/workflows/1-preproduction/game-brief/template.md"
+    - ".bmad/bmgd/workflows/1-preproduction/game-brief/instructions.md"
+    - ".bmad/bmgd/workflows/1-preproduction/game-brief/checklist.md"
+    - ".bmad/bmgd/workflows/1-preproduction/game-brief/template.md"

package/src/modules/bmgd/workflows/2-design/gdd/instructions-gdd.md

@@ -2,7 +2,7 @@
 
 <workflow>
 
-<critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
+<critical>The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
 <critical>Generate all documents in {document_output_language}</critical>
@@ -35,7 +35,7 @@ This workflow requires: game brief, and may reference market research or brownfi
 
 <step n="0" goal="Validate workflow and extract project configuration">
 
-<invoke-workflow path="{project-root}/{bmad_folder}/bmm/workflows/workflow-status">
+<invoke-workflow path="{project-root}/.bmad/bmm/workflows/workflow-status">
   <param>mode: data</param>
   <param>data_request: project_config</param>
 </invoke-workflow>
@@ -399,7 +399,7 @@ Your choice:</ask>
 </check>
 
 <check if="user selects option 1 or fuzzy indicates wanting to create the narrative design document">
-  <invoke-workflow>{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/narrative/workflow.yaml</invoke-workflow>
+  <invoke-workflow>{project-root}/.bmad/bmm/workflows/2-plan-workflows/narrative/workflow.yaml</invoke-workflow>
   <action>Pass GDD context to narrative workflow</action>
   <action>Exit current workflow (narrative will hand off to solutioning when done)</action>
 
@@ -493,7 +493,7 @@ Which would you like to proceed with?</ask>
 </check>
 
 <check if="user selects narrative option">
-  <invoke-workflow>{project-root}/{bmad_folder}/bmm/workflows/2-plan-workflows/narrative/workflow.yaml</invoke-workflow>
+  <invoke-workflow>{project-root}/.bmad/bmm/workflows/2-plan-workflows/narrative/workflow.yaml</invoke-workflow>
   <action>Pass GDD context to narrative workflow</action>
 </check>
 

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

@@ -4,7 +4,7 @@ description: "Game Design Document workflow for all game project levels - from s
 author: "BMad"
 
 # Critical variables from config
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ game_dev_experience: "{config_source}:game_dev_experience"
 date: system-generated
 
 # Workflow components
-installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/2-design/gdd"
+installed_path: "{project-root}/.bmad/bmgd/workflows/2-design/gdd"
 instructions: "{installed_path}/instructions-gdd.md"
 template: "{installed_path}/gdd-template.md"
 game_types_csv: "{installed_path}/game-types.csv"
@@ -50,32 +50,32 @@ web_bundle:
   name: "gdd"
   description: "Game Design Document workflow for all game project levels - from small prototypes to full AAA games. Generates comprehensive GDD with game mechanics, systems, progression, and implementation guidance."
   author: "BMad"
-  instructions: "{bmad_folder}/bmgd/workflows/2-design/gdd/instructions-gdd.md"
+  instructions: ".bmad/bmgd/workflows/2-design/gdd/instructions-gdd.md"
   web_bundle_files:
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/instructions-gdd.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/gdd-template.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types.csv"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/action-platformer.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/adventure.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/card-game.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/fighting.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/horror.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/idle-incremental.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/metroidvania.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/moba.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/party-game.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/puzzle.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/racing.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/rhythm.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/roguelike.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/rpg.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/sandbox.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/shooter.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/simulation.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/sports.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/strategy.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/survival.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/text-based.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/tower-defense.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/turn-based-tactics.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/gdd/game-types/visual-novel.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/instructions-gdd.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/gdd-template.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types.csv"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/action-platformer.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/adventure.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/card-game.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/fighting.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/horror.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/idle-incremental.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/metroidvania.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/moba.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/party-game.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/puzzle.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/racing.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/rhythm.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/roguelike.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/rpg.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/sandbox.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/shooter.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/simulation.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/sports.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/strategy.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/survival.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/text-based.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/tower-defense.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/turn-based-tactics.md"
+    - ".bmad/bmgd/workflows/2-design/gdd/game-types/visual-novel.md"

package/src/modules/bmgd/workflows/2-design/narrative/instructions-narrative.md

@@ -2,7 +2,7 @@
 
 <workflow>
 
-<critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
+<critical>The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already completed the GDD workflow</critical>
 <critical>Communicate all responses in {communication_language}</critical>
 <critical>This workflow creates detailed narrative content for story-driven games</critical>

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

@@ -4,7 +4,7 @@ description: "Narrative design workflow for story-driven games and applications.
 author: "BMad"
 
 # Critical variables from config
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -13,7 +13,7 @@ game_dev_experience: "{config_source}:game_dev_experience"
 date: system-generated
 
 # Workflow components
-installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/2-design/narrative"
+installed_path: "{project-root}/.bmad/bmgd/workflows/2-design/narrative"
 instructions: "{installed_path}/instructions-narrative.md"
 template: "{installed_path}/narrative-template.md"
 
@@ -26,7 +26,7 @@ web_bundle:
   name: "narrative"
   description: "Narrative design workflow for story-driven games and applications. Creates comprehensive narrative documentation including story structure, character arcs, dialogue systems, and narrative implementation guidance."
   author: "BMad"
-  instructions: "{bmad_folder}/bmgd/workflows/2-design/narrative/instructions-narrative.md"
+  instructions: ".bmad/bmgd/workflows/2-design/narrative/instructions-narrative.md"
   web_bundle_files:
-    - "{bmad_folder}/bmgd/workflows/2-design/narrative/instructions-narrative.md"
-    - "{bmad_folder}/bmgd/workflows/2-design/narrative/narrative-template.md"
+    - ".bmad/bmgd/workflows/2-design/narrative/instructions-narrative.md"
+    - ".bmad/bmgd/workflows/2-design/narrative/narrative-template.md"

package/src/modules/bmgd/workflows/3-technical/game-architecture/instructions.md

@@ -2,7 +2,7 @@
 
 <workflow name="architecture">
 
-<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
+<critical>The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>This workflow uses ADAPTIVE FACILITATION - adjust your communication style based on {user_skill_level}</critical>
 <critical>The goal is ARCHITECTURAL DECISIONS that prevent AI agent conflicts, not detailed implementation specs</critical>

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

@@ -4,7 +4,7 @@ description: "Collaborative game architecture workflow for AI-agent consistency.
 author: "BMad"
 
 # Critical variables
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -39,7 +39,7 @@ input_file_patterns:
     load_strategy: "INDEX_GUIDED"
 
 # Module path and component files
-installed_path: "{project-root}/{bmad_folder}/bmgd/workflows/3-technical/game-architecture"
+installed_path: "{project-root}/.bmad/bmgd/workflows/3-technical/game-architecture"
 instructions: "{installed_path}/instructions.md"
 validation: "{installed_path}/checklist.md"
 template: "{installed_path}/architecture-template.md"

package/src/modules/bmgd/workflows/4-production/code-review/instructions.md

@@ -1,7 +1,7 @@
 # Senior Developer Review - Workflow Instructions
 
 ````xml
-<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
+<critical>The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
 <critical>Generate all documents in {document_output_language}</critical>
@@ -354,7 +354,7 @@ Review was saved to story file, but sprint-status.yaml may be out of sync.
   </step>
 
   <step n="10" goal="Validation and completion">
-    <invoke-task>Run validation checklist at {installed_path}/checklist.md using {project-root}/{bmad_folder}/core/tasks/validate-workflow.xml</invoke-task>
+    <invoke-task>Run validation checklist at {installed_path}/checklist.md using {project-root}/.bmad/core/tasks/validate-workflow.xml</invoke-task>
     <action>Report workflow completion.</action>
 
     <check if="ad_hoc_review_mode == true">

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

@@ -4,7 +4,7 @@ description: "Perform a Senior Developer code review on a completed story flagge
 author: "BMad"
 
 # Critical variables from config
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -15,7 +15,7 @@ sprint_artifacts: "{config_source}:sprint_artifacts"
 sprint_status: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-status.yaml"
 
 # Workflow components
-installed_path: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/code-review"
+installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/code-review"
 instructions: "{installed_path}/instructions.md"
 validation: "{installed_path}/checklist.md"
 template: false

package/src/modules/bmgd/workflows/4-production/correct-course/checklist.md

@@ -1,6 +1,6 @@
 # Change Navigation Checklist
 
-<critical>This checklist is executed as part of: {project-root}/{bmad_folder}/bmm/workflows/4-implementation/correct-course/workflow.yaml</critical>
+<critical>This checklist is executed as part of: {project-root}/.bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml</critical>
 <critical>Work through each section systematically with the user, recording findings and impacts</critical>
 
 <checklist>

package/src/modules/bmgd/workflows/4-production/correct-course/instructions.md

@@ -1,7 +1,7 @@
 # Correct Course - Sprint Change Management Instructions
 
-<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}/bmm/workflows/4-implementation/correct-course/workflow.yaml</critical>
+<critical>The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project-root}/.bmad/bmm/workflows/4-implementation/correct-course/workflow.yaml</critical>
 <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
 <critical>Generate all documents in {document_output_language}</critical>
 

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

@@ -3,7 +3,7 @@ name: "correct-course"
 description: "Navigate significant changes during sprint execution by analyzing impact, proposing solutions, and routing for implementation"
 author: "BMad Method"
 
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -46,7 +46,7 @@ input_file_patterns:
     sharded: "{output_folder}/index.md"
     load_strategy: "INDEX_GUIDED"
 
-installed_path: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/correct-course"
+installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/correct-course"
 template: false
 instructions: "{installed_path}/instructions.md"
 validation: "{installed_path}/checklist.md"

package/src/modules/bmgd/workflows/4-production/create-story/instructions.md

@@ -1,7 +1,7 @@
 # Create Story - Workflow Instructions (Spec-compliant, non-interactive by default)
 
 ````xml
-<critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
+<critical>The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>Generate all documents in {document_output_language}</critical>
 <critical>This workflow creates or updates the next user story from epics/PRD and architecture context, saving to the configured stories directory and optionally invoking Story Context.</critical>
@@ -213,7 +213,7 @@ Will update existing story file rather than creating new one.
   </step>
 
   <step n="8" goal="Validate, save, and mark story drafted" tag="sprint-status">
-    <invoke-task>Validate against checklist at {installed_path}/checklist.md using {bmad_folder}/core/tasks/validate-workflow.xml</invoke-task>
+    <invoke-task>Validate against checklist at {installed_path}/checklist.md using .bmad/core/tasks/validate-workflow.xml</invoke-task>
     <action>Save document unconditionally (non-interactive default). In interactive mode, allow user confirmation.</action>
 
     <!-- Mark story as drafted in sprint status -->

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

@@ -3,7 +3,7 @@ description: "Create the next user story markdown from epics/PRD and architectur
 author: "BMad"
 
 # Critical variables from config
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -12,7 +12,7 @@ sprint_artifacts: "{config_source}:sprint_artifacts"
 story_dir: "{sprint_artifacts}"
 
 # Workflow components
-installed_path: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/create-story"
+installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/create-story"
 template: "{installed_path}/template.md"
 instructions: "{installed_path}/instructions.md"
 validation: "{installed_path}/checklist.md"

package/src/modules/bmgd/workflows/4-production/dev-story/instructions.md

@@ -1,7 +1,7 @@
 # Develop Story - Workflow Instructions
 
 ```xml
-<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
+<critical>The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
 <critical>Generate all documents in {document_output_language}</critical>
@@ -232,7 +232,7 @@ Story is marked Ready for Review in file, but sprint-status.yaml may be out of s
   </step>
 
   <step n="7" goal="Completion communication and user support">
-    <action>Optionally run the workflow validation task against the story using {project-root}/{bmad_folder}/core/tasks/validate-workflow.xml</action>
+    <action>Optionally run the workflow validation task against the story using {project-root}/.bmad/core/tasks/validate-workflow.xml</action>
     <action>Prepare a concise summary in Dev Agent Record → Completion Notes</action>
 
     <action>Communicate to {user_name} that story implementation is complete and ready for review</action>

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

@@ -3,7 +3,7 @@ description: "Execute a story by implementing tasks/subtasks, writing tests, val
 author: "BMad"
 
 # Critical variables from config
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -49,7 +49,7 @@ input_file_patterns:
     load_strategy: "INDEX_GUIDED"
 
 # Workflow components
-installed_path: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/dev-story"
+installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/dev-story"
 instructions: "{installed_path}/instructions.md"
 validation: "{installed_path}/checklist.md"
 

package/src/modules/bmgd/workflows/4-production/epic-tech-context/checklist.md

@@ -1,7 +1,7 @@
 # Tech Spec Validation Checklist
 
 ```xml
-<checklist id="{bmad_folder}/bmm/workflows/4-implementation/epic-tech-context/checklist">
+<checklist id=".bmad/bmm/workflows/4-implementation/epic-tech-context/checklist">
   <item>Overview clearly ties to PRD goals</item>
   <item>Scope explicitly lists in-scope and out-of-scope</item>
   <item>Design lists all services/modules with responsibilities</item>

package/src/modules/bmgd/workflows/4-production/epic-tech-context/instructions.md

@@ -1,7 +1,7 @@
 <!-- BMAD BMM Tech Spec Workflow Instructions (v6) -->
 
 ```xml
-<critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
+<critical>The workflow execution engine is governed by: {project_root}/.bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>Communicate all responses in {communication_language}</critical>
 <critical>This workflow generates a comprehensive Technical Specification from PRD and Architecture, including detailed design, NFRs, acceptance criteria, and traceability mapping.</critical>
@@ -132,7 +132,7 @@ Continuing to regenerate tech spec...
   </step>
 
   <step n="9" goal="Validate and mark epic contexted" tag="sprint-status">
-    <invoke-task>Validate against checklist at {installed_path}/checklist.md using {bmad_folder}/core/tasks/validate-workflow.xml</invoke-task>
+    <invoke-task>Validate against checklist at {installed_path}/checklist.md using .bmad/core/tasks/validate-workflow.xml</invoke-task>
 
     <!-- Mark epic as contexted -->
     <action>Load the FULL file: {sprint_status}</action>

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

@@ -3,7 +3,7 @@ description: "Generate a comprehensive Technical Specification from PRD and Arch
 author: "BMAD BMM"
 
 # Critical variables
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -47,7 +47,7 @@ input_file_patterns:
     load_strategy: "INDEX_GUIDED"
 
 # Workflow components
-installed_path: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/epic-tech-context"
+installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/epic-tech-context"
 template: "{installed_path}/template.md"
 instructions: "{installed_path}/instructions.md"
 validation: "{installed_path}/checklist.md"

package/src/modules/bmgd/workflows/4-production/retrospective/instructions.md

@@ -1,7 +1,7 @@
 # Retrospective - Epic Completion Review Instructions
 
-<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}/bmm/workflows/4-implementation/retrospective/workflow.yaml</critical>
+<critical>The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project-root}/.bmad/bmm/workflows/4-implementation/retrospective/workflow.yaml</critical>
 <critical>Communicate all responses in {communication_language} and language MUST be tailored to {user_skill_level}</critical>
 <critical>Generate all documents in {document_output_language}</critical>
 <critical>⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.</critical>

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

@@ -3,7 +3,7 @@ name: "retrospective"
 description: "Run after epic completion to review overall success, extract lessons learned, and explore if new information emerged that might impact the next epic"
 author: "BMad"
 
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -12,12 +12,12 @@ document_output_language: "{config_source}:document_output_language"
 date: system-generated
 sprint_artifacts: "{config_source}:sprint_artifacts"
 
-installed_path: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/retrospective"
+installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/retrospective"
 template: false
 instructions: "{installed_path}/instructions.md"
 
 required_inputs:
-  - agent_manifest: "{project-root}/{bmad_folder}/_cfg/agent-manifest.csv"
+  - agent_manifest: "{project-root}/.bmad/_cfg/agent-manifest.csv"
 
 # Smart input file references - handles both whole docs and sharded docs
 # Priority: Whole document first, then sharded version

package/src/modules/bmgd/workflows/4-production/sprint-planning/instructions.md

@@ -1,7 +1,7 @@
 # Sprint Planning - Sprint Status Generator
 
-<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}/bmm/workflows/4-implementation/sprint-planning/workflow.yaml</critical>
+<critical>The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project-root}/.bmad/bmm/workflows/4-implementation/sprint-planning/workflow.yaml</critical>
 
 ## 📚 Document Discovery - Full Epic Loading
 

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

@@ -3,7 +3,7 @@ description: "Generate and manage the sprint status tracking file for Phase 4 im
 author: "BMad"
 
 # Critical variables from config
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -11,7 +11,7 @@ date: system-generated
 sprint_artifacts: "{config_source}:sprint_artifacts"
 
 # Workflow components
-installed_path: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/sprint-planning"
+installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/sprint-planning"
 instructions: "{installed_path}/instructions.md"
 template: "{installed_path}/sprint-status-template.yaml"
 validation: "{installed_path}/checklist.md"

package/src/modules/bmgd/workflows/4-production/story-context/checklist.md

@@ -1,7 +1,7 @@
 # Story Context Assembly Checklist
 
 ```xml
-<checklist id="{bmad_folder}/bmm/workflows/4-implementation/story-context/checklist">
+<checklist id=".bmad/bmm/workflows/4-implementation/story-context/checklist">
   <item>Story fields (asA/iWant/soThat) captured</item>
   <item>Acceptance criteria list matches story draft exactly (no invention)</item>
   <item>Tasks/subtasks captured as task list</item>

package/src/modules/bmgd/workflows/4-production/story-context/context-template.xml

@@ -1,4 +1,4 @@
-<story-context id="{bmad_folder}/bmm/workflows/4-implementation/story-context/template" v="1.0">
+<story-context id=".bmad/bmm/workflows/4-implementation/story-context/template" v="1.0">
   <metadata>
     <epicId>{{epic_id}}</epicId>
     <storyId>{{story_id}}</storyId>

package/src/modules/bmgd/workflows/4-production/story-context/instructions.md

@@ -1,7 +1,7 @@
 <!-- BMAD BMM Story Context Assembly Instructions (v6) -->
 
 ```xml
-<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
+<critical>The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml</critical>
 <critical>You MUST have already loaded and processed: {installed_path}/workflow.yaml</critical>
 <critical>Communicate all responses in {communication_language}</critical>
 <critical>Generate all documents in {document_output_language}</critical>
@@ -156,7 +156,7 @@
   <step n="6" goal="Validate and save">
     <anchor id="validation_step" />
     <action>Validate output context file structure and content</action>
-    <invoke-task>Validate against checklist at {installed_path}/checklist.md using {bmad_folder}/core/tasks/validate-workflow.xml</invoke-task>
+    <invoke-task>Validate against checklist at {installed_path}/checklist.md using .bmad/core/tasks/validate-workflow.xml</invoke-task>
   </step>
 
   <step n="7" goal="Update story file and mark ready for dev" tag="sprint-status">

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

@@ -4,7 +4,7 @@ description: "Assemble a dynamic Story Context XML by pulling latest documentati
 author: "BMad"
 
 # Critical variables
-config_source: "{project-root}/{bmad_folder}/bmgd/config.yaml"
+config_source: "{project-root}/.bmad/bmgd/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
@@ -15,7 +15,7 @@ sprint_artifacts: "{config_source}:sprint_artifacts"
 sprint_status: "{sprint_artifacts}/sprint-status.yaml || {output_folder}/sprint-status.yaml"
 
 # Workflow components
-installed_path: "{project-root}/{bmad_folder}/bmm/workflows/4-implementation/story-context"
+installed_path: "{project-root}/.bmad/bmm/workflows/4-implementation/story-context"
 template: "{installed_path}/context-template.xml"
 instructions: "{installed_path}/instructions.md"
 validation: "{installed_path}/checklist.md"