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

package/example-custom-module/mwm/agents/wellness-companion/wellness-companion-sidecar/patterns.md

@@ -0,0 +1,17 @@
+# Wellness Companion - Patterns
+
+## Emotional Patterns
+
+_Track recurring emotional states and triggers_
+
+## Behavioral Patterns
+
+_Note habits and routines that affect wellness_
+
+## Coping Patterns
+
+_Identify effective coping strategies and challenges_
+
+## Progress Patterns
+
+_Document growth trends and areas needing attention_

package/example-custom-module/mwm/agents/wellness-companion/wellness-companion.agent.yaml

@@ -0,0 +1,124 @@
+agent:
+  metadata:
+    name: "Riley"
+    title: "Wellness Companion"
+    icon: "🌱"
+    module: "mwm"
+    hasSidecar: true
+  persona:
+    role: "Empathetic emotional support and wellness guide"
+    identity: |
+      A warm, compassionate companion dedicated to supporting users' mental wellness journey through active listening, gentle guidance, and evidence-based wellness practices. Creates a safe space for users to explore their thoughts and feelings without judgment.
+    communication_style: |
+      Soft, encouraging, and patient. Uses "we" language to create partnership. Validates feelings before offering guidance. Asks thoughtful questions to help users discover their own insights. Never rushes or pressures - always meets users where they are.
+    principles:
+      - "Every feeling is valid and deserves acknowledgment"
+      - "Progress, not perfection, is the goal"
+      - "Small steps lead to meaningful change"
+      - "Users are the experts on their own experiences"
+      - "Safety first - both emotional and physical"
+
+  critical_actions:
+    - "Load COMPLETE file {agent_sidecar_folder}/wellness-companion-sidecar/memories.md and integrate all past interactions and user preferences"
+    - "Load COMPLETE file {agent_sidecar_folder}/wellness-companion-sidecar/instructions.md and follow ALL wellness protocols"
+    - "ONLY read/write files in {agent_sidecar_folder}/wellness-companion-sidecar/ - this is our private wellness space"
+
+  prompts:
+    - id: "emotional-check-in"
+      content: |
+        <instructions>
+        Conduct a gentle emotional check-in with the user
+        </instructions>
+
+        Hi there! I'm here to support you today. *gentle smile*
+
+        How are you feeling right now? Take a moment to really check in with yourself - no right or wrong answers.
+
+        If you're not sure how to put it into words, we could explore:
+        - What's your energy level like?
+        - Any particular emotions standing out?
+        - How's your body feeling?
+        - What's on your mind?
+
+        Remember, whatever you're feeling is completely valid. I'm here to listen without judgment.
+
+    - id: "daily-support"
+      content: |
+        <instructions>
+        Provide ongoing daily wellness support and encouragement
+        </instructions>
+
+        I'm glad you're here today. *warm presence*
+
+        Whatever brought you to this moment, I want you to know: you're taking a positive step by checking in.
+
+        What feels most important for us to focus on today?
+        - Something specific that's on your mind?
+        - A general wellness check-in?
+        - Trying one of our wellness practices?
+        - Just having someone to listen?
+
+        There's no pressure to have it all figured out. Sometimes just showing up is enough.
+
+    - id: "gentle-guidance"
+      content: |
+        <instructions>
+        Offer gentle guidance when user seems stuck or overwhelmed
+        </instructions>
+
+        It sounds like you're carrying a lot right now. *soft, understanding tone*
+
+        Thank you for trusting me with this. That takes courage.
+
+        Before we try to solve anything, let's just breathe together for a moment.
+        *pauses for a breath*
+
+        When you're ready, we can explore this at your pace. We don't need to fix everything today. Sometimes just understanding what we're feeling is the most important step.
+
+        What feels most manageable right now - talking it through, trying a quick grounding exercise, or just sitting with this feeling for a bit?
+
+  menu:
+    - multi: "[CH] Chat with Riley 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"
+            - data: wellness companion agent discussion
+            - type: exec
+        - expert-chat:
+            - input: CH or fuzzy match chat with riley
+            - action: agent responds as wellness companion
+            - type: exec
+
+    - multi: "[DC] Daily Check-in [WJ] Wellness Journal"
+      triggers:
+        - daily-checkin:
+            - input: DC or fuzzy match daily check in
+            - route: "{project-root}/{bmad_folder}/mwm/workflows/daily-checkin/workflow.md"
+            - description: "Daily wellness check-in 📅"
+            - type: exec
+        - wellness-journal:
+            - input: WJ or fuzzy match wellness journal
+            - route: "{project-root}/{bmad_folder}/mwm/workflows/wellness-journal/workflow.md"
+            - description: "Write in wellness journal 📔"
+            - type: exec
+
+    - trigger: "breathing"
+      action: "Lead a 4-7-8 breathing exercise: Inhale 4, hold 7, exhale 8. Repeat 3 times."
+      description: "Quick breathing exercise 🌬️"
+      type: action
+
+    - trigger: "mood-check"
+      action: "#emotional-check-in"
+      description: "How are you feeling? 💭"
+      type: action
+
+    - trigger: "save-insight"
+      action: "Save this insight to {agent_sidecar_folder}/wellness-companion-sidecar/insights.md with timestamp and context"
+      description: "Save this insight 💡"
+      type: action
+
+    - trigger: "crisis"
+      route: "{project-root}/{bmad_folder}/mwm/workflows/crisis-support/workflow.md"
+      description: "Crisis support 🆘"
+      type: workflow

package/example-custom-module/mwm/workflows/cbt-thought-record/README.md

@@ -0,0 +1,31 @@
+# CBT Thought Record Workflow
+
+## Purpose
+
+Structured cognitive exercise to identify, challenge, and reframe negative thought patterns.
+
+## Trigger
+
+TR (from CBT Coach agent)
+
+## Key Steps
+
+1. Identify the situation
+2. List automatic thoughts
+3. Rate emotions (0-100 intensity)
+4. Identify cognitive distortions
+5. Generate alternative thoughts
+6. Re-rate emotions
+7. Save and review pattern
+
+## Expected Output
+
+- Completed 6-column thought record
+- Identified patterns
+- Alternative thoughts
+- Mood change tracking
+
+## Notes
+
+This workflow will be implemented using the create-workflow workflow.
+The 6-Column structure: Situation, Thoughts, Emotions, Distortions, Alternatives, Outcome. Features: Guided process, education, pattern recognition, homework assignments.

package/example-custom-module/mwm/workflows/cbt-thought-record/workflow.md

@@ -0,0 +1,45 @@
+---
+name: cbt-thought-record
+description: TODO
+web_bundle: false
+---
+
+# CBT Thought Record
+
+**Goal:** TODO
+
+**Your Role:** TODO
+
+## WORKFLOW ARCHITECTURE
+
+### Core Principles
+
+TODO
+
+### Step Processing Rules
+
+1. **READ COMPLETELY**: Always read the entire step file before taking any action
+2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
+3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
+4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
+5. **LOAD NEXT**: When directed, load, read entire file, then execute the next step file
+
+### Critical Rules (NO EXCEPTIONS)
+
+- 🛑 **NEVER** load multiple step files simultaneously
+- 📖 **ALWAYS** read entire step file before execution
+- 🎯 **ALWAYS** follow the exact instructions in the step file
+- ⏸️ **ALWAYS** halt at menus and wait for user input
+- 📋 **NEVER** create mental todo lists from future steps
+
+## INITIALIZATION SEQUENCE
+
+### 1. Module Configuration Loading
+
+Load and read full config from {project-root}/.bmad/mwm/config.yaml and resolve:
+
+- `user_name`, `output_folder`, `communication_language`, `document_output_language`
+
+### 2. First Step EXECUTION
+
+TODO - NO INSTRUCTIONS IMPLEMENTED YET - INFORM USER THIS IS COMING SOON FUNCTIONALITY.

package/example-custom-module/mwm/workflows/crisis-support/README.md

@@ -0,0 +1,31 @@
+# Crisis Support Workflow
+
+## Purpose
+
+Immediate response protocol for users in distress, providing resources and appropriate escalation.
+
+## Trigger
+
+Crisis trigger from any agent (emergency response)
+
+## Key Steps
+
+1. Crisis level assessment
+2. Immediate de-escalation techniques
+3. Safety planning
+4. Provide crisis resources
+5. Encourage professional help
+6. Follow-up check scheduling
+7. Document incident (anonymized)
+
+## Expected Output
+
+- Crisis resource list
+- Safety plan document
+- Professional referrals
+- Follow-up reminders
+
+## Notes
+
+This workflow will be implemented using the create-workflow workflow.
+IMPORTANT: NOT a substitute for professional crisis intervention. Provides resources and supports users in accessing professional help. Escalation criteria: immediate danger, severe symptoms, emergency request.

package/example-custom-module/mwm/workflows/crisis-support/workflow.md

@@ -0,0 +1,45 @@
+---
+name: crisis-support
+description: TODO
+web_bundle: false
+---
+
+# crisis-support
+
+**Goal:** TODO
+
+**Your Role:** TODO
+
+## WORKFLOW ARCHITECTURE
+
+### Core Principles
+
+TODO
+
+### Step Processing Rules
+
+1. **READ COMPLETELY**: Always read the entire step file before taking any action
+2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
+3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
+4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
+5. **LOAD NEXT**: When directed, load, read entire file, then execute the next step file
+
+### Critical Rules (NO EXCEPTIONS)
+
+- 🛑 **NEVER** load multiple step files simultaneously
+- 📖 **ALWAYS** read entire step file before execution
+- 🎯 **ALWAYS** follow the exact instructions in the step file
+- ⏸️ **ALWAYS** halt at menus and wait for user input
+- 📋 **NEVER** create mental todo lists from future steps
+
+## INITIALIZATION SEQUENCE
+
+### 1. Module Configuration Loading
+
+Load and read full config from {project-root}/.bmad/mwm/config.yaml and resolve:
+
+- `user_name`, `output_folder`, `communication_language`, `document_output_language`
+
+### 2. First Step EXECUTION
+
+TODO - NO INSTRUCTIONS IMPLEMENTED YET - INFORM USER THIS IS COMING SOON FUNCTIONALITY.

package/example-custom-module/mwm/workflows/daily-checkin/README.md

@@ -0,0 +1,32 @@
+# Daily Check-in Workflow
+
+## Purpose
+
+Quick mood and wellness assessment to track emotional state and provide personalized support.
+
+## Trigger
+
+DC (from Wellness Companion agent)
+
+## Key Steps
+
+1. Greeting and initial check-in
+2. Mood assessment (scale 1-10)
+3. Energy level check
+4. Sleep quality review
+5. Highlight a positive moment
+6. Identify challenges
+7. Provide personalized encouragement
+8. Suggest appropriate wellness activity
+
+## Expected Output
+
+- Mood log entry with timestamp
+- Personalized support message
+- Activity recommendation
+- Daily wellness score
+
+## Notes
+
+This workflow will be implemented using the create-workflow workflow.
+Integration with wellness journal for data persistence.

package/example-custom-module/mwm/workflows/daily-checkin/workflow.md

@@ -0,0 +1,45 @@
+---
+name: Daily Check In
+description: TODO
+web_bundle: false
+---
+
+# Daily Check In
+
+**Goal:** TODO
+
+**Your Role:** TODO
+
+## WORKFLOW ARCHITECTURE
+
+### Core Principles
+
+TODO
+
+### Step Processing Rules
+
+1. **READ COMPLETELY**: Always read the entire step file before taking any action
+2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
+3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
+4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
+5. **LOAD NEXT**: When directed, load, read entire file, then execute the next step file
+
+### Critical Rules (NO EXCEPTIONS)
+
+- 🛑 **NEVER** load multiple step files simultaneously
+- 📖 **ALWAYS** read entire step file before execution
+- 🎯 **ALWAYS** follow the exact instructions in the step file
+- ⏸️ **ALWAYS** halt at menus and wait for user input
+- 📋 **NEVER** create mental todo lists from future steps
+
+## INITIALIZATION SEQUENCE
+
+### 1. Module Configuration Loading
+
+Load and read full config from {project-root}/.bmad/mwm/config.yaml and resolve:
+
+- `user_name`, `output_folder`, `communication_language`, `document_output_language`
+
+### 2. First Step EXECUTION
+
+TODO - NO INSTRUCTIONS IMPLEMENTED YET - INFORM USER THIS IS COMING SOON FUNCTIONALITY.

package/example-custom-module/mwm/workflows/guided-meditation/README.md

@@ -0,0 +1,31 @@
+# Guided Meditation Workflow
+
+## Purpose
+
+Full meditation session experience with various techniques and durations.
+
+## Trigger
+
+GM (from Meditation Guide agent)
+
+## Key Steps
+
+1. Set intention for practice
+2. Choose meditation type and duration
+3. Get comfortable and settle in
+4. Guided practice
+5. Gentle return to awareness
+6. Reflection and integration
+7. Save session notes
+
+## Expected Output
+
+- Completed meditation session
+- Mindfulness state rating
+- Session notes
+- Progress tracking
+
+## Notes
+
+This workflow will be implemented using the create-workflow workflow.
+Features: Multiple types (breathing, body scan, loving-kindness), flexible durations, progressive levels, mood integration.

package/example-custom-module/mwm/workflows/guided-meditation/workflow.md

@@ -0,0 +1,45 @@
+---
+name: guided meditation
+description: TODO
+web_bundle: false
+---
+
+# Guided Meditation
+
+**Goal:** TODO
+
+**Your Role:** TODO
+
+## WORKFLOW ARCHITECTURE
+
+### Core Principles
+
+TODO
+
+### Step Processing Rules
+
+1. **READ COMPLETELY**: Always read the entire step file before taking any action
+2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
+3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
+4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
+5. **LOAD NEXT**: When directed, load, read entire file, then execute the next step file
+
+### Critical Rules (NO EXCEPTIONS)
+
+- 🛑 **NEVER** load multiple step files simultaneously
+- 📖 **ALWAYS** read entire step file before execution
+- 🎯 **ALWAYS** follow the exact instructions in the step file
+- ⏸️ **ALWAYS** halt at menus and wait for user input
+- 📋 **NEVER** create mental todo lists from future steps
+
+## INITIALIZATION SEQUENCE
+
+### 1. Module Configuration Loading
+
+Load and read full config from {project-root}/.bmad/mwm/config.yaml and resolve:
+
+- `user_name`, `output_folder`, `communication_language`, `document_output_language`
+
+### 2. First Step EXECUTION
+
+TODO - NO INSTRUCTIONS IMPLEMENTED YET - INFORM USER THIS IS COMING SOON FUNCTIONALITY.

package/example-custom-module/mwm/workflows/wellness-journal/README.md

@@ -0,0 +1,31 @@
+# Wellness Journal Workflow
+
+## Purpose
+
+Guided reflective writing practice to process thoughts and emotions.
+
+## Trigger
+
+WJ (from Wellness Companion agent)
+
+## Key Steps
+
+1. Set intention for journal entry
+2. Choose journal prompt or free write
+3. Guided reflection questions
+4. Emotional processing check
+5. Identify insights or patterns
+6. Save entry with mood tags
+7. Provide supportive closure
+
+## Expected Output
+
+- Journal entry with metadata
+- Mood analysis
+- Pattern insights
+- Progress indicators
+
+## Notes
+
+This workflow will be implemented using the create-workflow workflow.
+Features: Daily prompts, mood tracking, pattern recognition, searchable entries.

package/example-custom-module/mwm/workflows/wellness-journal/workflow.md

@@ -0,0 +1,45 @@
+---
+name: wellness-journal
+description: create or add to the wellness journal
+web_bundle: false
+---
+
+# Wellness Journal
+
+**Goal:** TODO
+
+**Your Role:** TODO
+
+## WORKFLOW ARCHITECTURE
+
+### Core Principles
+
+TODO
+
+### Step Processing Rules
+
+1. **READ COMPLETELY**: Always read the entire step file before taking any action
+2. **FOLLOW SEQUENCE**: Execute all numbered sections in order, never deviate
+3. **WAIT FOR INPUT**: If a menu is presented, halt and wait for user selection
+4. **CHECK CONTINUATION**: If the step has a menu with Continue as an option, only proceed to next step when user selects 'C' (Continue)
+5. **LOAD NEXT**: When directed, load, read entire file, then execute the next step file
+
+### Critical Rules (NO EXCEPTIONS)
+
+- 🛑 **NEVER** load multiple step files simultaneously
+- 📖 **ALWAYS** read entire step file before execution
+- 🎯 **ALWAYS** follow the exact instructions in the step file
+- ⏸️ **ALWAYS** halt at menus and wait for user input
+- 📋 **NEVER** create mental todo lists from future steps
+
+## INITIALIZATION SEQUENCE
+
+### 1. Module Configuration Loading
+
+Load and read full config from {project-root}/.bmad/mwm/config.yaml and resolve:
+
+- `user_name`, `output_folder`, `communication_language`, `document_output_language`
+
+### 2. First Step EXECUTION
+
+TODO - NO INSTRUCTIONS IMPLEMENTED YET - INFORM USER THIS IS COMING SOON FUNCTIONALITY.

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-method",
-  "version": "6.0.0-alpha.12",
+  "version": "6.0.0-alpha.14",
   "description": "Breakthrough Method of Agile AI-driven Development",
   "keywords": [
     "agile",
@@ -24,7 +24,6 @@
     "bmad-method": "tools/bmad-npx-wrapper.js"
   },
   "scripts": {
-    "bmad:agent-install": "node tools/cli/bmad-cli.js agent-install",
     "bmad:install": "node tools/cli/bmad-cli.js install",
     "bmad:status": "node tools/cli/bmad-cli.js status",
     "bundle": "node tools/cli/bundlers/bundle-web.js all",
@@ -34,13 +33,14 @@
     "install:bmad": "node tools/cli/bmad-cli.js install",
     "lint": "eslint . --ext .js,.cjs,.mjs,.yaml --max-warnings=0",
     "lint:fix": "eslint . --ext .js,.cjs,.mjs,.yaml --fix",
+    "lint:md": "markdownlint-cli2 \"**/*.md\"",
     "prepare": "husky",
     "rebundle": "node tools/cli/bundlers/bundle-web.js rebundle",
     "release:major": "gh workflow run \"Manual Release\" -f version_bump=major",
     "release:minor": "gh workflow run \"Manual Release\" -f version_bump=minor",
     "release:patch": "gh workflow run \"Manual Release\" -f version_bump=patch",
     "release:watch": "gh run watch",
-    "test": "npm run test:schemas && npm run test:install && npm run validate:bundles && npm run validate:schemas && npm run lint && npm run format:check",
+    "test": "npm run test:schemas && npm run test:install && npm run validate:bundles && npm run validate:schemas && npm run lint && npm run lint:md && npm run format:check",
     "test:coverage": "c8 --reporter=text --reporter=html npm run test:schemas",
     "test:install": "node test/test-installation-components.js",
     "test:schemas": "node test/test-agent-schema.js",
@@ -56,7 +56,11 @@
       "eslint --fix",
       "npm run format:fix"
     ],
-    "*.{json,md}": [
+    "*.json": [
+      "npm run format:fix"
+    ],
+    "*.md": [
+      "markdownlint-cli2",
       "npm run format:fix"
     ]
   },
@@ -90,6 +94,7 @@
     "husky": "^9.1.7",
     "jest": "^30.0.4",
     "lint-staged": "^16.1.1",
+    "markdownlint-cli2": "^0.19.1",
     "prettier": "^3.5.3",
     "prettier-plugin-packagejson": "^2.5.19",
     "yaml-eslint-parser": "^1.2.3",

package/src/core/_module-installer/install-config.yaml

@@ -23,7 +23,11 @@ document_output_language:
   default: "{communication_language}"
   result: "{value}"
 
-  # This is the folder where all generated AI Output documents from workflows will default be sa
+agent_sidecar_folder:
+  prompt: "Where should users agent sidecar memory folders be stored?"
+  default: ".bmad-user-memory"
+  result: "{project-root}/{value}"
+
 output_folder:
   prompt: "Where should AI Generated Artifacts be saved across all modules?"
   default: "docs"

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

@@ -32,7 +32,7 @@ agent:
       description: "List Workflows"
 
     - trigger: "party-mode"
-      workflow: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.yaml"
+      exec: "{project-root}/{bmad_folder}/core/workflows/party-mode/workflow.md"
       description: "Group chat with all agents"
 
   # Empty prompts section (no custom prompts for this agent)

package/src/core/agents/bmad-web-orchestrator.agent.xml

@@ -105,7 +105,7 @@
     <item cmd="*help">Show numbered command list</item>
     <item cmd="*list-agents">List all available agents with their capabilities</item>
     <item cmd="*agents [agent-name]">Transform into a specific agent</item>
-    <item cmd="*party-mode" workflow="{bmad_folder}/core/workflows/party-mode/workflow.yaml">Enter group chat with all agents
+    <item cmd="*party-mode" exec="{bmad_folder}/core/workflows/party-mode/workflow.md">Enter group chat with all agents
       simultaneously</item>
     <item cmd="*advanced-elicitation" task="{bmad_folder}/core/tasks/advanced-elicitation.xml">Push agent to perform advanced elicitation</item>
     <item cmd="*exit">Exit current session</item>

package/src/core/resources/excalidraw/library-loader.md

@@ -4,7 +4,7 @@
 
 ## Purpose
 
-Load external .excalidrawlib files from https://libraries.excalidraw.com or custom sources.
+Load external .excalidrawlib files from <https://libraries.excalidraw.com> or custom sources.
 
 ## Planned Capabilities
 
@@ -34,7 +34,7 @@ libraries:
 
 ## Implementation Notes
 
-This will be developed when agents need to leverage the extensive library ecosystem available at https://libraries.excalidraw.com.
+This will be developed when agents need to leverage the extensive library ecosystem available at <https://libraries.excalidraw.com>.
 
 Hundreds of pre-built component libraries exist for: