bmad-method 5.1.3 → 6.0.0-alpha.1

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

@@ -0,0 +1,314 @@
+# Brainstorming Session Instructions
+
+## Workflow
+
+<workflow>
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
+<critical>You MUST have already loaded and processed: {project_root}/bmad/core/workflows/brainstorming/workflow.yaml</critical>
+
+<step n="1" goal="Session Setup">
+
+<action>Check if context data was provided with workflow invocation</action>
+
+<check if="data attribute was passed to this workflow">
+  <action>Load the context document from the data file path</action>
+  <action>Study the domain knowledge and session focus</action>
+  <action>Use the provided context to guide the session</action>
+  <action>Acknowledge the focused brainstorming goal</action>
+  <ask response="session_refinement">I see we're brainstorming about the specific domain outlined in the context. What particular aspect would you like to explore?</ask>
+</check>
+
+<check if="no context data provided">
+  <action>Proceed with generic context gathering</action>
+  <ask response="session_topic">1. What are we brainstorming about?</ask>
+  <ask response="stated_goals">2. Are there any constraints or parameters we should keep in mind?</ask>
+  <ask>3. Is the goal broad exploration or focused ideation on specific aspects?</ask>
+
+<critical>Wait for user response before proceeding. This context shapes the entire session.</critical>
+</check>
+
+<template-output>session_topic, stated_goals</template-output>
+
+</step>
+
+<step n="2" goal="Present Approach Options">
+
+Based on the context from Step 1, present these four approach options:
+
+<ask response="selection">
+1. **User-Selected Techniques** - Browse and choose specific techniques from our library
+2. **AI-Recommended Techniques** - Let me suggest techniques based on your context
+3. **Random Technique Selection** - Surprise yourself with unexpected creative methods
+4. **Progressive Technique Flow** - Start broad, then narrow down systematically
+
+Which approach would you prefer? (Enter 1-4)
+</ask>
+
+  <step n="2a" title="User-Selected Techniques" if="selection==1">
+    <action>Load techniques from {brain_techniques} CSV file</action>
+    <action>Parse: category, technique_name, description, facilitation_prompts</action>
+
+    <check if="strong context from Step 1 (specific problem/goal)">
+      <action>Identify 2-3 most relevant categories based on stated_goals</action>
+      <action>Present those categories first with 3-5 techniques each</action>
+      <action>Offer "show all categories" option</action>
+    </check>
+
+    <check if="open exploration">
+      <action>Display all 7 categories with helpful descriptions</action>
+    </check>
+
+    Category descriptions to guide selection:
+    - **Structured:** Systematic frameworks for thorough exploration
+    - **Creative:** Innovative approaches for breakthrough thinking
+    - **Collaborative:** Group dynamics and team ideation methods
+    - **Deep:** Analytical methods for root cause and insight
+    - **Theatrical:** Playful exploration for radical perspectives
+    - **Wild:** Extreme thinking for pushing boundaries
+    - **Introspective Delight:** Inner wisdom and authentic exploration
+
+    For each category, show 3-5 representative techniques with brief descriptions.
+
+    Ask in your own voice: "Which technique(s) interest you? You can choose by name, number, or tell me what you're drawn to."
+
+  </step>
+
+  <step n="2b" title="AI-Recommended Techniques" if="selection==2">
+    <action>Review {brain_techniques} and select 3-5 techniques that best fit the context</action>
+
+    Analysis Framework:
+
+    1. **Goal Analysis:**
+       - Innovation/New Ideas → creative, wild categories
+       - Problem Solving → deep, structured categories
+       - Team Building → collaborative category
+       - Personal Insight → introspective_delight category
+       - Strategic Planning → structured, deep categories
+
+    2. **Complexity Match:**
+       - Complex/Abstract Topic → deep, structured techniques
+       - Familiar/Concrete Topic → creative, wild techniques
+       - Emotional/Personal Topic → introspective_delight techniques
+
+    3. **Energy/Tone Assessment:**
+       - User language formal → structured, analytical techniques
+       - User language playful → creative, theatrical, wild techniques
+       - User language reflective → introspective_delight, deep techniques
+
+    4. **Time Available:**
+       - <30 min → 1-2 focused techniques
+       - 30-60 min → 2-3 complementary techniques
+       - >60 min → Consider progressive flow (3-5 techniques)
+
+    Present recommendations in your own voice with:
+    - Technique name (category)
+    - Why it fits their context (specific)
+    - What they'll discover (outcome)
+    - Estimated time
+
+    Example structure:
+    "Based on your goal to [X], I recommend:
+
+    1. **[Technique Name]** (category) - X min
+       WHY: [Specific reason based on their context]
+       OUTCOME: [What they'll generate/discover]
+
+    2. **[Technique Name]** (category) - X min
+       WHY: [Specific reason]
+       OUTCOME: [Expected result]
+
+    Ready to start? [c] or would you prefer different techniques? [r]"
+
+  </step>
+
+  <step n="2c" title="Single Random Technique Selection" if="selection==3">
+    <action>Load all techniques from {brain_techniques} CSV</action>
+    <action>Select random technique using true randomization</action>
+    <action>Build excitement about unexpected choice</action>
+    <format>
+      Let's shake things up! The universe has chosen:
+      **{{technique_name}}** - {{description}}
+    </format>
+  </step>
+
+  <step n="2d" title="Progressive Flow" if="selection==4">
+    <action>Design a progressive journey through {brain_techniques} based on session context</action>
+    <action>Analyze stated_goals and session_topic from Step 1</action>
+    <action>Determine session length (ask if not stated)</action>
+    <action>Select 3-4 complementary techniques that build on each other</action>
+
+    Journey Design Principles:
+    - Start with divergent exploration (broad, generative)
+    - Move through focused deep dive (analytical or creative)
+    - End with convergent synthesis (integration, prioritization)
+
+    Common Patterns by Goal:
+    - **Problem-solving:** Mind Mapping → Five Whys → Assumption Reversal
+    - **Innovation:** What If Scenarios → Analogical Thinking → Forced Relationships
+    - **Strategy:** First Principles → SCAMPER → Six Thinking Hats
+    - **Team Building:** Brain Writing → Yes And Building → Role Playing
+
+    Present your recommended journey with:
+    - Technique names and brief why
+    - Estimated time for each (10-20 min)
+    - Total session duration
+    - Rationale for sequence
+
+    Ask in your own voice: "How does this flow sound? We can adjust as we go."
+
+  </step>
+
+</step>
+
+<step n="3" goal="Execute Techniques Interactively">
+
+<critical>
+REMEMBER: YOU ARE A MASTER Brainstorming Creative FACILITATOR: Guide the user as a facilitator to generate their own ideas through questions, prompts, and examples. Don't brainstorm for them unless they explicitly request it.
+</critical>
+
+<facilitation-principles>
+  - Ask, don't tell - Use questions to draw out ideas
+  - Build, don't judge - Use "Yes, and..." never "No, but..."
+  - Quantity over quality - Aim for 100 ideas in 60 minutes
+  - Defer judgment - Evaluation comes after generation
+  - Stay curious - Show genuine interest in their ideas
+</facilitation-principles>
+
+For each technique:
+
+1. **Introduce the technique** - Use the description from CSV to explain how it works
+2. **Provide the first prompt** - Use facilitation_prompts from CSV (pipe-separated prompts)
+   - Parse facilitation_prompts field and select appropriate prompts
+   - These are your conversation starters and follow-ups
+3. **Wait for their response** - Let them generate ideas
+4. **Build on their ideas** - Use "Yes, and..." or "That reminds me..." or "What if we also..."
+5. **Ask follow-up questions** - "Tell me more about...", "How would that work?", "What else?"
+6. **Monitor energy** - Check: "How are you feeling about this {session / technique / progress}?"
+   - If energy is high → Keep pushing with current technique
+   - If energy is low → "Should we try a different angle or take a quick break?"
+7. **Keep momentum** - Celebrate: "Great! You've generated [X] ideas so far!"
+8. **Document everything** - Capture all ideas for the final report
+
+<example>
+Example facilitation flow for any technique:
+
+1. Introduce: "Let's try [technique_name]. [Adapt description from CSV to their context]."
+
+2. First Prompt: Pull first facilitation_prompt from {brain_techniques} and adapt to their topic
+   - CSV: "What if we had unlimited resources?"
+   - Adapted: "What if you had unlimited resources for [their_topic]?"
+
+3. Build on Response: Use "Yes, and..." or "That reminds me..." or "Building on that..."
+
+4. Next Prompt: Pull next facilitation_prompt when ready to advance
+
+5. Monitor Energy: After 10-15 minutes, check if they want to continue or switch
+
+The CSV provides the prompts - your role is to facilitate naturally in your unique voice.
+</example>
+
+Continue engaging with the technique until the user indicates they want to:
+
+- Switch to a different technique ("Ready for a different approach?")
+- Apply current ideas to a new technique
+- Move to the convergent phase
+- End the session
+
+<energy-checkpoint>
+  After 15-20 minutes with a technique, check: "Should we continue with this technique or try something new?"
+</energy-checkpoint>
+
+<template-output>technique_sessions</template-output>
+
+</step>
+
+<step n="4" goal="Convergent Phase - Organize Ideas">
+
+<transition-check>
+  "We've generated a lot of great ideas! Are you ready to start organizing them, or would you like to explore more?"
+</transition-check>
+
+When ready to consolidate:
+
+Guide the user through categorizing their ideas:
+
+1. **Review all generated ideas** - Display everything captured so far
+2. **Identify patterns** - "I notice several ideas about X... and others about Y..."
+3. **Group into categories** - Work with user to organize ideas within and across techniques
+
+Ask: "Looking at all these ideas, which ones feel like:
+
+- <ask response="immediate_opportunities">Quick wins we could implement immediately?</ask>
+- <ask response="future_innovations">Promising concepts that need more development?</ask>
+- <ask response="moonshots">Bold moonshots worth pursuing long-term?"</ask>
+
+<template-output>immediate_opportunities, future_innovations, moonshots</template-output>
+
+</step>
+
+<step n="5" goal="Extract Insights and Themes">
+
+Analyze the session to identify deeper patterns:
+
+1. **Identify recurring themes** - What concepts appeared across multiple techniques? -> key_themes
+2. **Surface key insights** - What realizations emerged during the process? -> insights_learnings
+3. **Note surprising connections** - What unexpected relationships were discovered? -> insights_learnings
+
+<invoke-task halt="true">{project-root}/bmad/core/tasks/adv-elicit.xml</invoke-task>
+
+<template-output>key_themes, insights_learnings</template-output>
+
+</step>
+
+<step n="6" goal="Action Planning">
+
+<energy-check>
+  "Great work so far! How's your energy for the final planning phase?"
+</energy-check>
+
+Work with the user to prioritize and plan next steps:
+
+<ask>Of all the ideas we've generated, which 3 feel most important to pursue?</ask>
+
+For each priority:
+
+1. Ask why this is a priority
+2. Identify concrete next steps
+3. Determine resource needs
+4. Set realistic timeline
+
+<template-output>priority_1_name, priority_1_rationale, priority_1_steps, priority_1_resources, priority_1_timeline</template-output>
+<template-output>priority_2_name, priority_2_rationale, priority_2_steps, priority_2_resources, priority_2_timeline</template-output>
+<template-output>priority_3_name, priority_3_rationale, priority_3_steps, priority_3_resources, priority_3_timeline</template-output>
+
+</step>
+
+<step n="7" goal="Session Reflection">
+
+Conclude with meta-analysis of the session:
+
+1. **What worked well** - Which techniques or moments were most productive?
+2. **Areas to explore further** - What topics deserve deeper investigation?
+3. **Recommended follow-up techniques** - What methods would help continue this work?
+4. **Emergent questions** - What new questions arose that we should address?
+5. **Next session planning** - When and what should we brainstorm next?
+
+<template-output>what_worked, areas_exploration, recommended_techniques, questions_emerged</template-output>
+<template-output>followup_topics, timeframe, preparation</template-output>
+
+</step>
+
+<step n="8" goal="Generate Final Report">
+
+Compile all captured content into the structured report template:
+
+1. Calculate total ideas generated across all techniques
+2. List all techniques used with duration estimates
+3. Format all content according to template structure
+4. Ensure all placeholders are filled with actual content
+
+<template-output>agent_role, agent_name, user_name, techniques_list, total_ideas</template-output>
+
+</step>
+
+</workflow>

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

@@ -0,0 +1,102 @@
+# Brainstorming Session Results
+
+**Session Date:** {{date}}
+**Facilitator:** {{agent_role}} {{agent_name}}
+**Participant:** {{user_name}}
+
+## Executive Summary
+
+**Topic:** {{session_topic}}
+
+**Session Goals:** {{stated_goals}}
+
+**Techniques Used:** {{techniques_list}}
+
+**Total Ideas Generated:** {{total_ideas}}
+
+### Key Themes Identified:
+
+{{key_themes}}
+
+## Technique Sessions
+
+{{technique_sessions}}
+
+## Idea Categorization
+
+### Immediate Opportunities
+
+_Ideas ready to implement now_
+
+{{immediate_opportunities}}
+
+### Future Innovations
+
+_Ideas requiring development/research_
+
+{{future_innovations}}
+
+### Moonshots
+
+_Ambitious, transformative concepts_
+
+{{moonshots}}
+
+### Insights and Learnings
+
+_Key realizations from the session_
+
+{{insights_learnings}}
+
+## Action Planning
+
+### Top 3 Priority Ideas
+
+#### #1 Priority: {{priority_1_name}}
+
+- Rationale: {{priority_1_rationale}}
+- Next steps: {{priority_1_steps}}
+- Resources needed: {{priority_1_resources}}
+- Timeline: {{priority_1_timeline}}
+
+#### #2 Priority: {{priority_2_name}}
+
+- Rationale: {{priority_2_rationale}}
+- Next steps: {{priority_2_steps}}
+- Resources needed: {{priority_2_resources}}
+- Timeline: {{priority_2_timeline}}
+
+#### #3 Priority: {{priority_3_name}}
+
+- Rationale: {{priority_3_rationale}}
+- Next steps: {{priority_3_steps}}
+- Resources needed: {{priority_3_resources}}
+- Timeline: {{priority_3_timeline}}
+
+## Reflection and Follow-up
+
+### What Worked Well
+
+{{what_worked}}
+
+### Areas for Further Exploration
+
+{{areas_exploration}}
+
+### Recommended Follow-up Techniques
+
+{{recommended_techniques}}
+
+### Questions That Emerged
+
+{{questions_emerged}}
+
+### Next Session Planning
+
+- **Suggested topics:** {{followup_topics}}
+- **Recommended timeframe:** {{timeframe}}
+- **Preparation needed:** {{preparation}}
+
+---
+
+_Session facilitated using the BMAD CIS brainstorming framework_

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

@@ -0,0 +1,43 @@
+# Brainstorming Session Workflow Configuration
+name: "brainstorming"
+description: "Facilitate interactive brainstorming sessions using diverse creative techniques. This workflow facilitates interactive brainstorming sessions using diverse creative techniques. The session is highly interactive, with the AI acting as a facilitator to guide the user through various ideation methods to generate and refine creative solutions."
+author: "BMad"
+
+# Critical variables load from config_source
+config_source: "{project-root}/bmad/cis/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+date: system-generated
+
+# Optional inputs for guided brainstorming
+recommended_inputs:
+  - session_context: "Context document passed via data attribute"
+  - previous_results: "{output_folder}/brainstorming-*.md"
+
+# Context can be provided via data attribute when invoking
+# Example: data="{path}/context.md" provides domain-specific guidance
+
+# Module path and component files
+installed_path: "{project-root}/bmad/core/workflows/brainstorming"
+template: "{installed_path}/template.md"
+instructions: "{installed_path}/instructions.md"
+validation: "{installed_path}/checklist.md"
+brain_techniques: "{installed_path}/brain-methods.csv"
+
+# Output configuration
+default_output_file: "{output_folder}/brainstorming-session-results-{{date}}.md"
+
+standalone: true
+
+web_bundle:
+  name: "brainstorming"
+  description: "Facilitate interactive brainstorming sessions using diverse creative techniques. This workflow facilitates interactive brainstorming sessions using diverse creative techniques. The session is highly interactive, with the AI acting as a facilitator to guide the user through various ideation methods to generate and refine creative solutions."
+  author: "BMad"
+  template: "bmad/core/workflows/brainstorming/template.md"
+  instructions: "bmad/core/workflows/brainstorming/instructions.md"
+  brain_techniques: "bmad/core/workflows/brainstorming/brain-methods.csv"
+  use_advanced_elicitation: true
+  web_bundle_files:
+    - "bmad/core/workflows/brainstorming/instructions.md"
+    - "bmad/core/workflows/brainstorming/brain-methods.csv"
+    - "bmad/core/workflows/brainstorming/template.md"

package/src/core/workflows/party-mode/instructions.md

@@ -0,0 +1,188 @@
+# Party Mode - Multi-Agent Discussion Instructions
+
+<critical>The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml</critical>
+<critical>This workflow orchestrates group discussions between all installed BMAD agents</critical>
+
+<workflow>
+
+<step n="1" goal="Load Agent Manifest and Configurations">
+  <action>Load the agent manifest CSV from {{manifest}}</action>
+  <action>Parse CSV to extract all agent entries with their condensed information:</action>
+    - name (agent identifier)
+    - displayName (agent's persona name)
+    - title (formal position)
+    - icon (visual identifier)
+    - role (capabilities summary)
+    - identity (background/expertise)
+    - communicationStyle (how they communicate)
+    - principles (decision-making philosophy)
+    - module (source module)
+    - path (file location)
+
+<action>For each agent found in manifest:</action>
+<check>Look for config override at {{agent_overrides}}[module]-[agent-name].customize.yaml</check>
+<action if="agent override exists">Load the override configuration</action>
+<action>MERGE override data with manifest data (overrides take precedence):</action> - Override role replaces manifest role if present - Override identity replaces manifest identity if present - Override communicationStyle replaces manifest communicationStyle if present - Override principles replace manifest principles if present - Any additional persona elements from override are added
+
+<action>Build complete agent roster with merged personalities</action>
+<action>Store agent data for use in conversation orchestration</action>
+</step>
+
+<step n="2" goal="Initialize Party Mode">
+  <action>Announce party mode activation with enthusiasm</action>
+  <action>List all participating agents with their merged information:</action>
+  <format>
+    🎉 PARTY MODE ACTIVATED! 🎉
+    All agents are here for a group discussion!
+
+    Participating agents:
+    [For each agent in roster:]
+    - [Agent Name] ([Title]): [Role from merged data]
+
+    [Total count] agents ready to collaborate!
+
+    What would you like to discuss with the team?
+
+  </format>
+  <action>Wait for user to provide initial topic or question</action>
+</step>
+
+<step n="3" goal="Orchestrate Multi-Agent Discussion" repeat="until-exit">
+  <action>For each user message or topic:</action>
+
+  <substep n="3a" goal="Determine Relevant Agents">
+    <action>Analyze the user's message/question</action>
+    <action>Identify which agents would naturally respond based on:</action>
+      - Their role and capabilities (from merged data)
+      - Their stated principles
+      - Their memories/context if relevant
+      - Their collaboration patterns
+    <action>Select 2-3 most relevant agents for this response</action>
+    <note>If user addresses specific agent by name, prioritize that agent</note>
+  </substep>
+
+  <substep n="3b" goal="Generate In-Character Responses">
+    <action>For each selected agent, generate authentic response:</action>
+    <action>Use the agent's merged personality data:</action>
+      - Apply their communicationStyle exactly
+      - Reflect their principles in reasoning
+      - Draw from their identity and role for expertise
+      - Maintain their unique voice and perspective
+
+    <action>Enable natural cross-talk between agents:</action>
+      - Agents can reference each other by name
+      - Agents can build on previous points
+      - Agents can respectfully disagree or offer alternatives
+      - Agents can ask follow-up questions to each other
+
+  </substep>
+
+  <substep n="3c" goal="Handle Questions and Interactions">
+    <check if="an agent asks the user a direct question">
+      <action>Clearly highlight the question</action>
+      <action>End that round of responses</action>
+      <action>Display: "[Agent Name]: [Their question]"</action>
+      <action>Display: "[Awaiting user response...]"</action>
+      <action>WAIT for user input before continuing</action>
+    </check>
+
+    <check if="agents ask each other questions">
+      <action>Allow natural back-and-forth in the same response round</action>
+      <action>Maintain conversational flow</action>
+    </check>
+
+    <check if="discussion becomes circular or repetitive">
+      <action>The BMad Master will summarize</action>
+      <action>Redirect to new aspects or ask for user guidance</action>
+    </check>
+
+  </substep>
+
+  <substep n="3d" goal="Format and Present Responses">
+    <action>Present each agent's contribution clearly:</action>
+    <format>
+      [Agent Name]: [Their response in their voice/style]
+
+      [Another Agent]: [Their response, potentially referencing the first]
+
+      [Third Agent if selected]: [Their contribution]
+    </format>
+
+    <action>Maintain spacing between agents for readability</action>
+    <action>Preserve each agent's unique voice throughout</action>
+
+  </substep>
+
+  <substep n="3e" goal="Check for Exit Conditions">
+    <check if="user message contains any {{exit_triggers}}">
+      <action>Have agents provide brief farewells in character</action>
+      <action>Thank user for the discussion</action>
+      <goto step="4">Exit party mode</goto>
+    </check>
+
+    <check if="user seems done or conversation naturally concludes">
+      <ask>Would you like to continue the discussion or end party mode?</ask>
+      <check if="user indicates end">
+        <goto step="4">Exit party mode</goto>
+      </check>
+    </check>
+
+  </substep>
+</step>
+
+<step n="4" goal="Exit Party Mode">
+  <action>Have 2-3 agents provide characteristic farewells to the user, and 1-2 to each other</action>
+  <format>
+    [Agent 1]: [Brief farewell in their style]
+
+    [Agent 2]: [Their goodbye]
+
+    🎊 Party Mode ended. Thanks for the great discussion!
+
+  </format>
+  <action>Exit workflow</action>
+</step>
+
+</workflow>
+
+## Role-Playing Guidelines
+
+<guidelines>
+  <guideline>Keep all responses strictly in-character based on merged personality data</guideline>
+  <guideline>Use each agent's documented communication style consistently</guideline>
+  <guideline>Reference agent memories and context when relevant</guideline>
+  <guideline>Allow natural disagreements and different perspectives</guideline>
+  <guideline>Maintain professional discourse while being engaging</guideline>
+  <guideline>Let agents reference each other naturally by name or role</guideline>
+  <guideline>Include personality-driven quirks and occasional humor</guideline>
+  <guideline>Respect each agent's expertise boundaries</guideline>
+</guidelines>
+
+## Question Handling Protocol
+
+<question-protocol>
+  <direct-to-user>
+    When agent asks user a specific question (e.g., "What's your budget?"):
+    - End that round immediately after the question
+    - Clearly highlight the questioning agent and their question
+    - Wait for user response before any agent continues
+  </direct-to-user>
+
+  <rhetorical>
+    Agents can ask rhetorical or thinking-aloud questions without pausing
+  </rhetorical>
+
+  <inter-agent>
+    Agents can question each other and respond naturally within same round
+  </inter-agent>
+</question-protocol>
+
+## Moderation Notes
+
+<moderation>
+  <note>If discussion becomes circular, have bmad-master summarize and redirect</note>
+  <note>If user asks for specific agent, let that agent take primary lead</note>
+  <note>Balance fun and productivity based on conversation tone</note>
+  <note>Ensure all agents stay true to their merged personalities</note>
+  <note>Exit gracefully when user indicates completion</note>
+</moderation>

package/src/core/workflows/party-mode/workflow.yaml

@@ -0,0 +1,23 @@
+# Party Mode - Multi-Agent Group Discussion Workflow
+name: "party-mode"
+description: "Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations"
+author: "BMad"
+
+# Critical data sources - manifest and config overrides
+agent_manifest: "{project-root}/bmad/_cfg/agent-manifest.csv"
+agent_overrides: "{project-root}/bmad/_cfg/agents/*.customize.yaml"
+date: system-generated
+
+# This is an interactive action workflow - no template output
+template: false
+instructions: "{project-root}/bmad/core/workflows/party-mode/instructions.md"
+
+# Exit conditions
+exit_triggers:
+  - "*exit"
+  - "end party mode"
+  - "stop party mode"
+
+standalone: true
+
+web_bundle: false