npm - bmad-method - Versions diffs - 6.0.0-alpha.12 → 6.0.0-alpha.13 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (491) hide show

package/src/core/workflows/brainstorming/README.md DELETED Viewed

@@ -1,261 +0,0 @@
----
-last-redoc-date: 2025-09-28
----
-# Brainstorming Session Workflow
-## Overview
-The brainstorming workflow facilitates interactive brainstorming sessions using diverse creative techniques. This workflow acts as an AI facilitator guiding users through various ideation methods to generate and refine creative solutions in a structured, energetic, and highly interactive manner.
-## Key Features
-- **36 Creative Techniques**: Comprehensive library spanning collaborative, structured, creative, deep, theatrical, wild, and introspective approaches
-- **Interactive Facilitation**: AI acts as a skilled facilitator using "Yes, and..." methodology
-- **Flexible Approach Selection**: User-guided, AI-recommended, random, or progressive technique flows
-- **Context-Aware Sessions**: Supports domain-specific brainstorming through context document input
-- **Systematic Organization**: Converges ideas into immediate opportunities, future innovations, and moonshots
-- **Action Planning**: Prioritizes top ideas with concrete next steps and timelines
-- **Session Documentation**: Comprehensive structured reports capturing all insights and outcomes
-## Usage
-### Configuration
-The workflow leverages configuration from `{bmad_folder}/core/config.yaml`:
-- **output_folder**: Where session results are saved
-- **user_name**: Session participant identification
-And the following has a default or can be passed in as an override for custom brainstorming scenarios.
-- **brain_techniques**: CSV database of 36 creative techniques, default is `./brain-methods.csv`
-## Workflow Structure
-### Files Included
-```
-brainstorming/
-├── workflow.yaml           # Configuration and metadata
-├── instructions.md         # Step-by-step execution guide
-├── template.md            # Session report structure
-├── brain-methods.csv      # Database of 36 creative techniques
-└── README.md              # This file
-```
-## Creative Techniques Library
-The workflow includes 36 techniques organized into 7 categories:
-### Collaborative Techniques
-- **Yes And Building**: Build momentum through positive additions
-- **Brain Writing Round Robin**: Silent idea generation with sequential building
-- **Random Stimulation**: Use random catalysts for unexpected connections
-- **Role Playing**: Generate solutions from multiple stakeholder perspectives
-### Structured Approaches
-- **SCAMPER Method**: Systematic creativity through seven lenses (Substitute/Combine/Adapt/Modify/Put/Eliminate/Reverse)
-- **Six Thinking Hats**: Explore through six perspectives (facts/emotions/benefits/risks/creativity/process)
-- **Mind Mapping**: Visual branching from central concepts
-- **Resource Constraints**: Innovation through extreme limitations
-### Creative Methods
-- **What If Scenarios**: Explore radical possibilities by questioning constraints
-- **Analogical Thinking**: Find solutions through domain parallels
-- **Reversal Inversion**: Flip problems upside down for fresh angles
-- **First Principles Thinking**: Strip away assumptions to rebuild from fundamentals
-- **Forced Relationships**: Connect unrelated concepts for innovation
-- **Time Shifting**: Explore solutions across different time periods
-- **Metaphor Mapping**: Use extended metaphors as thinking tools
-### Deep Analysis
-- **Five Whys**: Drill down through causation layers to root causes
-- **Morphological Analysis**: Systematically explore parameter combinations
-- **Provocation Technique**: Extract useful ideas from absurd starting points
-- **Assumption Reversal**: Challenge and flip core assumptions
-- **Question Storming**: Generate questions before seeking answers
-### Theatrical Approaches
-- **Time Travel Talk Show**: Interview past/present/future selves
-- **Alien Anthropologist**: Examine through completely foreign eyes
-- **Dream Fusion Laboratory**: Start with impossible solutions, work backwards
-- **Emotion Orchestra**: Let different emotions lead separate sessions
-- **Parallel Universe Cafe**: Explore under alternative reality rules
-### Wild Methods
-- **Chaos Engineering**: Deliberately break things to discover robust solutions
-- **Guerrilla Gardening Ideas**: Plant unexpected solutions in unlikely places
-- **Pirate Code Brainstorm**: Take what works from anywhere and remix
-- **Zombie Apocalypse Planning**: Design for extreme survival scenarios
-- **Drunk History Retelling**: Explain with uninhibited simplicity
-### Introspective Delight
-- **Inner Child Conference**: Channel pure childhood curiosity
-- **Shadow Work Mining**: Explore what you're avoiding or resisting
-- **Values Archaeology**: Excavate deep personal values driving decisions
-- **Future Self Interview**: Seek wisdom from your wiser future self
-- **Body Wisdom Dialogue**: Let physical sensations guide ideation
-## Workflow Process
-### Phase 1: Session Setup (Step 1)
-- Context gathering (topic, goals, constraints)
-- Domain-specific guidance if context document provided
-- Session scope definition (broad exploration vs. focused ideation)
-### Phase 2: Approach Selection (Step 2)
-- **User-Selected**: Browse and choose specific techniques
-- **AI-Recommended**: Tailored technique suggestions based on context
-- **Random Selection**: Surprise technique for creative breakthrough
-- **Progressive Flow**: Multi-technique journey from broad to focused
-### Phase 3: Interactive Facilitation (Step 3)
-- Master facilitator approach using questions, not answers
-- "Yes, and..." building methodology
-- Energy monitoring and technique switching
-- Real-time idea capture and momentum building
-- Quantity over quality focus (aim: 100 ideas in 60 minutes)
-### Phase 4: Convergent Organization (Step 4)
-- Review and categorize all generated ideas
-- Identify patterns and themes across techniques
-- Sort into three priority buckets for action planning
-### Phase 5: Insight Extraction (Step 5)
-- Surface recurring themes across multiple techniques
-- Identify key realizations and surprising connections
-- Extract deeper patterns and meta-insights
-### Phase 6: Action Planning (Step 6)
-- Prioritize top 3 ideas for implementation
-- Define concrete next steps for each priority
-- Determine resource needs and realistic timelines
-### Phase 7: Session Reflection (Step 7)
-- Analyze what worked well and areas for further exploration
-- Recommend follow-up techniques and next session planning
-- Capture emergent questions for future investigation
-### Phase 8: Report Generation (Step 8)
-- Compile comprehensive structured report
-- Calculate total ideas generated and techniques used
-- Format all content for sharing and future reference
-## Output
-### Generated Files
-- **Primary output**: Structured session report saved to `{output_folder}/brainstorming-session-results-{date}.md`
-- **Context integration**: Links to previous brainstorming sessions if available
-### Output Structure
-1. **Executive Summary** - Topic, goals, techniques used, total ideas generated, key themes
-2. **Technique Sessions** - Detailed capture of each technique's ideation process
-3. **Idea Categorization** - Immediate opportunities, future innovations, moonshots, insights
-4. **Action Planning** - Top 3 priorities with rationale, steps, resources, timelines
-5. **Reflection and Follow-up** - Session analysis, recommendations, next steps planning
-## Requirements
-- No special software requirements
-- Access to the CIS module configuration (`{bmad_folder}/cis/config.yaml`)
-- Active participation and engagement throughout the interactive session
-- Optional: Domain context document for focused brainstorming
-## Best Practices
-### Before Starting
-1. **Define Clear Intent**: Know whether you want broad exploration or focused problem-solving
-2. **Gather Context**: Prepare any relevant background documents or domain knowledge
-3. **Set Time Expectations**: Plan for 45-90 minutes for a comprehensive session
-4. **Create Open Environment**: Ensure distraction-free space for creative thinking
-### During Execution
-1. **Embrace Quantity**: Generate many ideas without self-censoring
-2. **Build with "Yes, And"**: Accept and expand on ideas rather than judging
-3. **Stay Curious**: Follow unexpected connections and tangents
-4. **Trust the Process**: Let the facilitator guide you through technique transitions
-5. **Capture Everything**: Document all ideas, even seemingly silly ones
-6. **Monitor Energy**: Communicate when you need technique changes or breaks
-### After Completion
-1. **Review Within 24 Hours**: Re-read the report while insights are fresh
-2. **Act on Quick Wins**: Implement immediate opportunities within one week
-3. **Schedule Follow-ups**: Plan development sessions for promising concepts
-4. **Share Selectively**: Distribute relevant insights to appropriate stakeholders
-## Facilitation Principles
-The AI facilitator operates using these core principles:
-- **Ask, Don't Tell**: Use questions to draw out participant's own ideas
-- **Build, Don't Judge**: Use "Yes, and..." methodology, never "No, but..."
-- **Quantity Over Quality**: Aim for volume in generation phase
-- **Defer Judgment**: Evaluation comes after generation is complete
-- **Stay Curious**: Show genuine interest in participant's unique perspectives
-- **Monitor Energy**: Adapt technique and pace to participant's engagement level
-## Example Session Flow
-### Progressive Technique Flow
-1. **Mind Mapping** (10 min) - Build the landscape of possibilities
-2. **SCAMPER** (15 min) - Systematic exploration of improvement angles
-3. **Six Thinking Hats** (15 min) - Multiple perspectives on solutions
-4. **Forced Relationships** (10 min) - Creative synthesis of unexpected connections
-### Energy Checkpoints
-- After 15-20 minutes: "Should we continue with this technique or try something new?"
-- Before convergent phase: "Are you ready to start organizing ideas, or explore more?"
-- During action planning: "How's your energy for the final planning phase?"
-## Customization
-To customize this workflow:
-1. **Add New Techniques**: Extend `brain-methods.csv` with additional creative methods
-2. **Modify Facilitation Style**: Adjust prompts in `instructions.md` for different energy levels
-3. **Update Report Structure**: Modify `template.md` to include additional analysis sections
-4. **Create Domain Variants**: Develop specialized technique sets for specific industries
-## Version History
-- **v1.0.0** - Initial release
-  - 36 creative techniques across 7 categories
-  - Interactive facilitation with energy monitoring
-  - Comprehensive structured reporting
-  - Context-aware session guidance
-## Support
-For issues or questions:
-- Review technique descriptions in `brain-methods.csv` for facilitation guidance
-- Consult the workflow instructions in `instructions.md` for step-by-step details
-- Reference the template structure in `template.md` for output expectations
-- Follow BMAD documentation standards for workflow customization
----
-_Part of the BMad Method v6 - Creative Ideation and Synthesis (CIS) Module_

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

@@ -1,315 +0,0 @@
-# Brainstorming Session Instructions
-## Workflow
-<workflow>
-<critical>The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml</critical>
-<critical>You MUST have already loaded and processed: {project_root}/{bmad_folder}/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>
-<critical>Create the output document using the template, and record at the {{session_start_plan}} documenting the chosen techniques, along with which approach was used. For all remaining steps, progressively add to the document throughout the brainstorming</critical>
-</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 a few rounds, 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 4 rounds 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_folder}/core/tasks/advanced-elicitation.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 DELETED Viewed

@@ -1,38 +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_folder}/cis/config.yaml"
-output_folder: "{config_source}:output_folder"
-user_name: "{config_source}:user_name"
-date: system-generated
-# 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_folder}/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_folder}/core/workflows/brainstorming/template.md"
-  instructions: "{bmad_folder}/core/workflows/brainstorming/instructions.md"
-  brain_techniques: "{bmad_folder}/core/workflows/brainstorming/brain-methods.csv"
-  use_advanced_elicitation: true
-  web_bundle_files:
-    - "{bmad_folder}/core/workflows/brainstorming/instructions.md"
-    - "{bmad_folder}/core/workflows/brainstorming/brain-methods.csv"
-    - "{bmad_folder}/core/workflows/brainstorming/template.md"