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

package/src/modules/bmb/agents/bmad-builder.agent.yaml

@@ -11,47 +11,84 @@ agent:
     module: bmb
 
   persona:
-    role: Master BMad Module Agent Team and Workflow Builder and Maintainer
-    identity: Lives to serve the expansion of the BMad Method
-    communication_style: Talks like a pulp super hero
+    role: Generalist Builder and BMAD System Maintainer
+    identity: A hands-on builder who gets things done efficiently and maintains the entire BMAD ecosystem
+    communication_style: Direct, action-oriented, and encouraging with a can-do attitude
     principles:
-      - Execute resources directly
+      - Execute resources directly without hesitation
       - Load resources at runtime never pre-load
-      - Always present numbered lists for choices
+      - Always present numbered lists for clear choices
+      - Focus on practical implementation and results
+      - Maintain system-wide coherence and standards
+      - Balance speed with quality and compliance
 
-  menu:
-    - trigger: audit-workflow
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/audit-workflow/workflow.yaml"
-      description: Audit existing workflows for BMAD Core compliance and best practices
-
-    - trigger: convert
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/convert-legacy/workflow.yaml"
-      description: Convert v4 or any other style task agent or template to a workflow
-
-    - trigger: create-agent
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/create-agent/workflow.yaml"
-      description: Create a new BMAD Core compliant agent
-
-    - trigger: create-module
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/create-module/workflow.yaml"
-      description: Create a complete BMAD compatible module (custom agents and workflows)
+  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"
 
-    - trigger: create-workflow
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/create-workflow/workflow.yaml"
-      description: Create a new BMAD Core workflow with proper structure
-
-    - trigger: edit-agent
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/edit-agent/workflow.yaml"
-      description: Edit existing agents while following best practices
-
-    - trigger: edit-module
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/edit-module/workflow.yaml"
-      description: Edit existing modules (structure, agents, workflows, documentation)
+  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"
+            - data: null
+            - type: exec
+        - edit-agent:
+            - input: EA or fuzzy match edit agent
+            - route: "{project-root}/{bmad_folder}/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"
+            - data: null
+            - type: exec
 
-    - trigger: edit-workflow
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/edit-workflow/workflow.yaml"
-      description: Edit existing workflows while following best practices
+    - multi: "[CW] Create, [EW] Edit, or [VW] Validate with Compliance CheckBMAD workflows with best practices"
+      triggers:
+        - create-workflow:
+            - input: CW or fuzzy match create workflow
+            - route: "{project-root}/{bmad_folder}/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"
+            - 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"
+            - data: null
+            - type: exec
 
-    - trigger: redoc
-      workflow: "{project-root}/{bmad_folder}/bmb/workflows/redoc/workflow.yaml"
-      description: Create or update module documentation
+    - multi: "[BM] Brainstorm, [PBM] Product Brief, [CM] Create, [EM] Edit or [VM] Validate with Compliance Check BMAD modules with best practices"
+      triggers:
+        - brainstorm-module:
+            - input: BM or fuzzy match brainstorm module
+            - route: "{project-root}/{bmad_folder}/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"
+            - data: null
+            - type: exec
+        - create-module:
+            - input: CM or fuzzy match create module
+            - route: "{project-root}/{bmad_folder}/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"
+            - 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"
+            - data: null
+            - type: exec

package/src/modules/bmb/docs/{agent-menu-patterns.md → agents/agent-menu-patterns.md}

@@ -115,7 +115,7 @@ menu:
   - trigger: create-brief
     exec: '{project-root}/{bmad_folder}/core/tasks/create-doc.xml'
     tmpl: '{project-root}/{bmad_folder}/bmm/templates/brief.md'
-    description: 'Create project brief'
+    description: 'Create a Product Brief'
 ```
 
 **When to Use:**
@@ -375,7 +375,7 @@ exec: "../../../core/tasks/validate.xml"
 
 - `{project-root}` - Project root directory
 - `{bmad_folder}` - BMAD installation folder
-- `{agent-folder}` - Agent installation directory (Expert agents)
+- `{agent_sidecar_folder}` - Agent installation directory (Expert agents)
 - `{output_folder}` - Document output location
 - `{user_name}` - User's name from config
 - `{communication_language}` - Language preference
@@ -415,9 +415,9 @@ menu:
 
 ```yaml
 critical_actions:
-  - 'Load {agent-folder}/memories.md'
-  - 'Follow {agent-folder}/instructions.md'
-  - 'ONLY access {agent-folder}/'
+  - 'Load ./memories.md'
+  - 'Follow ./instructions.md'
+  - 'ONLY access ./'
 
 prompts:
   - id: reflect
@@ -431,7 +431,7 @@ menu:
     description: 'Write journal entry'
 
   - trigger: save
-    action: 'Update {agent-folder}/memories.md with session insights'
+    action: 'Update ./memories.md with session insights'
     description: "Save today's session"
 
   - trigger: patterns

package/src/modules/bmb/docs/{expert-agent-architecture.md → agents/expert-agent-architecture.md}

@@ -57,9 +57,9 @@ agent:
       - My approach to memory and learning
 
   critical_actions:
-    - 'Load COMPLETE file {agent-folder}/{agent-name}-sidecar/memories.md and remember all past insights'
-    - 'Load COMPLETE file {agent-folder}/{agent-name}-sidecar/instructions.md and follow ALL protocols'
-    - 'ONLY read/write files in {agent-folder}/{agent-name}-sidecar/ - this is our private space'
+    - 'Load COMPLETE file ./{agent-name}-sidecar/memories.md and remember all past insights'
+    - 'Load COMPLETE file ./{agent-name}-sidecar/instructions.md and follow ALL protocols'
+    - 'ONLY read/write files in ./{agent-name}-sidecar/ - this is our private space'
     - 'Address user as {{greeting_name}}'
     - 'Track patterns, themes, and important moments'
     - 'Reference past interactions naturally to show continuity'
@@ -94,7 +94,7 @@ agent:
       description: 'Primary agent function'
 
     - trigger: remember
-      action: 'Update {agent-folder}/{agent-name}-sidecar/memories.md with session insights'
+      action: 'Update ./{agent-name}-sidecar/memories.md with session insights'
       description: 'Save what we discussed today'
 
     - trigger: patterns
@@ -102,7 +102,7 @@ agent:
       description: 'Recall patterns from past interactions'
 
     - trigger: insight
-      action: 'Document breakthrough in {agent-folder}/{agent-name}-sidecar/breakthroughs.md'
+      action: 'Document breakthrough in ./{agent-name}-sidecar/breakthroughs.md'
       description: 'Record a significant insight'
 
   install_config:
@@ -184,9 +184,9 @@ Add domain-specific documentation here.
 
 ```yaml
 critical_actions:
-  - 'Load COMPLETE file {agent-folder}/{sidecar}/memories.md and remember all past insights'
-  - 'Load COMPLETE file {agent-folder}/{sidecar}/instructions.md and follow ALL protocols'
-  - 'ONLY read/write files in {agent-folder}/{sidecar}/ - this is our private space'
+  - 'Load COMPLETE file ./{sidecar}/memories.md and remember all past insights'
+  - 'Load COMPLETE file ./{sidecar}/instructions.md and follow ALL protocols'
+  - 'ONLY read/write files in ./{sidecar}/ - this is our private space'
 ```
 
 **Key patterns:**
@@ -196,7 +196,7 @@ critical_actions:
 - **Memory integration** - Past context becomes part of current session
 - **Protocol adherence** - Ensures consistent behavior
 
-### {agent-folder} Variable
+### {agent_sidecar_folder} Variable
 
 Special variable resolved during installation:
 
@@ -211,9 +211,9 @@ Same as simple agents, PLUS:
 1. **Critical actions become numbered activation steps**
 
    ```xml
-   <step n="4">Load COMPLETE file {agent-folder}/memories.md...</step>
-   <step n="5">Load COMPLETE file {agent-folder}/instructions.md...</step>
-   <step n="6">ONLY read/write files in {agent-folder}/...</step>
+   <step n="4">Load COMPLETE file ./memories.md...</step>
+   <step n="5">Load COMPLETE file ./instructions.md...</step>
+   <step n="6">ONLY read/write files in ./...</step>
    ```
 
 2. **Sidecar files copied during installation**
@@ -260,7 +260,7 @@ The installer:
 ```yaml
 menu:
   - trigger: save
-    action: "Update {agent-folder}/sidecar/memories.md with today's session insights"
+    action: "Update ./sidecar/memories.md with today's session insights"
     description: 'Save session to memory'
 ```
 
@@ -281,7 +281,7 @@ prompts:
 ```yaml
 menu:
   - trigger: insight
-    action: 'Document in {agent-folder}/sidecar/breakthroughs.md with date, context, significance'
+    action: 'Document in ./sidecar/breakthroughs.md with date, context, significance'
     description: 'Record meaningful insight'
 ```
 
@@ -291,7 +291,7 @@ menu:
 
 ```yaml
 critical_actions:
-  - 'ONLY read/write files in {agent-folder}/sidecar/ - NO OTHER FOLDERS'
+  - 'ONLY read/write files in ./sidecar/ - NO OTHER FOLDERS'
 ```
 
 ### User Space Access
@@ -305,15 +305,15 @@ critical_actions:
 
 ```yaml
 critical_actions:
-  - 'Load knowledge from {agent-folder}/knowledge/ but NEVER modify'
-  - 'Write ONLY to {agent-folder}/sessions/'
+  - 'Load knowledge from ./knowledge/ but NEVER modify'
+  - 'Write ONLY to ./sessions/'
 ```
 
 ## Best Practices
 
 1. **Load sidecar files in critical_actions** - Must be explicit and MANDATORY
 2. **Enforce domain restrictions** - Clear boundaries prevent scope creep
-3. **Use {agent-folder} paths** - Portable across installations
+3. **Use {agent_sidecar_folder} paths** - Portable across installations
 4. **Design for memory growth** - Structure sidecar files for accumulation
 5. **Reference past naturally** - Don't dump memory, weave it into conversation
 6. **Separate concerns** - Memories, instructions, knowledge in distinct files
@@ -356,8 +356,8 @@ identity: |
 - [ ] Sidecar folder structure created and populated
 - [ ] memories.md has clear section structure
 - [ ] instructions.md contains core directives
-- [ ] Menu actions reference {agent-folder} correctly
-- [ ] File paths use {agent-folder} variable
+- [ ] Menu actions reference {agent_sidecar_folder} correctly
+- [ ] File paths use {agent_sidecar_folder} variable
 - [ ] Install config personalizes sidecar references
 - [ ] Agent folder named consistently: `{agent-name}/`
 - [ ] YAML file named: `{agent-name}.agent.yaml`

package/src/modules/bmb/docs/{module-agent-architecture.md → 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_folder*}/{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_folder*}/{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_folder*}/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_folder*}/{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_folder*}/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_folder*}/core/tasks/create-doc.xml'
+      tmpl: '{project-root}/{*bmad_folder*}/{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_folder*}/{module-code}/tasks/{task-name}.xml'
+      data: '{project-root}/{*bmad_folder*}/_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_folder*}` 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_folder*}/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_folder*}/core/tasks/validate-workflow.xml'
     description: 'Validate document structure'
 ```
 
@@ -123,9 +123,9 @@ 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'
-    description: 'Create project brief from template'
+    exec: '{project-root}/{*bmad_folder*}/core/tasks/create-doc.xml'
+    tmpl: '{project-root}/{*bmad_folder*}/bmm/templates/brief.md'
+    description: 'Create a Product Brief from template'
 ```
 
 Combines task execution with template file.
@@ -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_folder*}/bmm/tasks/standup.xml'
+    data: '{project-root}/{*bmad_folder*}/_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_folder*}/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_folder*}/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_folder*}` - 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_folder*}/bmm/workflows/prd/workflow.yaml"
 
 # BAD
 workflow: "/Users/john/project/.bmad/bmm/workflows/prd/workflow.yaml"
@@ -203,12 +203,12 @@ Module agents use the same injection process as simple agents:
 2. **Activation block** with standard steps
 3. **Menu handlers** based on usage (workflow, exec, tmpl, data)
 4. **Rules section** for consistent behavior
-5. **Auto-injected** *help and *exit commands
+5. **Auto-injected** \*help and \*exit commands
 
 **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_folder*}/{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_folder*}/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_folder*}/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_folder*}/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_folder*}/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_folder*}/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_folder*}/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_folder*}/bmm/workflows/2-planning/architecture/workflow.yaml'
     description: 'Design architecture'
 ```
 
@@ -292,17 +292,17 @@ menu:
 ```yaml
 menu:
   - trigger: party-mode
-    workflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml'
+    workflow: '{project-root}/{*bmad_folder*}/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_folder*}/cis/workflows/brainstorming/workflow.yaml'
     description: 'Use CIS brainstorming techniques'
 ```
 
 ## Best Practices
 
-1. **Use {bmad_folder} paths** - Portable across installations
+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
@@ -318,7 +318,7 @@ menu:
 ```yaml
 menu:
   - trigger: start
-    workflow: '{project-root}/{bmad_folder}/{module}/workflows/init/workflow.yaml'
+    workflow: '{project-root}/{*bmad_folder*}/{module}/workflows/init/workflow.yaml'
     description: 'Start new project (BEGIN HERE)'
 ```
 
@@ -327,7 +327,7 @@ menu:
 ```yaml
 menu:
   - trigger: status
-    workflow: '{project-root}/{bmad_folder}/{module}/workflows/status/workflow.yaml'
+    workflow: '{project-root}/{*bmad_folder*}/{module}/workflows/status/workflow.yaml'
     description: 'Check workflow progress'
 ```
 
@@ -336,27 +336,27 @@ menu:
 ```yaml
 menu:
   - trigger: party
-    workflow: '{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml'
+    workflow: '{project-root}/{*bmad_folder*}/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_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               |
 
 ## 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_folder*}/{module}/agents/{name}.md`
+- [ ] All workflow paths use `{project-root}/{*bmad_folder*}/` prefix
 - [ ] No hardcoded paths
 - [ ] No duplicate triggers
 - [ ] Each menu item has description

package/src/modules/bmb/docs/{simple-agent-architecture.md → agents/simple-agent-architecture.md}

@@ -217,9 +217,13 @@ Features demonstrated:
 # Copy to your project
 cp /path/to/commit-poet.agent.yaml .bmad/custom/agents/
 
-# Install with personalization
-bmad agent-install
-# or: npx bmad agent-install
+# Create custom.yaml and install
+echo "code: my-agent
+name: My Agent
+default_selected: true" > custom.yaml
+
+npx bmad-method install
+# or: bmad install
 ```
 
 The installer: