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

package/src/modules/bmb/workflows/create-module/templates/agent.template.md

@@ -18,7 +18,7 @@ agent:
     identity: |
       {agent-identity - multi-line description}
     communication_style: |
-      {communication-style - multi-line description}
+      {communication-style - 1-2 short sentences to describe chat style}
     principles:
       - '{agent-principle-1}'
       - '{agent-principle-2}'
@@ -27,9 +27,8 @@ agent:
 
   # Optional: Only include if agent needs memory/persistence
   critical_actions:
-    - 'Load COMPLETE file ./[agent-name]-sidecar/memories.md and integrate all past interactions'
-    - 'Load COMPLETE file ./[agent-name]-sidecar/instructions.md and follow ALL protocols'
-    - 'ONLY read/write files in ./[agent-name]-sidecar/ - this is our private workspace'
+    - 'Load COMPLETE file [project-root]/_bmad/_memory/[agent-name]-sidecar/memories.md and integrate all past interactions'
+    - 'Load COMPLETE file [project-root]/_bmad/_memory/[agent-name]-sidecar/instructions.md and follow ALL protocols'
 
   # Optional: Embedded prompts for common interactions
   prompts:
@@ -55,7 +54,7 @@ agent:
       triggers:
         - party-mode:
           input: SPM or fuzzy match start party mode
-          route: '{project-root}/{bmad_folder}/core/workflows/edit-agent/workflow.md'
+          route: '{project-root}/_bmad/core/workflows/edit-agent/workflow.md'
           data: what is being discussed or suggested with the command
           type: exec
         - expert-chat:
@@ -83,7 +82,7 @@ agent:
 
     # Workflow for complex processes
     - trigger: 'generate-report'
-      route: '{project-root}/{bmad_folder}/{custom_module}/workflows/report-gen/workflow.md'
+      route: '{project-root}/_bmad/{custom_module}/workflows/report-gen/workflow.md'
       description: 'Generate detailed report 📊'
 
     # Exec with internal prompt reference
@@ -98,7 +97,7 @@ agent:
 When creating expert agents in modules, create a sidecar folder:
 
 ```
-{custom_module_location}/{module_name}/agents/[agent-name]-sidecar/
+{bmb_creations_output_folder}/{module_name}/agents/[agent-name]-sidecar/
 ├── memories.md          # Persistent memory across sessions
 ├── instructions.md      # Agent-specific protocols
 ├── insights.md          # Important breakthroughs/realizations
@@ -156,7 +155,7 @@ Expert agents support three types of menu actions:
 
 ```yaml
 - trigger: 'generate-report'
-  route: '{project-root}/{bmad_folder}/{custom_module}/workflows/report-gen/workflow.md'
+  route: '{project-root}/_bmad/{custom_module}/workflows/report-gen/workflow.md'
   description: 'Generate report 📊'
 ```
 
@@ -166,19 +165,16 @@ Expert agents support three types of menu actions:
 ## Notes for Module Creation:
 
 1. **File Paths**:
-   - Agent files go in: `{custom_module_location}/{module_name}/agents/[agent-name]/[agent-name].yaml`
-   - Sidecar folders go in: `{custom_module_location}/{module_name}/agents/[agent-name]/[agent-name]-sidecar/`
+   - Agent files go in: `[bmb_creations_output_folder]/[module_name]/agents/[agent-name]/[agent-name].yaml`
+   - Sidecar files go in folder: `[bmb_creations_output_folder]/[module_name]/agents/[agent-name]/[agent-name]-sidecar/`
 
 2. **Variable Usage**:
-   - `{agent_sidecar_folder}` resolves to the agents sidecar folder destination after installation
-   - `{bmad_folder}` resolves to .bmad
-   - `{custom_module}` resolves to custom/src/modules
-   - `{module}` is your module code/name
+   - `module` is your module code/name
 
 3. **Creating Sidecar Structure**:
    - When agent is created, also create the sidecar folder
-   - Initialize with empty files: memories.md, instructions.md
-   - Create sessions/ subfolder
+   - Initialize with empty files: memories.md, instructions.md and any other files the agent will need to have special knowledge or files to record information to
+   - Create sessions/ subfolder if interactions will result in new sessions
    - These files are automatically loaded due to critical_actions
 
 4. **Choosing Menu Actions**:
@@ -268,7 +264,7 @@ Analyze the visual design with my signature dramatic flair
 menu: # Core interactions - multi: "[CH] Chat with Caravaggio or [SPM] Start Party Mode"
 triggers: - party-mode:
 input: SPM or fuzzy match start party mode
-route: "{project-root}/{bmad_folder}/core/workflows/edit-agent/workflow.md"
+route: "{project-root}/\_bmad/core/workflows/edit-agent/workflow.md"
 data: what's being discussed, plus custom party agents if specified
 type: exec - expert-chat:
 input: CH or fuzzy match validate agent
@@ -305,11 +301,11 @@ type: action
       triggers:
         - pitch-deck:
           input: PD or fuzzy match pitch deck
-          route: "{project-root}/{bmad_folder}/{custom_module}/workflows/pitch-deck/workflow.md"
+          route: "{project-root}/_bmad/{custom_module}/workflows/pitch-deck/workflow.md"
           description: 'Investor pitch deck 📈'
         - explainer:
           input: EX or fuzzy match explainer
-          route: "{project-root}/{bmad_folder}/{custom_module}/workflows/explainer/workflow.md"
+          route: "{project-root}/_bmad/{custom_module}/workflows/explainer/workflow.md"
           description: 'Video explainer 🎥'
 
     - trigger: 'save-project'

package/src/modules/bmb/workflows/create-module/templates/module.template.yaml

@@ -50,4 +50,4 @@ prompt:
 
 # STATIC path:
 # data_path:
-#   result: "{project-root}/{bmad_folder}/{module_name}/data"
+#   result: "{project-root}/_bmad/{module_name}/data"

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

@@ -2,7 +2,7 @@
 name: create-module
 description: 'Interactive workflow to build complete BMAD modules with agents, workflows, and installation infrastructure'
 web_bundle: true
-installed_path: '{project-root}/{bmad_folder}/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
 ---
 
 # Create Module Workflow
@@ -46,9 +46,9 @@ installed_path: '{project-root}/{bmad_folder}/bmb/workflows/create-module'
 
 ### 1. Module 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_module_location`
+- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `bmb_creations_output_folder`
 
 ### 2. First Step EXECUTION
 

package/src/modules/bmb/workflows/create-workflow/steps/step-01-init.md

@@ -3,7 +3,7 @@ name: 'step-01-init'
 description: 'Initialize workflow creation session by gathering project information and setting up unique workflow folder'
 
 # 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-01-init.md'
@@ -11,7 +11,7 @@ nextStepFile: '{workflow_path}/steps/step-02-gather.md'
 workflowFile: '{workflow_path}/workflow.md'
 
 # Output files for workflow creation process
-targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}'
+targetWorkflowPath: '{bmb_creations_output_folder}/workflows/{new_workflow_name}'
 workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
 # Template References
 # No workflow plan template needed - will create plan file directly
@@ -83,7 +83,7 @@ After getting the workflow name:
 
 **Check for existing workflows:**
 
-- Look for folder at `{custom_stand_alone_location}/workflows/{new_workflow_name}/`
+- Look for folder at `{bmb_creations_output_folder}/workflows/{new_workflow_name}/`
 - If it exists, inform the user and suggest or get from them a unique name or postfix
 
 **Example alternatives:**
@@ -97,7 +97,7 @@ After getting the workflow name:
 
 Based on the module selection, confirm the target location:
 
-- For bmb module: `{custom_workflow_location}` (defaults to `{bmad_folder}/custom/src/workflows`)
+- For bmb module: `{custom_workflow_location}` (defaults to `_bmad/custom/src/workflows`)
 - For other modules: Check their module.yaml for custom workflow locations
 - Confirm the exact folder path where the workflow will be created
 - Store the confirmed path as `{targetWorkflowPath}`

package/src/modules/bmb/workflows/create-workflow/steps/step-02-gather.md

@@ -3,18 +3,18 @@ name: 'step-02-gather'
 description: 'Gather comprehensive requirements for the workflow being created'
 
 # 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-02-gather.md'
 nextStepFile: '{workflow_path}/steps/step-03-tools-configuration.md'
 # Output files for workflow creation process
-targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}'
+targetWorkflowPath: '{bmb_creations_output_folder}/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 requirements directly to workflow plan
 ---
@@ -90,7 +90,7 @@ Let's load some examples to help you decide the workflow pattern:
 Load and reference the Meal Prep & Nutrition Plan workflow as an example:
 
 ```
-Read: {project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition/workflow.md
+Read: {project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md
 ```
 
 This shows a linear workflow structure. Now let's explore your desired pattern:
@@ -104,7 +104,7 @@ This shows a linear workflow structure. Now let's explore your desired pattern:
 **Based on our reference examples:**
 
 - **Linear**: Like Meal Prep Plan (Init → Profile → Assessment → Strategy → Shopping → Prep)
-  - See: `{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition/`
+  - See: `{project-root}/_bmad/bmb/reference/workflows/meal-prep-nutrition/`
 - **Looping**: User Story Generator (Generate → Review → Refine → Generate more... until done)
 - **Branching**: Architecture Decision (Analyze → Choose pattern → Implement based on choice)
 - **Iterative**: Document Review (Load → Analyze → Suggest changes → Implement → Repeat until approved)

package/src/modules/bmb/workflows/create-workflow/steps/step-03-tools-configuration.md

@@ -3,21 +3,21 @@ name: 'step-03-tools-configuration'
 description: 'Configure all required tools (core, memory, external) and installation requirements in one comprehensive step'
 
 # 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-03-tools-configuration.md'
 nextStepFile: '{workflow_path}/steps/step-04-plan-review.md'
 
-targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}'
+targetWorkflowPath: '{bmb_creations_output_folder}/workflows/{new_workflow_name}'
 workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
 
 # Documentation References
-commonToolsCsv: '{project-root}/{bmad_folder}/bmb/docs/workflows/common-workflow-tools.csv'
+commonToolsCsv: '{project-root}/_bmad/bmb/docs/workflows/common-workflow-tools.csv'
 
 # 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 tools configuration directly to workflow plan
 ---

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

@@ -3,19 +3,19 @@ name: 'step-04-plan-review'
 description: 'Review complete workflow plan (requirements + tools) and get user approval before design'
 
 # 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-04-plan-review.md'
 nextStepFormDesign: '{workflow_path}/steps/step-05-output-format-design.md'
 nextStepDesign: '{workflow_path}/steps/step-06-design.md'
 
-targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}'
+targetWorkflowPath: '{bmb_creations_output_folder}/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 review summary directly to workflow plan
 ---

package/src/modules/bmb/workflows/create-workflow/steps/step-05-output-format-design.md

@@ -3,18 +3,18 @@ name: 'step-05-output-format-design'
 description: 'Design the output format for workflows that produce documents or files'
 
 # 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-05-output-format-design.md'
 nextStepFile: '{workflow_path}/steps/step-06-design.md'
 
-targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}'
+targetWorkflowPath: '{bmb_creations_output_folder}/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'
 ---
 
 # Step 5: Output Format Design

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

@@ -3,19 +3,19 @@ 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'
 nextStepFile: '{workflow_path}/steps/step-07-build.md'
 workflowFile: '{workflow_path}/workflow.md'
 # Output files for workflow creation process
-targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}'
+targetWorkflowPath: '{bmb_creations_output_folder}/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,21 +3,21 @@ 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'
 nextStepFile: '{workflow_path}/steps/step-08-review.md'
 workflowFile: '{workflow_path}/workflow.md'
 # Output files for workflow creation process
-targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}'
+targetWorkflowPath: '{bmb_creations_output_folder}/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:
 
@@ -95,7 +95,7 @@ Ready to proceed?"
 Create the workflow folder structure in the target location:
 
 ```
-{custom_stand_alone_location}/workflows/{workflow_name}/
+{bmb_creations_output_folder}/workflows/{workflow_name}/
 ├── workflow.md
 ├── steps/
 │   ├── step-01-init.md
@@ -108,7 +108,7 @@ 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 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,19 +3,19 @@ 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'
 workflowFile: '{workflow_path}/workflow.md'
 
 # Output files for workflow creation process
-targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}'
+targetWorkflowPath: '{bmb_creations_output_folder}/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,13 +3,13 @@ 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'
 workflowFile: '{workflow_path}/workflow.md'
 # Output files for workflow creation process
-targetWorkflowPath: '{custom_stand_alone_location}/workflows/{new_workflow_name}'
+targetWorkflowPath: '{bmb_creations_output_folder}/workflows/{new_workflow_name}'
 workflowPlanFile: '{targetWorkflowPath}/workflow-plan-{new_workflow_name}.md'
 completionFile: '{targetWorkflowPath}/completion-summary-{new_workflow_name}.md'
 ---

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

@@ -49,9 +49,9 @@ 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`
+- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `bmb_creations_output_folder`
 
 ### 2. First Step EXECUTION
 

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`