Merge branch 'main' into fix/issue-1088-remove-stale-workflow-refs

2025-12-29 16:14:59 +00:00 · 2025-12-10 16:00:11 -07:00
parent b9ba98d3f8 26e47562dd
commit 0f06ef724b
389 changed files with 1556 additions and 4683 deletions
--- a/src/modules/bmb/README.md
+++ b/src/modules/bmb/README.md
@@ -24,13 +24,13 @@ Specialized tools and workflows for creating, customizing, and extending BMad co

 **Active Workflows** (Step-File Architecture)

- Location: `src/modules/bmb/workflows/`
+- Location: `bmb/workflows/create-agent/`
 - 5 core workflows with 41 step files total
 - Template-based execution with JIT loading

 **Legacy Workflows** (Being Migrated)

- Location: `src/modules/bmb/workflows-legacy/`
+- Location: `bmb/workflows/create-agent-legacy/`
 - Module-specific workflows pending conversion to step-file architecture

 ### 📚 Documentation
--- a/src/modules/bmb/agents/bmad-builder.agent.yaml
+++ b/src/modules/bmb/agents/bmad-builder.agent.yaml
@@ -4,7 +4,7 @@
 agent:
  webskip: true
  metadata:
-    id: "{bmad_folder}/bmb/agents/bmad-builder.md"
+    id: ".bmad/bmb/agents/bmad-builder.md"
    name: BMad Builder
    title: BMad Builder
    icon: 🧙
@@ -24,26 +24,26 @@ agent:

  discussion: true
  conversational_knowledge:
-    - agents: "{project-root}/{bmad_folder}/bmb/docs/agents/kb.csv"
-    - workflows: "{project-root}/{bmad_folder}/bmb/docs/workflows/kb.csv"
-    - modules: "{project-root}/{bmad_folder}/bmb/docs/modules/kb.csv"
+    - agents: "{project-root}/.bmad/bmb/docs/agents/kb.csv"
+    - workflows: "{project-root}/.bmad/bmb/docs/workflows/kb.csv"
+    - modules: "{project-root}/.bmad/bmb/docs/modules/kb.csv"

  menu:
    - multi: "[CA] Create, [EA] Edit, or [VA] Validate with Compliance CheckBMAD agents with best practices"
      triggers:
        - create-agent:
            - input: CA or fuzzy match create agent
-            - route: "{project-root}/{bmad_folder}/bmb/workflows/create-agent/workflow.md"
+            - route: "{project-root}/.bmad/bmb/workflows/create-agent/workflow.md"
            - data: null
            - type: exec
        - edit-agent:
            - input: EA or fuzzy match edit agent
-            - route: "{project-root}/{bmad_folder}/bmb/workflows/edit-agent/workflow.md"
+            - route: "{project-root}/.bmad/bmb/workflows/edit-agent/workflow.md"
            - data: null
            - type: exec
        - run-agent-compliance-check:
            - input: VA or fuzzy match validate agent
-            - route: "{project-root}/{bmad_folder}/bmb/workflows/agent-compliance-check/workflow.md"
+            - route: "{project-root}/.bmad/bmb/workflows/agent-compliance-check/workflow.md"
            - data: null
            - type: exec

@@ -51,17 +51,17 @@ agent:
      triggers:
        - create-workflow:
            - input: CW or fuzzy match create workflow
-            - route: "{project-root}/{bmad_folder}/bmb/workflows/create-workflow/workflow.md"
+            - route: "{project-root}/.bmad/bmb/workflows/create-workflow/workflow.md"
            - data: null
            - type: exec
        - edit-workflow:
            - input: EW or fuzzy match edit workflow
-            - route: "{project-root}/{bmad_folder}/bmb/workflows/edit-workflow/workflow.md"
+            - route: "{project-root}/.bmad/bmb/workflows/edit-workflow/workflow.md"
            - data: null
            - type: exec
        - run-workflow-compliance-check:
            - input: VW or fuzzy match validate workflow
-            - route: "{project-root}/{bmad_folder}/bmb/workflows/workflow-compliance-check/workflow.md"
+            - route: "{project-root}/.bmad/bmb/workflows/workflow-compliance-check/workflow.md"
            - data: null
            - type: exec

@@ -69,26 +69,26 @@ agent:
      triggers:
        - brainstorm-module:
            - input: BM or fuzzy match brainstorm module
-            - route: "{project-root}/{bmad_folder}/bmb/workflows/brainstorm-module/workflow.md"
+            - route: "{project-root}/.bmad/bmb/workflows/brainstorm-module/workflow.md"
            - data: null
            - type: exec
        - product-brief-module:
            - input: PBM or fuzzy match product brief module
-            - route: "{project-root}/{bmad_folder}/bmb/workflows/product-brief-module/workflow.md"
+            - route: "{project-root}/.bmad/bmb/workflows/product-brief-module/workflow.md"
            - data: null
            - type: exec
        - create-module:
            - input: CM or fuzzy match create module
-            - route: "{project-root}/{bmad_folder}/bmb/workflows/create-module/workflow.md"
+            - route: "{project-root}/.bmad/bmb/workflows/create-module/workflow.md"
            - data: null
            - type: exec
        - edit-module:
            - input: EM or fuzzy match edit module
-            - route: "{project-root}/{bmad_folder}/bmb/workflows/edit-module/workflow.md"
+            - route: "{project-root}/.bmad/bmb/workflows/edit-module/workflow.md"
            - data: null
            - type: exec
        - run-module-compliance-check:
            - input: VM or fuzzy match validate module
-            - route: "{project-root}/{bmad_folder}/bmb/workflows/module-compliance-check/workflow.md"
+            - route: "{project-root}/.bmad/bmb/workflows/module-compliance-check/workflow.md"
            - data: null
            - type: exec
--- a/src/modules/bmb/docs/agents/agent-compilation.md
+++ b/src/modules/bmb/docs/agents/agent-compilation.md
@@ -35,7 +35,7 @@ rex.agent.yaml           ← Persona name (users might rename to "Max")
 **Pattern:**

 - Filename: `{role-or-function}.agent.yaml` (kebab-case)
- Metadata ID: `{bmad_folder}/{module}/agents/{role-or-function}.md`
+- Metadata ID: `.bmad/{module}/agents/{role-or-function}.md`
 - Persona Name: User-customizable in metadata or customize.yaml

 **Example:**
@@ -44,7 +44,7 @@ rex.agent.yaml           ← Persona name (users might rename to "Max")
 # File: presentation-master.agent.yaml
 agent:
  metadata:
-    id: '{bmad_folder}/cis/agents/presentation-master.md'
+    id: '.bmad/cis/agents/presentation-master.md'
    name: Caravaggio # ← Users can change this to "Pablo" or "Vince"
    title: Visual Communication & Presentation Expert
 ```
--- a/src/modules/bmb/docs/agents/agent-menu-patterns.md
+++ b/src/modules/bmb/docs/agents/agent-menu-patterns.md
@@ -65,11 +65,11 @@ For module agents orchestrating multi-step processes.
 ```yaml
 menu:
  - trigger: create-prd
-    workflow: '{project-root}/{bmad_folder}/bmm/workflows/prd/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/prd/workflow.yaml'
    description: 'Create Product Requirements Document'

  - trigger: brainstorm
-    workflow: '{project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml'
+    workflow: '{project-root}/.bmad/core/workflows/brainstorming/workflow.yaml'
    description: 'Guided brainstorming session'

  # Placeholder for unimplemented workflows
@@ -92,11 +92,11 @@ For executing tasks directly.
 ```yaml
 menu:
  - trigger: validate
-    exec: '{project-root}/{bmad_folder}/core/tasks/validate-workflow.xml'
+    exec: '{project-root}/.bmad/core/tasks/validate-workflow.xml'
    description: 'Validate document structure'

  - trigger: advanced-elicitation
-    exec: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
+    exec: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
    description: 'Advanced elicitation techniques'
 ```

@@ -113,8 +113,8 @@ For document generation with templates.
 ```yaml
 menu:
  - trigger: create-brief
-    exec: '{project-root}/{bmad_folder}/core/tasks/create-doc.xml'
-    tmpl: '{project-root}/{bmad_folder}/bmm/templates/brief.md'
+    exec: '{project-root}/.bmad/core/tasks/create-doc.xml'
+    tmpl: '{project-root}/.bmad/bmm/templates/brief.md'
    description: 'Create a Product Brief'
 ```

@@ -131,8 +131,8 @@ Universal attribute for supplementary information.
 ```yaml
 menu:
  - trigger: team-standup
-    exec: '{project-root}/{bmad_folder}/bmm/tasks/standup.xml'
-    data: '{project-root}/{bmad_folder}/_cfg/agent-manifest.csv'
+    exec: '{project-root}/.bmad/bmm/tasks/standup.xml'
+    data: '{project-root}/.bmad/_cfg/agent-manifest.csv'
    description: 'Run team standup'

  - trigger: analyze-metrics
@@ -154,12 +154,12 @@ Control visibility based on deployment target:
 ```yaml
 menu:
  - trigger: git-flow
-    exec: '{project-root}/{bmad_folder}/bmm/tasks/git-flow.xml'
+    exec: '{project-root}/.bmad/bmm/tasks/git-flow.xml'
    description: 'Git workflow operations'
    ide-only: true # Only in IDE environments

  - trigger: advanced-elicitation
-    exec: '{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml'
+    exec: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
    description: 'Advanced elicitation'
    web-only: true # Only in web bundles
 ```
@@ -251,20 +251,20 @@ menu:
 menu:
  # Analysis Phase
  - trigger: brainstorm
-    workflow: '{project-root}/{bmad_folder}/bmm/workflows/1-analysis/brainstorm/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/1-analysis/brainstorm/workflow.yaml'
    description: 'Brainstorm ideas'

  - trigger: research
-    workflow: '{project-root}/{bmad_folder}/bmm/workflows/1-analysis/research/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/1-analysis/research/workflow.yaml'
    description: 'Conduct research'

  # Planning Phase
  - trigger: prd
-    workflow: '{project-root}/{bmad_folder}/bmm/workflows/2-planning/prd/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/2-planning/prd/workflow.yaml'
    description: 'Create PRD'

  - trigger: architecture
-    workflow: '{project-root}/{bmad_folder}/bmm/workflows/2-planning/architecture/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/2-planning/architecture/workflow.yaml'
    description: 'Design architecture'
 ```

@@ -362,8 +362,8 @@ prompts:

 ```yaml
 # GOOD - Portable paths
-workflow: "{project-root}/{bmad_folder}/bmm/workflows/prd/workflow.yaml"
-exec: "{project-root}/{bmad_folder}/core/tasks/validate.xml"
+workflow: "{project-root}/.bmad/bmm/workflows/prd/workflow.yaml"
+exec: "{project-root}/.bmad/core/tasks/validate.xml"
 data: "{project-root}/_data/metrics.csv"

 # BAD - Hardcoded paths
@@ -374,7 +374,7 @@ exec: "../../../core/tasks/validate.xml"
 ### Available Variables

 - `{project-root}` - Project root directory
- `{bmad_folder}` - BMAD installation folder
+- `.bmad` - BMAD installation folder
 - `{agent_sidecar_folder}` - Agent installation directory (Expert agents)
 - `{output_folder}` - Document output location
 - `{user_name}` - User's name from config
@@ -444,23 +444,23 @@ menu:
 ```yaml
 menu:
  - trigger: workflow-init
-    workflow: '{project-root}/{bmad_folder}/bmm/workflows/workflow-status/init/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/workflow-status/init/workflow.yaml'
    description: 'Initialize workflow path (START HERE)'

  - trigger: brainstorm
-    workflow: '{project-root}/{bmad_folder}/bmm/workflows/1-analysis/brainstorm/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/1-analysis/brainstorm/workflow.yaml'
    description: 'Guided brainstorming'

  - trigger: prd
-    workflow: '{project-root}/{bmad_folder}/bmm/workflows/2-planning/prd/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/2-planning/prd/workflow.yaml'
    description: 'Create PRD'

  - trigger: architecture
-    workflow: '{project-root}/{bmad_folder}/bmm/workflows/2-planning/architecture/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/2-planning/architecture/workflow.yaml'
    description: 'Design architecture'

  - trigger: party-mode
-    workflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml'
+    workflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.yaml'
    description: 'Multi-agent discussion'
 ```

--- a/src/modules/bmb/docs/agents/expert-agent-architecture.md
+++ b/src/modules/bmb/docs/agents/expert-agent-architecture.md
@@ -223,7 +223,7 @@ Same as simple agents, PLUS:

 ## Reference Example

-See: `src/modules/bmb/reference/agents/expert-examples/journal-keeper/`
+See: `bmb/reference/agents/expert-examples/journal-keeper/`

 Features demonstrated:

--- a/src/modules/bmb/docs/agents/index.md
+++ b/src/modules/bmb/docs/agents/index.md
@@ -18,7 +18,7 @@ Comprehensive guides for each agent type (choose based on use case):

 ## Reference Examples

-Production-ready examples in `/src/modules/bmb/reference/agents/`:
+Production-ready examples in `/bmb/reference/agents/`:

 **Simple Agents** (`simple-examples/`)

--- a/src/modules/bmb/docs/agents/module-agent-architecture.md
+++ b/src/modules/bmb/docs/agents/module-agent-architecture.md
@@ -27,7 +27,7 @@ Compiles to:
 ```yaml
 agent:
  metadata:
-    id: '{*bmad_folder*}/{module-code}/agents/{agent-name}.md'
+    id: '.bmad/{module-code}/agents/{agent-name}.md'
    name: 'Persona Name'
    title: 'Professional Title'
    icon: 'emoji'
@@ -41,29 +41,29 @@ agent:

  menu:
    - trigger: workflow-action
-      workflow: '{project-root}/{*bmad_folder*}/{module-code}/workflows/{workflow-name}/workflow.yaml'
+      workflow: '{project-root}/.bmad/{module-code}/workflows/{workflow-name}/workflow.yaml'
      description: 'Execute module workflow'

    - trigger: another-workflow
-      workflow: '{project-root}/{*bmad_folder*}/core/workflows/{workflow-name}/workflow.yaml'
+      workflow: '{project-root}/.bmad/core/workflows/{workflow-name}/workflow.yaml'
      description: 'Execute core workflow'

    - trigger: task-action
-      exec: '{project-root}/{*bmad_folder*}/{module-code}/tasks/{task-name}.xml'
+      exec: '{project-root}/.bmad/{module-code}/tasks/{task-name}.xml'
      description: 'Execute module task'

    - trigger: cross-module
-      workflow: '{project-root}/{*bmad_folder*}/other-module/workflows/{workflow-name}/workflow.yaml'
+      workflow: '{project-root}/.bmad/other-module/workflows/{workflow-name}/workflow.yaml'
      description: 'Execute workflow from another module'

    - trigger: with-template
-      exec: '{project-root}/{*bmad_folder*}/core/tasks/create-doc.xml'
-      tmpl: '{project-root}/{*bmad_folder*}/{module-code}/templates/{template-name}.md'
+      exec: '{project-root}/.bmad/core/tasks/create-doc.xml'
+      tmpl: '{project-root}/.bmad/{module-code}/templates/{template-name}.md'
      description: 'Create document from template'

    - trigger: with-data
-      exec: '{project-root}/{*bmad_folder*}/{module-code}/tasks/{task-name}.xml'
-      data: '{project-root}/{*bmad_folder*}/_cfg/agent-manifest.csv'
+      exec: '{project-root}/.bmad/{module-code}/tasks/{task-name}.xml'
+      data: '{project-root}/.bmad/_cfg/agent-manifest.csv'
      description: 'Execute task with data file'
 ```

@@ -71,7 +71,7 @@ agent:

 ### Metadata

- **id**: Path with `{*bmad_folder*}` variable (resolved at install time)
+- **id**: Path with `.bmad` variable (resolved at install time)
 - **name**: Agent persona name
 - **title**: Professional role
 - **icon**: Single emoji
@@ -101,7 +101,7 @@ persona:
 ```yaml
 menu:
  - trigger: create-prd
-    workflow: '{project-root}/{*bmad_folder*}/bmm/workflows/prd/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/prd/workflow.yaml'
    description: 'Create Product Requirements Document'
 ```

@@ -112,7 +112,7 @@ Invokes BMAD workflow engine to execute multi-step processes.
 ```yaml
 menu:
  - trigger: validate
-    exec: '{project-root}/{*bmad_folder*}/core/tasks/validate-workflow.xml'
+    exec: '{project-root}/.bmad/core/tasks/validate-workflow.xml'
    description: 'Validate document structure'
 ```

@@ -123,8 +123,8 @@ Executes single-operation tasks.
 ```yaml
 menu:
  - trigger: create-brief
-    exec: '{project-root}/{*bmad_folder*}/core/tasks/create-doc.xml'
-    tmpl: '{project-root}/{*bmad_folder*}/bmm/templates/brief.md'
+    exec: '{project-root}/.bmad/core/tasks/create-doc.xml'
+    tmpl: '{project-root}/.bmad/bmm/templates/brief.md'
    description: 'Create a Product Brief from template'
 ```

@@ -135,8 +135,8 @@ Combines task execution with template file.
 ```yaml
 menu:
  - trigger: team-standup
-    exec: '{project-root}/{*bmad_folder*}/bmm/tasks/standup.xml'
-    data: '{project-root}/{*bmad_folder*}/_cfg/agent-manifest.csv'
+    exec: '{project-root}/.bmad/bmm/tasks/standup.xml'
+    data: '{project-root}/.bmad/_cfg/agent-manifest.csv'
    description: 'Run team standup with agent roster'
 ```

@@ -160,12 +160,12 @@ Control visibility based on platform:
 ```yaml
 menu:
  - trigger: advanced-elicitation
-    exec: '{project-root}/{*bmad_folder*}/core/tasks/advanced-elicitation.xml'
+    exec: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
    description: 'Advanced elicitation techniques'
    web-only: true # Only shows in web bundle

  - trigger: git-operations
-    exec: '{project-root}/{*bmad_folder*}/bmm/tasks/git-flow.xml'
+    exec: '{project-root}/.bmad/bmm/tasks/git-flow.xml'
    description: 'Git workflow operations'
    ide-only: true # Only shows in IDE environments
 ```
@@ -175,7 +175,7 @@ menu:
 ### Core Variables

 - `{project-root}` - Root directory of installed project
- `{*bmad_folder*}` - BMAD installation folder (usually `.bmad`)
+- `.bmad` - BMAD installation folder (usually `.bmad`)
 - `{user_name}` - User's name from module config
 - `{communication_language}` - Language preference
 - `{output_folder}` - Document output directory
@@ -186,7 +186,7 @@ menu:

 ```yaml
 # GOOD
-workflow: "{project-root}/{*bmad_folder*}/bmm/workflows/prd/workflow.yaml"
+workflow: "{project-root}/.bmad/bmm/workflows/prd/workflow.yaml"

 # BAD
 workflow: "/Users/john/project/.bmad/bmm/workflows/prd/workflow.yaml"
@@ -208,7 +208,7 @@ Module agents use the same injection process as simple agents:
 **Key difference:** Module agents load **module-specific config** instead of core config:

 ```xml
-<step n="2">Load and read {project-root}/{*bmad_folder*}/{module}/config.yaml...</step>
+<step n="2">Load and read {project-root}/.bmad/{module}/config.yaml...</step>
 ```

 ## Reference Examples
@@ -252,15 +252,15 @@ Agents load this at activation for consistent behavior.
 ```yaml
 menu:
  - trigger: init
-    workflow: '{project-root}/{*bmad_folder*}/bmm/workflows/workflow-init/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/workflow-init/workflow.yaml'
    description: 'Initialize workflow path (START HERE)'

  - trigger: status
-    workflow: '{project-root}/{*bmad_folder*}/bmm/workflows/workflow-status/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/workflow-status/workflow.yaml'
    description: 'Check current workflow status'

  - trigger: next-step
-    workflow: '{project-root}/{*bmad_folder*}/bmm/workflows/next-step/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/next-step/workflow.yaml'
    description: 'Execute next workflow in sequence'
 ```

@@ -270,20 +270,20 @@ menu:
 menu:
  # Phase 1: Analysis
  - trigger: brainstorm
-    workflow: '{project-root}/{*bmad_folder*}/bmm/workflows/1-analysis/brainstorm/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/1-analysis/brainstorm/workflow.yaml'
    description: 'Guided brainstorming session'

  - trigger: research
-    workflow: '{project-root}/{*bmad_folder*}/bmm/workflows/1-analysis/research/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/1-analysis/research/workflow.yaml'
    description: 'Market and technical research'

  # Phase 2: Planning
  - trigger: prd
-    workflow: '{project-root}/{*bmad_folder*}/bmm/workflows/2-planning/prd/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/2-planning/prd/workflow.yaml'
    description: 'Create PRD'

  - trigger: architecture
-    workflow: '{project-root}/{*bmad_folder*}/bmm/workflows/2-planning/architecture/workflow.yaml'
+    workflow: '{project-root}/.bmad/bmm/workflows/2-planning/architecture/workflow.yaml'
    description: 'Design architecture'
 ```

@@ -292,24 +292,23 @@ menu:
 ```yaml
 menu:
  - trigger: party-mode
-    workflow: '{project-root}/{*bmad_folder*}/core/workflows/party-mode/workflow.yaml'
+    workflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.yaml'
    description: 'Bring all agents together'

  - trigger: brainstorm
-    workflow: '{project-root}/{*bmad_folder*}/cis/workflows/brainstorming/workflow.yaml'
+    workflow: '{project-root}/.bmad/cis/workflows/brainstorming/workflow.yaml'
    description: 'Use CIS brainstorming techniques'
 ```

 ## Best Practices

-1. **Use {_bmad_folder_} paths** - Portable across installations
-2. **Organize workflows by phase** - Clear progression for users
-3. **Include workflow-status** - Help users track progress
-4. **Reference module config** - Consistent behavior
-5. **No Handlebars templating** - Module agents are fixed personalities
-6. **Professional personas** - Match module purpose
-7. **Clear trigger names** - Self-documenting commands
-8. **Group related workflows** - Logical menu organization
+1. **Organize workflows by phase** - Clear progression for users
+2. **Include workflow-status** - Help users track progress
+3. **Reference module config** - Consistent behavior
+4. **No Handlebars templating** - Module agents are fixed personalities
+5. **Professional personas** - Match module purpose
+6. **Clear trigger names** - Self-documenting commands
+7. **Group related workflows** - Logical menu organization

 ## Common Patterns

@@ -318,7 +317,7 @@ menu:
 ```yaml
 menu:
  - trigger: start
-    workflow: '{project-root}/{*bmad_folder*}/{module}/workflows/init/workflow.yaml'
+    workflow: '{project-root}/.bmad/{module}/workflows/init/workflow.yaml'
    description: 'Start new project (BEGIN HERE)'
 ```

@@ -327,7 +326,7 @@ menu:
 ```yaml
 menu:
  - trigger: status
-    workflow: '{project-root}/{*bmad_folder*}/{module}/workflows/status/workflow.yaml'
+    workflow: '{project-root}/.bmad/{module}/workflows/status/workflow.yaml'
    description: 'Check workflow progress'
 ```

@@ -336,27 +335,27 @@ menu:
 ```yaml
 menu:
  - trigger: party
-    workflow: '{project-root}/{*bmad_folder*}/core/workflows/party-mode/workflow.yaml'
+    workflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.yaml'
    description: 'Multi-agent discussion'
 ```

 ## Module Agent vs Simple/Expert

-| Aspect        | Module Agent                       | Simple/Expert Agent              |
-| ------------- | ---------------------------------- | -------------------------------- |
-| Location      | `{*bmad_folder*}/{module}/agents/` | `{*bmad_folder*}/custom/agents/` |
-| Persona       | Fixed, professional                | Customizable via install_config  |
-| Handlebars    | No templating                      | Yes, extensive                   |
-| Menu actions  | Workflows, tasks, templates        | Prompts, inline actions          |
-| Configuration | Module config.yaml                 | Core config or none              |
-| Purpose       | Professional tooling               | Personal utilities               |
+| Aspect        | Module Agent                | Simple/Expert Agent             |
+| ------------- | --------------------------- | ------------------------------- |
+| Location      | `.bmad/{module}/agents/`    | `.bmad/custom/agents/`          |
+| Persona       | Fixed, professional         | Customizable via install_config |
+| Handlebars    | No templating               | Yes, extensive                  |
+| Menu actions  | Workflows, tasks, templates | Prompts, inline actions         |
+| Configuration | Module config.yaml          | Core config or none             |
+| Purpose       | Professional tooling        | Personal utilities              |

 ## Validation Checklist

 - [ ] Valid YAML syntax
 - [ ] Metadata includes `module: "{module-code}"`
- [ ] id uses `{*bmad_folder*}/{module}/agents/{name}.md`
- [ ] All workflow paths use `{project-root}/{*bmad_folder*}/` prefix
+- [ ] id uses `.bmad/{module}/agents/{name}.md`
+- [ ] All workflow paths use `{project-root}/.bmad/` prefix
 - [ ] No hardcoded paths
 - [ ] No duplicate triggers
 - [ ] Each menu item has description
--- a/src/modules/bmb/docs/agents/understanding-agent-types.md
+++ b/src/modules/bmb/docs/agents/understanding-agent-types.md
@@ -7,7 +7,7 @@ ALL agent types can:
 - ✓ Write to {output_folder}, {project-root}, or anywhere on system
 - ✓ Update artifacts and files
 - ✓ Execute bash commands
- ✓ Use core variables ({bmad_folder}, {output_folder}, etc.)
+- ✓ Use core variables (.bmad, {output_folder}, etc.)
 - ✓ Have complex prompts and logic
 - ✓ Invoke external tools

@@ -98,11 +98,11 @@ agent:

  menu:
    - trigger: implement-story
-      workflow: '{bmad_folder}/bmm/workflows/dev-story/workflow.yaml'
+      workflow: '.bmad/bmm/workflows/dev-story/workflow.yaml'
      description: Implement user story

    - trigger: refactor
-      workflow: '{bmad_folder}/bmm/workflows/refactor/workflow.yaml'
+      workflow: '.bmad/bmm/workflows/refactor/workflow.yaml'
      description: Refactor codebase
 ```

--- a/src/modules/bmb/docs/workflows/architecture.md
+++ b/src/modules/bmb/docs/workflows/architecture.md
@@ -69,7 +69,7 @@ workflow-folder/
 Standard variables in step files:

 ```yaml
-workflow_path: '{project-root}/{*bmad_folder*}/bmb/reference/workflows/[workflow-name]'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/[workflow-name]'
 thisStepFile: '{workflow_path}/steps/step-[N]-[name].md'
 nextStepFile: '{workflow_path}/steps/step-[N+1]-[name].md'
 workflowFile: '{workflow_path}/workflow.md'
--- a/src/modules/bmb/docs/workflows/common-workflow-tools.csv
+++ b/src/modules/bmb/docs/workflows/common-workflow-tools.csv
@@ -1,7 +1,7 @@
 propose,type,tool_name,description,url,requires_install
-always,workflow,party-mode,"Enables collaborative idea generation by managing turn-taking, summarizing contributions, and synthesizing ideas from multiple AI personas in structured conversation sessions about workflow steps or work in progress.",{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md,no
-always,task,advanced-elicitation,"Employs diverse elicitation strategies such as Socratic questioning, role-playing, and counterfactual analysis to critically evaluate and enhance LLM outputs, forcing assessment from multiple perspectives and techniques.",{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml,no
-always,task,brainstorming,"Facilitates idea generation by prompting users with targeted questions, encouraging divergent thinking, and synthesizing concepts into actionable insights through collaborative creative exploration.",{project-root}/{bmad_folder}/core/tasks/brainstorming.xml,no
+always,workflow,party-mode,"Enables collaborative idea generation by managing turn-taking, summarizing contributions, and synthesizing ideas from multiple AI personas in structured conversation sessions about workflow steps or work in progress.",{project-root}/.bmad/core/workflows/party-mode/workflow.md,no
+always,task,advanced-elicitation,"Employs diverse elicitation strategies such as Socratic questioning, role-playing, and counterfactual analysis to critically evaluate and enhance LLM outputs, forcing assessment from multiple perspectives and techniques.",{project-root}/.bmad/core/tasks/advanced-elicitation.xml,no
+always,task,brainstorming,"Facilitates idea generation by prompting users with targeted questions, encouraging divergent thinking, and synthesizing concepts into actionable insights through collaborative creative exploration.",{project-root}/.bmad/core/tasks/brainstorming.xml,no
 always,llm-tool-feature,web-browsing,"Provides LLM with capabilities to perform real-time web searches, extract relevant data, and incorporate current information into responses when up-to-date information is required beyond training knowledge.",,no
 always,llm-tool-feature,file-io,"Enables LLM to manage file operations such as creating, reading, updating, and deleting files, facilitating seamless data handling, storage, and document management within user environments.",,no
 always,llm-tool-feature,sub-agents,"Allows LLM to create and manage specialized sub-agents that handle specific tasks or modules within larger workflows, improving efficiency through parallel processing and modular task delegation.",,no
--- a/src/modules/bmb/docs/workflows/templates/step-01-init-continuable-template.md
+++ b/src/modules/bmb/docs/workflows/templates/step-01-init-continuable-template.md
@@ -13,7 +13,7 @@ description: 'Initialize the [workflow-type] workflow by detecting continuation

 <!-- Path Definitions -->

-workflow*path: '{project-root}/{\_bmad_folder*}/[module-path]/workflows/[workflow-name]'
+workflow\*path: '{project-root}/.bmad/[module-path]/workflows/[workflow-name]'

 # File References (all use {variable} format in file)

--- a/src/modules/bmb/docs/workflows/templates/step-1b-template.md
+++ b/src/modules/bmb/docs/workflows/templates/step-1b-template.md
@@ -13,7 +13,7 @@ description: 'Handle workflow continuation from previous session'

 <!-- Path Definitions -->

-workflow*path: '{project-root}/{\_bmad_folder*}/[module-path]/workflows/[workflow-name]'
+workflow\*path: '{project-root}/.bmad/[module-path]/workflows/[workflow-name]'

 # File References (all use {variable} format in file)

--- a/src/modules/bmb/docs/workflows/templates/step-file.md
+++ b/src/modules/bmb/docs/workflows/templates/step-file.md
@@ -3,7 +3,7 @@ name: "step-{{stepNumber}}-{{stepName}}"
 description: "{{stepDescription}}"

 # Path Definitions
-workflow_path: "{project-root}/{*bmad_folder*}/{{targetModule}}/workflows/{{workflowName}}"
+workflow_path: "{project-root}/.bmad/{{targetModule}}/workflows/{{workflowName}}"

 # File References
 thisStepFile: "{workflow_path}/steps/step-{{stepNumber}}-{{stepName}}.md"
@@ -16,8 +16,8 @@ outputFile: "{output_folder}/{{outputFileName}}-{project_name}.md"
 {{/hasOutput}}

 # Task References (list only if used in THIS step file instance and only the ones used, there might be others)
-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"

 {{#hasTemplates}}
 # Template References
--- a/src/modules/bmb/docs/workflows/templates/step-template.md
+++ b/src/modules/bmb/docs/workflows/templates/step-template.md
@@ -11,7 +11,7 @@ description: '[Brief description of what this step accomplishes]'

 <!-- Path Definitions -->

-workflow*path: '{project-root}/{\_bmad_folder*}/bmb/reference/workflows/[workflow-name]' # the folder the workflow.md file is in
+workflow\*path: '{project-root}/.bmad/[module]/reference/workflows/[workflow-name]' # the folder the workflow.md file is in

 # File References (all use {variable} format in file)

@@ -23,8 +23,8 @@ outputFile: '{output_folder}/[output-file-name]-{project_name}.md'

 # Task References (IF THE workflow uses and it makes sense in this step to have these )

-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 (if this step uses a specific templates)

--- a/src/modules/bmb/docs/workflows/templates/workflow-template.md
+++ b/src/modules/bmb/docs/workflows/templates/workflow-template.md
@@ -53,7 +53,7 @@ web_bundle: [true/false] # Set to true for inclusion in web bundle builds

 ### 1. Module Configuration Loading

-Load and read full config from {project-root}/{_bmad_folder_}/[MODULE FOLDER]/config.yaml and resolve:
+Load and read full config from {project-root}/.bmad/[MODULE FOLDER]/config.yaml and resolve:

 - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, [MODULE VARS]

@@ -101,4 +101,4 @@ Example: Load, read the full file and then execute `{workflow_path}/steps/step-0

 ### NOTE: You can View a real example of a perfect workflow.md file that was created from this template

-`{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition/workflow.md`
+`{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition/workflow.md`
--- a/src/modules/bmb/docs/workflows/templates/workflow.md
+++ b/src/modules/bmb/docs/workflows/templates/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_}/{{targetModule}}/config.yaml and resolve:
+Load and read full config from {project-root}/.bmad/{{targetModule}}/config.yaml and resolve:

 - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`

--- a/src/modules/bmb/module.yaml
+++ b/src/modules/bmb/module.yaml
@@ -11,7 +11,6 @@ subheader: "Configure the settings for the BoMB Factory!\nThe agent, workflow an
 ## user_name
 ## communication_language
 ## output_folder
-## bmad_folder
 ## install_user_docs
 ## kb_install

--- a/src/modules/bmb/reference/agents/module-examples/README.md
+++ b/src/modules/bmb/reference/agents/module-examples/README.md
@@ -7,7 +7,7 @@ Reference examples for module-integrated agents.
 Module agents integrate with BMAD module workflows (BMM, CIS, BMB). They:

 - Orchestrate multi-step workflows
- Use `{bmad_folder}` path variables
+- Use `.bmad` path variables
 - Have fixed professional personas (no install_config)
 - Reference module-specific configurations

--- a/src/modules/bmb/reference/agents/module-examples/security-engineer.agent.yaml
+++ b/src/modules/bmb/reference/agents/module-examples/security-engineer.agent.yaml
@@ -10,7 +10,7 @@

 agent:
  metadata:
-    id: "{*bmad_folder*}/bmm/agents/security-engineer.md"
+    id: ".bmad/bmm/agents/security-engineer.md"
    name: "Sam"
    title: "Security Engineer"
    icon: "🔐"
@@ -32,11 +32,11 @@ agent:
  menu:
    # NOTE: These workflows are hypothetical examples assuming add to a module called bmm - not implemented
    - trigger: threat-model
-      exec: "{project-root}/{*bmad_folder*}/bmm/workflows/threat-model/workflow.md"
+      exec: "{project-root}/.bmad/bmm/workflows/threat-model/workflow.md"
      description: "Create STRIDE threat model for architecture"

    - trigger: security-review
-      exec: "{project-root}/{*bmad_folder*}/bmm/workflows/security-review/workflow.md"
+      exec: "{project-root}/.bmad/bmm/workflows/security-review/workflow.md"
      description: "Review code/design for security issues"

    - trigger: owasp-check
@@ -44,10 +44,10 @@ agent:
      description: "Check against OWASP Top 10"

    - trigger: compliance
-      exec: "{project-root}/{*bmad_folder*}/bmm/workflows/compliance-check/workflow.md"
+      exec: "{project-root}/.bmad/bmm/workflows/compliance-check/workflow.md"
      description: "Verify compliance requirements (SOC2, GDPR, etc.)"

    # Core workflow that exists
    - trigger: party-mode
-      exec: "{project-root}/{*bmad_folder*}/core/workflows/party-mode/workflow.md"
+      exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
      description: "Multi-agent security discussion"
--- a/src/modules/bmb/reference/agents/module-examples/trend-analyst.agent.yaml
+++ b/src/modules/bmb/reference/agents/module-examples/trend-analyst.agent.yaml
@@ -10,7 +10,7 @@

 agent:
  metadata:
-    id: "{*bmad_folder*}/cis/agents/trend-analyst.md"
+    id: ".bmad/cis/agents/trend-analyst.md"
    name: "Nova"
    title: "Trend Analyst"
    icon: "📈"
@@ -32,26 +32,26 @@ agent:
  menu:
    # NOTE: These workflows are hypothetical examples - not implemented
    - trigger: scan-trends
-      exec: "{project-root}/{*bmad_folder*}/cis/workflows/trend-scan/workflow.md"
+      exec: "{project-root}/.bmad/cis/workflows/trend-scan/workflow.md"
      description: "Scan for emerging trends in a domain"

    - trigger: analyze-trend
-      exec: "{project-root}/{*bmad_folder*}/cis/workflows/trend-analysis/workflow.md"
+      exec: "{project-root}/.bmad/cis/workflows/trend-analysis/workflow.md"
      description: "Deep dive on a specific trend"

    - trigger: opportunity-map
-      exec: "{project-root}/{*bmad_folder*}/cis/workflows/opportunity-mapping/workflow.md"
+      exec: "{project-root}/.bmad/cis/workflows/opportunity-mapping/workflow.md"
      description: "Map trend to strategic opportunities"

    - trigger: competitor-trends
-      exec: "{project-root}/{*bmad_folder*}/cis/tasks/competitor-trend-watch.xml"
+      exec: "{project-root}/.bmad/cis/tasks/competitor-trend-watch.xml"
      description: "Monitor competitor trend adoption"

    # Core workflows that exist
    - trigger: brainstorm
-      exec: "{project-root}/{*bmad_folder*}/core/workflows/brainstorming/workflow.md"
+      exec: "{project-root}/.bmad/core/workflows/brainstorming/workflow.md"
      description: "Brainstorm trend implications"

    - trigger: party-mode
-      exec: "{project-root}/{*bmad_folder*}/core/workflows/party-mode/workflow.md"
+      exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
      description: "Discuss trends with other agents"
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md
@@ -3,7 +3,7 @@ name: 'step-01-init'
 description: 'Initialize the nutrition plan workflow by detecting continuation state and creating output document'

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References
 thisStepFile: '{workflow_path}/steps/step-01-init.md'
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md
@@ -3,7 +3,7 @@ name: 'step-01b-continue'
 description: 'Handle workflow continuation from previous session'

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References
 thisStepFile: '{workflow_path}/steps/step-01b-continue.md'
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md
@@ -3,7 +3,7 @@ name: 'step-02-profile'
 description: 'Gather comprehensive user profile information through collaborative conversation'

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References (all use {variable} format in file)
 thisStepFile: '{workflow_path}/steps/step-02-profile.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/nutrition-plan-{project_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
 profileTemplate: '{workflow_path}/templates/profile-section.md'
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md
@@ -3,7 +3,7 @@ name: 'step-03-assessment'
 description: 'Analyze nutritional requirements, identify restrictions, and calculate target macros'

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References
 thisStepFile: '{workflow_path}/steps/step-03-assessment.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/nutrition-plan-{project_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'

 # Data References
 dietaryRestrictionsDB: '{workflow_path}/data/dietary-restrictions.csv'
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md
@@ -3,7 +3,7 @@ name: 'step-04-strategy'
 description: 'Design a personalized meal strategy that meets nutritional needs and fits lifestyle'

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References
 thisStepFile: '{workflow_path}/steps/step-04-strategy.md'
@@ -13,8 +13,8 @@ workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/nutrition-plan-{project_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'

 # Data References
 recipeDatabase: '{workflow_path}/data/recipe-database.csv'
@@ -167,8 +167,8 @@ Display: **Select an Option:** [A] Meal Variety Optimization [P] Chef & Dietitia
 #### Menu Handling Logic:

 - HALT and AWAIT ANSWER
- IF A: Execute `{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml`
- IF P: Execute `{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md` with a chef and dietitian expert also as part of the party
+- IF A: Execute `{project-root}/.bmad/core/tasks/advanced-elicitation.xml`
+- IF P: Execute `{project-root}/.bmad/core/workflows/party-mode/workflow.md` with a chef and dietitian expert also as part of the party
 - IF C: Save content to nutrition-plan.md, update frontmatter `stepsCompleted` to add 4 at the end of the array before loading next step, check cooking frequency:
  - IF cooking frequency > 2x/week: load, read entire file, then execute `{workflow_path}/step-05-shopping.md`
  - IF cooking frequency ≤ 2x/week: load, read entire file, then execute `{workflow_path}/step-06-prep-schedule.md`
--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md
@@ -3,7 +3,7 @@ name: 'step-05-shopping'
 description: 'Create a comprehensive shopping list that supports the meal strategy'

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References
 thisStepFile: '{workflow_path}/steps/step-05-shopping.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/nutrition-plan-{project_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
 shoppingTemplate: '{workflow_path}/templates/shopping-section.md'
@@ -157,8 +157,8 @@ Display: **Select an Option:** [A] Budget Optimization Strategies [P] Shopping P
 #### Menu Handling Logic:

 - HALT and AWAIT ANSWER
- IF A: Execute `{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml`
- IF P: Execute `{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md`
+- IF A: Execute `{project-root}/.bmad/core/tasks/advanced-elicitation.xml`
+- IF P: Execute `{project-root}/.bmad/core/workflows/party-mode/workflow.md`
 - IF C: Save content to nutrition-plan.md, update frontmatter `stepsCompleted` to add 5 at the end of the array before loading next step, then load, read entire file, then execute `{workflow_path}/step-06-prep-schedule.md`
 - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#5-present-menu-options)

--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md
@@ -3,7 +3,7 @@ name: 'step-06-prep-schedule'
 description: "Create a realistic meal prep schedule that fits the user's lifestyle"

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References
 thisStepFile: '{workflow_path}/steps/step-06-prep-schedule.md'
@@ -11,8 +11,8 @@ workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/nutrition-plan-{project_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
 prepScheduleTemplate: '{workflow_path}/templates/prep-schedule-section.md'
@@ -178,8 +178,8 @@ Display: **Select an Option:** [A] Advanced Prep Techniques [P] Coach Perspectiv
 #### Menu Handling Logic:

 - HALT and AWAIT ANSWER
- IF A: Execute `{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml`
- IF P: Execute `{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md`
+- IF A: Execute `{project-root}/.bmad/core/tasks/advanced-elicitation.xml`
+- IF P: Execute `{project-root}/.bmad/core/workflows/party-mode/workflow.md`
 - IF C: update frontmatter `stepsCompleted` to add 6 at the end of the array before loading next step, mark workflow complete, display final message
 - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#6-present-menu-options)

--- a/src/modules/bmb/reference/workflows/meal-prep-nutrition/workflow.md
+++ b/src/modules/bmb/reference/workflows/meal-prep-nutrition/workflow.md
@@ -49,10 +49,10 @@ This uses **step-file architecture** for disciplined execution:

 ### 1. Configuration Loading

-Load and read full config from {project-root}/{bmad_folder}/core/config.yaml and resolve:
+Load and read full config from {project-root}/.bmad/core/config.yaml and resolve:

 - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`

 ### 2. First Step EXECUTION

-Load, read the full file and then execute `{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md` to begin the workflow.
+Load, read the full file and then execute `{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md` to begin the workflow.
--- a/src/modules/bmb/workflows-legacy/edit-module/README.md
+++ b/src/modules/bmb/workflows-legacy/edit-module/README.md
@@ -106,7 +106,7 @@ Modules can share workflows:

 ```yaml
 # In agent menu item:
-workflow: '{project-root}/{bmad_folder}/other-module/workflows/shared-workflow/workflow.yaml'
+workflow: '{project-root}/.bmad/other-module/workflows/shared-workflow/workflow.yaml'
 ```

 Common patterns:
@@ -151,7 +151,7 @@ Changes are reviewed and approved by you before being applied.
 - Can configure web bundles
 - Are the development source of truth

-**Installed modules** (in {bmad_folder}/):
+**Installed modules** (in .bmad/):

 - Are deployed to target projects
 - Use config.yaml for user customization
--- a/src/modules/bmb/workflows-legacy/edit-module/checklist.md
+++ b/src/modules/bmb/workflows-legacy/edit-module/checklist.md
@@ -5,7 +5,7 @@ Use this checklist to validate module edits meet BMAD Core standards.
 ## Module Structure Validation

 - [ ] Module has clear 3-letter code (bmm, bmb, cis, etc.)
- [ ] Module is in correct location (src/modules/ for source, {bmad_folder}/ for installed)
+- [ ] Module is in correct location (src/modules/ for source, .bmad/ for installed)
 - [ ] agents/ directory exists
 - [ ] workflows/ directory exists
 - [ ] config.yaml exists in module root
@@ -127,7 +127,7 @@ Use this checklist to validate module edits meet BMAD Core standards.

 - [ ] Web bundles configured in workflow.yaml files
 - [ ] All referenced files included in web_bundle_files
- [ ] Paths are {bmad_folder}/-relative (not project-root)
+- [ ] Paths are .bmad/-relative (not project-root)
 - [ ] No config_source references in web bundles
 - [ ] Invoked workflows included in dependencies

--- a/src/modules/bmb/workflows-legacy/edit-module/instructions.md
+++ b/src/modules/bmb/workflows-legacy/edit-module/instructions.md
@@ -1,7 +1,7 @@
 # Edit Module - Module Editor Instructions

-<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
-<critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/edit-module/workflow.yaml</critical>
+<critical>The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project-root}/.bmad/bmb/workflows/edit-module/workflow.yaml</critical>
 <critical>This workflow uses ADAPTIVE FACILITATION - adjust your communication based on context and user needs</critical>
 <critical>The goal is COLLABORATIVE IMPROVEMENT - work WITH the user, not FOR them</critical>
 <critical>Communicate all responses in {communication_language}</critical>
@@ -9,7 +9,7 @@
 <workflow>

 <step n="1" goal="Load and deeply understand the target module">
-<ask>What is the path to the module you want to edit? (provide path to module directory like {bmad_folder}/bmm/ or src/modules/bmm/)</ask>
+<ask>What is the path to the module you want to edit? (provide path to module directory like .bmad/bmm/ or src/modules/bmm/)</ask>

 <action>Load the module directory structure completely:

@@ -187,7 +187,7 @@ Let the conversation flow naturally. Build a shared vision of what "better" look
 **If setting up cross-module integration:**

 - Identify which workflows from other modules are needed
- Show how to reference workflows properly: {project-root}/{bmad_folder}/{{module}}/workflows/{{workflow}}/workflow.yaml
+- Show how to reference workflows properly: {project-root}/.bmad/{{module}}/workflows/{{workflow}}/workflow.yaml
 - Document the integration in README
 - Ensure dependencies are clear
 - Consider adding example usage
--- a/src/modules/bmb/workflows-legacy/edit-module/workflow.yaml
+++ b/src/modules/bmb/workflows-legacy/edit-module/workflow.yaml
@@ -4,26 +4,26 @@ description: "Edit existing BMAD modules (structure, agents, workflows, document
 author: "BMad"

 # Critical variables load from config_source
-config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
+config_source: "{project-root}/.bmad/bmb/config.yaml"
 communication_language: "{config_source}:communication_language"
 user_name: "{config_source}:user_name"

 # Required Data Files - Critical for understanding module conventions
-module_structure_guide: "{project-root}/{bmad_folder}/bmb/workflows/create-module/module-structure.md"
+module_structure_guide: "{project-root}/.bmad/bmb/workflows/create-module/module-structure.md"

 # Related workflow editors
-agent_editor: "{project-root}/{bmad_folder}/bmb/workflows/edit-agent/workflow.yaml"
-workflow_editor: "{project-root}/{bmad_folder}/bmb/workflows/edit-workflow/workflow.yaml"
+agent_editor: "{project-root}/.bmad/bmb/workflows/edit-agent/workflow.yaml"
+workflow_editor: "{project-root}/.bmad/bmb/workflows/edit-workflow/workflow.yaml"

 # Reference examples - for learning patterns
-bmm_module_dir: "{project-root}/{bmad_folder}/bmm/"
-bmb_module_dir: "{project-root}/{bmad_folder}/bmb/"
-cis_module_dir: "{project-root}/{bmad_folder}/cis/"
-existing_agents_dir: "{project-root}/{bmad_folder}/*/agents/"
-existing_workflows_dir: "{project-root}/{bmad_folder}/*/workflows/"
+bmm_module_dir: "{project-root}/.bmad/bmm/"
+bmb_module_dir: "{project-root}/.bmad/bmb/"
+cis_module_dir: "{project-root}/.bmad/cis/"
+existing_agents_dir: "{project-root}/.bmad/*/agents/"
+existing_workflows_dir: "{project-root}/.bmad/*/workflows/"

 # Module path and component files
-installed_path: "{project-root}/{bmad_folder}/bmb/workflows/edit-module"
+installed_path: "{project-root}/.bmad/bmb/workflows/edit-module"
 template: false # This is an action workflow - no template needed
 instructions: "{installed_path}/instructions.md"
 validation: "{installed_path}/checklist.md"
--- a/src/modules/bmb/workflows-legacy/module-brief/README.md
+++ b/src/modules/bmb/workflows-legacy/module-brief/README.md
@@ -254,8 +254,8 @@ To customize this workflow:

 For issues or questions:

- Review the workflow creation guide at `/{bmad_folder}/bmb/workflows/create-workflow/workflow-creation-guide.md`
- Study existing module examples in `/{bmad_folder}/` for patterns and inspiration
+- Review the workflow creation guide at `/.bmad/bmb/workflows/create-workflow/workflow-creation-guide.md`
+- Study existing module examples in `/.bmad/` for patterns and inspiration
 - Validate output using `checklist.md`
 - Consult module structure guide at `create-module/module-structure.md`

--- a/src/modules/bmb/workflows-legacy/module-brief/instructions.md
+++ b/src/modules/bmb/workflows-legacy/module-brief/instructions.md
@@ -1,7 +1,7 @@
 # Module Brief Instructions

-<critical>The workflow execution engine is governed by: {project-root}/{bmad_folder}/core/tasks/workflow.xml</critical>
-<critical>You MUST have already loaded and processed: {project-root}/{bmad_folder}/bmb/workflows/module-brief/workflow.yaml</critical>
+<critical>The workflow execution engine is governed by: {project-root}/.bmad/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project-root}/.bmad/bmb/workflows/module-brief/workflow.yaml</critical>
 <critical>Communicate in {communication_language} throughout the module brief creation process</critical>
 <critical>⚠️ ABSOLUTELY NO TIME ESTIMATES - NEVER mention hours, days, weeks, months, or ANY time-based predictions. AI has fundamentally changed development speed - what once took teams weeks/months can now be done by one person in hours. DO NOT give ANY time estimates whatsoever.</critical>

--- a/src/modules/bmb/workflows-legacy/module-brief/workflow.yaml
+++ b/src/modules/bmb/workflows-legacy/module-brief/workflow.yaml
@@ -4,15 +4,15 @@ description: "Create a comprehensive Module Brief that serves as the blueprint f
 author: "BMad Builder"

 # Critical variables
-config_source: "{project-root}/{bmad_folder}/bmb/config.yaml"
+config_source: "{project-root}/.bmad/bmb/config.yaml"
 output_folder: "{config_source}:output_folder"
 user_name: "{config_source}:user_name"
 communication_language: "{config_source}:communication_language"
 date: system-generated

 # Reference examples and documentation
-existing_modules_dir: "{project-root}/{bmad_folder}/"
-module_structure_guide: "{project-root}/{bmad_folder}/bmb/workflows/create-module/module-structure.md"
+existing_modules_dir: "{project-root}/.bmad/"
+module_structure_guide: "{project-root}/.bmad/bmb/workflows/create-module/module-structure.md"

 # Optional user inputs - discovered if they exist
 input_file_patterns:
@@ -22,7 +22,7 @@ input_file_patterns:
    load_strategy: "FULL_LOAD"

 # Module path and component files
-installed_path: "{project-root}/{bmad_folder}/bmb/workflows/module-brief"
+installed_path: "{project-root}/.bmad/bmb/workflows/module-brief"
 template: "{installed_path}/template.md"
 instructions: "{installed_path}/instructions.md"
 validation: "{installed_path}/checklist.md"
--- a/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/README.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/README.md
@@ -7,7 +7,7 @@ Reference examples for module-integrated agents.
 Module agents integrate with BMAD module workflows (BMM, CIS, BMB). They:

 - Orchestrate multi-step workflows
- Use `{bmad_folder}` path variables
+- Use `.bmad` path variables
 - Have fixed professional personas (no install_config)
 - Reference module-specific configurations

--- a/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/security-engineer.agent.yaml
+++ b/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/security-engineer.agent.yaml
@@ -10,7 +10,7 @@

 agent:
  metadata:
-    id: "{bmad_folder}/bmm/agents/security-engineer.md"
+    id: ".bmad/bmm/agents/security-engineer.md"
    name: "Sam"
    title: "Security Engineer"
    icon: "🔐"
@@ -32,22 +32,22 @@ agent:
  menu:
    # NOTE: These workflows are hypothetical examples - not implemented
    - trigger: threat-model
-      workflow: "{project-root}/{bmad_folder}/bmm/workflows/threat-model/workflow.yaml"
+      workflow: "{project-root}/.bmad/bmm/workflows/threat-model/workflow.yaml"
      description: "Create STRIDE threat model for architecture"

    - trigger: security-review
-      workflow: "{project-root}/{bmad_folder}/bmm/workflows/security-review/workflow.yaml"
+      workflow: "{project-root}/.bmad/bmm/workflows/security-review/workflow.yaml"
      description: "Review code/design for security issues"

    - trigger: owasp-check
-      exec: "{project-root}/{bmad_folder}/bmm/tasks/owasp-top-10.xml"
+      exec: "{project-root}/.bmad/bmm/tasks/owasp-top-10.xml"
      description: "Check against OWASP Top 10"

    - trigger: compliance
-      workflow: "{project-root}/{bmad_folder}/bmm/workflows/compliance-check/workflow.yaml"
+      workflow: "{project-root}/.bmad/bmm/workflows/compliance-check/workflow.yaml"
      description: "Verify compliance requirements (SOC2, GDPR, etc.)"

    # Core workflow that exists
    - trigger: party-mode
-      exec: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md"
+      exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
      description: "Multi-agent security discussion"
--- a/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/trend-analyst.agent.yaml
+++ b/src/modules/bmb/workflows/create-agent/data/reference/agents/module-examples/trend-analyst.agent.yaml
@@ -10,7 +10,7 @@

 agent:
  metadata:
-    id: "{bmad_folder}/cis/agents/trend-analyst.md"
+    id: ".bmad/cis/agents/trend-analyst.md"
    name: "Nova"
    title: "Trend Analyst"
    icon: "📈"
@@ -32,26 +32,26 @@ agent:
  menu:
    # NOTE: These workflows are hypothetical examples - not implemented
    - trigger: scan-trends
-      workflow: "{project-root}/{bmad_folder}/cis/workflows/trend-scan/workflow.yaml"
+      workflow: "{project-root}/.bmad/cis/workflows/trend-scan/workflow.yaml"
      description: "Scan for emerging trends in a domain"

    - trigger: analyze-trend
-      workflow: "{project-root}/{bmad_folder}/cis/workflows/trend-analysis/workflow.yaml"
+      workflow: "{project-root}/.bmad/cis/workflows/trend-analysis/workflow.yaml"
      description: "Deep dive on a specific trend"

    - trigger: opportunity-map
-      workflow: "{project-root}/{bmad_folder}/cis/workflows/opportunity-mapping/workflow.yaml"
+      workflow: "{project-root}/.bmad/cis/workflows/opportunity-mapping/workflow.yaml"
      description: "Map trend to strategic opportunities"

    - trigger: competitor-trends
-      exec: "{project-root}/{bmad_folder}/cis/tasks/competitor-trend-watch.xml"
+      exec: "{project-root}/.bmad/cis/tasks/competitor-trend-watch.xml"
      description: "Monitor competitor trend adoption"

    # Core workflows that exist
    - trigger: brainstorm
-      workflow: "{project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml"
+      workflow: "{project-root}/.bmad/core/workflows/brainstorming/workflow.yaml"
      description: "Brainstorm trend implications"

    - trigger: party-mode
-      exec: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md"
+      exec: "{project-root}/.bmad/core/workflows/party-mode/workflow.md"
      description: "Discuss trends with other agents"
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01-init.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01-init.md
@@ -3,7 +3,7 @@ name: 'step-01-init'
 description: 'Initialize the nutrition plan workflow by detecting continuation state and creating output document'

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References
 thisStepFile: '{workflow_path}/steps/step-01-init.md'
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-01b-continue.md
@@ -3,7 +3,7 @@ name: 'step-01b-continue'
 description: 'Handle workflow continuation from previous session'

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References
 thisStepFile: '{workflow_path}/steps/step-01b-continue.md'
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-02-profile.md
@@ -3,7 +3,7 @@ name: 'step-02-profile'
 description: 'Gather comprehensive user profile information through collaborative conversation'

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References (all use {variable} format in file)
 thisStepFile: '{workflow_path}/steps/step-02-profile.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/nutrition-plan-{project_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
 profileTemplate: '{workflow_path}/templates/profile-section.md'
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-03-assessment.md
@@ -3,7 +3,7 @@ name: 'step-03-assessment'
 description: 'Analyze nutritional requirements, identify restrictions, and calculate target macros'

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References
 thisStepFile: '{workflow_path}/steps/step-03-assessment.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/nutrition-plan-{project_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'

 # Data References
 dietaryRestrictionsDB: '{workflow_path}/data/dietary-restrictions.csv'
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-04-strategy.md
@@ -3,7 +3,7 @@ name: 'step-04-strategy'
 description: 'Design a personalized meal strategy that meets nutritional needs and fits lifestyle'

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References
 thisStepFile: '{workflow_path}/steps/step-04-strategy.md'
@@ -13,8 +13,8 @@ workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/nutrition-plan-{project_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'

 # Data References
 recipeDatabase: '{workflow_path}/data/recipe-database.csv'
@@ -167,8 +167,8 @@ Display: **Select an Option:** [A] Meal Variety Optimization [P] Chef & Dietitia
 #### Menu Handling Logic:

 - HALT and AWAIT ANSWER
- IF A: Execute `{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml`
- IF P: Execute `{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md`
+- IF A: Execute `{project-root}/.bmad/core/tasks/advanced-elicitation.xml`
+- IF P: Execute `{project-root}/.bmad/core/workflows/party-mode/workflow.md`
 - IF C: Save content to nutrition-plan.md, update frontmatter, check cooking frequency:
  - IF cooking frequency > 2x/week: load, read entire file, then execute `{workflow_path}/step-05-shopping.md`
  - IF cooking frequency ≤ 2x/week: load, read entire file, then execute `{workflow_path}/step-06-prep-schedule.md`
--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-05-shopping.md
@@ -3,7 +3,7 @@ name: 'step-05-shopping'
 description: 'Create a comprehensive shopping list that supports the meal strategy'

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References
 thisStepFile: '{workflow_path}/steps/step-05-shopping.md'
@@ -12,8 +12,8 @@ workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/nutrition-plan-{project_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
 shoppingTemplate: '{workflow_path}/templates/shopping-section.md'
@@ -157,8 +157,8 @@ Display: **Select an Option:** [A] Budget Optimization Strategies [P] Shopping P
 #### Menu Handling Logic:

 - HALT and AWAIT ANSWER
- IF A: Execute `{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml`
- IF P: Execute `{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md`
+- IF A: Execute `{project-root}/.bmad/core/tasks/advanced-elicitation.xml`
+- IF P: Execute `{project-root}/.bmad/core/workflows/party-mode/workflow.md`
 - IF C: Save content to nutrition-plan.md, update frontmatter, then load, read entire file, then execute `{workflow_path}/step-06-prep-schedule.md`
 - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#5-present-menu-options)

--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/steps/step-06-prep-schedule.md
@@ -3,7 +3,7 @@ name: 'step-06-prep-schedule'
 description: "Create a realistic meal prep schedule that fits the user's lifestyle"

 # Path Definitions
-workflow_path: '{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition'
+workflow_path: '{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition'

 # File References
 thisStepFile: '{workflow_path}/steps/step-06-prep-schedule.md'
@@ -11,8 +11,8 @@ workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/nutrition-plan-{project_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
 prepScheduleTemplate: '{workflow_path}/templates/prep-schedule-section.md'
@@ -178,8 +178,8 @@ Display: **Select an Option:** [A] Advanced Prep Techniques [P] Coach Perspectiv
 #### Menu Handling Logic:

 - HALT and AWAIT ANSWER
- IF A: Execute `{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml`
- IF P: Execute `{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md`
+- IF A: Execute `{project-root}/.bmad/core/tasks/advanced-elicitation.xml`
+- IF P: Execute `{project-root}/.bmad/core/workflows/party-mode/workflow.md`
 - IF C: Update frontmatter with all steps completed, mark workflow complete, display final message
 - IF Any other comments or queries: help user respond then [Redisplay Menu Options](#6-present-menu-options)

--- a/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/workflow.md
+++ b/src/modules/bmb/workflows/create-agent/data/reference/workflows/meal-prep-nutrition/workflow.md
@@ -49,10 +49,10 @@ This uses **step-file architecture** for disciplined execution:

 ### 1. Configuration Loading

-Load and read full config from {project-root}/{bmad_folder}/bmm/config.yaml and resolve:
+Load and read full config from {project-root}/.bmad/bmm/config.yaml and resolve:

 - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`, `user_skill_level`

 ### 2. First Step EXECUTION

-Load, read the full file and then execute `{project-root}/{bmad_folder}/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md` to begin the workflow.
+Load, read the full file and then execute `{project-root}/.bmad/bmb/reference/workflows/meal-prep-nutrition/steps/step-01-init.md` to begin the workflow.
--- a/src/modules/bmb/workflows/create-agent/data/validation-complete.md
+++ b/src/modules/bmb/workflows/create-agent/data/validation-complete.md
@@ -2,8 +2,8 @@

 ## Migration Summary

-**Legacy Workflow:** `src/modules/bmb/workflows-legacy/create-agent/workflow.yaml` + `instructions.md`
-**New Workflow:** `src/modules/bmb/workflows/create-agent/workflow.md` + 11 step files
+**Legacy Workflow:** `bmb/workflows/create-agent-legacy/create-agent/workflow.yaml` + `instructions.md`
+**New Workflow:** `bmb/workflows/create-agent/create-agent/workflow.md` + 11 step files
 **Migration Date:** 2025-11-30T06:32:21.248Z
 **Migration Status:** ✅ COMPLETE

@@ -81,10 +81,10 @@

 **Agent Documentation References**

- Agent compilation guide: `{project-root}/{bmad_folder}/bmb/docs/agents/agent-compilation.md`
- Agent types guide: `{project-root}/{bmad_folder}/bmb/docs/agents/understanding-agent-types.md`
+- Agent compilation guide: `{project-root}/.bmad/bmb/docs/agents/agent-compilation.md`
+- Agent types guide: `{project-root}/.bmad/bmb/docs/agents/understanding-agent-types.md`
 - Architecture docs: simple, expert, module agent architectures
- Menu patterns guide: `{project-root}/{bmad_folder}/bmb/docs/agents/agent-menu-patterns.md`
+- Menu patterns guide: `{project-root}/.bmad/bmb/docs/agents/agent-menu-patterns.md`
 - Status: ✅ ALL REFERENCES PRESERVED

 **Communication Presets**
--- a/src/modules/bmb/workflows/create-agent/steps/step-01-brainstorm.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-01-brainstorm.md
@@ -3,18 +3,18 @@ name: 'step-01-brainstorm'
 description: 'Optional brainstorming for agent ideas'

 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/create-agent'

 # File References
 thisStepFile: '{workflow_path}/steps/step-01-brainstorm.md'
 nextStepFile: '{workflow_path}/steps/step-02-discover.md'
 workflowFile: '{workflow_path}/workflow.md'
 brainstormContext: '{workflow_path}/data/brainstorm-context.md'
-brainstormWorkflow: '{project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.md'
+brainstormWorkflow: '{project-root}/.bmad/core/workflows/brainstorming/workflow.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: Optional Brainstorming
--- a/src/modules/bmb/workflows/create-agent/steps/step-02-discover.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-02-discover.md
@@ -3,14 +3,14 @@ name: 'step-02-discover'
 description: 'Discover the agent purpose and type through natural conversation'

 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/create-agent'

 # File References
 thisStepFile: '{workflow_path}/steps/step-02-discover.md'
 nextStepFile: '{workflow_path}/steps/step-03-persona.md'
 workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/agent-purpose-{project_name}.md'
-agentTypesGuide: '{project-root}/{bmad_folder}/bmb/docs/agents/understanding-agent-types.md'
+agentTypesGuide: '{project-root}/.bmad/bmb/docs/agents/understanding-agent-types.md'
 simpleExamples: '{workflow_path}/data/reference/agents/simple-examples/'
 expertExamples: '{workflow_path}/data/reference/agents/expert-examples/'
 moduleExamples: '{workflow_path}/data/reference/agents/module-examples/'
@@ -19,8 +19,8 @@ moduleExamples: '{workflow_path}/data/reference/agents/module-examples/'
 agentPurposeTemplate: '{workflow_path}/templates/agent-purpose-and-type.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 2: Discover Agent Purpose and Type
--- a/src/modules/bmb/workflows/create-agent/steps/step-03-persona.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-03-persona.md
@@ -3,7 +3,7 @@ name: 'step-03-persona'
 description: 'Shape the agent personality through collaborative discovery'

 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/create-agent'

 # File References
 thisStepFile: '{workflow_path}/steps/step-03-persona.md'
@@ -11,14 +11,14 @@ nextStepFile: '{workflow_path}/steps/step-04-commands.md'
 workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/agent-persona-{project_name}.md'
 communicationPresets: '{workflow_path}/data/communication-presets.csv'
-agentMenuPatterns: '{project-root}/{bmad_folder}/bmb/docs/agents/agent-menu-patterns.md'
+agentMenuPatterns: '{project-root}/.bmad/bmb/docs/agents/agent-menu-patterns.md'

 # Template References
 personaTemplate: '{workflow_path}/templates/agent-persona.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 3: Shape Agent's Personality
--- a/src/modules/bmb/workflows/create-agent/steps/step-04-commands.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-04-commands.md
@@ -3,24 +3,24 @@ name: 'step-04-commands'
 description: 'Build capabilities through natural progression and refine commands'

 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/create-agent'

 # File References
 thisStepFile: '{workflow_path}/steps/step-04-commands.md'
 nextStepFile: '{workflow_path}/steps/step-05-name.md'
 workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/agent-commands-{project_name}.md'
-agentMenuPatterns: '{project-root}/{bmad_folder}/bmb/docs/agents/agent-menu-patterns.md'
-simpleArchitecture: '{project-root}/{bmad_folder}/bmb/docs/agents/simple-agent-architecture.md'
-expertArchitecture: '{project-root}/{bmad_folder}/bmb/docs/agents/expert-agent-architecture.md'
-moduleArchitecture: '{project-root}/{bmad_folder}/bmb/docs/agents/module-agent-architecture.md'
+agentMenuPatterns: '{project-root}/.bmad/bmb/docs/agents/agent-menu-patterns.md'
+simpleArchitecture: '{project-root}/.bmad/bmb/docs/agents/simple-agent-architecture.md'
+expertArchitecture: '{project-root}/.bmad/bmb/docs/agents/expert-agent-architecture.md'
+moduleArchitecture: '{project-root}/.bmad/bmb/docs/agents/module-agent-architecture.md'

 # Template References
 commandsTemplate: '{workflow_path}/templates/agent-commands.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: Build Capabilities and Commands
--- a/src/modules/bmb/workflows/create-agent/steps/step-05-name.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-05-name.md
@@ -3,7 +3,7 @@ name: 'step-05-name'
 description: 'Name the agent based on discovered characteristics'

 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/create-agent'

 # File References
 thisStepFile: '{workflow_path}/steps/step-05-name.md'
@@ -15,8 +15,8 @@ outputFile: '{output_folder}/agent-identity-{project_name}.md'
 identityTemplate: '{workflow_path}/templates/agent-identity.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: Agent Naming and Identity
--- a/src/modules/bmb/workflows/create-agent/steps/step-06-build.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-06-build.md
@@ -3,22 +3,22 @@ name: 'step-06-build'
 description: 'Generate complete YAML incorporating all discovered elements'

 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/create-agent'

 # File References
 thisStepFile: '{workflow_path}/steps/step-06-build.md'
 nextStepFile: '{workflow_path}/steps/step-07-validate.md'
 workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/agent-yaml-{project_name}.md'
-moduleOutputFile: '{project-root}/{bmad_folder}/{target_module}/agents/{agent_filename}.agent.yaml'
+moduleOutputFile: '{project-root}/.bmad/{target_module}/agents/{agent_filename}.agent.yaml'
 standaloneOutputFile: '{workflow_path}/data/{agent_filename}/{agent_filename}.agent.yaml'

 # Template References
 completeAgentTemplate: '{workflow_path}/templates/agent-complete-{agent_type}.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 6: Build Complete Agent YAML
--- a/src/modules/bmb/workflows/create-agent/steps/step-07-validate.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-07-validate.md
@@ -3,22 +3,22 @@ name: 'step-07-validate'
 description: 'Quality check with personality and technical validation'

 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/create-agent'

 # File References
 thisStepFile: '{workflow_path}/steps/step-07-validate.md'
 nextStepFile: '{workflow_path}/steps/step-08-setup.md'
 workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/agent-validation-{project_name}.md'
-agentValidationChecklist: '{project-root}/{bmad_folder}/bmb/workflows/create-agent/agent-validation-checklist.md'
+agentValidationChecklist: '{project-root}/.bmad/bmb/workflows/create-agent/agent-validation-checklist.md'
 agentFile: '{{output_file_path}}'

 # Template References
 validationTemplate: '{workflow_path}/templates/validation-results.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 7: Quality Check and Validation
--- a/src/modules/bmb/workflows/create-agent/steps/step-08-setup.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-08-setup.md
@@ -3,7 +3,7 @@ name: 'step-08-setup'
 description: 'Set up the agent workspace with sidecar files for expert agents'

 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/create-agent'

 # File References
 thisStepFile: '{workflow_path}/steps/step-08-setup.md'
@@ -16,8 +16,8 @@ agentSidecarFolder: '{{standalone_output_folder}}/{{agent_filename}}-sidecar'
 sidecarTemplate: '{workflow_path}/templates/expert-sidecar-structure.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 8: Expert Agent Workspace Setup
--- a/src/modules/bmb/workflows/create-agent/steps/step-09-customize.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-09-customize.md
@@ -3,21 +3,21 @@ name: 'step-09-customize'
 description: 'Optional personalization with customization file creation'

 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/create-agent'

 # File References
 thisStepFile: '{workflow_path}/steps/step-09-customize.md'
 nextStepFile: '{workflow_path}/steps/step-10-build-tools.md'
 workflowFile: '{workflow_path}/workflow.md'
 outputFile: '{output_folder}/agent-customization-{project_name}.md'
-configOutputFile: '{project-root}/{bmad_folder}/_cfg/agents/{target_module}-{agent_filename}.customize.yaml'
+configOutputFile: '{project-root}/.bmad/_cfg/agents/{target_module}-{agent_filename}.customize.yaml'

 # Template References
 customizationTemplate: '{workflow_path}/templates/agent-customization.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 9: Optional Customization File
--- a/src/modules/bmb/workflows/create-agent/steps/step-10-build-tools.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-10-build-tools.md
@@ -3,7 +3,7 @@ name: 'step-10-build-tools'
 description: 'Handle build tools availability and generate compiled agent if needed'

 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/create-agent'

 # File References
 thisStepFile: '{workflow_path}/steps/step-10-build-tools.md'
@@ -17,8 +17,8 @@ compiledAgentFile: '{{output_folder}}/{{agent_filename}}.md'
 buildHandlingTemplate: '{workflow_path}/templates/build-results.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 10: Build Tools Handling
--- a/src/modules/bmb/workflows/create-agent/steps/step-11-celebrate.md
+++ b/src/modules/bmb/workflows/create-agent/steps/step-11-celebrate.md
@@ -3,7 +3,7 @@ name: 'step-11-celebrate'
 description: 'Celebrate completion and guide next steps for using the agent'

 # Path Definitions
-workflow_path: '{project-root}/src/modules/bmb/workflows/create-agent'
+workflow_path: '{project-root}/bmb/workflows/create-agent/create-agent'

 # File References
 thisStepFile: '{workflow_path}/steps/step-11-celebrate.md'
@@ -16,8 +16,8 @@ compiledAgentFile: '{{compiled_agent_path}}'
 completionTemplate: '{workflow_path}/templates/completion-summary.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 11: Celebration and Next Steps
--- a/src/modules/bmb/workflows/create-agent/workflow.md
+++ b/src/modules/bmb/workflows/create-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`:
+Load and read full config from `{project-root}/.bmad/bmb/config.yaml`:

 - `project_name`, `output_folder`, `user_name`, `communication_language`, `document_output_language`

@@ -63,12 +63,12 @@ Load, read completely, then execute `steps/step-01-brainstorm.md` to begin the w

 # 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"
+agent_compilation: "{project-root}/.bmad/bmb/docs/agents/agent-compilation.md"
+understanding_agent_types: "{project-root}/.bmad/bmb/docs/agents/understanding-agent-types.md"
+simple_agent_architecture: "{project-root}/.bmad/bmb/docs/agents/simple-agent-architecture.md"
+expert_agent_architecture: "{project-root}/.bmad/bmb/docs/agents/expert-agent-architecture.md"
+module_agent_architecture: "{project-root}/.bmad/bmb/docs/agents/module-agent-architecture.md"
+agent_menu_patterns: "{project-root}/.bmad/bmb/docs/agents/agent-menu-patterns.md"

 # Data and templates

@@ -77,15 +77,15 @@ 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/"
+simple_agent_examples: "{project-root}/bmb/reference/agents/simple-examples/"
+expert_agent_examples: "{project-root}/bmb/reference/agents/expert-examples/"
+module_agent_examples: "{project-root}/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"
+custom_agent_location: "{project-root}/.bmad/custom/src/agents"
+module_output_file: "{project-root}/.bmad/{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"
+config_output_file: "{project-root}/.bmad/\_cfg/agents/{target_module}-{agent_filename}.customize.yaml"
--- a/src/modules/bmb/workflows/create-module/steps/step-01-init.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-01-init.md
@@ -2,8 +2,8 @@
 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'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 customModuleLocation: '{custom_module_location}'
 modulePlanFile: '{custom_module_location}/{module_name}/module-plan-{module_name}.md'
 ---
--- a/src/modules/bmb/workflows/create-module/steps/step-02-concept.md
+++ b/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'
+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
--- a/src/modules/bmb/workflows/create-module/steps/step-03-components.md
+++ b/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'
+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
--- a/src/modules/bmb/workflows/create-module/steps/step-04-structure.md
+++ b/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'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 ---

 # Step 4: Create Module Structure
--- a/src/modules/bmb/workflows/create-module/steps/step-05-config.md
+++ b/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'
+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]
 ````

--- a/src/modules/bmb/workflows/create-module/steps/step-06-agents.md
+++ b/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'
 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
--- a/src/modules/bmb/workflows/create-module/steps/step-07-workflows.md
+++ b/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'
 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
--- a/src/modules/bmb/workflows/create-module/steps/step-08-installer.md
+++ b/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'
 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
@@ -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
--- a/src/modules/bmb/workflows/create-module/steps/step-09-documentation.md
+++ b/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'
+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:**

--- a/src/modules/bmb/workflows/create-module/steps/step-10-roadmap.md
+++ b/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'
+advancedElicitationTask: '{project-root}/.bmad/core/tasks/advanced-elicitation.xml'
+partyModeWorkflow: '{project-root}/.bmad/core/workflows/party-mode/workflow.md'
 ---

 # Step 10: Generate Development Roadmap
--- a/src/modules/bmb/workflows/create-module/steps/step-11-validate.md
+++ b/src/modules/bmb/workflows/create-module/steps/step-11-validate.md
@@ -2,8 +2,8 @@
 workflowFile: '{installed_path}/workflow.md'
 modulePlanFile: '{custom_module_location}/{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
@@ -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

--- a/src/modules/bmb/workflows/create-module/templates/agent.template.md
+++ b/src/modules/bmb/workflows/create-module/templates/agent.template.md
@@ -55,7 +55,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 +83,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
@@ -156,7 +156,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 📊'
 ```

@@ -171,7 +171,7 @@ Expert agents support three types of menu actions:

 2. **Variable Usage**:
   - `{agent_sidecar_folder}` resolves to the agents sidecar folder destination after installation
-   - `{bmad_folder}` resolves to .bmad
+   - `.bmad` resolves to .bmad
   - `{custom_module}` resolves to custom/src/modules
   - `{module}` is your module code/name

@@ -268,7 +268,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 +305,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'
--- a/src/modules/bmb/workflows/create-module/templates/module.template.yaml
+++ b/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"
--- a/src/modules/bmb/workflows/create-module/workflow.md
+++ b/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,7 +46,7 @@ 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`

--- a/src/modules/bmb/workflows/create-workflow/steps/step-01-init.md
+++ b/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'
@@ -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}`
--- a/src/modules/bmb/workflows/create-workflow/steps/step-02-gather.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-02-gather.md
@@ -3,7 +3,7 @@ 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'
@@ -13,8 +13,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 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)
--- a/src/modules/bmb/workflows/create-workflow/steps/step-03-tools-configuration.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-03-tools-configuration.md
@@ -3,7 +3,7 @@ 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'
@@ -13,11 +13,11 @@ targetWorkflowPath: '{custom_stand_alone_location}/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
 ---
--- a/src/modules/bmb/workflows/create-workflow/steps/step-04-plan-review.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-04-plan-review.md
@@ -3,7 +3,7 @@ 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'
@@ -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 review summary directly to workflow plan
 ---
--- a/src/modules/bmb/workflows/create-workflow/steps/step-05-output-format-design.md
+++ b/src/modules/bmb/workflows/create-workflow/steps/step-05-output-format-design.md
@@ -3,7 +3,7 @@ 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'
@@ -13,8 +13,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'
 ---

 # Step 5: Output Format Design
--- a/src/modules/bmb/workflows/create-workflow/steps/step-06-design.md
+++ b/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.
--- a/src/modules/bmb/workflows/create-workflow/steps/step-07-build.md
+++ b/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,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
--- a/src/modules/bmb/workflows/create-workflow/steps/step-08-review.md
+++ b/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
--- a/src/modules/bmb/workflows/create-workflow/steps/step-09-complete.md
+++ b/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'
--- a/src/modules/bmb/workflows/create-workflow/workflow.md
+++ b/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`

--- a/src/modules/bmb/workflows/edit-agent/steps/step-01-discover-intent.md
+++ b/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
--- a/src/modules/bmb/workflows/edit-agent/steps/step-02-analyze-agent.md
+++ b/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
--- a/src/modules/bmb/workflows/edit-agent/steps/step-03-propose-changes.md
+++ b/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
--- a/src/modules/bmb/workflows/edit-agent/steps/step-04-apply-changes.md
+++ b/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
--- a/src/modules/bmb/workflows/edit-agent/steps/step-05-validate.md
+++ b/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
--- a/src/modules/bmb/workflows/edit-agent/workflow.md
+++ b/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`

--- a/src/modules/bmb/workflows/edit-workflow/steps/step-01-analyze.md
+++ b/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:

--- a/src/modules/bmb/workflows/edit-workflow/steps/step-02-discover.md
+++ b/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'
--- a/src/modules/bmb/workflows/edit-workflow/steps/step-03-improve.md
+++ b/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

--- a/src/modules/bmb/workflows/edit-workflow/steps/step-04-validate.md
+++ b/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'
--- a/src/modules/bmb/workflows/edit-workflow/steps/step-05-compliance-check.md
+++ b/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
--- a/src/modules/bmb/workflows/edit-workflow/workflow.md
+++ b/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`

--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-01-validate-goal.md
+++ b/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
--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-02-workflow-validation.md
+++ b/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:

--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-03-step-validation.md
+++ b/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

--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-04-file-validation.md
+++ b/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
--- a/src/modules/bmb/workflows/workflow-compliance-check/steps/step-05-intent-spectrum-validation.md
+++ b/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
--- a/Show More
+++ b/Show More