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

package/src/modules/bmb/workflows/create-workflow/steps/step-06-design.md

@@ -3,7 +3,7 @@ name: 'step-06-design'
 description: 'Design the workflow structure and step sequence based on gathered requirements, tools configuration, and output format'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-06-design.md'
@@ -14,8 +14,8 @@ targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}
 workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
 
 # Task References
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 # Template References
 # No template needed - will append design details directly to workflow plan
 ---
@@ -70,11 +70,11 @@ To collaboratively design the workflow structure, step sequence, and interaction
 
 When designing, you may load these documents as needed:
 
-- `{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md` - Step file structure
-- `{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-01-init-continuable-template.md` - Continuable init step template
-- `{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-1b-template.md` - Continuation step template
-- `{project-root}/{bmad_folder}/bmb/docs/workflows/templates/workflow-template.md` - Workflow configuration
-- `{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition/workflow.md` - Complete example
+- `{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md` - Step file structure
+- `{project-root}/.bmad/bmb/docs/workflows/templates/step-01-init-continuable-template.md` - Continuable init step template
+- `{project-root}/.bmad/bmb/docs/workflows/templates/step-1b-template.md` - Continuation step template
+- `{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md` - Workflow configuration
+- `{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md` - Complete example
 
 ## WORKFLOW DESIGN PROCESS:
 
@@ -85,13 +85,13 @@ Let's reference our step creation documentation for best practices:
 Load and reference step-file architecture guide:
 
 ```
-Read: {project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md
+Read: {project-root}/.bmad/bmb/docs/workflows/templates/step-template.md
 ```
 
 This shows the standard structure for step files. Also reference:
 
 ```
-Read: {project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-1b-template.md
+Read: {project-root}/.bmad/bmb/docs/workflows/templates/step-1b-template.md
 ```
 
 This shows the continuation step pattern for workflows that might take multiple sessions.

package/src/modules/bmb/workflows/create-workflow/steps/step-07-build.md

@@ -3,7 +3,7 @@ name: 'step-07-build'
 description: 'Generate all workflow files based on the approved plan'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-07-build.md'
@@ -14,10 +14,10 @@ targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}
 workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
 
 # Template References
-workflowTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/workflow-template.md'
-stepTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md'
-stepInitContinuableTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-01-init-continuable-template.md'
-step1bTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-1b-template.md'
+workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
+stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
+stepInitContinuableTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-01-init-continuable-template.md'
+step1bTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-1b-template.md'
 # No content templates needed - will create content as needed during build
 # No build summary template needed - will append summary directly to workflow plan
 ---
@@ -68,11 +68,11 @@ To generate all the workflow files (workflow.md, step files, templates, and supp
 
 ## BUILD REFERENCE MATERIALS:
 
-- When building each step file, you must follow template `{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md`
-- When building continuable step-01-init.md files, use template `{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-01-init-continuable-template.md`
-- When building continuation steps, use template `{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-1b-template.md`
-- When building the main workflow.md file, you must follow template `{project-root}/{bmad_folder}/bmb/docs/workflows/templates/workflow-template.md`
-- Example step files from {project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition/workflow.md for patterns
+- When building each step file, you must follow template `{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md`
+- When building continuable step-01-init.md files, use template `{project-root}/.bmad/bmb/docs/workflows/templates/step-01-init-continuable-template.md`
+- When building continuation steps, use template `{project-root}/.bmad/bmb/docs/workflows/templates/step-1b-template.md`
+- When building the main workflow.md file, you must follow template `{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md`
+- Example step files from {project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md for patterns
 
 ## FILE GENERATION SEQUENCE:
 
@@ -108,8 +108,8 @@ Create the workflow folder structure in the target location:
     └── [as needed]
 ```
 
-For bmb module, this will be: `{bmad_folder}/custom/src/workflows/{workflow_name}/`
-For other modules, check their install-config.yaml for custom_workflow_location
+For bmb module, this will be: `.bmad/custom/src/workflows/{workflow_name}/`
+For other modules, check their module.yaml for custom_workflow_location
 
 ### 3. Generate workflow.md
 
@@ -117,7 +117,7 @@ Load and follow {workflowTemplate}:
 
 - Create workflow.md using template structure
 - Insert workflow name and description
-- Configure all path variables ({project-root}, {_bmad_folder_}, {workflow_path})
+- Configure all path variables ({project-root}, .bmad, {workflow_path})
 - Set web_bundle flag to true unless user has indicated otherwise
 - Define role and goal
 - Include initialization path to step-01

package/src/modules/bmb/workflows/create-workflow/steps/step-08-review.md

@@ -3,7 +3,7 @@ name: 'step-08-review'
 description: 'Review the generated workflow and provide final validation and next steps'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-08-review.md'
@@ -14,8 +14,8 @@ targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}
 workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
 
 # Task References
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 
 # Template References
 # No review template needed - will append review summary directly to workflow plan

package/src/modules/bmb/workflows/create-workflow/steps/step-09-complete.md

@@ -3,7 +3,7 @@ name: 'step-09-complete'
 description: 'Final completion and wrap-up of workflow creation process'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/create-workflow'
+workflow_path: '{project-root}/.bmad/bmb/workflows/create-workflow'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-09-complete.md'

package/src/modules/bmb/workflows/create-workflow/workflow.md

@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
 
 ### 1. Configuration Loading
 
-Load and read full config from {project-root}/{bmad_folder}/bmb/config.yaml and resolve:
+Load and read full config from {project-root}/.bmad/bmb/config.yaml and resolve:
 
 - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `custom_stand_alone_location`
 

package/src/modules/bmb/workflows/edit-agent/steps/step-01-discover-intent.md

@@ -3,15 +3,15 @@ name: 'step-01-discover-intent'
 description: 'Get agent path and user editing goals'
 
 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/edit-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/edit-agent'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-01-discover-intent.md'
 nextStepFile: '{workflow_path}/steps/step-02-analyze-agent.md'
 
 # Task References
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 ---
 
 # Step 1: Discover Edit Intent

package/src/modules/bmb/workflows/edit-agent/steps/step-02-analyze-agent.md

@@ -3,27 +3,27 @@ name: 'step-02-analyze-agent'
 description: 'Load agent and relevant documentation for analysis'
 
 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/edit-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/edit-agent'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-02-analyze-agent.md'
 nextStepFile: '{workflow_path}/steps/step-03-propose-changes.md'
 
 # Task References
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 
 # Documentation References (load JIT based on user goals)
-understanding_agent_types: '{project-root}/{bmad_folder}/bmb/docs/agents/understanding-agent-types.md'
-agent_compilation: '{project-root}/{bmad_folder}/bmb/docs/agents/agent-compilation.md'
-simple_architecture: '{project-root}/{bmad_folder}/bmb/docs/agents/simple-agent-architecture.md'
-expert_architecture: '{project-root}/{bmad_folder}/bmb/docs/agents/expert-agent-architecture.md'
-module_architecture: '{project-root}/{bmad_folder}/bmb/docs/agents/module-agent-architecture.md'
-menu_patterns: '{project-root}/{bmad_folder}/bmb/docs/agents/agent-menu-patterns.md'
-communication_presets: '{project-root}/{bmad_folder}/bmb/workflows/create-agent/data/communication-presets.csv'
-reference_simple_agent: '{project-root}/{bmad_folder}/bmb/reference/agents/simple-examples/commit-poet.agent.yaml'
-reference_expert_agent: '{project-root}/{bmad_folder}/bmb/reference/agents/expert-examples/journal-keeper/journal-keeper.agent.yaml'
-validation: '{project-root}/{bmad_folder}/bmb/workflows/create-agent/data/agent-validation-checklist.md'
+understanding_agent_types: '{project-root}/.bmad/bmb/docs/agents/understanding-agent-types.md'
+agent_compilation: '{project-root}/.bmad/bmb/docs/agents/agent-compilation.md'
+simple_architecture: '{project-root}/.bmad/bmb/docs/agents/simple-agent-architecture.md'
+expert_architecture: '{project-root}/.bmad/bmb/docs/agents/expert-agent-architecture.md'
+module_architecture: '{project-root}/.bmad/bmb/docs/agents/module-agent-architecture.md'
+menu_patterns: '{project-root}/.bmad/bmb/docs/agents/agent-menu-patterns.md'
+communication_presets: '{project-root}/.bmad/bmb/workflows/create-agent/data/communication-presets.csv'
+reference_simple_agent: '{project-root}/.bmad/bmb/reference/agents/simple-examples/commit-poet.agent.yaml'
+reference_expert_agent: '{project-root}/.bmad/bmb/reference/agents/expert-examples/journal-keeper/journal-keeper.agent.yaml'
+validation: '{project-root}/.bmad/bmb/workflows/create-agent/data/agent-validation-checklist.md'
 ---
 
 # Step 2: Analyze Agent

package/src/modules/bmb/workflows/edit-agent/steps/step-03-propose-changes.md

@@ -3,7 +3,7 @@ name: 'step-03-propose-changes'
 description: 'Propose specific changes and get approval'
 
 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/edit-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/edit-agent'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-03-propose-changes.md'
@@ -11,12 +11,12 @@ nextStepFile: '{workflow_path}/steps/step-04-apply-changes.md'
 agentFile: '{{agent_path}}'
 
 # Task References
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 
 # Documentation References (load JIT if needed)
-communication_presets: '{project-root}/{bmad_folder}/bmb/workflows/create-agent/data/communication-presets.csv'
-agent_compilation: '{project-root}/{bmad_folder}/bmb/docs/agents/agent-compilation.md'
+communication_presets: '{project-root}/.bmad/bmb/workflows/create-agent/data/communication-presets.csv'
+agent_compilation: '{project-root}/.bmad/bmb/docs/agents/agent-compilation.md'
 ---
 
 # Step 3: Propose Changes

package/src/modules/bmb/workflows/edit-agent/steps/step-04-apply-changes.md

@@ -3,7 +3,7 @@ name: 'step-04-apply-changes'
 description: 'Apply approved changes to the agent'
 
 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/edit-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/edit-agent'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-04-apply-changes.md'
@@ -11,8 +11,8 @@ agentFile: '{{agent_path}}'
 nextStepFile: '{workflow_path}/steps/step-05-validate.md'
 
 # Task References
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 ---
 
 # Step 4: Apply Changes

package/src/modules/bmb/workflows/edit-agent/steps/step-05-validate.md

@@ -3,19 +3,19 @@ name: 'step-05-validate'
 description: 'Validate that changes work correctly'
 
 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/edit-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/edit-agent'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-05-validate.md'
 agentFile: '{{agent_path}}'
 
 # Task References
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 
 # Documentation References (load JIT)
-validation: '{project-root}/{bmad_folder}/bmb/workflows/create-agent/data/agent-validation-checklist.md'
-agent_compilation: '{project-root}/{bmad_folder}/bmb/docs/agents/agent-compilation.md'
+validation: '{project-root}/.bmad/bmb/workflows/create-agent/data/agent-validation-checklist.md'
+agent_compilation: '{project-root}/.bmad/bmb/docs/agents/agent-compilation.md'
 ---
 
 # Step 5: Validate Changes

package/src/modules/bmb/workflows/edit-agent/workflow.md

@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
 
 ### 1. Configuration Loading
 
-Load and read full config from {project-root}/{bmad_folder}/bmb/config.yaml and resolve:
+Load and read full config from {project-root}/.bmad/bmb/config.yaml and resolve:
 
 - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
 

package/src/modules/bmb/workflows/edit-workflow/steps/step-01-analyze.md

@@ -3,7 +3,7 @@ name: 'step-01-analyze'
 description: 'Load and deeply understand the target workflow'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/edit-workflow'
+workflow_path: '{project-root}/.bmad/bmb/workflows/edit-workflow'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-01-analyze.md'
@@ -129,9 +129,9 @@ Based on what the user wants to edit:
 
 Load reference documentation as needed:
 
-- `{project-root}/{bmad_folder}/bmb/docs/workflows/architecture.md`
-- `{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md`
-- `{project-root}/{bmad_folder}/bmb/docs/workflows/templates/workflow-template.md`
+- `{project-root}/.bmad/bmb/docs/workflows/architecture.md`
+- `{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md`
+- `{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md`
 
 Check against best practices:
 

package/src/modules/bmb/workflows/edit-workflow/steps/step-02-discover.md

@@ -3,7 +3,7 @@ name: 'step-02-discover'
 description: 'Discover improvement goals collaboratively'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/edit-workflow'
+workflow_path: '{project-root}/.bmad/bmb/workflows/edit-workflow'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-02-discover.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/workflow-edit-{target_workflow_name}.md'
 
 # Task References
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 
 # Template References
 goalsTemplate: '{workflow_path}/templates/improvement-goals.md'

package/src/modules/bmb/workflows/edit-workflow/steps/step-03-improve.md

@@ -3,7 +3,7 @@ name: 'step-03-improve'
 description: 'Facilitate collaborative improvements to the workflow'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/edit-workflow'
+workflow_path: '{project-root}/.bmad/bmb/workflows/edit-workflow'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-03-improve.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/workflow-edit-{target_workflow_name}.md'
 
 # Task References
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 
 # Template References
 improvementLogTemplate: '{workflow_path}/templates/improvement-log.md'
@@ -69,9 +69,9 @@ To facilitate collaborative improvements to the workflow, working iteratively on
 
 Load documentation as needed for specific improvements:
 
-- `{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md`
-- `{project-root}/{bmad_folder}/bmb/docs/workflows/templates/workflow-template.md`
-- `{project-root}/{bmad_folder}/bmb/docs/workflows/architecture.md`
+- `{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md`
+- `{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md`
+- `{project-root}/.bmad/bmb/docs/workflows/architecture.md`
 
 ### 2. Address Each Improvement Iteratively
 

package/src/modules/bmb/workflows/edit-workflow/steps/step-04-validate.md

@@ -3,7 +3,7 @@ name: 'step-04-validate'
 description: 'Validate improvements and prepare for completion'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/edit-workflow'
+workflow_path: '{project-root}/.bmad/bmb/workflows/edit-workflow'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-04-validate.md'
@@ -12,8 +12,8 @@ outputFile: '{output_folder}/workflow-edit-{target_workflow_name}.md'
 nextStepFile: '{workflow_path}/steps/step-05-compliance-check.md'
 
 # Task References
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 
 # Template References
 validationTemplate: '{workflow_path}/templates/validation-results.md'

package/src/modules/bmb/workflows/edit-workflow/steps/step-05-compliance-check.md

@@ -3,17 +3,17 @@ name: 'step-05-compliance-check'
 description: 'Run comprehensive compliance validation on the edited workflow'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/edit-workflow'
+workflow_path: '{project-root}/.bmad/bmb/workflows/edit-workflow'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-05-compliance-check.md'
 workflowFile: '{workflow_path}/workflow.md'
 editedWorkflowPath: '{target_workflow_path}'
-complianceCheckWorkflow: '{project-root}/{bmad_folder}/bmb/workflows/workflow-compliance-check/workflow.md'
+complianceCheckWorkflow: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check/workflow.md'
 outputFile: '{output_folder}/workflow-edit-{target_workflow_name}.md'
 
 # Task References
-complianceCheckTask: '{project-root}/{bmad_folder}/bmb/workflows/workflow-compliance-check/workflow.md'
+complianceCheckTask: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check/workflow.md'
 ---
 
 # Step 5: Compliance Validation

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

@@ -49,7 +49,7 @@ This uses **step-file architecture** for disciplined execution:
 
 ### 1. Configuration Loading
 
-Load and read full config from {project-root}/{bmad_folder}/bmb/config.yaml and resolve:
+Load and read full config from {project-root}/.bmad/bmb/config.yaml and resolve:
 
 - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
 

package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-01-validate-goal.md

@@ -3,7 +3,7 @@ name: 'step-01-validate-goal'
 description: 'Confirm workflow path and validation goals before proceeding'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-01-validate-goal.md'
@@ -15,8 +15,8 @@ complianceReportFile: '{output_folder}/workflow-compliance-report-{workflow_name
 complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
 
 # Documentation References
-stepTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/workflow-template.md'
+stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
 ---
 
 # Step 1: Goal Confirmation and Workflow Target

package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-02-workflow-validation.md

@@ -3,7 +3,7 @@ name: 'step-02-workflow-validation'
 description: 'Validate workflow.md against workflow-template.md standards'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-02-workflow-validation.md'
@@ -16,8 +16,8 @@ targetWorkflowFile: '{target_workflow_path}'
 complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
 
 # Documentation References
-stepTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/workflow-template.md'
+stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
 ---
 
 # Step 2: Workflow.md Validation
@@ -132,10 +132,10 @@ For each deviation:
 
 "**Initialization Validation:**"
 
-- Configuration Loading uses correct path format: `{project-root}/{*bmad_folder*}/[module]/config.yaml` (variable substitution pattern)
+- Configuration Loading uses correct path format: `{project-root}/.bmad/[module]/config.yaml` (variable substitution pattern)
 - First step follows pattern: `step-01-init.md` OR documented deviation
 - Required config variables properly listed
-- Variables use proper substitution pattern: {project-root}, {_bmad_folder_}, {workflow_path}, etc.
+- Variables use proper substitution pattern: {project-root}, .bmad, {workflow_path}, etc.
 
 For violations:
 

package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-03-step-validation.md

@@ -3,7 +3,7 @@ name: 'step-03-step-validation'
 description: 'Validate each step file against step-template.md standards'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-03-step-validation.md'
@@ -16,8 +16,8 @@ targetWorkflowStepsPath: '{target_workflow_steps_path}'
 complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
 
 # Documentation References
-stepTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/workflow-template.md'
+stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
 ---
 
 # Step 3: Step-by-Step Validation
@@ -138,8 +138,8 @@ Check for proper references:
 
 ```yaml
 # Task References
-advancedElicitationTask: '{project-root}/{*bmad_folder*}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{*bmad_folder*}/core/workflows/party-mode/workflow.md'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 ```
 
 **Violations to document:**
@@ -186,7 +186,7 @@ For each step:
 
 "**Path Variable Validation:**"
 
-- Check format: `{project-root}/{*bmad_folder*}/bmb/...` vs `{project-root}/src/modules/bmb/...`
+- Check format: `{project-root}/.bmad/bmb/...` vs `{project-root}/bmb/...`
 - Ensure consistent variable usage across all step files
 - Validate relative vs absolute path usage
 

package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-04-file-validation.md

@@ -3,7 +3,7 @@ name: 'step-04-file-validation'
 description: 'Validate file sizes, markdown formatting, and CSV data files'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-04-file-validation.md'
@@ -16,9 +16,9 @@ targetWorkflowPath: '{target_workflow_path}'
 complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
 
 # Documentation References
-stepTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/workflow-template.md'
-csvStandards: '{project-root}/{bmad_folder}/bmb/docs/workflows/csv-data-file-standards.md'
+stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
+csvStandards: '{project-root}/.bmad/bmb/docs/workflows/csv-data-file-standards.md'
 ---
 
 # Step 4: File Size, Formatting, and Data Validation

package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-05-intent-spectrum-validation.md

@@ -3,7 +3,7 @@ name: 'step-05-intent-spectrum-validation'
 description: 'Dedicated analysis and validation of intent vs prescriptive spectrum positioning'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-05-intent-spectrum-validation.md'
@@ -16,9 +16,9 @@ targetWorkflowPath: '{target_workflow_path}'
 complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
 
 # Documentation References
-stepTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/workflow-template.md'
-intentSpectrum: '{project-root}/{bmad_folder}/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
+stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
+intentSpectrum: '{project-root}/.bmad/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
 ---
 
 # Step 5: Intent vs Prescriptive Spectrum Validation

package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-06-web-subprocess-validation.md

@@ -3,7 +3,7 @@ name: 'step-06-web-subprocess-validation'
 description: 'Analyze web search utilization and subprocess optimization opportunities across workflow steps'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-06-web-subprocess-validation.md'
@@ -16,9 +16,9 @@ targetWorkflowStepsPath: '{target_workflow_steps_path}'
 complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
 
 # Documentation References
-stepTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/workflow-template.md'
-intentSpectrum: '{project-root}/{bmad_folder}/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
+stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
+intentSpectrum: '{project-root}/.bmad/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
 ---
 
 # Step 6: Web Search & Subprocess Optimization Analysis

package/src/modules/bmb/workflows/workflow-compliance-check/steps/step-07-holistic-analysis.md

@@ -3,7 +3,7 @@ name: 'step-07-holistic-analysis'
 description: 'Analyze workflow flow, goal alignment, and meta-workflow failures'
 
 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/workflows/workflow-compliance-check'
+workflow_path: '{project-root}/.bmad/bmb/workflows/workflow-compliance-check'
 
 # File References
 thisStepFile: '{workflow_path}/steps/step-07-holistic-analysis.md'
@@ -16,9 +16,9 @@ targetWorkflowFile: '{target_workflow_path}'
 complianceReportTemplate: '{workflow_path}/templates/compliance-report.md'
 
 # Documentation References
-stepTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/step-template.md'
-workflowTemplate: '{project-root}/{bmad_folder}/bmb/docs/workflows/templates/workflow-template.md'
-intentSpectrum: '{project-root}/{bmad_folder}/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
+stepTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/step-template.md'
+workflowTemplate: '{project-root}/.bmad/bmb/docs/workflows/templates/workflow-template.md'
+intentSpectrum: '{project-root}/.bmad/bmb/docs/workflows/intent-vs-prescriptive-spectrum.md'
 ---
 
 # Step 7: Holistic Workflow Analysis