bmad-method 6.0.0-alpha.22 → 6.0.0-alpha.23

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-method",
-  "version": "6.0.0-alpha.22",
+  "version": "6.0.0-alpha.23",
   "description": "Breakthrough Method of Agile AI-driven Development",
   "keywords": [
     "agile",
@@ -27,8 +27,10 @@
     "bmad:install": "node tools/cli/bmad-cli.js install",
     "bundle": "node tools/cli/bundlers/bundle-web.js all",
     "docs:build": "node tools/build-docs.js",
-    "docs:dev": "npm run docs:build && npm run docs:serve",
-    "docs:serve": "docusaurus start --config website/docusaurus.config.js --host localhost",
+    "docs:dev": "astro dev --root website",
+    "docs:fix-links": "node tools/fix-doc-links.js",
+    "docs:preview": "astro preview --root website",
+    "docs:validate-links": "node tools/validate-doc-links.js",
     "flatten": "node tools/flattener/main.js",
     "format:check": "prettier --check \"**/*.{js,cjs,mjs,json,yaml}\"",
     "format:fix": "prettier --write \"**/*.{js,cjs,mjs,json,yaml}\"",
@@ -84,10 +86,11 @@
     "yaml": "^2.7.0"
   },
   "devDependencies": {
-    "@docusaurus/core": "^3.6.0",
-    "@docusaurus/preset-classic": "^3.6.0",
+    "@astrojs/sitemap": "^3.6.0",
+    "@astrojs/starlight": "^0.37.0",
     "@eslint/js": "^9.33.0",
     "archiver": "^7.0.1",
+    "astro": "^5.16.0",
     "c8": "^10.1.3",
     "eslint": "^9.33.0",
     "eslint-config-prettier": "^10.1.8",
@@ -100,12 +103,9 @@
     "markdownlint-cli2": "^0.19.1",
     "prettier": "^3.5.3",
     "prettier-plugin-packagejson": "^2.5.19",
-    "prism-react-renderer": "^2.4.1",
-    "react": "^18.3.1",
-    "react-dom": "^18.3.1",
+    "sharp": "^0.33.5",
     "yaml-eslint-parser": "^1.2.3",
-    "yaml-lint": "^1.7.0",
-    "zod": "^4.1.12"
+    "yaml-lint": "^1.7.0"
   },
   "engines": {
     "node": ">=20.0.0"

package/samples/sample-custom-modules/sample-unitary-module/agents/commit-poet/commit-poet.agent.yaml

@@ -5,6 +5,7 @@ agent:
     title: "Commit Message Artisan"
     icon: "📜"
     module: stand-alone
+    hasSidecar: false
 
   persona:
     role: |

package/samples/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/knowledge/installers.md

@@ -61,7 +61,7 @@
 | -------------- | -------------- | ------------------------- | ----------------------------- |
 | claude-code    | Claude Code    | .claude/commands/         | .md with frontmatter          |
 | codex          | Codex          | (varies)                  | .md                           |
-| cursor         | Cursor         | .cursor/rules/bmad/       | .mdc with MDC frontmatter     |
+| cursor         | Cursor         | .cursor/commands/bmad/    | .md with YAML frontmatter     |
 | github-copilot | GitHub Copilot | .github/                  | .md                           |
 | opencode       | OpenCode       | .opencode/                | .md                           |
 | windsurf       | Windsurf       | .windsurf/workflows/bmad/ | .md with workflow frontmatter |

package/samples/sample-custom-modules/sample-unitary-module/agents/toolsmith/toolsmith-sidecar/knowledge/modules.md

@@ -128,7 +128,7 @@ module.exports = { NewIdeSetup };
 | IDE            | Config Pattern            | File Extension |
 | -------------- | ------------------------- | -------------- |
 | Claude Code    | .claude/commands/bmad/    | .md            |
-| Cursor         | .cursor/rules/bmad/       | .mdc           |
+| Cursor         | .cursor/commands/bmad/    | .md            |
 | Windsurf       | .windsurf/workflows/bmad/ | .md            |
 | GitHub Copilot | .github/                  | .md            |
 

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-01-init.md

@@ -6,8 +6,8 @@ description: 'Initialize quiz game with mode selection and category choice'
 workflow_path: '{project-root}/_bmad/custom/src/workflows/quiz-master'
 
 # File References
-thisStepFile: '{workflow_path}/steps/step-01-init.md'
-nextStepFile: '{workflow_path}/steps/step-02-q1.md'
+thisStepFile: './step-01-init.md'
+nextStepFile: './step-02-q1.md'
 workflowFile: '{workflow_path}/workflow.md'
 csvFile: '{project-root}/BMad-quiz-results.csv'
 csvTemplate: '{workflow_path}/templates/csv-headers.template'
@@ -146,7 +146,7 @@ Display: **Starting your quiz adventure...**
 
 ## CRITICAL STEP COMPLETION NOTE
 
-ONLY WHEN setup is complete (mode selected, category chosen, CSV initialized) will you then load, read fully, and execute `{workflow_path}/steps/step-02-q1.md` to begin the first question.
+ONLY WHEN setup is complete (mode selected, category chosen, CSV initialized) will you then load, read fully, and execute `./step-02-q1.md` to begin the first question.
 
 ## 🚨 SYSTEM SUCCESS/FAILURE METRICS
 

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-02-q1.md

@@ -6,9 +6,9 @@ description: 'Question 1 - Level 1 difficulty'
 workflow_path: '{project-root}/_bmad/custom/src/workflows/quiz-master'
 
 # File References
-thisStepFile: '{workflow_path}/steps/step-02-q1.md'
-nextStepFile: '{workflow_path}/steps/step-03-q2.md'
-resultsStepFile: '{workflow_path}/steps/step-12-results.md'
+thisStepFile: './step-02-q1.md'
+nextStepFile: './step-03-q2.md'
+resultsStepFile: './step-12-results.md'
 workflowFile: '{workflow_path}/workflow.md'
 csvFile: '{project-root}/BMad-quiz-results.csv'
 # Task References

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-03-q2.md

@@ -6,9 +6,9 @@ description: 'Question 2 - Level 2 difficulty'
 workflow_path: '{project-root}/_bmad/custom/src/workflows/quiz-master'
 
 # File References
-thisStepFile: '{workflow_path}/steps/step-03-q2.md'
-nextStepFile: '{workflow_path}/steps/step-04-q3.md'
-resultsStepFile: '{workflow_path}/steps/step-12-results.md'
+thisStepFile: './step-03-q2.md'
+nextStepFile: './step-04-q3.md'
+resultsStepFile: './step-12-results.md'
 workflowFile: '{workflow_path}/workflow.md'
 csvFile: '{project-root}/BMad-quiz-results.csv'
 ---

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-04-q3.md

@@ -6,9 +6,9 @@ description: 'Question 3 - Level 3 difficulty'
 workflow_path: '{project-root}/_bmad/custom/src/workflows/quiz-master'
 
 # File References
-thisStepFile: '{workflow_path}/steps/step-04-q3.md'
-nextStepFile: '{workflow_path}/steps/step-04-q3.md'
-resultsStepFile: '{workflow_path}/steps/step-12-results.md'
+thisStepFile: './step-04-q3.md'
+nextStepFile: './step-04-q3.md'
+resultsStepFile: './step-12-results.md'
 workflowFile: '{workflow_path}/workflow.md'
 csvFile: '{project-root}/BMad-quiz-results.csv'
 ---

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-05-q4.md

@@ -6,9 +6,9 @@ description: 'Question 4 - Level 4 difficulty'
 workflow_path: '{project-root}/_bmad/custom/src/workflows/quiz-master'
 
 # File References
-thisStepFile: '{workflow_path}/steps/step-05-q4.md'
-nextStepFile: '{workflow_path}/steps/step-05-q4.md'
-resultsStepFile: '{workflow_path}/steps/step-12-results.md'
+thisStepFile: './step-05-q4.md'
+nextStepFile: './step-05-q4.md'
+resultsStepFile: './step-12-results.md'
 workflowFile: '{workflow_path}/workflow.md'
 csvFile: '{project-root}/BMad-quiz-results.csv'
 ---

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-06-q5.md

@@ -6,9 +6,9 @@ description: 'Question 5 - Level 5 difficulty'
 workflow_path: '{project-root}/_bmad/custom/src/workflows/quiz-master'
 
 # File References
-thisStepFile: '{workflow_path}/steps/step-06-q5.md'
-nextStepFile: '{workflow_path}/steps/step-06-q5.md'
-resultsStepFile: '{workflow_path}/steps/step-12-results.md'
+thisStepFile: './step-06-q5.md'
+nextStepFile: './step-06-q5.md'
+resultsStepFile: './step-12-results.md'
 workflowFile: '{workflow_path}/workflow.md'
 csvFile: '{project-root}/BMad-quiz-results.csv'
 ---

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-07-q6.md

@@ -6,9 +6,9 @@ description: 'Question 6 - Level 6 difficulty'
 workflow_path: '{project-root}/_bmad/custom/src/workflows/quiz-master'
 
 # File References
-thisStepFile: '{workflow_path}/steps/step-07-q6.md'
-nextStepFile: '{workflow_path}/steps/step-07-q6.md'
-resultsStepFile: '{workflow_path}/steps/step-12-results.md'
+thisStepFile: './step-07-q6.md'
+nextStepFile: './step-07-q6.md'
+resultsStepFile: './step-12-results.md'
 workflowFile: '{workflow_path}/workflow.md'
 csvFile: '{project-root}/BMad-quiz-results.csv'
 ---

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-08-q7.md

@@ -6,9 +6,9 @@ description: 'Question 7 - Level 7 difficulty'
 workflow_path: '{project-root}/_bmad/custom/src/workflows/quiz-master'
 
 # File References
-thisStepFile: '{workflow_path}/steps/step-08-q7.md'
-nextStepFile: '{workflow_path}/steps/step-08-q7.md'
-resultsStepFile: '{workflow_path}/steps/step-12-results.md'
+thisStepFile: './step-08-q7.md'
+nextStepFile: './step-08-q7.md'
+resultsStepFile: './step-12-results.md'
 workflowFile: '{workflow_path}/workflow.md'
 csvFile: '{project-root}/BMad-quiz-results.csv'
 ---

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-09-q8.md

@@ -6,9 +6,9 @@ description: 'Question 8 - Level 8 difficulty'
 workflow_path: '{project-root}/_bmad/custom/src/workflows/quiz-master'
 
 # File References
-thisStepFile: '{workflow_path}/steps/step-09-q8.md'
-nextStepFile: '{workflow_path}/steps/step-09-q8.md'
-resultsStepFile: '{workflow_path}/steps/step-12-results.md'
+thisStepFile: './step-09-q8.md'
+nextStepFile: './step-09-q8.md'
+resultsStepFile: './step-12-results.md'
 workflowFile: '{workflow_path}/workflow.md'
 csvFile: '{project-root}/BMad-quiz-results.csv'
 ---

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-10-q9.md

@@ -6,9 +6,9 @@ description: 'Question 9 - Level 9 difficulty'
 workflow_path: '{project-root}/_bmad/custom/src/workflows/quiz-master'
 
 # File References
-thisStepFile: '{workflow_path}/steps/step-10-q9.md'
-nextStepFile: '{workflow_path}/steps/step-10-q9.md'
-resultsStepFile: '{workflow_path}/steps/step-12-results.md'
+thisStepFile: './step-10-q9.md'
+nextStepFile: './step-10-q9.md'
+resultsStepFile: './step-12-results.md'
 workflowFile: '{workflow_path}/workflow.md'
 csvFile: '{project-root}/BMad-quiz-results.csv'
 ---

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-11-q10.md

@@ -6,9 +6,9 @@ description: 'Question 10 - Level 10 difficulty'
 workflow_path: '{project-root}/_bmad/custom/src/workflows/quiz-master'
 
 # File References
-thisStepFile: '{workflow_path}/steps/step-11-q10.md'
-nextStepFile: '{workflow_path}/steps/results.md'
-resultsStepFile: '{workflow_path}/steps/step-12-results.md'
+thisStepFile: './step-11-q10.md'
+nextStepFile: './results.md'
+resultsStepFile: './step-12-results.md'
 workflowFile: '{workflow_path}/workflow.md'
 csvFile: '{project-root}/BMad-quiz-results.csv'
 ---

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/steps/step-12-results.md

@@ -6,8 +6,8 @@ description: 'Final results and celebration'
 workflow_path: '{project-root}/_bmad/custom/src/workflows/quiz-master'
 
 # File References
-thisStepFile: '{workflow_path}/steps/step-12-results.md'
-initStepFile: '{workflow_path}/steps/step-01-init.md'
+thisStepFile: './step-12-results.md'
+initStepFile: './step-01-init.md'
 workflowFile: '{workflow_path}/workflow.md'
 csvFile: '{project-root}/BMad-quiz-results.csv'
 # Task References

package/samples/sample-custom-modules/sample-unitary-module/workflows/quiz-master/workflow.md

@@ -51,4 +51,4 @@ Load and read full config from {project-root}/_bmad/bmb/config.yaml and resolve:
 
 ### 2. First Step EXECUTION
 
-Load, read the full file and then execute {workflow_path}/steps/step-01-init.md to begin the workflow.
+Load, read the full file and then execute ./step-01-init.md to begin the workflow.

package/samples/sample-custom-modules/sample-wellness-module/agents/meditation-guide.agent.yaml

@@ -5,6 +5,7 @@ agent:
     title: "Meditation Guide"
     icon: "🧘"
     module: "mwm"
+    hasSidecar: false
   persona:
     role: "Mindfulness and meditation specialist"
     identity: |

package/src/core/agents/bmad-master.agent.yaml

@@ -7,6 +7,7 @@ agent:
     name: "BMad Master"
     title: "BMad Master Executor, Knowledge Custodian, and Workflow Orchestrator"
     icon: "🧙"
+    hasSidecar: false
 
   persona:
     role: "Master Task Executor + BMad Expert + Guiding Facilitator Orchestrator"

package/src/core/tasks/shard-doc.xml

@@ -1,4 +1,4 @@
-<tool id="_bmad/core/tasks/shard-doc" name="Shard Document"
+<task id="_bmad/core/tasks/shard-doc" name="Shard Document"
   description="Splits large markdown documents into smaller, organized files based on level 2 (default) sections" webskip="true"
   standalone="true">
   <objective>Split large markdown documents into smaller, organized files based on level 2 sections using @kayvan/markdown-tree-parser tool</objective>
@@ -106,4 +106,4 @@
   <halt-conditions critical="true">
     <i>HALT if npx command fails or produces no output files</i>
   </halt-conditions>
-</tool>
+</task>

package/src/core/workflows/brainstorming/steps/step-03-technique-execution.md

@@ -1,19 +1,36 @@
 # Step 3: Interactive Technique Execution and Facilitation
 
+---
+advancedElicitationTask: '{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml'
+---
+
 ## MANDATORY EXECUTION RULES (READ FIRST):
 
 - ✅ YOU ARE A CREATIVE FACILITATOR, engaging in genuine back-and-forth coaching
+- 🎯 AIM FOR 100+ IDEAS before suggesting organization - quantity unlocks quality (quality must grow as we progress)
+- 🔄 DEFAULT IS TO KEEP EXPLORING - only move to organization when user explicitly requests it
+- 🧠 **THOUGHT BEFORE INK (CoT):** Before generating each idea, you must internally reason: "What domain haven't we explored yet? What would make this idea surprising or 'uncomfortable' for the user?"
+- 🛡️ **ANTI-BIAS DOMAIN PIVOT:** Every 10 ideas, review existing themes and consciously pivot to an orthogonal domain (e.g., UX -> Business -> Physics -> Social Impact).
+- 🌡️ **SIMULATED TEMPERATURE:** Act as if your creativity is set to 0.85 - take wilder leaps and suggest "provocative" concepts.
+- ⏱️ Spend minimum 30-45 minutes in active ideation before offering to conclude
 - 🎯 EXECUTE ONE TECHNIQUE ELEMENT AT A TIME with interactive exploration
 - 📋 RESPOND DYNAMICALLY to user insights and build upon their ideas
 - 🔍 ADAPT FACILITATION based on user engagement and emerging directions
 - 💬 CREATE TRUE COLLABORATION, not question-answer sequences
 - ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the `communication_language`
 
+## IDEA FORMAT TEMPLATE:
+
+Every idea you capture should follow this structure:
+**[Category #X]**: [Mnemonic Title]
+_Concept_: [2-3 sentence description]
+_Novelty_: [What makes this different from obvious solutions]
+
 ## EXECUTION PROTOCOLS:
 
 - 🎯 Present one technique element at a time for deep exploration
 - ⚠️ Ask "Continue with current technique?" before moving to next technique
-- 💾 Document insights and ideas as they emerge organically
+- 💾 Document insights and ideas using the **IDEA FORMAT TEMPLATE**
 - 📖 Follow user's creative energy and interests within technique structure
 - 🚫 FORBIDDEN rushing through technique elements without user engagement
 
@@ -142,6 +159,26 @@ Before moving to next technique element:
 
 **Remember:** At any time, just say **"next technique"** or **"move on"** and I'll immediately document our current progress and start the next technique!"
 
+### 4.1. Energy Checkpoint (After Every 4-5 Exchanges)
+
+**Periodic Check-In (DO NOT skip this):**
+
+"We've generated [X] ideas so far - great momentum!
+
+**Quick energy check:**
+
+- Want to **keep pushing** on this angle?
+- **Switch techniques** for a fresh perspective?
+- Or are you feeling like we've **thoroughly explored** this space?
+
+Remember: The goal is quantity first - we can organize later. What feels right?"
+
+**IMPORTANT:** Default to continuing exploration. Only suggest organization if:
+
+- User has explicitly asked to wrap up, OR
+- You've been exploring for 45+ minutes AND generated 100+ ideas, OR
+- User's energy is clearly depleted (short responses, "I don't know", etc.)
+
 ### 4a. Handle Immediate Technique Transition
 
 **When user says "next technique" or "move on":**
@@ -208,13 +245,15 @@ This connects beautifully with what we discovered earlier about _[previous conne
 
 **After Deep Exploration:**
 
-"Let me summarize what we've uncovered in this exploration:
+"Let me summarize what we've uncovered in this exploration using our **IDEA FORMAT TEMPLATE**:
 
 **Key Ideas Generated:**
 
-- **[Idea 1]:** [Context and development]
-- **[Idea 2]:** [How this emerged and evolved]
-- **[Idea 3]:** [User's insight plus your coaching contribution]
+**[Category #X]**: [Mnemonic Title]
+_Concept_: [2-3 sentence description]
+_Novelty_: [What makes this different from obvious solutions]
+
+(Repeat for all ideas generated)
 
 **Creative Breakthrough:** [Most innovative insight from the dialogue]
 
@@ -243,17 +282,29 @@ After final technique element:
 
 **Before we move to idea organization, any final thoughts about this technique? Any insights you want to make sure we carry forward?**
 
-**Ready to organize all these brilliant ideas and identify your top priorities?**
-[C] Continue - Organize ideas and create action plans
+**What would you like to do next?**
+
+[K] **Keep exploring this technique** - We're just getting warmed up!
+[T] **Try a different technique** - Fresh perspective on the same topic
+[A] **Go deeper on a specific idea** - Develop a promising concept further (Advanced Elicitation)
+[B] **Take a quick break** - Pause and return with fresh energy
+[C] **Move to organization** - Only when you feel we've thoroughly explored
 
-### 8. Handle Continue Selection
+**Default recommendation:** Unless you feel we've generated at least 100+ ideas, I suggest we keep exploring! The best insights often come after the obvious ideas are exhausted.
 
-#### If 'C' (Continue):
+### 8. Handle Menu Selection
+
+#### If 'C' (Move to organization):
 
 - **Append the technique execution content to `{output_folder}/analysis/brainstorming-session-{{date}}.md`**
 - **Update frontmatter:** `stepsCompleted: [1, 2, 3]`
 - **Load:** `./step-04-idea-organization.md`
 
+#### If 'K', 'T', 'A', or 'B' (Continue Exploring):
+
+- **Stay in Step 3** and restart the facilitation loop for the chosen path (or pause if break requested).
+- For option A, invoke Advanced Elicitation: `{advancedElicitationTask}`
+
 ### 9. Update Documentation
 
 Update frontmatter and document with interactive session insights:
@@ -279,6 +330,7 @@ facilitation_notes: [key insights about user's creative process]
 
 - **Interactive Focus:** [Main exploration directions]
 - **Key Breakthroughs:** [Major insights from coaching dialogue]
+
 - **User Creative Strengths:** [What user demonstrated]
 - **Energy Level:** [Observation about engagement]
 
@@ -308,6 +360,9 @@ When user selects 'C', append the content directly to `{output_folder}/analysis/
 
 ## SUCCESS METRICS:
 
+✅ Minimum 100 ideas generated before organization is offered
+✅ User explicitly confirms readiness to conclude (not AI-initiated)
+✅ Multiple technique exploration encouraged over single-technique completion
 ✅ True back-and-forth facilitation rather than question-answer format
 ✅ User's creative energy and interests guide technique direction
 ✅ Deep exploration of promising ideas before moving on
@@ -318,6 +373,10 @@ When user selects 'C', append the content directly to `{output_folder}/analysis/
 
 ## FAILURE MODES:
 
+❌ Offering organization after only one technique or <20 ideas
+❌ AI initiating conclusion without user explicitly requesting it
+❌ Treating technique completion as session completion signal
+❌ Rushing to document rather than staying in generative mode
 ❌ Rushing through technique elements without user engagement
 ❌ Not following user's creative energy and interests
 ❌ Missing opportunities to develop promising ideas deeper

package/src/core/workflows/brainstorming/workflow.md

@@ -10,6 +10,12 @@ context_file: '' # Optional context file path for project-specific guidance
 
 **Your Role:** You are a brainstorming facilitator and creative thinking guide. You bring structured creativity techniques, facilitation expertise, and an understanding of how to guide users through effective ideation processes that generate innovative ideas and breakthrough solutions. During this entire workflow it is critical that you speak to the user in the config loaded `communication_language`.
 
+**Critical Mindset:** Your job is to keep the user in generative exploration mode as long as possible. The best brainstorming sessions feel slightly uncomfortable - like you've pushed past the obvious ideas into truly novel territory. Resist the urge to organize or conclude. When in doubt, ask another question, try another technique, or dig deeper into a promising thread.
+
+**Anti-Bias Protocol:** LLMs naturally drift toward semantic clustering (sequential bias). To combat this, you MUST consciously shift your creative domain every 10 ideas. If you've been focusing on technical aspects, pivot to user experience, then to business viability, then to edge cases or "black swan" events. Force yourself into orthogonal categories to maintain true divergence.
+
+**Quantity Goal:** Aim for 100+ ideas before any organization. The first 20 ideas are usually obvious - the magic happens in ideas 50-100.
+
 ---
 
 ## WORKFLOW ARCHITECTURE
@@ -41,6 +47,7 @@ Load config from `{project-root}/_bmad/core/config.yaml` and resolve:
 - `brain_techniques_path` = `{installed_path}/brain-methods.csv`
 - `default_output_file` = `{output_folder}/analysis/brainstorming-session-{{date}}.md`
 - `context_file` = Optional context file path from workflow invocation for project-specific guidance
+- `advancedElicitationTask` = `{project-root}/_bmad/core/workflows/advanced-elicitation/workflow.xml`
 
 ---
 

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

@@ -9,6 +9,7 @@ agent:
     title: Agent Building Expert
     icon: 🤖
     module: bmb
+    hasSidecar: false
 
   persona:
     role: Agent Architecture Specialist + BMAD Compliance Expert
@@ -34,3 +35,7 @@ agent:
     - trigger: EA or fuzzy match on edit-agent
       exec: "{project-root}/_bmad/bmb/workflows/agent/workflow.md"
       description: "[EA] Edit existing BMAD agents while maintaining compliance"
+
+    - trigger: VA or fuzzy match on validate-agent
+      exec: "{project-root}/_bmad/bmb/workflows/agent/workflow.md"
+      description: "[VA] Validate existing BMAD agents and offer to improve deficiencies"

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

@@ -9,6 +9,7 @@ agent:
     title: Module Creation Master
     icon: 🏗️
     module: bmb
+    hasSidecar: false
 
   persona:
     role: Module Architecture Specialist + Full-Stack Systems Designer
@@ -27,22 +28,18 @@ agent:
     - modules: "{project-root}/_bmad/bmb/docs/modules/kb.csv"
 
   menu:
-    - trigger: BM or fuzzy match on brainstorm-module
-      exec: "{project-root}/_bmad/bmb/workflows/brainstorm-module/workflow.md"
-      description: "[BM] Brainstorm and conceptualize new BMAD modules"
-
     - trigger: PB or fuzzy match on product-brief
-      exec: "{project-root}/_bmad/bmb/workflows/product-brief-module/workflow.md"
+      exec: "{project-root}/_bmad/bmb/workflows/module/workflow.md"
       description: "[PB] Create product brief for BMAD module development"
 
     - trigger: CM or fuzzy match on create-module
-      exec: "{project-root}/_bmad/bmb/workflows/create-module/workflow.md"
+      exec: "{project-root}/_bmad/bmb/workflows/module/workflow.md"
       description: "[CM] Create a complete BMAD module with agents, workflows, and infrastructure"
 
     - trigger: EM or fuzzy match on edit-module
-      exec: "{project-root}/_bmad/bmb/workflows/edit-module/workflow.md"
+      exec: "{project-root}/_bmad/bmb/workflows/module/workflow.md"
       description: "[EM] Edit existing BMAD modules while maintaining coherence"
 
     - trigger: VM or fuzzy match on validate-module
-      exec: "{project-root}/_bmad/bmb/workflows/module-compliance-check/workflow.md"
+      exec: "{project-root}/_bmad/bmb/workflows/module/workflow.md"
       description: "[VM] Run compliance check on BMAD modules against best practices"

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

@@ -9,6 +9,7 @@ agent:
     title: Workflow Building Master
     icon: 🔄
     module: bmb
+    hasSidecar: false
 
   persona:
     role: Workflow Architecture Specialist + Process Design Expert
@@ -28,13 +29,21 @@ agent:
 
   menu:
     - trigger: CW or fuzzy match on create-workflow
-      exec: "{project-root}/_bmad/bmb/workflows/create-workflow/workflow.md"
+      exec: "{project-root}/_bmad/bmb/workflows/workflow/workflow.md"
       description: "[CW] Create a new BMAD workflow with proper structure and best practices"
 
-    # - trigger: EW or fuzzy match on edit-workflow
-    #   exec: "{project-root}/_bmad/bmb/workflows/edit-workflow/workflow.md"
-    #   description: "[EW] Edit existing BMAD workflows while maintaining integrity"
+    - trigger: EW or fuzzy match on edit-workflow
+      exec: "{project-root}/_bmad/bmb/workflows/workflow/workflow.md"
+      description: "[EW] Edit existing BMAD workflows while maintaining integrity"
 
-    # - trigger: VW or fuzzy match on validate-workflow
-    #   exec: "{project-root}/_bmad/bmb/workflows/workflow-compliance-check/workflow.md"
-    #   description: "[VW] Run compliance check on BMAD workflows against best practices"
+    - trigger: VW or fuzzy match on validate-workflow
+      exec: "{project-root}/_bmad/bmb/workflows/workflow/workflow.md"
+      description: "[VW] Run validation check on BMAD workflows against best practices"
+
+    - trigger: MV or fuzzy match on validate-max-parallel-workflow
+      exec: "{project-root}/_bmad/bmb/workflows/workflow/workflow.md"
+      description: "[MV] Run validation checks in MAX-PARALLEL mode against a workflow (requires a tool that supports Parallel Sub-Processes)"
+
+    - trigger: RW or fuzzy match on convert-or-rework-workflow
+      exec: "{project-root}/_bmad/bmb/workflows/workflow/workflow.md"
+      description: "[RW] Rework a Workflow to a V6 Compliant Version"

package/src/modules/bmb/workflows/agent/data/agent-menu-patterns.md

@@ -54,7 +54,7 @@ For module agents referencing external workflow files.
   description: '[CP] Create Product Requirements Document'
 
 - trigger: GB or fuzzy match on brainstorm
-  exec: '{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml'
+  exec: '{project-root}/_bmad/core/workflows/brainstorming/workflow.md'
   description: '[GB] Guided brainstorming session'
 
 # Planned but unimplemented
@@ -112,11 +112,11 @@ menu:
 
 ```yaml
 # ✅ CORRECT
-exec: '{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml'
+exec: '{project-root}/_bmad/core/workflows/brainstorming/workflow.md'
 data: '{project-root}/_data/metrics.csv'
 
 # ❌ WRONG
-exec: '../../../core/workflows/brainstorming/workflow.yaml'
+exec: '../../../core/workflows/brainstorming/workflow.md'
 ```
 
 **Available variables:**
@@ -213,8 +213,8 @@ menu:
     description: '[WI] Initialize workflow path'
 
   - trigger: BS or fuzzy match on brainstorm
-    exec: '{project-root}/_bmad/core/workflows/brainstorming/workflow.yaml'
-    description: '[BS] Guided brainstorming'
+    exec: '{project-root}/_bmad/core/workflows/brainstorming/workflow.md'
+    description: '[BS] Guided brainstorming [K,T,A,B,C]'
 
   - trigger: CP or fuzzy match on create-prd
     exec: '{project-root}/_bmad/bmm/workflows/create-prd/workflow.md'

package/src/modules/bmb/workflows/agent/data/critical-actions.md

@@ -31,8 +31,8 @@ critical_actions:
 
 **CRITICAL Path Format:**
 - `{project-root}` = literal text (not replaced)
-- Sidecar copied to `_memory/` at build time
-- Use `{project-root}/_bmad/_memory/{sidecar-folder}/` format
+- Sidecar created next to agent.yaml during BUILD, then copied to `_memory/` during BMAD INSTALLATION
+- Use `{project-root}/_bmad/_memory/{sidecar-folder}/` format for RUNTIME paths in agent YAML
 
 ---
 

package/src/modules/bmb/workflows/agent/data/expert-agent-architecture.md

@@ -39,7 +39,7 @@ Agents with a sidecar folder for persistent memory, custom workflows, and restri
 
 ## CRITICAL: Sidecar Path Format
 
-At build/install, sidecar is copied to `{project-root}/_bmad/_memory/{sidecar-folder}/`
+During BMAD INSTALLATION, sidecar folder is copied from the agent location to `{project-root}/_bmad/_memory/{sidecar-folder}/`
 
 **ALL agent YAML references MUST use:**
 

package/src/modules/bmb/workflows/agent/data/expert-agent-validation.md

@@ -7,7 +7,8 @@ Validate Expert agents meet BMAD quality standards.
 ## YAML Structure
 
 - [ ] YAML parses without errors
-- [ ] `agent.metadata` includes: `id`, `name`, `title`, `icon`, `module`
+- [ ] `agent.metadata` includes: `id`, `name`, `title`, `icon`, `module`, `hasSidecar`
+- [ ] `agent.metadata.hasSidecar` is `true` (Expert agents have sidecars)
 - [ ] `agent.metadata.module` is `stand-alone` or module code (`bmm`, `cis`, `bmgd`, etc.)
 - [ ] `agent.persona` exists with: `role`, `identity`, `communication_style`, `principles`
 - [ ] `agent.critical_actions` exists (MANDATORY for Expert)