bmad-method 6.0.0-alpha.2 → 6.0.0-alpha.20

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

@@ -1,314 +0,0 @@
-# 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/workflow.yaml

@@ -1,43 +0,0 @@
-# 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

@@ -1,188 +0,0 @@
-# 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

@@ -1,23 +0,0 @@
-# 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

package/src/modules/bmb/_module-installer/install-config.yaml

@@ -1,26 +0,0 @@
-# BMAD™ Method Core Configuration
-
-code: bmb
-name: "BMB: BMad Builder - Agent, Workflow and Module Builder"
-default_selected: false # This module will not be selected by default for new installations
-
-prompt: "Happy Building - Build the Modules, Workflows and Agents of your dreams."
-# Variables from Core Config inserted:
-## user_name
-## communication_language
-## output_folder
-
-custom_agent_location:
-  prompt: "Where do custom agents get created?"
-  default: "bmad/agents"
-  result: "{project-root}/{value}"
-
-custom_workflow_location:
-  prompt: "Where do custom workflows get stored?"
-  default: "bmad/workflows"
-  result: "{project-root}/{value}"
-
-custom_module_location:
-  prompt: "Where do custom modules get stored?"
-  default: "bmad"
-  result: "{project-root}/{value}"