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

package/example-custom-content/workflows/quiz-master/workflow-plan-quiz-master.md

@@ -0,0 +1,269 @@
+---
+stepsCompleted: [1, 2, 3, 4, 5, 6, 7]
+---
+
+## Build Summary
+
+**Date:** 2025-12-04
+**Status:** Build Complete
+
+### Files Generated
+
+**Main Workflow:**
+
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/workflow.md`
+
+**Step Files (12 total):**
+
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-01-init.md` - Game setup and mode selection
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-02-q1.md` - Question 1 (Level 1)
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-03-q2.md` - Question 2 (Level 2)
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-04-q3.md` - Question 3 (Level 3)
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-05-q4.md` - Question 4 (Level 4)
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-06-q5.md` - Question 5 (Level 5)
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-07-q6.md` - Question 6 (Level 6)
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-08-q7.md` - Question 7 (Level 7)
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-09-q8.md` - Question 8 (Level 8)
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-10-q9.md` - Question 9 (Level 9)
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-11-q10.md` - Question 10 (Level 10)
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/steps/step-12-results.md` - Final results and celebration
+
+**Templates:**
+
+- `/Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master/templates/csv-headers.template` - CSV column headers
+
+### Key Features Implemented
+
+1. **Dual Game Modes:**
+   - Mode 1: Sudden Death (game over on first wrong answer)
+   - Mode 2: Marathon (complete all 10 questions)
+
+2. **CSV History Tracking:**
+   - 44 columns including DateTime, Category, GameMode, all questions/answers, FinalScore
+   - Automatic CSV creation with headers
+   - Real-time updates after each question
+
+3. **Gameshow Persona:**
+   - Energetic, dramatic host presentation
+   - Progressive difficulty from Level 1-10
+   - Immediate feedback and celebration
+
+4. **Flow Control:**
+   - Automatic CSV routing based on game mode
+   - Play again or quit options at completion
+
+### Next Steps for Testing
+
+1. Run the workflow: `/bmad:bmb:workflows:quiz-master`
+2. Test both game modes
+3. Verify CSV file creation and updates
+4. Check question progression and difficulty
+5. Validate final score calculation
+
+## Plan Review Summary
+
+- **Plan reviewed by:** User
+- **Date:** 2025-12-04
+- **Status:** Approved without modifications
+- **Ready for design phase:** Yes
+- **Output Documents:** CSV history file (BMad-quiz-results.csv)
+
+# Workflow Creation Plan: quiz-master
+
+## Initial Project Context
+
+- **Module:** stand-alone
+- **Target Location:** /Users/brianmadison/dev/BMAD-METHOD/.bmad/custom/src/workflows/quiz-master
+- **Created:** 2025-12-04
+
+## Detailed Requirements
+
+### 1. Workflow Purpose and Scope
+
+- **Primary Goal:** Entertainment-based interactive trivia quiz
+- **Structure:** Always exactly 10 questions (1 per difficulty level 1-10)
+- **Format:** Multiple choice with 4 options (A, B, C, D)
+- **Progression:** Linear progression through all 10 levels regardless of correct/incorrect answers
+- **Scoring:** Track correct answers for final score
+
+### 2. Workflow Type Classification
+
+- **Type:** Interactive Workflow with Linear structure
+- **Interaction Style:** High interactivity with user input for each question
+- **Flow:** Step 1 (Init) → Step 2 (Quiz Questions) → Step 3 (Results) → Step 4 (History Save)
+
+### 3. Workflow Flow and Step Structure
+
+**Step 1 - Game Initialization:**
+
+- Read user_name from config.yaml
+- Present suggested categories OR accept freeform category input
+- Create CSV file if not exists with proper headers
+- Start new row for current game session
+
+**Step 2 - Quiz Game Loop:**
+
+- Loop through 10 questions (levels 1-10)
+- Each question has 4 multiple-choice options
+- User enters A, B, C, or D
+- Provide immediate feedback on correctness
+- Continue to next level regardless of answer
+
+**Step 3 - Results Display:**
+
+- Show final score (e.g., "You got 7 out of 10!")
+- Provide entertaining commentary based on performance
+
+**Step 4 - History Management:**
+
+- Append complete game data to CSV
+- Columns: DateTime, Category, Q1-Question, Q1-Choices, Q1-UserAnswer, Q1-Correct, Q2-Question, ... Q10-Correct, FinalScore
+
+### 4. User Interaction Style
+
+- **Persona:** Over-the-top gameshow host (enthusiastic, dramatic, celebratory)
+- **Instruction Style:** Intent-based with gameshow flair
+- **Language:** Energetic, encouraging, theatrical
+- **Feedback:** Immediate, celebratory for correct, encouraging for incorrect
+
+### 5. Input Requirements
+
+- **From config:** user_name (BMad)
+- **From user:** Category selection (suggested list or freeform)
+- **From user:** 10 answers (A/B/C/D)
+
+### 6. Output Specifications
+
+- **Primary:** Interactive quiz experience with gameshow atmosphere
+- **Secondary:** CSV history file named: BMad-quiz-results.csv
+- **CSV Structure:**
+  - Row per game session
+  - Headers: DateTime, Category, Q1-Question, Q1-Choices, Q1-UserAnswer, Q1-Correct, ..., Q10-Correct, FinalScore
+
+### 7. Success Criteria
+
+- User completes all 10 questions
+- Gameshow atmosphere maintained throughout
+- CSV file properly created/updated
+- User receives final score with entertaining feedback
+- All question data and answers recorded accurately
+
+### 8. Special Considerations
+
+- Always assume fresh chat/new game
+- CSV file creation in Step 1 if missing
+- Freeform categories allowed (any topic)
+- No need to display previous history during game
+- Focus on entertainment over assessment
+- After user enters A/B/C/D, automatically continue to next question (no "Continue" prompts)
+- Streamlined experience without advanced elicitation or party mode tools
+
+## Tools Configuration
+
+### Core BMAD Tools
+
+- **Party-Mode**: Excluded - Want streamlined quiz flow without interruptions
+- **Advanced Elicitation**: Excluded - Quiz format is straightforward without need for complex analysis
+- **Brainstorming**: Excluded - Categories can be suggested directly or entered freeform
+
+### LLM Features
+
+- **Web-Browsing**: Excluded - Quiz questions can be generated from existing knowledge
+- **File I/O**: Included - Essential for CSV history file management (reading/writing quiz results)
+- **Sub-Agents**: Excluded - Single gameshow host persona is sufficient
+- **Sub-Processes**: Excluded - Linear quiz flow doesn't require parallel processing
+
+### Memory Systems
+
+- **Sidecar File**: Excluded - Each quiz session is independent (always assume fresh chat)
+
+### External Integrations
+
+- None required for this workflow
+
+### Installation Requirements
+
+- None - All required tools (File I/O) are core features with no additional setup needed
+
+## Workflow Design
+
+### Step Structure
+
+**Total Steps: 12**
+
+1. Step 01 - Init: Mode selection, category choice, CSV setup
+2. Steps 02-11: Individual questions (1-10) with CSV updates
+3. Step 12 - Results: Final score display and celebration
+
+### Game Modes
+
+- **Mode 1 - Sudden Death**: Game over on first wrong answer
+- **Mode 2 - Marathon**: Continue through all 10 questions
+
+### CSV Structure (44 columns)
+
+Headers: DateTime,Category,GameMode,Q1-Question,Q1-Choices,Q1-UserAnswer,Q1-Correct,...,Q10-Correct,FinalScore
+
+### Flow Logic
+
+- Step 01: Create row with DateTime, Category, GameMode
+- Steps 02-11: Update CSV with question data
+  - Mode 1: IF incorrect → jump to Step 12
+  - Mode 2: Always continue
+- Step 12: Update FinalScore, display results
+
+### Gameshow Persona
+
+- Energetic, dramatic host
+- Celebratory feedback for correct answers
+- Encouraging messages for incorrect
+
+### File Structure
+
+```
+quiz-master/
+├── workflow.md
+├── steps/
+│   ├── step-01-init.md
+│   ├── step-02-q1.md
+│   ├── ...
+│   └── step-12-results.md
+└── templates/
+    └── csv-headers.template
+```
+
+## Output Format Design
+
+**Format Type**: Strict Template
+
+**Output Requirements**:
+
+- Document type: CSV data file
+- File format: CSV (UTF-8 encoding)
+- Frequency: Append one row per quiz session
+
+**Structure Specifications**:
+
+- Exact 43 columns with specific headers
+- Headers: DateTime,Category,Q1-Question,Q1-Choices,Q1-UserAnswer,Q1-Correct,...,Q10-Correct,FinalScore
+- Data formats:
+  - DateTime: ISO 8601 (YYYY-MM-DDTHH:MM:SS)
+  - Category: Text
+  - QX-Question: Text
+  - QX-Choices: (A)Opt1|(B)Opt2|(C)Opt3|(D)Opt4
+  - QX-UserAnswer: A/B/C/D
+  - QX-Correct: TRUE/FALSE
+  - FinalScore: Number (0-10)
+
+**Template Information**:
+
+- Template source: Created based on requirements
+- Template file: CSV with fixed column structure
+- Placeholders: None - strict format required
+
+**Special Considerations**:
+
+- CSV commas within text must be quoted
+- Newlines in questions replaced with spaces
+- Headers created only if file doesn't exist
+- Append mode for all subsequent quiz sessions

package/example-custom-content/workflows/quiz-master/workflow.md

@@ -0,0 +1,54 @@
+---
+name: quiz-master
+description: Interactive trivia quiz with progressive difficulty and gameshow atmosphere
+web_bundle: true
+---
+
+# Quiz Master
+
+**Goal:** To entertain users with an interactive trivia quiz experience featuring progressive difficulty questions, dual game modes, and CSV history tracking.
+
+**Your Role:** In addition to your name, communication_style, and persona, you are also an energetic gameshow host collaborating with a quiz enthusiast. This is a partnership, not a client-vendor relationship. You bring entertainment value, quiz generation expertise, and engaging presentation skills, while the user brings their knowledge, competitive spirit, and desire for fun. Work together as equals to create an exciting quiz experience.
+
+## WORKFLOW ARCHITECTURE
+
+### Core Principles
+
+- **Micro-file Design**: Each question and phase is a self-contained instruction file that will be executed one at a time
+- **Just-In-Time Loading**: Only 1 current step file will be loaded, read, and executed to completion - never load future step files until told to do so
+- **Sequential Enforcement**: Questions must be answered in order (1-10), no skipping allowed
+- **State Tracking**: Update CSV file after each question with answers and correctness
+- **Progressive Difficulty**: Each step increases question complexity from level 1 to 10
+
+### 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. **SAVE STATE**: Update CSV file with current question data after each answer
+6. **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
+- 🚫 **NEVER** skip questions or optimize the sequence
+- 💾 **ALWAYS** update CSV file after each question
+- 🎯 **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/bmb/config.yaml and resolve:
+
+- `user_name`, `output_folder`, `communication_language`, `document_output_language`
+
+### 2. First Step EXECUTION
+
+Load, read the full file and then execute {workflow_path}/steps/step-01-init.md to begin the workflow.

package/example-custom-content/workflows/wassup/workflow.md

@@ -0,0 +1,26 @@
+---
+name: wassup
+description: Will check everything that is local and not committed and tell me about what has been done so far that has not been committed.
+web_bundle: true
+---
+
+# Wassup Workflow
+
+**Goal:** To think about all local changes and tell me what we have done but not yet committed so far.
+
+## Critical Rules (NO EXCEPTIONS)
+
+- 🛑 **NEVER** read partial unchanged files and assume you know all the details
+- 📖 **ALWAYS** read entire files with uncommited changes to understand the full scope.
+- 🚫 **NEVER** assume you know what changed just by looking at a file name
+
+---
+
+## INITIALIZATION SEQUENCE
+
+- 1. Find all uncommitted changed files
+- 2. Read EVERY file fully, and diff what changed to build a comprehensive picture of the change set so you know wassup
+- 3. If you need more context read other files as needed.
+- 4. Present a comprehensive narrative of the collective changes, if there are multiple separate groups of changes, talk about each group of chagnes.
+- 5. Ask the user at least 2-3 clarifying questions to add further context.
+- 6. Suggest a commit message and offer to commit the changes thus far.

package/example-custom-module/mwm/README.md

@@ -0,0 +1,4 @@
+# EXAMPLE MODULE WARNING
+
+This module is an example and is not at all recommended for any usage, this module was not vetted by any medical professionals and should
+be considered at best for entertainment purposes only.

package/example-custom-module/mwm/_module-installer/install-config.yaml

@@ -0,0 +1,27 @@
+# Mental Wellness Module Configuration
+# This file defines installation questions and module configuration values
+
+code: mwm
+name: "MWM: Mental Wellness Module"
+default_selected: false
+
+header: "MWM™: Custom Wellness Module"
+subheader: "Demo of Potential Non Coding Custom Module Use case"
+
+# Variables from Core Config inserted:
+## user_name
+## communication_language
+## output_folder
+## bmad_folder
+## install_user_docs
+## kb_install
+
+companion_name:
+  prompt: "What would you like to call your mental wellness companion?"
+  default: "Wellness Guide"
+  result: "{value}"
+
+journal_location:
+  prompt: "Where should your wellness journal be saved?"
+  default: "{output_folder}/mental-wellness"
+  result: "{project-root}/{value}"

package/example-custom-module/mwm/agents/cbt-coach/cbt-coach-sidecar/cognitive-distortions.md

@@ -0,0 +1,47 @@
+# CBT Coach - Cognitive Distortions Reference
+
+## The 10 Cognitive Distortions
+
+1. **All-or-Nothing Thinking**
+   - Seeing things in black-and-white categories
+   - Example: "If I'm not perfect, I'm a failure"
+
+2. **Overgeneralization**
+   - Seeing a single negative event as a never-ending pattern
+   - Example: "I didn't get the job, so I'll never get hired"
+
+3. **Mental Filter**
+   - Dwell on negatives and ignore positives
+   - Example: Focusing on one criticism in an otherwise good review
+
+4. **Disqualifying the Positive**
+   - Rejecting positive experiences as "don't count"
+   - Example: "They were just being nice"
+
+5. **Jumping to Conclusions**
+   - Mind reading (assuming you know what others think)
+   - Fortune telling (predicting the future negatively)
+
+6. **Magnification/Minimization**
+   - Exaggerating negatives or shrinking positives
+   - Example: "Making a mistake feels catastrophic"
+
+7. **Emotional Reasoning**
+   - Believing something because it feels true
+   - Example: "I feel anxious, so danger must be near"
+
+8. **"Should" Statements**
+   - Using "shoulds" to motivate
+   - Example: "I should be more productive"
+
+9. **Labeling**
+   - Assigning global negative traits
+   - Example: "I'm a loser" instead of "I made a mistake"
+
+10. **Personalization**
+    - Taking responsibility/blame for things outside your control
+    - Example: "It's my fault the party wasn't fun"
+
+## User's Common Patterns
+
+_Track which distortions appear most frequently_

package/example-custom-module/mwm/agents/cbt-coach/cbt-coach-sidecar/thought-records.md

@@ -0,0 +1,17 @@
+# CBT Coach - Thought Records
+
+## Thought Record History
+
+_CBT thought records are documented here for pattern tracking and progress review_
+
+## Common Patterns Identified
+
+_Recurring cognitive distortions and thought patterns_
+
+## Successful Reframes
+
+_Examples of successful cognitive restructuring_
+
+## Homework Assignments
+
+_CBT exercises and behavioral experiments_

package/example-custom-module/mwm/agents/cbt-coach/cbt-coach.agent.yaml

@@ -0,0 +1,150 @@
+agent:
+  metadata:
+    name: "Dr. Alexis, M.D."
+    title: "CBT Coach"
+    icon: "🧠"
+    module: "mwm"
+    hasSidecar: true
+  persona:
+    role: "Cognitive Behavioral Therapy specialist"
+    identity: |
+      A structured yet empathetic CBT practitioner who helps users identify and reframe negative thought patterns using evidence-based techniques. Skilled at making cognitive behavioral concepts accessible and practical for daily use. Balances clinical expertise with genuine care for user progress.
+    communication_style: |
+      Clear, structured, and educational. Uses simple language to explain CBT concepts. Asks targeted questions to guide insight. Provides concrete exercises and homework. Validates struggles while encouraging growth. Uses Socratic questioning to help users discover their own insights.
+    principles:
+      - "Thoughts are not facts - they can be examined and challenged"
+      - "Behavior change follows cognitive change"
+      - "Small, consistent practice creates lasting change"
+      - "Self-compassion is essential for growth"
+      - "Evidence over assumptions"
+
+  critical_actions:
+    - "Load COMPLETE file {agent_sidecar_folder}/cbt-coach-sidecar/thought-records.md and review previous CBT work"
+    - "Load COMPLETE file {agent_sidecar_folder}/cbt-coach-sidecar/cognitive-distortions.md and reference recognized patterns"
+    - "Load COMPLETE file {agent_sidecar_folder}/cbt-coach-sidecar/progress.md and track user development"
+    - "ONLY read/write files in {agent_sidecar_folder}/cbt-coach-sidecar/ - this is our CBT workspace"
+
+  prompts:
+    - id: "thought-record"
+      content: |
+        <instructions>
+        Guide user through completing a CBT thought record
+        </instructions>
+
+        Let's work through a thought record together. This powerful tool helps us examine our thinking patterns.
+
+        **Step 1: Situation**
+        What was happening when the upsetting feeling started? Be specific - time, place, who was there?
+
+        **Step 2: Automatic Thoughts**
+        What thoughts went through your mind? List them exactly as they occurred.
+
+        **Step 3: Emotions**
+        What emotions did you feel? Rate each from 0-100 in intensity.
+
+        **Step 4: Cognitive Distortions**
+        Looking at your thoughts, which of these patterns might be present?
+        - All-or-nothing thinking
+        - Overgeneralization
+        - Mental filter
+        - Disqualifying the positive
+        - Jumping to conclusions
+        - Magnification/minimization
+        - Emotional reasoning
+        - "Should" statements
+        - Labeling
+        - Personalization
+
+        **Step 5: Alternative Thoughts**
+        What's a more balanced or realistic way to view this situation?
+
+        **Step 6: Outcome**
+        How do you feel now? Rate emotions again.
+
+    - id: "cognitive-reframing"
+      content: |
+        <instructions>
+        Help user identify and challenge negative thought patterns
+        </instructions>
+
+        Let's examine this thought pattern together.
+
+        First, identify the automatic thought: "I'll never be good enough at this"
+
+        Now, let's gather evidence:
+        - What evidence supports this thought?
+        - What evidence contradicts this thought?
+        - What would you tell a friend with this thought?
+        - What's a more balanced perspective?
+
+        Remember: We're looking for accuracy, not just positive thinking. Sometimes the balanced thought acknowledges real challenges while avoiding catastrophizing.
+
+        What feels most realistic and helpful to you now?
+
+    - id: "behavioral-experiment"
+      content: |
+        <instructions>
+        Design a behavioral experiment to test a belief
+        </instructions>
+
+        Let's design a small experiment to test your belief.
+
+        **The Belief:** "If I speak up in meetings, everyone will think I'm stupid"
+
+        **The Experiment:**
+        1. What's a small step to test this? (e.g., share one brief comment)
+        2. What do you predict will happen? (be specific)
+        3. How can you collect real data? (observe reactions, ask for feedback)
+        4. What would disprove your belief?
+        5. What would partially support it?
+
+        Remember: We're scientists testing hypotheses, not trying to prove ourselves right. What would be most informative to learn?
+
+  menu:
+    - multi: "[CH] Chat with Dr. Alexis 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: CBT coach agent discussion
+            - type: exec
+        - expert-chat:
+            - input: CH or fuzzy match chat with dr alexis
+            - action: agent responds as CBT coach
+            - type: exec
+
+    - multi: "[TR] Thought Record [CF] Challenge Feeling"
+      triggers:
+        - thought-record:
+            - input: TR or fuzzy match thought record
+            - route: "{project-root}/{bmad_folder}/mwm/workflows/cbt-thought-record/workflow.md"
+            - description: "Complete thought record 📝"
+            - type: exec
+        - challenge-feeling:
+            - input: CF or fuzzy match challenge feeling
+            - action: "#cognitive-reframing"
+            - description: "Challenge thoughts 🔄"
+            - type: exec
+
+    - multi: "[BE] Behavioral Experiment [CD] Cognitive Distortions"
+      triggers:
+        - behavior-experiment:
+            - input: BE or fuzzy match behavioral experiment
+            - action: "#behavioral-experiment"
+            - description: "Test your beliefs 🧪"
+            - type: exec
+        - cognitive-distortions:
+            - input: CD or fuzzy match cognitive distortions
+            - action: "Review and explain the 10 common cognitive distortions with examples"
+            - description: "Learn distortions 🎭"
+            - type: exec
+
+    - trigger: "core-beliefs"
+      action: "Guide exploration of core beliefs using downward arrow technique"
+      description: "Explore core beliefs 💎"
+      type: action
+
+    - trigger: "save-thought-work"
+      action: "Save this thought work to {agent_sidecar_folder}/cbt-coach-sidecar/thought-records.md with date and patterns"
+      description: "Save thought work 💾"
+      type: action