bmalph 1.0.0 → 2.2.1

package/bmad/core/workflows/brainstorming/steps/step-04-idea-organization.md

@@ -1,303 +1,303 @@
-# Step 4: Idea Organization and Action Planning
-
-## MANDATORY EXECUTION RULES (READ FIRST):
-
-- ✅ YOU ARE AN IDEA SYNTHESIZER, turning creative chaos into actionable insights
-- 🎯 ORGANIZE AND PRIORITIZE all generated ideas systematically
-- 📋 CREATE ACTIONABLE NEXT STEPS from brainstorming outcomes
-- 🔍 FACILITATE CONVERGENT THINKING after divergent exploration
-- 💬 DELIVER COMPREHENSIVE SESSION DOCUMENTATION
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the `communication_language`
-
-## EXECUTION PROTOCOLS:
-
-- 🎯 Systematically organize all ideas from technique execution
-- ⚠️ Present [C] complete option after final documentation
-- 💾 Create comprehensive session output document
-- 📖 Update frontmatter with final session outcomes
-- 🚫 FORBIDDEN workflow completion without action planning
-
-## CONTEXT BOUNDARIES:
-
-- All generated ideas from technique execution in Step 3 are available
-- Session context, goals, and constraints from Step 1 are understood
-- Selected approach and techniques from Step 2 inform organization
-- User preferences for prioritization criteria identified
-
-## YOUR TASK:
-
-Organize all brainstorming ideas into coherent themes, facilitate prioritization, and create actionable next steps with comprehensive session documentation.
-
-## IDEA ORGANIZATION SEQUENCE:
-
-### 1. Review Creative Output
-
-Begin systematic review of all generated ideas:
-
-"**Outstanding creative work!** You've generated an incredible range of ideas through our [approach_name] approach with [number] techniques.
-
-**Session Achievement Summary:**
-
-- **Total Ideas Generated:** [number] ideas across [number] techniques
-- **Creative Techniques Used:** [list of completed techniques]
-- **Session Focus:** [session_topic] with emphasis on [session_goals]
-
-**Now let's organize these creative gems and identify your most promising opportunities for action.**
-
-**Loading all generated ideas for systematic organization...**"
-
-### 2. Theme Identification and Clustering
-
-Group related ideas into meaningful themes:
-
-**Theme Analysis Process:**
-"I'm analyzing all your generated ideas to identify natural themes and patterns. This will help us see the bigger picture and prioritize effectively.
-
-**Emerging Themes I'm Identifying:**
-
-**Theme 1: [Theme Name]**
-_Focus: [Description of what this theme covers]_
-
-- **Ideas in this cluster:** [List 3-5 related ideas]
-- **Pattern Insight:** [What connects these ideas]
-
-**Theme 2: [Theme Name]**
-_Focus: [Description of what this theme covers]_
-
-- **Ideas in this cluster:** [List 3-5 related ideas]
-- **Pattern Insight:** [What connects these ideas]
-
-**Theme 3: [Theme Name]**
-_Focus: [Description of what this theme covers]_
-
-- **Ideas in this cluster:** [List 3-5 related ideas]
-- **Pattern Insight:** [What connects these ideas]
-
-**Additional Categories:**
-
-- **[Cross-cutting Ideas]:** [Ideas that span multiple themes]
-- **[Breakthrough Concepts]:** [Particularly innovative or surprising ideas]
-- **[Implementation-Ready Ideas]:** [Ideas that seem immediately actionable]"
-
-### 3. Present Organized Idea Themes
-
-Display systematically organized ideas for user review:
-
-**Organized by Theme:**
-
-"**Your Brainstorming Results - Organized by Theme:**
-
-**[Theme 1]: [Theme Description]**
-
-- **[Idea 1]:** [Development potential and unique insight]
-- **[Idea 2]:** [Development potential and unique insight]
-- **[Idea 3]:** [Development potential and unique insight]
-
-**[Theme 2]: [Theme Description]**
-
-- **[Idea 1]:** [Development potential and unique insight]
-- **[Idea 2]:** [Development potential and unique insight]
-
-**[Theme 3]: [Theme Description]**
-
-- **[Idea 1]:** [Development potential and unique insight]
-- **[Idea 2]:** [Development potential and unique insight]
-
-**Breakthrough Concepts:**
-
-- **[Innovative Idea]:** [Why this represents a significant breakthrough]
-- **[Unexpected Connection]:** [How this creates new possibilities]
-
-**Which themes or specific ideas stand out to you as most valuable?**"
-
-### 4. Facilitate Prioritization
-
-Guide user through strategic prioritization:
-
-**Prioritization Framework:**
-
-"Now let's identify your most promising ideas based on what matters most for your **[session_goals]**.
-
-**Prioritization Criteria for Your Session:**
-
-- **Impact:** Potential effect on [session_topic] success
-- **Feasibility:** Implementation difficulty and resource requirements
-- **Innovation:** Originality and competitive advantage
-- **Alignment:** Match with your stated constraints and goals
-
-**Quick Prioritization Exercise:**
-
-Review your organized ideas and identify:
-
-1. **Top 3 High-Impact Ideas:** Which concepts could deliver the greatest results?
-2. **Easiest Quick Wins:** Which ideas could be implemented fastest?
-3. **Most Innovative Approaches:** Which concepts represent true breakthroughs?
-
-**What stands out to you as most valuable? Share your top priorities and I'll help you develop action plans.**"
-
-### 5. Develop Action Plans
-
-Create concrete next steps for prioritized ideas:
-
-**Action Planning Process:**
-
-"**Excellent choices!** Let's develop actionable plans for your top priority ideas.
-
-**For each selected idea, let's explore:**
-
-- **Immediate Next Steps:** What can you do this week?
-- **Resource Requirements:** What do you need to move forward?
-- **Potential Obstacles:** What challenges might arise?
-- **Success Metrics:** How will you know it's working?
-
-**Idea [Priority Number]: [Idea Name]**
-**Why This Matters:** [Connection to user's goals]
-**Next Steps:**
-
-1. [Specific action step 1]
-2. [Specific action step 2]
-3. [Specific action step 3]
-
-**Resources Needed:** [List of requirements]
-**Timeline:** [Implementation estimate]
-**Success Indicators:** [How to measure progress]
-
-**Would you like me to develop similar action plans for your other top ideas?**"
-
-### 6. Create Comprehensive Session Documentation
-
-Prepare final session output:
-
-**Session Documentation Structure:**
-
-"**Creating your comprehensive brainstorming session documentation...**
-
-This document will include:
-
-- **Session Overview:** Context, goals, and approach used
-- **Complete Idea Inventory:** All concepts organized by theme
-- **Prioritization Results:** Your selected top ideas and rationale
-- **Action Plans:** Concrete next steps for implementation
-- **Session Insights:** Key learnings and creative breakthroughs
-
-**Your brainstorming session has produced [number] organized ideas across [number] themes, with [number] prioritized concepts ready for action planning.**"
-
-**Append to document:**
-
-```markdown
-## Idea Organization and Prioritization
-
-**Thematic Organization:**
-[Content showing all ideas organized by themes]
-
-**Prioritization Results:**
-
-- **Top Priority Ideas:** [Selected priorities with rationale]
-- **Quick Win Opportunities:** [Easy implementation ideas]
-- **Breakthrough Concepts:** [Innovative approaches for longer-term]
-
-**Action Planning:**
-[Detailed action plans for top priorities]
-
-## Session Summary and Insights
-
-**Key Achievements:**
-
-- [Major accomplishments of the session]
-- [Creative breakthroughs and insights]
-- [Actionable outcomes generated]
-
-**Session Reflections:**
-[Content about what worked well and key learnings]
-```
-
-### 7. Session Completion and Next Steps
-
-Provide final session wrap-up and forward guidance:
-
-**Session Completion:**
-
-"**Congratulations on an incredibly productive brainstorming session!**
-
-**Your Creative Achievements:**
-
-- **[Number]** breakthrough ideas generated for **[session_topic]**
-- **[Number]** organized themes identifying key opportunity areas
-- **[Number prioritized concepts** with concrete action plans
-- **Clear pathway** from creative ideas to practical implementation
-
-**Key Session Insights:**
-
-- [Major insight about the topic or problem]
-- [Discovery about user's creative thinking or preferences]
-- [Breakthrough connection or innovative approach]
-
-**What Makes This Session Valuable:**
-
-- Systematic exploration using proven creativity techniques
-- Balance of divergent and convergent thinking
-- Actionable outcomes rather than just ideas
-- Comprehensive documentation for future reference
-
-**Your Next Steps:**
-
-1. **Review** your session document when you receive it
-2. **Begin** with your top priority action steps this week
-3. **Share** promising concepts with stakeholders if relevant
-4. **Schedule** follow-up sessions as ideas develop
-
-**Ready to complete your session documentation?**
-[C] Complete - Generate final brainstorming session document
-
-### 8. Handle Completion Selection
-
-#### If [C] Complete:
-
-- **Append the final session content to `{output_folder}/brainstorming/brainstorming-session-{{date}}.md`**
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4]`
-- Set `session_active: false` and `workflow_completed: true`
-- Complete workflow with positive closure message
-
-## APPEND TO DOCUMENT:
-
-When user selects 'C', append the content directly to `{output_folder}/brainstorming/brainstorming-session-{{date}}.md` using the structure from step 7.
-
-## SUCCESS METRICS:
-
-✅ All generated ideas systematically organized and themed
-✅ User successfully prioritized ideas based on personal criteria
-✅ Actionable next steps created for high-priority concepts
-✅ Comprehensive session documentation prepared
-✅ Clear pathway from ideas to implementation established
-✅ [C] complete option presented with value proposition
-✅ Session outcomes exceed user expectations and goals
-
-## FAILURE MODES:
-
-❌ Poor idea organization leading to missed connections or insights
-❌ Inadequate prioritization framework or guidance
-❌ Action plans that are too vague or not truly actionable
-❌ Missing comprehensive session documentation
-❌ Not providing clear next steps or implementation guidance
-
-## IDEA ORGANIZATION PROTOCOLS:
-
-- Use consistent formatting and clear organization structure
-- Include specific details and insights rather than generic summaries
-- Capture user preferences and decision criteria for future reference
-- Provide multiple access points to ideas (themes, priorities, techniques)
-- Include facilitator insights about session dynamics and breakthroughs
-
-## SESSION COMPLETION:
-
-After user selects 'C':
-
-- All brainstorming workflow steps completed successfully
-- Comprehensive session document generated with full idea inventory
-- User equipped with actionable plans and clear next steps
-- Creative breakthroughs and insights preserved for future use
-- User confidence high about moving ideas to implementation
-
-Congratulations on facilitating a transformative brainstorming session that generated innovative solutions and actionable outcomes! 🚀
-
-The user has experienced the power of structured creativity combined with expert facilitation to produce breakthrough ideas for their specific challenges and opportunities.
+# Step 4: Idea Organization and Action Planning
+
+## MANDATORY EXECUTION RULES (READ FIRST):
+
+- ✅ YOU ARE AN IDEA SYNTHESIZER, turning creative chaos into actionable insights
+- 🎯 ORGANIZE AND PRIORITIZE all generated ideas systematically
+- 📋 CREATE ACTIONABLE NEXT STEPS from brainstorming outcomes
+- 🔍 FACILITATE CONVERGENT THINKING after divergent exploration
+- 💬 DELIVER COMPREHENSIVE SESSION DOCUMENTATION
+- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the `communication_language`
+
+## EXECUTION PROTOCOLS:
+
+- 🎯 Systematically organize all ideas from technique execution
+- ⚠️ Present [C] complete option after final documentation
+- 💾 Create comprehensive session output document
+- 📖 Update frontmatter with final session outcomes
+- 🚫 FORBIDDEN workflow completion without action planning
+
+## CONTEXT BOUNDARIES:
+
+- All generated ideas from technique execution in Step 3 are available
+- Session context, goals, and constraints from Step 1 are understood
+- Selected approach and techniques from Step 2 inform organization
+- User preferences for prioritization criteria identified
+
+## YOUR TASK:
+
+Organize all brainstorming ideas into coherent themes, facilitate prioritization, and create actionable next steps with comprehensive session documentation.
+
+## IDEA ORGANIZATION SEQUENCE:
+
+### 1. Review Creative Output
+
+Begin systematic review of all generated ideas:
+
+"**Outstanding creative work!** You've generated an incredible range of ideas through our [approach_name] approach with [number] techniques.
+
+**Session Achievement Summary:**
+
+- **Total Ideas Generated:** [number] ideas across [number] techniques
+- **Creative Techniques Used:** [list of completed techniques]
+- **Session Focus:** [session_topic] with emphasis on [session_goals]
+
+**Now let's organize these creative gems and identify your most promising opportunities for action.**
+
+**Loading all generated ideas for systematic organization...**"
+
+### 2. Theme Identification and Clustering
+
+Group related ideas into meaningful themes:
+
+**Theme Analysis Process:**
+"I'm analyzing all your generated ideas to identify natural themes and patterns. This will help us see the bigger picture and prioritize effectively.
+
+**Emerging Themes I'm Identifying:**
+
+**Theme 1: [Theme Name]**
+_Focus: [Description of what this theme covers]_
+
+- **Ideas in this cluster:** [List 3-5 related ideas]
+- **Pattern Insight:** [What connects these ideas]
+
+**Theme 2: [Theme Name]**
+_Focus: [Description of what this theme covers]_
+
+- **Ideas in this cluster:** [List 3-5 related ideas]
+- **Pattern Insight:** [What connects these ideas]
+
+**Theme 3: [Theme Name]**
+_Focus: [Description of what this theme covers]_
+
+- **Ideas in this cluster:** [List 3-5 related ideas]
+- **Pattern Insight:** [What connects these ideas]
+
+**Additional Categories:**
+
+- **[Cross-cutting Ideas]:** [Ideas that span multiple themes]
+- **[Breakthrough Concepts]:** [Particularly innovative or surprising ideas]
+- **[Implementation-Ready Ideas]:** [Ideas that seem immediately actionable]"
+
+### 3. Present Organized Idea Themes
+
+Display systematically organized ideas for user review:
+
+**Organized by Theme:**
+
+"**Your Brainstorming Results - Organized by Theme:**
+
+**[Theme 1]: [Theme Description]**
+
+- **[Idea 1]:** [Development potential and unique insight]
+- **[Idea 2]:** [Development potential and unique insight]
+- **[Idea 3]:** [Development potential and unique insight]
+
+**[Theme 2]: [Theme Description]**
+
+- **[Idea 1]:** [Development potential and unique insight]
+- **[Idea 2]:** [Development potential and unique insight]
+
+**[Theme 3]: [Theme Description]**
+
+- **[Idea 1]:** [Development potential and unique insight]
+- **[Idea 2]:** [Development potential and unique insight]
+
+**Breakthrough Concepts:**
+
+- **[Innovative Idea]:** [Why this represents a significant breakthrough]
+- **[Unexpected Connection]:** [How this creates new possibilities]
+
+**Which themes or specific ideas stand out to you as most valuable?**"
+
+### 4. Facilitate Prioritization
+
+Guide user through strategic prioritization:
+
+**Prioritization Framework:**
+
+"Now let's identify your most promising ideas based on what matters most for your **[session_goals]**.
+
+**Prioritization Criteria for Your Session:**
+
+- **Impact:** Potential effect on [session_topic] success
+- **Feasibility:** Implementation difficulty and resource requirements
+- **Innovation:** Originality and competitive advantage
+- **Alignment:** Match with your stated constraints and goals
+
+**Quick Prioritization Exercise:**
+
+Review your organized ideas and identify:
+
+1. **Top 3 High-Impact Ideas:** Which concepts could deliver the greatest results?
+2. **Easiest Quick Wins:** Which ideas could be implemented fastest?
+3. **Most Innovative Approaches:** Which concepts represent true breakthroughs?
+
+**What stands out to you as most valuable? Share your top priorities and I'll help you develop action plans.**"
+
+### 5. Develop Action Plans
+
+Create concrete next steps for prioritized ideas:
+
+**Action Planning Process:**
+
+"**Excellent choices!** Let's develop actionable plans for your top priority ideas.
+
+**For each selected idea, let's explore:**
+
+- **Immediate Next Steps:** What can you do this week?
+- **Resource Requirements:** What do you need to move forward?
+- **Potential Obstacles:** What challenges might arise?
+- **Success Metrics:** How will you know it's working?
+
+**Idea [Priority Number]: [Idea Name]**
+**Why This Matters:** [Connection to user's goals]
+**Next Steps:**
+
+1. [Specific action step 1]
+2. [Specific action step 2]
+3. [Specific action step 3]
+
+**Resources Needed:** [List of requirements]
+**Timeline:** [Implementation estimate]
+**Success Indicators:** [How to measure progress]
+
+**Would you like me to develop similar action plans for your other top ideas?**"
+
+### 6. Create Comprehensive Session Documentation
+
+Prepare final session output:
+
+**Session Documentation Structure:**
+
+"**Creating your comprehensive brainstorming session documentation...**
+
+This document will include:
+
+- **Session Overview:** Context, goals, and approach used
+- **Complete Idea Inventory:** All concepts organized by theme
+- **Prioritization Results:** Your selected top ideas and rationale
+- **Action Plans:** Concrete next steps for implementation
+- **Session Insights:** Key learnings and creative breakthroughs
+
+**Your brainstorming session has produced [number] organized ideas across [number] themes, with [number] prioritized concepts ready for action planning.**"
+
+**Append to document:**
+
+```markdown
+## Idea Organization and Prioritization
+
+**Thematic Organization:**
+[Content showing all ideas organized by themes]
+
+**Prioritization Results:**
+
+- **Top Priority Ideas:** [Selected priorities with rationale]
+- **Quick Win Opportunities:** [Easy implementation ideas]
+- **Breakthrough Concepts:** [Innovative approaches for longer-term]
+
+**Action Planning:**
+[Detailed action plans for top priorities]
+
+## Session Summary and Insights
+
+**Key Achievements:**
+
+- [Major accomplishments of the session]
+- [Creative breakthroughs and insights]
+- [Actionable outcomes generated]
+
+**Session Reflections:**
+[Content about what worked well and key learnings]
+```
+
+### 7. Session Completion and Next Steps
+
+Provide final session wrap-up and forward guidance:
+
+**Session Completion:**
+
+"**Congratulations on an incredibly productive brainstorming session!**
+
+**Your Creative Achievements:**
+
+- **[Number]** breakthrough ideas generated for **[session_topic]**
+- **[Number]** organized themes identifying key opportunity areas
+- **[Number prioritized concepts** with concrete action plans
+- **Clear pathway** from creative ideas to practical implementation
+
+**Key Session Insights:**
+
+- [Major insight about the topic or problem]
+- [Discovery about user's creative thinking or preferences]
+- [Breakthrough connection or innovative approach]
+
+**What Makes This Session Valuable:**
+
+- Systematic exploration using proven creativity techniques
+- Balance of divergent and convergent thinking
+- Actionable outcomes rather than just ideas
+- Comprehensive documentation for future reference
+
+**Your Next Steps:**
+
+1. **Review** your session document when you receive it
+2. **Begin** with your top priority action steps this week
+3. **Share** promising concepts with stakeholders if relevant
+4. **Schedule** follow-up sessions as ideas develop
+
+**Ready to complete your session documentation?**
+[C] Complete - Generate final brainstorming session document
+
+### 8. Handle Completion Selection
+
+#### If [C] Complete:
+
+- **Append the final session content to `{output_folder}/brainstorming/brainstorming-session-{{date}}.md`**
+- Update frontmatter: `stepsCompleted: [1, 2, 3, 4]`
+- Set `session_active: false` and `workflow_completed: true`
+- Complete workflow with positive closure message
+
+## APPEND TO DOCUMENT:
+
+When user selects 'C', append the content directly to `{output_folder}/brainstorming/brainstorming-session-{{date}}.md` using the structure from step 7.
+
+## SUCCESS METRICS:
+
+✅ All generated ideas systematically organized and themed
+✅ User successfully prioritized ideas based on personal criteria
+✅ Actionable next steps created for high-priority concepts
+✅ Comprehensive session documentation prepared
+✅ Clear pathway from ideas to implementation established
+✅ [C] complete option presented with value proposition
+✅ Session outcomes exceed user expectations and goals
+
+## FAILURE MODES:
+
+❌ Poor idea organization leading to missed connections or insights
+❌ Inadequate prioritization framework or guidance
+❌ Action plans that are too vague or not truly actionable
+❌ Missing comprehensive session documentation
+❌ Not providing clear next steps or implementation guidance
+
+## IDEA ORGANIZATION PROTOCOLS:
+
+- Use consistent formatting and clear organization structure
+- Include specific details and insights rather than generic summaries
+- Capture user preferences and decision criteria for future reference
+- Provide multiple access points to ideas (themes, priorities, techniques)
+- Include facilitator insights about session dynamics and breakthroughs
+
+## SESSION COMPLETION:
+
+After user selects 'C':
+
+- All brainstorming workflow steps completed successfully
+- Comprehensive session document generated with full idea inventory
+- User equipped with actionable plans and clear next steps
+- Creative breakthroughs and insights preserved for future use
+- User confidence high about moving ideas to implementation
+
+Congratulations on facilitating a transformative brainstorming session that generated innovative solutions and actionable outcomes! 🚀
+
+The user has experienced the power of structured creativity combined with expert facilitation to produce breakthrough ideas for their specific challenges and opportunities.

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

@@ -1,15 +1,15 @@
----
-stepsCompleted: []
-inputDocuments: []
-session_topic: ''
-session_goals: ''
-selected_approach: ''
-techniques_used: []
-ideas_generated: []
-context_file: ''
----
-
-# Brainstorming Session Results
-
-**Facilitator:** {{user_name}}
-**Date:** {{date}}
+---
+stepsCompleted: []
+inputDocuments: []
+session_topic: ''
+session_goals: ''
+selected_approach: ''
+techniques_used: []
+ideas_generated: []
+context_file: ''
+---
+
+# Brainstorming Session Results
+
+**Facilitator:** {{user_name}}
+**Date:** {{date}}