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

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

@@ -0,0 +1,257 @@
+# Simple Agent Architecture
+
+Self-contained agents with prompts, menus, and optional install-time customization.
+
+## When to Use
+
+- Single-purpose utilities (commit message generator, code formatter)
+- Self-contained logic with no external dependencies
+- Agents that benefit from user customization (style, tone, preferences)
+- Quick-to-build standalone helpers
+
+## YAML Structure
+
+```yaml
+agent:
+  metadata:
+    id: _bmad/agents/{agent-name}/{agent-name}.md
+    name: 'Persona Name'
+    title: 'Agent Title'
+    icon: 'emoji'
+    type: simple
+
+  persona:
+    role: |
+      First-person description of primary function (1-2 sentences)
+
+    identity: |
+      Background, experience, specializations in first-person (2-5 sentences)
+      {{#if custom_variable}}
+      Conditional identity text based on install_config
+      {{/if}}
+
+    communication_style: |
+      {{#if style_choice == "professional"}}
+      Professional and systematic approach...
+      {{/if}}
+      {{#if style_choice == "casual"}}
+      Friendly and approachable tone...
+      {{/if}}
+
+    principles:
+      - Core belief or methodology
+      - Another guiding principle
+      - Values that shape decisions
+
+  prompts:
+    - id: main-action
+      content: |
+        <instructions>
+        What this prompt does
+        </instructions>
+
+        <process>
+        1. Step one
+        {{#if detailed_mode}}
+        2. Additional detailed step
+        {{/if}}
+        3. Final step
+        </process>
+
+    - id: another-action
+      content: |
+        Another reusable prompt template
+
+  menu:
+    - trigger: inline
+      action: 'Direct inline prompt text'
+      description: 'Execute inline action'
+
+    - multi: "[DF] Do Foo or start [CH] Chat with expert"
+      triggers:
+        - do-foo
+            - input: [DF] or fuzzy match on do foo
+            - action: '#main-action'
+            - data: what is being discussed or suggested with the command, along with custom party custom agents if specified
+            - type: action
+        - expert-chat:
+            - input: [CH] or fuzzy match validate agent
+            - action: agent responds as expert based on its persona to converse
+            - type: action
+
+  install_config:
+    compile_time_only: true
+    description: 'Personalize your agent'
+    questions:
+      - var: style_choice
+        prompt: 'Preferred communication style?'
+        type: choice
+        options:
+          - label: 'Professional'
+            value: 'professional'
+          - label: 'Casual'
+            value: 'casual'
+        default: 'professional'
+
+      - var: detailed_mode
+        prompt: 'Enable detailed explanations?'
+        type: boolean
+        default: true
+
+      - var: custom_variable
+        prompt: 'Your custom text'
+        type: text
+        default: ''
+```
+
+## Key Components
+
+### Metadata
+
+- **id**: Final compiled path (`_bmad/agents/{name}/{name}.md` for standalone)
+- **name**: Agent's persona name displayed to users
+- **title**: Professional role/function
+- **icon**: Single emoji for visual identification
+- **type**: `simple` - identifies agent category
+
+### Persona (First-Person Voice)
+
+- **role**: Primary expertise in 1-2 sentences
+- **identity**: Background and specializations (2-5 sentences)
+- **communication_style**: HOW the agent interacts, including conditional variations
+- **principles**: Array of core beliefs (start with action verbs)
+
+### Prompts with IDs
+
+Reusable prompt templates referenced by `#id`:
+
+```yaml
+prompts:
+  - id: analyze-code
+    content: |
+      <instructions>
+      Analyze the provided code for patterns
+      </instructions>
+```
+
+Menu items reference these:
+
+```yaml
+menu:
+  - trigger: analyze
+    action: '#analyze-code'
+    description: 'Analyze code patterns'
+```
+
+### Menu Actions
+
+Two forms of action handlers:
+
+1. **Prompt Reference**: `action: "#prompt-id"` - Executes prompt content
+2. **Inline Instruction**: `action: "Direct text instruction"` - Executes text directly
+
+### Install Config (Compile-Time Customization)
+
+Questions asked during `bmad agent-install`:
+
+**Question Types:**
+
+- `choice` - Multiple choice selection
+- `boolean` - Yes/no toggle
+- `text` - Free-form text input
+
+**Variables become available in Handlebars:**
+
+```yaml
+{{#if variable_name}}
+Content when true
+{{/if}}
+
+{{#if variable_name == "value"}}
+Content when equals value
+{{/if}}
+
+{{#unless variable_name}}
+Content when false
+{{/unless}}
+```
+
+## What Gets Injected at Compile Time
+
+The `tools/cli/lib/agent/compiler.js` automatically adds:
+
+1. **YAML Frontmatter**
+
+   ```yaml
+   ---
+   name: 'agent name'
+   description: 'Agent Title'
+   ---
+   ```
+
+2. **Activation Block**
+   - Load persona step
+   - Load core config for {user_name}, {communication_language}
+   - Agent-specific critical_actions as numbered steps
+   - Menu display and input handling
+   - Menu handlers (action/workflow/exec/tmpl) based on usage
+   - Rules section
+
+3. **Auto-Injected Menu Items**
+   - `*help` always first
+   - `*exit` always last
+
+4. **Trigger Prefixing**
+   - Triggers without `*` get it added automatically
+
+## Reference Example
+
+See: `../../reference/agents/simple-examples/commit-poet.agent.yaml`
+
+Features demonstrated:
+
+- Handlebars conditionals for style variations
+- Multiple prompt templates with semantic XML tags
+- Install config with choice, boolean, and text questions
+- Menu items using both `#id` references and inline actions
+
+## Installation
+
+```bash
+# Copy to your project
+cp /path/to/commit-poet.agent.yaml _bmad/custom/agents/
+
+# Create custom.yaml and install
+echo "code: my-agent
+name: My Agent
+default_selected: true" > custom.yaml
+
+npx bmad-method install
+# or: bmad install
+```
+
+The installer:
+
+1. Prompts for personalization (name, preferences)
+2. Processes Handlebars templates with your answers
+3. Compiles YAML to XML-in-markdown
+4. Creates IDE slash commands
+5. Saves source for reinstallation
+
+## Best Practices
+
+1. **Use first-person voice** in all persona elements
+2. **Keep prompts focused** - one clear purpose per prompt
+3. **Leverage Handlebars** for user customization without code changes
+4. **Provide sensible defaults** in install_config
+5. **Use semantic XML tags** in prompt content for clarity
+6. **Test all conditional paths** before distribution
+
+## Validation Checklist
+
+- [ ] Valid YAML syntax
+- [ ] All metadata fields present (id, name, title, icon, type)
+- [ ] Persona complete (role, identity, communication_style, principles)
+- [ ] Prompts have unique IDs
+- [ ] Install config questions have defaults
+- [ ] File named `{agent-name}.agent.yaml`

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

@@ -49,43 +49,10 @@ This uses **step-file architecture** for disciplined execution:
 
 ### 1. Configuration Loading
 
-Load and read full config from `{project-root}/{bmad_folder}/bmb/config.yaml`:
+Load and read full config from `{project-root}/_bmad/bmb/config.yaml`:
 
-- `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`
+- `project_name`, `user_name`, `communication_language`, `document_output_language`, `bmb_creations_output_folder`
 
 ### 2. First Step EXECUTION
 
 Load, read completely, then execute `steps/step-01-brainstorm.md` to begin the workflow.
-
----
-
-## PATH DEFINITIONS
-
-# Technical documentation for agent building
-
-agent_compilation: "{project-root}/{bmad_folder}/bmb/docs/agents/agent-compilation.md"
-understanding_agent_types: "{project-root}/{bmad_folder}/bmb/docs/agents/understanding-agent-types.md"
-simple_agent_architecture: "{project-root}/{bmad_folder}/bmb/docs/agents/simple-agent-architecture.md"
-expert_agent_architecture: "{project-root}/{bmad_folder}/bmb/docs/agents/expert-agent-architecture.md"
-module_agent_architecture: "{project-root}/{bmad_folder}/bmb/docs/agents/module-agent-architecture.md"
-agent_menu_patterns: "{project-root}/{bmad_folder}/bmb/docs/agents/agent-menu-patterns.md"
-
-# Data and templates
-
-communication_presets: "{workflow_path}/data/communication-presets.csv"
-brainstorm_context: "{workflow_path}/data/brainstorm-context.md"
-
-# Reference examples
-
-simple_agent_examples: "{project-root}/src/modules/bmb/reference/agents/simple-examples/"
-expert_agent_examples: "{project-root}/src/modules/bmb/reference/agents/expert-examples/"
-module_agent_examples: "{project-root}/src/modules/bmb/reference/agents/module-examples/"
-
-# Output configuration
-
-custom_agent_location: "{project-root}/{bmad_folder}/custom/src/agents"
-module_output_file: "{project-root}/{bmad_folder}/{target_module}/agents/{agent_filename}.agent.yaml"
-standalone_output_folder: "{custom_agent_location}/{agent_filename}"
-standalone_output_file: "{standalone_output_folder}/{agent_filename}.agent.yaml"
-standalone_info_guide: "{standalone_output_folder}/info-and-installation-guide.md"
-config_output_file: "{project-root}/{bmad_folder}/\_cfg/agents/{target_module}-{agent_filename}.customize.yaml"

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

@@ -2,10 +2,10 @@
 nextStepFile: '{installed_path}/steps/step-02-concept.md'
 continueFile: '{installed_path}/steps/step-01b-continue.md'
 modulePlanTemplate: '{installed_path}/templates/module-plan.template.md'
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
-customModuleLocation: '{custom_module_location}'
-modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
+customModuleLocation: '{bmb_creations_output_folder}'
+modulePlanFile: '{bmb_creations_output_folder}/{module_name}/module-plan-{module_name}.md'
 ---
 
 # Step 1: Workflow Initialization

package/src/modules/bmb/workflows/create-module/steps/step-01b-continue.md

@@ -1,5 +1,5 @@
 ---
-modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
+modulePlanFile: '{bmb_creations_output_folder}/{module_name}/module-plan-{module_name}.md'
 ---
 
 # Step 1b: Continue Module Creation
@@ -70,7 +70,7 @@ Extract current status from frontmatter fields:
 - **Started:** {date}
 - **Last Step:** {lastStep}
 - **Steps Completed:** {stepsCompleted count}/{total steps}
-- **Location:** {custom_module_location}/{module_name}
+- **Location:** {bmb_creations_output_folder}/{module_name}
 
 \*\*Progress Summary:"
 

package/src/modules/bmb/workflows/create-module/steps/step-02-concept.md

@@ -1,10 +1,10 @@
 ---
-installed_path: '{project-root}/{bmad_folder}/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
 nextStepFile: '{installed_path}/steps/step-03-components.md'
-modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
-moduleStructureGuide: '{project-root}/src/modules/bmb/workflows-legacy/create-module/module-structure.md'
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+modulePlanFile: '{bmb_creations_output_folder}/{module_name}/module-plan-{module_name}.md'
+moduleStructureGuide: '{project-root}/bmb/workflows/create-agent-legacy/create-module/module-structure.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
 ---
 
 # Step 2: Define Module Concept and Scope

package/src/modules/bmb/workflows/create-module/steps/step-03-components.md

@@ -1,10 +1,10 @@
 ---
-installed_path: '{project-root}/{bmad_folder}/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
 nextStepFile: '{installed_path}/steps/step-04-structure.md'
-modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
-agent_examples_path: '{project-root}/src/modules/bmb/reference/agents/module-examples'
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+modulePlanFile: '{bmb_creations_output_folder}/{module_name}/module-plan-{module_name}.md'
+agent_examples_path: '{project-root}/bmb/reference/agents/module-examples'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
 ---
 
 # Step 3: Plan Module Components

package/src/modules/bmb/workflows/create-module/steps/step-04-structure.md

@@ -1,9 +1,9 @@
 ---
-installed_path: '{project-root}/{bmad_folder}/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
 nextStepFile: '{installed_path}/steps/step-05-config.md'
-modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+modulePlanFile: '{bmb_creations_output_folder}/{module_name}/module-plan-{module_name}.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
 ---
 
 # Step 4: Create Module Structure
@@ -122,7 +122,7 @@ For a [module type] module, we'll create this structure:"
 
 ### 3. Create Directory Structure
 
-Create all directories in {custom_module_location}/{module_name}/:
+Create all directories in {bmb_creations_output_folder}/{module_name}/:
 
 1. **agents/** - For agent definition files
 2. **workflows/** - For workflow folders
@@ -169,7 +169,7 @@ Update module-plan.md with structure section:
 ## Module Structure
 
 **Module Type:** [Simple/Standard/Complex]
-**Location:** {custom_module_location}/{module_name}
+**Location:** {bmb_creations_output_folder}/{module_name}
 
 **Directory Structure Created:**
 - ✅ agents/

package/src/modules/bmb/workflows/create-module/steps/step-05-config.md

@@ -1,9 +1,9 @@
 ---
-installed_path: '{project-root}/{bmad_folder}/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
 nextStepFile: '{installed_path}/steps/step-06-agents.md'
-modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+modulePlanFile: '{bmb_creations_output_folder}/{module_name}/module-plan-{module_name}.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
 ---
 
 # Step 5: Plan Module Configuration
@@ -185,7 +185,7 @@ Update module-plan.md with configuration section:
 ### Result Configuration Structure
 
 The module.yaml will generate:
-- Module configuration at: {bmad_folder}/{module_code}/config.yaml
+- Module configuration at: _bmad/{module_code}/config.yaml
 - User settings stored as: [describe structure]
 ````
 

package/src/modules/bmb/workflows/create-module/steps/step-06-agents.md

@@ -1,11 +1,11 @@
 ---
-installed_path: '{project-root}/{bmad_folder}/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
 nextStepFile: '{installed_path}/steps/step-07-workflows.md'
-modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
+modulePlanFile: '{bmb_creations_output_folder}/{module_name}/module-plan-{module_name}.md'
 agentTemplate: '{installed_path}/templates/agent.template.md'
-agent_examples_path: '{project-root}/src/modules/bmb/reference/agents/module-examples'
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+agent_examples_path: '{project-root}/bmb/reference/agents/module-examples'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
 ---
 
 # Step 6: Create Module Agents
@@ -183,7 +183,7 @@ agent:
       triggers:
         - party-mode:
           input: SPM
-          route: '{project-root}/{bmad_folder}/core/workflows/edit-agent/workflow.md'
+          route: '{project-root}/_bmad/core/workflows/edit-agent/workflow.md'
           type: exec
         - expert-chat:
           input: CH
@@ -204,7 +204,7 @@ agent:
 
     # Workflow only for complex processes
     - trigger: 'complex-process'
-      route: '{project-root}/{bmad_folder}/{custom_module}/workflows/[workflow]/workflow.md'
+      route: '{project-root}/_bmad/{custom_module}/workflows/[workflow]/workflow.md'
       description: 'Complex process [icon]'
 
     # Quick inline actions
@@ -217,7 +217,7 @@ agent:
 
 **If agent needs memory:**
 
-1. Create folder: {custom_module_location}/{module_name}/agents/[agent-name]-sidecar/
+1. Create folder: {bmb_creations_output_folder}/{module_name}/agents/[agent-name]-sidecar/
 2. Create files:
    - memories.md (empty, for persistent memory)
    - instructions.md (empty, for agent protocols)
@@ -228,7 +228,7 @@ agent:
 **If agent has workflows:**
 For each workflow that needs separate file:
 
-1. Create folder: {custom_module_location}/{module_name}/workflows/[workflow-name]/
+1. Create folder: {bmb_creations_output_folder}/{module_name}/workflows/[workflow-name]/
 2. Create README.md with workflow plan
 
 ### 4. Repeat for All Agents

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

@@ -1,10 +1,10 @@
 ---
-installed_path: '{project-root}/{bmad_folder}/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
 nextStepFile: '{installed_path}/steps/step-08-installer.md'
-modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
+modulePlanFile: '{bmb_creations_output_folder}/{module_name}/module-plan-{module_name}.md'
 workflowPlanTemplate: '{installed_path}/templates/workflow-plan-template.md'
-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 7: Review Workflow Plans
@@ -61,7 +61,7 @@ I've already created workflow folders and README.md files for each agent's workf
 
 **Workflow folders found:**
 
-- [List all workflow folders in {custom_module_location}/{module_name}/workflows/]
+- [List all workflow folders in {bmb_creations_output_folder}/{module_name}/workflows/]
 
 **Each workflow folder contains a README.md with:**
 

package/src/modules/bmb/workflows/create-module/steps/step-08-installer.md

@@ -1,11 +1,11 @@
 ---
-installed_path: '{project-root}/{bmad_folder}/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
 nextStepFile: '{installed_path}/steps/step-09-documentation.md'
-modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
+modulePlanFile: '{bmb_creations_output_folder}/{module_name}/module-plan-{module_name}.md'
 installerTemplate: '{installed_path}/templates/installer.template.js'
 installConfigTemplate: '{installed_path}/templates/install-config.template.yaml'
-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 8: Setup Module Installer
@@ -72,13 +72,13 @@ From step 5, we planned these configuration fields:
 ### 2. Create Installer Directory
 
 Ensure \_module-installer directory exists
-Directory: {custom_module_location}/{module_name}/\_module-installer/
+Directory: {bmb_creations_output_folder}/{module_name}/\_module-installer/
 
 ### 3. Create module.yaml
 
 "I'll create the module.yaml file based on your configuration plan. This is the core installer configuration file."
 
-Create file: {custom_module_location}/{module_name}/module.yaml from template {installConfigTemplate}
+Create file: {bmb_creations_output_folder}/{module_name}/module.yaml from template {installConfigTemplate}
 
 ### 4. Handle Custom Installation Logic
 
@@ -95,7 +95,7 @@ Does your module need any special setup during installation? For example:
 
 "I'll create an installer.js file for custom logic."
 
-Create file: {custom_module_location}/{module_name}/\_module-installer/installer.js from {installerTemplate}
+Create file: {bmb_creations_output_folder}/{module_name}/\_module-installer/installer.js from {installerTemplate}
 
 Update installer.js with module-specific logic
 
@@ -131,7 +131,7 @@ Update module-plan.md with installer section:
 
 1. User runs: `bmad install {module_name}`
 2. Installer asks: [list of questions]
-3. Creates: {bmad_folder}/{module_name}/
+3. Creates: \_bmad/{module_name}/
 4. Generates: config.yaml with user settings
 
 ### Validation

package/src/modules/bmb/workflows/create-module/steps/step-09-documentation.md

@@ -1,10 +1,10 @@
 ---
-installed_path: '{project-root}/{bmad_folder}/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
 nextStepFile: '{installed_path}/steps/step-10-roadmap.md'
-modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
-moduleReadmeFile: '{custom_module_location}/{module_name}/README.md'
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+modulePlanFile: '{bmb_creations_output_folder}/{module_name}/module-plan-{module_name}.md'
+moduleReadmeFile: '{bmb_creations_output_folder}/{module_name}/README.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
 ---
 
 # Step 9: Create Module Documentation
@@ -140,7 +140,7 @@ bmad install {module_name}
 
 ## Configuration
 
-The module can be configured in `{bmad_folder}/{module_name}/config.yaml`
+The module can be configured in `_bmad/{module_name}/config.yaml`
 
 **Key Settings:**
 
@@ -249,7 +249,7 @@ Update module-plan.md with documentation section:
 ## Documentation
 
 ### README.md Created
-- Location: {custom_module_location}/{module_name}/README.md
+- Location: {bmb_creations_output_folder}/{module_name}/README.md
 - Sections: [list of sections included]
 - Status: Complete
 

package/src/modules/bmb/workflows/create-module/steps/step-10-roadmap.md

@@ -1,10 +1,10 @@
 ---
-installed_path: '{project-root}/{bmad_folder}/bmb/workflows/create-module'
+installed_path: '{project-root}/_bmad/bmb/workflows/create-module'
 nextStepFile: '{installed_path}/steps/step-11-validate.md'
-modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
-moduleTodoFile: '{custom_module_location}/{module_name}/TODO.md'
-advancedElicitationTask: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
-partyModeWorkflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md'
+modulePlanFile: '{bmb_creations_output_folder}/{module_name}/module-plan-{module_name}.md'
+moduleTodoFile: '{bmb_creations_output_folder}/{module_name}/TODO.md'
+advancedElicitationTask: '{project-root}/_bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/_bmad/core/workflows/party-mode/workflow.md'
 ---
 
 # Step 10: Generate Development Roadmap
@@ -75,7 +75,7 @@ I'll organize the remaining work into logical phases to ensure a successful modu
 
 ### 3. Generate TODO.md
 
-Create file: {custom_module_location}/{module_name}/TODO.md
+Create file: {bmb_creations_output_folder}/{module_name}/TODO.md
 
 ````markdown
 # {module_display_name} Development Roadmap
@@ -273,7 +273,7 @@ Update module-plan.md with roadmap section:
 ## Development Roadmap
 
 ### TODO.md Created
-- Location: {custom_module_location}/{module_name}/TODO.md
+- Location: {bmb_creations_output_folder}/{module_name}/TODO.md
 - Phases defined: 3
 - Immediate tasks prioritized
 

package/src/modules/bmb/workflows/create-module/steps/step-11-validate.md

@@ -1,9 +1,9 @@
 ---
 workflowFile: '{installed_path}/workflow.md'
-modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
+modulePlanFile: '{bmb_creations_output_folder}/{module_name}/module-plan-{module_name}.md'
 validationChecklist: '{installed_path}/validation.md'
-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 11: Validate and Finalize Module
@@ -197,7 +197,7 @@ Fix issues one by one with user confirmation
 
 - **Name:** {module_display_name}
 - **Code:** {module_name}
-- **Location:** {custom_module_location}/{module_name}
+- **Location:** {bmb_creations_output_folder}/{module_name}
 - **Type:** {module_type}
 - **Status:** Ready for testing
 
@@ -297,8 +297,8 @@ Display: **Module Creation Complete!** [A] Advanced Elicitation [P] Party Mode [
 
 #### Menu Handling Logic:
 
-- IF A: Execute {project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml for reflection on process
-- IF P: Execute {project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md to celebrate completion
+- IF A: Execute {project-root}/_bmad/core/tasks/advanced-elicitation.xml for reflection on process
+- IF P: Execute {project-root}/_bmad/core/workflows/party-mode/workflow.md to celebrate completion
 - IF C: Mark as complete and exit gracefully
 - IF Any other comments or queries: help user respond then redisplay menu