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

package/src/core/tools/shard-doc.xml

@@ -0,0 +1,100 @@
+<tool id="bmad/core/tasks/shard-doc" name="Shard Document"
+  description="Splits large markdown documents into smaller, organized files based on level 2 (default) sections" webskip="true"
+  standalone="true">
+  <objective>Split large markdown documents into smaller, organized files based on level 2 sections using @kayvan/markdown-tree-parser tool</objective>
+
+  <llm critical="true">
+    <i>MANDATORY: Execute ALL steps in the flow section IN EXACT ORDER</i>
+    <i>DO NOT skip steps or change the sequence</i>
+    <i>HALT immediately when halt-conditions are met</i>
+    <i>Each action xml tag within step xml tag is a REQUIRED action to complete that step</i>
+    <i>Sections outside flow (validation, output, critical-context) provide essential context - review and apply throughout execution</i>
+  </llm>
+
+  <critical-context>
+    <i>This task ONLY supports automated sharding via @kayvan/markdown-tree-parser</i>
+    <i>The tool automatically handles: section splitting, heading level adjustment, code block detection, index generation</i>
+    <i>All markdown formatting is preserved during sharding</i>
+  </critical-context>
+
+  <flow>
+    <step n="1" title="Verify Tool Installation">
+      <action>Check if @kayvan/markdown-tree-parser is installed globally</action>
+      <action>Run: npm list -g @kayvan/markdown-tree-parser</action>
+      <action if="not installed">Inform user that tool needs to be installed</action>
+      <action if="not installed">Run: npm install -g @kayvan/markdown-tree-parser</action>
+      <action if="installation fails">HALT with error message about npm/node requirements</action>
+    </step>
+
+    <step n="2" title="Get Source Document">
+      <action>Ask user for the source document path if not provided already</action>
+      <action>Verify file exists and is accessible</action>
+      <action>Verify file is markdown format (.md extension)</action>
+      <action if="file not found or not markdown">HALT with error message</action>
+    </step>
+
+    <step n="3" title="Get Destination Folder">
+      <action>Determine default destination: same location as source file, folder named after source file without .md extension</action>
+      <action>Example: /path/to/architecture.md → /path/to/architecture/</action>
+      <action>Ask user for the destination folder path ([y] to confirm use of default: [suggested-path], else enter a new path)</action>
+      <action if="user accepts default">Use the suggested destination path</action>
+      <action if="user provides custom path">Use the custom destination path</action>
+      <action>Verify destination folder exists or can be created</action>
+      <action>Check write permissions for destination</action>
+      <action if="permission denied">HALT with error message</action>
+    </step>
+
+    <step n="4" title="Execute Sharding">
+      <action>Inform user that sharding is beginning</action>
+      <action>Execute command: md-tree explode [source-document] [destination-folder]</action>
+      <action>Capture command output and any errors</action>
+      <action if="command fails">HALT and display error to user</action>
+    </step>
+
+    <step n="5" title="Verify Output">
+      <action>Check that destination folder contains sharded files</action>
+      <action>Verify index.md was created in destination folder</action>
+      <action>Count the number of files created</action>
+      <action if="no files created">HALT with error message</action>
+    </step>
+
+    <step n="6" title="Report Completion">
+      <action>Display completion report to user including:</action>
+      <i>- Source document path and name</i>
+      <i>- Destination folder path</i>
+      <i>- Number of section files created</i>
+      <i>- Confirmation that index.md was created</i>
+      <i>- Any tool output or warnings</i>
+      <action>Inform user that sharding completed successfully</action>
+    </step>
+  </flow>
+
+  <halt-conditions critical="true">
+    <i>HALT if @kayvan/markdown-tree-parser cannot be installed</i>
+    <i>HALT if Node.js or npm is not available</i>
+    <i>HALT if source document does not exist or is inaccessible</i>
+    <i>HALT if source document is not markdown format (.md)</i>
+    <i>HALT if destination folder cannot be created</i>
+    <i>HALT if user does not have write permissions to destination</i>
+    <i>HALT if md-tree explode command fails</i>
+    <i>HALT if no output files were created</i>
+  </halt-conditions>
+
+  <tool-info>
+    <name>@kayvan/markdown-tree-parser</name>
+    <command>md-tree explode [source-document] [destination-folder]</command>
+    <installation>npm install -g @kayvan/markdown-tree-parser</installation>
+    <requirements>
+      <i>Node.js installed</i>
+      <i>npm package manager</i>
+      <i>Global npm installation permissions</i>
+    </requirements>
+    <features>
+      <i>Automatic section splitting by level 2 headings</i>
+      <i>Automatic heading level adjustment</i>
+      <i>Handles edge cases (code blocks, diagrams)</i>
+      <i>Generates navigable index.md</i>
+      <i>Preserves all markdown formatting</i>
+    </features>
+  </tool-info>
+</tool>

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

@@ -0,0 +1,271 @@
+---
+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
+
+### Basic Invocation
+
+```bash
+workflow brainstorming
+```
+
+### With Context Document
+
+```bash
+# Provide domain-specific context to guide the session
+workflow brainstorming --data /path/to/context.md
+```
+
+### Configuration
+
+The workflow leverages configuration from `/bmad/cis/config.yaml`:
+
+- **output_folder**: Where session results are saved
+- **user_name**: Session participant identification
+- **brain_techniques**: CSV database of 36 creative techniques
+
+## 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/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/brain-methods.csv

@@ -0,0 +1,36 @@
+category,technique_name,description,facilitation_prompts,best_for,energy_level,typical_duration
+collaborative,Yes And Building,Build momentum through positive additions where each idea becomes a launching pad for the next - creates energetic collaborative flow,Yes and we could also...|Building on that idea...|That reminds me of...|What if we added?,team-building,high,15-20
+collaborative,Brain Writing Round Robin,Silent idea generation followed by building on others' written concepts - gives quieter voices equal contribution while maintaining documentation,Write your idea silently|Pass to the next person|Build on what you received|Keep ideas flowing,quiet-voices,moderate,20-25
+collaborative,Random Stimulation,Use random words/images as creative catalysts to force unexpected connections - breaks through mental blocks with serendipitous inspiration,Pick a random word/image|How does this relate?|What connections do you see?|Force a relationship
+collaborative,Role Playing,Generate solutions from multiple stakeholder perspectives - builds empathy while ensuring comprehensive consideration of all viewpoints,Think as a [role]|What would they want?|How would they approach this?|What matters to them?
+creative,What If Scenarios,Explore radical possibilities by questioning all constraints and assumptions - perfect for breaking through stuck thinking and discovering unexpected opportunities,What if we had unlimited resources?|What if the opposite were true?|What if this problem didn't exist?,innovation,high,15-20
+creative,Analogical Thinking,Find creative solutions by drawing parallels to other domains - helps transfer successful patterns from one context to another,This is like what?|How is this similar to...?|What other examples come to mind?
+creative,Reversal Inversion,Deliberately flip problems upside down to reveal hidden assumptions and fresh angles - great when conventional approaches aren't working,What if we did the opposite?|How could we make this worse?|What's the reverse approach?
+creative,First Principles Thinking,Strip away assumptions to rebuild from fundamental truths - essential for breakthrough innovation and solving complex problems,What do we know for certain?|What are the fundamental truths?|If we started from scratch?
+creative,Forced Relationships,Connect unrelated concepts to spark innovative bridges - excellent for generating unexpected solutions through creative collision,Take these two unrelated things|Find connections between them|What bridges exist?|How could they work together?
+creative,Time Shifting,Explore how solutions would work across different time periods - reveals constraints and opportunities by changing temporal context,How would this work in the past?|What about 100 years from now?|Different era constraints?|Time-based solutions?
+creative,Metaphor Mapping,Use extended metaphors as thinking tools to explore problems from new angles - transforms abstract challenges into tangible narratives,This problem is like a [metaphor]|Extend the metaphor|What elements map over?|What insights emerge?
+deep,Five Whys,Drill down through layers of causation to uncover root causes - essential for solving problems at their source rather than treating symptoms,Why did this happen?|Why is that?|And why is that true?|What's behind that?|Why ultimately?,problem-solving,moderate,10-15
+deep,Morphological Analysis,Systematically explore all possible parameter combinations - perfect for complex systems requiring comprehensive solution mapping,What are the key parameters?|List options for each|Try different combinations|What patterns emerge?
+deep,Provocation Technique,Use deliberately provocative statements to extract useful ideas from seemingly absurd starting points - catalyzes breakthrough thinking,What if [provocative statement]?|How could this be useful?|What idea does this trigger?|Extract the principle
+deep,Assumption Reversal,Challenge and flip core assumptions to rebuild from new foundations - essential for paradigm shifts and fresh perspectives,What assumptions are we making?|What if the opposite were true?|Challenge each assumption|Rebuild from new assumptions
+deep,Question Storming,Generate questions before seeking answers to properly define the problem space - ensures you're solving the right problem,Only ask questions|No answers allowed yet|What don't we know?|What should we be asking?
+introspective_delight,Inner Child Conference,Channel pure childhood curiosity and wonder - rekindles playful exploration and innocent questioning that cuts through adult complications,What would 7-year-old you ask?|Why why why?|Make it fun again|No boring allowed
+introspective_delight,Shadow Work Mining,Explore what you're actively avoiding or resisting - uncovers hidden insights by examining unconscious blocks and resistance patterns,What are you avoiding?|Where's the resistance?|What scares you about this?|Mine the shadows
+introspective_delight,Values Archaeology,Excavate the deep personal values driving your decisions - clarifies authentic priorities by digging to bedrock motivations,What really matters here?|Why do you care?|Dig to bedrock values|What's non-negotiable?
+introspective_delight,Future Self Interview,Seek wisdom from your wiser future self - gains long-term perspective through imagined temporal self-mentoring,Ask your 80-year-old self|What would you tell younger you?|Future wisdom speaks|Long-term perspective
+introspective_delight,Body Wisdom Dialogue,Let physical sensations and gut feelings guide ideation - taps somatic intelligence often ignored by purely mental approaches,What does your body say?|Where do you feel it?|Trust the tension|Follow physical cues
+structured,SCAMPER Method,Systematic creativity through seven lenses (Substitute/Combine/Adapt/Modify/Put/Eliminate/Reverse) - ideal for methodical product improvement and innovation,S-What could you substitute?|C-What could you combine?|A-How could you adapt?|M-What could you modify?|P-Put to other uses?|E-What could you eliminate?|R-What if reversed?
+structured,Six Thinking Hats,Explore problems through six distinct perspectives (facts/emotions/benefits/risks/creativity/process) - ensures comprehensive analysis without conflict,White-What facts do we know?|Red-How do you feel about this?|Yellow-What are the benefits?|Black-What could go wrong?|Green-What creative alternatives?|Blue-How should we think about this?
+structured,Mind Mapping,Visually branch ideas from a central concept to discover connections and expand thinking - perfect for organizing complex thoughts and seeing the big picture,Put the main idea in center|What branches from this?|How do these connect?|What sub-branches emerge?
+structured,Resource Constraints,Generate innovative solutions by imposing extreme limitations - forces essential priorities and creative efficiency under pressure,What if you had only $1?|No technology allowed?|One hour to solve?|Minimal resources only?
+theatrical,Time Travel Talk Show,Interview your past/present/future selves for temporal wisdom - playful method for gaining perspective across different life stages,Interview your past self|What would future you say?|Different timeline perspectives|Cross-temporal dialogue
+theatrical,Alien Anthropologist,Examine familiar problems through completely foreign eyes - reveals hidden assumptions by adopting an outsider's bewildered perspective,You're an alien observer|What seems strange?|How would you explain this?|Outside perspective insights
+theatrical,Dream Fusion Laboratory,Start with impossible fantasy solutions then reverse-engineer practical steps - makes ambitious thinking actionable through backwards design,Dream the impossible solution|Work backwards to reality|What steps bridge the gap?|Make magic practical
+theatrical,Emotion Orchestra,Let different emotions lead separate brainstorming sessions then harmonize - uses emotional intelligence for comprehensive perspective,Angry perspective ideas|Joyful approach|Fearful considerations|Hopeful solutions|Harmonize all voices
+theatrical,Parallel Universe Cafe,Explore solutions under alternative reality rules - breaks conventional thinking by changing fundamental assumptions about how things work,Different physics universe|Alternative social norms|Changed historical events|Reality rule variations
+wild,Chaos Engineering,Deliberately break things to discover robust solutions - builds anti-fragility by stress-testing ideas against worst-case scenarios,What if everything went wrong?|Break it on purpose|How does it fail gracefully?|Build from the rubble
+wild,Guerrilla Gardening Ideas,Plant unexpected solutions in unlikely places - uses surprise and unconventional placement for stealth innovation,Where's the least expected place?|Plant ideas secretly|Grow solutions underground|Surprise implementation
+wild,Pirate Code Brainstorm,Take what works from anywhere and remix without permission - encourages rule-bending rapid prototyping and maverick thinking,What would pirates steal?|Remix without asking|Take the best and run|No permission needed
+wild,Zombie Apocalypse Planning,Design solutions for extreme survival scenarios - strips away all but essential functions to find core value,Society collapsed - now what?|Only basics work|Build from nothing|Survival mode thinking
+wild,Drunk History Retelling,Explain complex ideas with uninhibited simplicity - removes overthinking barriers to find raw truth through simplified expression,Explain it like you're tipsy|No filter needed|Raw unedited thoughts|Simplify to absurdity