From 4e254d7c6327e798aafda52897a637ece95c0d4a Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Fri, 28 Nov 2025 15:18:51 -0600 Subject: [PATCH] brainstorming, research and partymode updated to use sharded step flow workflows --- src/core/workflows/brainstorming/README.md | 261 ---------- .../workflows/brainstorming/brain-methods.csv | 98 ++-- .../workflows/brainstorming/instructions.md | 315 ------------ .../steps/step-01-session-setup.md | 196 +++++++ .../brainstorming/steps/step-01b-continue.md | 121 +++++ .../steps/step-02a-user-selected.md | 224 ++++++++ .../steps/step-02b-ai-recommended.md | 236 +++++++++ .../steps/step-02c-random-selection.md | 208 ++++++++ .../steps/step-02d-progressive-flow.md | 263 ++++++++++ .../steps/step-03-technique-execution.md | 339 +++++++++++++ .../steps/step-04-idea-organization.md | 302 +++++++++++ src/core/workflows/brainstorming/template.md | 117 +---- src/core/workflows/brainstorming/workflow.md | 51 ++ .../workflows/brainstorming/workflow.yaml | 38 -- src/core/workflows/party-mode/instructions.md | 197 ------- .../party-mode/steps/step-01-agent-loading.md | 138 +++++ .../steps/step-02-discussion-orchestration.md | 203 ++++++++ .../party-mode/steps/step-03-graceful-exit.md | 159 ++++++ src/core/workflows/party-mode/workflow.md | 207 ++++++++ src/core/workflows/party-mode/workflow.yaml | 28 - src/modules/bmm/agents/analyst.agent.yaml | 5 +- src/modules/bmm/agents/tech-writer.agent.yaml | 4 +- src/modules/bmm/data/README.md | 29 ++ .../documentation-standards.md | 0 .../bmm/data/project-context-template.md | 40 ++ .../brainstorm-project/brainstorming-focus.md | 71 --- .../steps/step-01-project-brainstorming.md | 194 ------- .../1-analysis/brainstorm-project/workflow.md | 191 ------- .../deep-prompt-steps/step-01-init.md | 191 ------- .../step-02-prompt-engineering.md | 190 ------- .../step-03-ai-interaction-patterns.md | 195 ------- .../step-04-workflow-integration.md | 235 --------- .../research/domain-steps/step-01-init.md | 36 +- .../domain-steps/step-02-domain-analysis.md | 52 +- .../step-05-research-synthesis.md | 436 ++++++++++++++++ .../research/market-steps/step-01-init.md | 40 +- .../market-steps/step-02-customer-insights.md | 47 +- .../step-04-research-completion.md | 394 +++++++++++--- .../research/technical-steps/step-01-init.md | 203 ++++++++ .../step-02-technical-overview.md | 68 +-- .../step-05-research-synthesis.md | 479 ++++++++++++++++++ .../workflows/1-analysis/research/workflow.md | 87 +++- .../2-plan-workflows/prd/workflow.md | 5 + .../paths/enterprise-brownfield.yaml | 1 + .../paths/enterprise-greenfield.yaml | 1 + .../paths/method-brownfield.yaml | 1 + .../paths/method-greenfield.yaml | 1 + src/utility/models/fragments/handler-exec.xml | 11 +- 48 files changed, 4476 insertions(+), 2432 deletions(-) delete mode 100644 src/core/workflows/brainstorming/README.md delete mode 100644 src/core/workflows/brainstorming/instructions.md create mode 100644 src/core/workflows/brainstorming/steps/step-01-session-setup.md create mode 100644 src/core/workflows/brainstorming/steps/step-01b-continue.md create mode 100644 src/core/workflows/brainstorming/steps/step-02a-user-selected.md create mode 100644 src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md create mode 100644 src/core/workflows/brainstorming/steps/step-02c-random-selection.md create mode 100644 src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md create mode 100644 src/core/workflows/brainstorming/steps/step-03-technique-execution.md create mode 100644 src/core/workflows/brainstorming/steps/step-04-idea-organization.md create mode 100644 src/core/workflows/brainstorming/workflow.md delete mode 100644 src/core/workflows/brainstorming/workflow.yaml delete mode 100644 src/core/workflows/party-mode/instructions.md create mode 100644 src/core/workflows/party-mode/steps/step-01-agent-loading.md create mode 100644 src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md create mode 100644 src/core/workflows/party-mode/steps/step-03-graceful-exit.md create mode 100644 src/core/workflows/party-mode/workflow.md delete mode 100644 src/core/workflows/party-mode/workflow.yaml create mode 100644 src/modules/bmm/data/README.md rename src/modules/bmm/{workflows/techdoc => data}/documentation-standards.md (100%) create mode 100644 src/modules/bmm/data/project-context-template.md delete mode 100644 src/modules/bmm/workflows/1-analysis/brainstorm-project/brainstorming-focus.md delete mode 100644 src/modules/bmm/workflows/1-analysis/brainstorm-project/steps/step-01-project-brainstorming.md delete mode 100644 src/modules/bmm/workflows/1-analysis/brainstorm-project/workflow.md delete mode 100644 src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-01-init.md delete mode 100644 src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-02-prompt-engineering.md delete mode 100644 src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-03-ai-interaction-patterns.md delete mode 100644 src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-04-workflow-integration.md create mode 100644 src/modules/bmm/workflows/1-analysis/research/domain-steps/step-05-research-synthesis.md create mode 100644 src/modules/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md create mode 100644 src/modules/bmm/workflows/1-analysis/research/technical-steps/step-05-research-synthesis.md diff --git a/src/core/workflows/brainstorming/README.md b/src/core/workflows/brainstorming/README.md deleted file mode 100644 index ba3a9111..00000000 --- a/src/core/workflows/brainstorming/README.md +++ /dev/null @@ -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_ diff --git a/src/core/workflows/brainstorming/brain-methods.csv b/src/core/workflows/brainstorming/brain-methods.csv index f192d6d9..29c7787d 100644 --- a/src/core/workflows/brainstorming/brain-methods.csv +++ b/src/core/workflows/brainstorming/brain-methods.csv @@ -1,36 +1,62 @@ -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 \ No newline at end of file +category,technique_name,description +collaborative,Yes And Building,"Build momentum through positive additions where each idea becomes a launching pad - use prompts like 'Yes and we could also...' or 'Building on that idea...' to create energetic collaborative flow that builds upon previous contributions" +collaborative,Brain Writing Round Robin,"Silent idea generation followed by building on others' written concepts - gives quieter voices equal contribution while maintaining documentation through the sequence of writing silently, passing ideas, and building on received concepts" +collaborative,Random Stimulation,"Use random words/images as creative catalysts to force unexpected connections - breaks through mental blocks with serendipitous inspiration by asking how random elements relate, what connections exist, and forcing relationships" +collaborative,Role Playing,"Generate solutions from multiple stakeholder perspectives to build empathy while ensuring comprehensive consideration - embody different roles by asking what they want, how they'd approach problems, and what matters most to them" +collaborative,Ideation Relay Race,"Rapid-fire idea building under time pressure creates urgency and breakthroughs - structure with 30-second additions, quick building on ideas, and fast passing to maintain creative momentum and prevent overthinking" +creative,What If Scenarios,"Explore radical possibilities by questioning all constraints and assumptions - perfect for breaking through stuck thinking using prompts like 'What if we had unlimited resources?' 'What if the opposite were true?' or 'What if this problem didn't exist?'" +creative,Analogical Thinking,"Find creative solutions by drawing parallels to other domains - transfer successful patterns by asking 'This is like what?' 'How is this similar to...' and 'What other examples come to mind?' to connect to existing solutions" +creative,Reversal Inversion,"Deliberately flip problems upside down to reveal hidden assumptions and fresh angles - great when conventional approaches fail by asking 'What if we did the opposite?' 'How could we make this worse?' and 'What's the reverse approach?'" +creative,First Principles Thinking,"Strip away assumptions to rebuild from fundamental truths - essential for breakthrough innovation by asking 'What do we know for certain?' 'What are the fundamental truths?' and 'If we started from scratch?'" +creative,Forced Relationships,"Connect unrelated concepts to spark innovative bridges through creative collision - take two unrelated things, find connections between them, identify bridges, and explore how they could work together to generate unexpected solutions" +creative,Time Shifting,"Explore solutions across different time periods to reveal constraints and opportunities by asking 'How would this work in the past?' 'What about 100 years from now?' 'Different era constraints?' and 'What time-based solutions apply?'" +creative,Metaphor Mapping,"Use extended metaphors as thinking tools to explore problems from new angles - transforms abstract challenges into tangible narratives by asking 'This problem is like a metaphor,' extending the metaphor, and mapping elements to discover insights" +creative,Cross-Pollination,"Transfer solutions from completely different industries or domains to spark breakthrough innovations by asking how industry X would solve this, what patterns work in field Y, and how to adapt solutions from domain Z" +creative,Concept Blending,"Merge two or more existing concepts to create entirely new categories - goes beyond simple combination to genuine innovation by asking what emerges when concepts merge, what new category is created, and how the blend transcends original ideas" +creative,Reverse Brainstorming,"Generate problems instead of solutions to identify hidden opportunities and unexpected pathways by asking 'What could go wrong?' 'How could we make this fail?' and 'What problems could we create?' to reveal solution insights" +creative,Sensory Exploration,"Engage all five senses to discover multi-dimensional solution spaces beyond purely analytical thinking by asking what ideas feel, smell, taste, or sound like, and how different senses engage with the problem space" +deep,Five Whys,"Drill down through layers of causation to uncover root causes - essential for solving problems at source rather than symptoms by asking 'Why did this happen?' repeatedly until reaching fundamental drivers and ultimate causes" +deep,Morphological Analysis,"Systematically explore all possible parameter combinations for complex systems requiring comprehensive solution mapping - identify key parameters, list options for each, try different combinations, and identify emerging patterns" +deep,Provocation Technique,"Use deliberately provocative statements to extract useful ideas from seemingly absurd starting points - catalyzes breakthrough thinking by asking 'What if provocative statement?' 'How could this be useful?' 'What idea triggers?' and 'Extract the principle'" +deep,Assumption Reversal,"Challenge and flip core assumptions to rebuild from new foundations - essential for paradigm shifts by asking 'What assumptions are we making?' 'What if the opposite were true?' 'Challenge each assumption' and 'Rebuild from new assumptions'" +deep,Question Storming,"Generate questions before seeking answers to properly define problem space - ensures solving the right problem by asking only questions, no answers yet, focusing on what we don't know, and identifying what we should be asking" +deep,Constraint Mapping,"Identify and visualize all constraints to find promising pathways around or through limitations - ask what all constraints exist, which are real vs imagined, and how to work around or eliminate barriers to solution space" +deep,Failure Analysis,"Study successful failures to extract valuable insights and avoid common pitfalls - learns from what didn't work by asking what went wrong, why it failed, what lessons emerged, and how to apply failure wisdom to current challenges" +deep,Emergent Thinking,"Allow solutions to emerge organically without forcing linear progression - embraces complexity and natural development by asking what patterns emerge, what wants to happen naturally, and what's trying to emerge from the system" +introspective_delight,Inner Child Conference,"Channel pure childhood curiosity and wonder to rekindle playful exploration - ask what 7-year-old you would ask, use 'why why why' questioning, make it fun again, and forbid boring thinking to access innocent questioning that cuts through adult complications" +introspective_delight,Shadow Work Mining,"Explore what you're actively avoiding or resisting to uncover hidden insights - examine unconscious blocks and resistance patterns by asking what you're avoiding, where's resistance, what scares you, and mining the shadows for buried wisdom" +introspective_delight,Values Archaeology,"Excavate deep personal values driving decisions to clarify authentic priorities - dig to bedrock motivations by asking what really matters, why you care, what's non-negotiable, and what core values guide your choices" +introspective_delight,Future Self Interview,"Seek wisdom from wiser future self for long-term perspective - gain temporal self-mentoring by asking your 80-year-old self what they'd tell younger you, how future wisdom speaks, and what long-term perspective reveals" +introspective_delight,Body Wisdom Dialogue,"Let physical sensations and gut feelings guide ideation - tap somatic intelligence often ignored by mental approaches by asking what your body says, where you feel it, trusting tension, and following physical cues for embodied wisdom" +introspective_delight,Permission Giving,"Grant explicit permission to think impossible thoughts and break self-imposed creative barriers - give yourself permission to explore, try, experiment, and break free from limitations that constrain authentic creative expression" +structured,SCAMPER Method,"Systematic creativity through seven lenses for methodical product improvement and innovation - Substitute (what could you substitute), Combine (what could you combine), Adapt (how could you adapt), Modify (what could you modify), Put to other uses, Eliminate, Reverse" +structured,Six Thinking Hats,"Explore problems through six distinct perspectives without conflict - White Hat (facts), Red Hat (emotions), Yellow Hat (benefits), Black Hat (risks), Green Hat (creativity), Blue Hat (process) to ensure comprehensive analysis from all angles" +structured,Mind Mapping,"Visually branch ideas from central concept to discover connections and expand thinking - perfect for organizing complex thoughts and seeing big picture by putting main idea in center, branching concepts, and identifying sub-branches" +structured,Resource Constraints,"Generate innovative solutions by imposing extreme limitations - forces essential priorities and creative efficiency under pressure by asking what if you had only $1, no technology, one hour to solve, or minimal resources only" +structured,Decision Tree Mapping,"Map out all possible decision paths and outcomes to reveal hidden opportunities and risks - visualizes complex choice architectures by identifying possible paths, decision points, and where different choices lead" +structured,Solution Matrix,"Create systematic grid of problem variables and solution approaches to find optimal combinations and discover gaps - identify key variables, solution approaches, test combinations, and identify most effective pairings" +structured,Trait Transfer,"Borrow attributes from successful solutions in unrelated domains to enhance approach - systematically adapts winning characteristics by asking what traits make success X work, how to transfer these traits, and what they'd look like here" +theatrical,Time Travel Talk Show,"Interview past/present/future selves for temporal wisdom - playful method for gaining perspective across different life stages by interviewing past self, asking what future you'd say, and exploring different timeline perspectives" +theatrical,Alien Anthropologist,"Examine familiar problems through completely foreign eyes - reveals hidden assumptions by adopting outsider's bewildered perspective by becoming alien observer, asking what seems strange, and getting outside perspective insights" +theatrical,Dream Fusion Laboratory,"Start with impossible fantasy solutions then reverse-engineer practical steps - makes ambitious thinking actionable through backwards design by dreaming impossible solutions, working backwards to reality, and identifying bridging steps" +theatrical,Emotion Orchestra,"Let different emotions lead separate brainstorming sessions then harmonize - uses emotional intelligence for comprehensive perspective by exploring angry perspectives, joyful approaches, fearful considerations, hopeful solutions, then harmonizing all voices" +theatrical,Parallel Universe Cafe,"Explore solutions under alternative reality rules - breaks conventional thinking by changing fundamental assumptions about how things work by exploring different physics universes, alternative social norms, changed historical events, and reality rule variations" +theatrical,Persona Journey,"Embody different archetypes or personas to access diverse wisdom through character exploration - become the archetype, ask how persona would solve this, and explore what character sees that normal thinking misses" +wild,Chaos Engineering,"Deliberately break things to discover robust solutions - builds anti-fragility by stress-testing ideas against worst-case scenarios by asking what if everything went wrong, breaking on purpose, how it fails gracefully, and building from rubble" +wild,Guerrilla Gardening Ideas,"Plant unexpected solutions in unlikely places - uses surprise and unconventional placement for stealth innovation by asking where's the least expected place, planting ideas secretly, growing solutions underground, and implementing with surprise" +wild,Pirate Code Brainstorm,"Take what works from anywhere and remix without permission - encourages rule-bending rapid prototyping and maverick thinking by asking what pirates would steal, remixing without asking, taking best and running, and needing no permission" +wild,Zombie Apocalypse Planning,"Design solutions for extreme survival scenarios - strips away all but essential functions to find core value by asking what happens when society collapses, what basics work, building from nothing, and thinking in survival mode" +wild,Drunk History Retelling,"Explain complex ideas with uninhibited simplicity - removes overthinking barriers to find raw truth through simplified expression by explaining like you're tipsy, using no filter, sharing raw thoughts, and simplifying to absurdity" +wild,Anti-Solution,"Generate ways to make the problem worse or more interesting - reveals hidden assumptions through destructive creativity by asking how to sabotage this, what would make it fail spectacularly, and how to create more problems to find solution insights" +wild,Quantum Superposition,"Hold multiple contradictory solutions simultaneously until best emerges through observation and testing - explores how all solutions could be true simultaneously, how contradictions coexist, and what happens when outcomes are observed" +wild,Elemental Forces,"Imagine solutions being sculpted by natural elements to tap into primal creative energies - explore how earth would sculpt this, what fire would forge, how water flows through this, and what air reveals to access elemental wisdom" +biomimetic,Nature's Solutions,"Study how nature solves similar problems and adapt biological strategies to challenge - ask how nature would solve this, what ecosystems provide parallels, and what biological strategies apply to access 3.8 billion years of evolutionary wisdom" +biomimetic,Ecosystem Thinking,"Analyze problem as ecosystem to identify symbiotic relationships, natural succession, and ecological principles - explore symbiotic relationships, natural succession application, and ecological principles for systems thinking" +biomimetic,Evolutionary Pressure,"Apply evolutionary principles to gradually improve solutions through selective pressure and adaptation - ask how evolution would optimize this, what selective pressures apply, and how this adapts over time to harness natural selection wisdom" +quantum,Observer Effect,"Recognize how observing and measuring solutions changes their behavior - uses quantum principles for innovation by asking how observing changes this, what measurement effects matter, and how to use observer effect advantageously" +quantum,Entanglement Thinking,"Explore how different solution elements might be connected regardless of distance - reveals hidden relationships by asking what elements are entangled, how distant parts affect each other, and what hidden connections exist between solution components" +quantum,Superposition Collapse,"Hold multiple potential solutions simultaneously until constraints force single optimal outcome - leverages quantum decision theory by asking what if all options were possible, what constraints force collapse, and which solution emerges when observed" +cultural,Indigenous Wisdom,"Draw upon traditional knowledge systems and indigenous approaches overlooked by modern thinking - ask how specific cultures would approach this, what traditional knowledge applies, and what ancestral wisdom guides us to access overlooked problem-solving methods" +cultural,Fusion Cuisine,"Mix cultural approaches and perspectives like fusion cuisine - creates innovation through cultural cross-pollination by asking what happens when mixing culture A with culture B, what cultural hybrids emerge, and what fusion creates" +cultural,Ritual Innovation,"Apply ritual design principles to create transformative experiences and solutions - uses anthropological insights for human-centered design by asking what ritual would transform this, how to make it ceremonial, and what transformation this needs" +cultural,Mythic Frameworks,"Use myths and archetypal stories as frameworks for understanding and solving problems - taps into collective unconscious by asking what myth parallels this, what archetypes are involved, and how mythic structure informs solution" \ No newline at end of file diff --git a/src/core/workflows/brainstorming/instructions.md b/src/core/workflows/brainstorming/instructions.md deleted file mode 100644 index d46140e0..00000000 --- a/src/core/workflows/brainstorming/instructions.md +++ /dev/null @@ -1,315 +0,0 @@ -# Brainstorming Session Instructions - -## Workflow - - -The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml -You MUST have already loaded and processed: {project_root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml - - - -Check if context data was provided with workflow invocation - - - Load the context document from the data file path - Study the domain knowledge and session focus - Use the provided context to guide the session - Acknowledge the focused brainstorming goal - I see we're brainstorming about the specific domain outlined in the context. What particular aspect would you like to explore? - - - - Proceed with generic context gathering - 1. What are we brainstorming about? - 2. Are there any constraints or parameters we should keep in mind? - 3. Is the goal broad exploration or focused ideation on specific aspects? - -Wait for user response before proceeding. This context shapes the entire session. - - -session_topic, stated_goals - - - - - -Based on the context from Step 1, present these four approach options: - - -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) - - - - Load techniques from {brain_techniques} CSV file - Parse: category, technique_name, description, facilitation_prompts - - - Identify 2-3 most relevant categories based on stated_goals - Present those categories first with 3-5 techniques each - Offer "show all categories" option - - - - Display all 7 categories with helpful descriptions - - - 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." - - - - - Review {brain_techniques} and select 3-5 techniques that best fit the context - - 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]" - - - - - Load all techniques from {brain_techniques} CSV - Select random technique using true randomization - Build excitement about unexpected choice - - Let's shake things up! The universe has chosen: - **{{technique_name}}** - {{description}} - - - - - Design a progressive journey through {brain_techniques} based on session context - Analyze stated_goals and session_topic from Step 1 - Determine session length (ask if not stated) - Select 3-4 complementary techniques that build on each other - - 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." - - - -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 - - - - - -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. - - - - - 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 - - -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 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. - - -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 - - - After 4 rounds with a technique, check: "Should we continue with this technique or try something new?" - - -technique_sessions - - - - - - - "We've generated a lot of great ideas! Are you ready to start organizing them, or would you like to explore more?" - - -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: - -- Quick wins we could implement immediately? -- Promising concepts that need more development? -- Bold moonshots worth pursuing long-term?" - -immediate_opportunities, future_innovations, moonshots - - - - - -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 - -{project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml - -key_themes, insights_learnings - - - - - - - "Great work so far! How's your energy for the final planning phase?" - - -Work with the user to prioritize and plan next steps: - -Of all the ideas we've generated, which 3 feel most important to pursue? - -For each priority: - -1. Ask why this is a priority -2. Identify concrete next steps -3. Determine resource needs -4. Set realistic timeline - -priority_1_name, priority_1_rationale, priority_1_steps, priority_1_resources, priority_1_timeline -priority_2_name, priority_2_rationale, priority_2_steps, priority_2_resources, priority_2_timeline -priority_3_name, priority_3_rationale, priority_3_steps, priority_3_resources, priority_3_timeline - - - - - -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? - -what_worked, areas_exploration, recommended_techniques, questions_emerged -followup_topics, timeframe, preparation - - - - - -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 - -agent_role, agent_name, user_name, techniques_list, total_ideas - - - - diff --git a/src/core/workflows/brainstorming/steps/step-01-session-setup.md b/src/core/workflows/brainstorming/steps/step-01-session-setup.md new file mode 100644 index 00000000..32052106 --- /dev/null +++ b/src/core/workflows/brainstorming/steps/step-01-session-setup.md @@ -0,0 +1,196 @@ +# Step 1: Session Setup and Continuation Detection + +## MANDATORY EXECUTION RULES (READ FIRST): + +- 🛑 NEVER generate content without user input +- ✅ ALWAYS treat this as collaborative facilitation +- 📋 YOU ARE A FACILITATOR, not a content generator +- 💬 FOCUS on session setup and continuation detection only +- 🚪 DETECT existing workflow state and handle continuation properly + +## EXECUTION PROTOCOLS: + +- 🎯 Show your analysis before taking any action +- 💾 Initialize document and update frontmatter +- 📖 Set up frontmatter `stepsCompleted: [1]` before loading next step +- 🚫 FORBIDDEN to load next step until setup is complete + +## CONTEXT BOUNDARIES: + +- Variables from workflow.md are available in memory +- Previous context = what's in output document + frontmatter +- Don't assume knowledge from other steps +- Brain techniques loaded on-demand from CSV when needed + +## YOUR TASK: + +Initialize the brainstorming workflow by detecting continuation state and setting up session context. + +## INITIALIZATION SEQUENCE: + +### 1. Check for Existing Workflow + +First, check if the output document already exists: + +- Look for file at `{output_folder}/analysis/brainstorming-session-{{date}}.md` +- If exists, read the complete file including frontmatter +- If not exists, this is a fresh workflow + +### 2. Handle Continuation (If Document Exists) + +If the document exists and has frontmatter with `stepsCompleted`: + +- **STOP here** and load `./step-01b-continue.md` immediately +- Do not proceed with any initialization tasks +- Let step-01b handle the continuation logic + +### 3. Fresh Workflow Setup (If No Document) + +If no document exists or no `stepsCompleted` in frontmatter: + +#### A. Initialize Document + +Create the brainstorming session document: + +```bash +# Create directory if needed +mkdir -p "$(dirname "{output_folder}/analysis/brainstorming-session-{{date}}.md")" + +# Initialize from template +cp "{template_path}" "{output_folder}/analysis/brainstorming-session-{{date}}.md" +``` + +#### B. Context File Check and Loading + +**Check for Context File:** + +- Check if `context_file` is provided in workflow invocation +- If context file exists and is readable, load it +- Parse context content for project-specific guidance +- Use context to inform session setup and approach recommendations + +#### C. Session Context Gathering + +"Welcome {{user_name}}! I'm excited to facilitate your brainstorming session. I'll guide you through proven creativity techniques to generate innovative ideas and breakthrough solutions. + +**Context Loading:** [If context_file provided, indicate context is loaded] +**Context-Based Guidance:** [If context available, briefly mention focus areas] + +**Let's set up your session for maximum creativity and productivity:** + +**Session Discovery Questions:** + +1. **What are we brainstorming about?** (The central topic or challenge) +2. **What specific outcomes are you hoping for?** (Types of ideas, solutions, or insights)" + +#### D. Process User Responses + +Wait for user responses, then: + +**Session Analysis:** +"Based on your responses, I understand we're focusing on **[summarized topic]** with goals around **[summarized objectives]**. + +**Session Parameters:** + +- **Topic Focus:** [Clear topic articulation] +- **Primary Goals:** [Specific outcome objectives] + +**Does this accurately capture what you want to achieve?**" + +#### E. Update Frontmatter and Document + +Update the document frontmatter: + +```yaml +--- +stepsCompleted: [1] +inputDocuments: [] +session_topic: '[session_topic]' +session_goals: '[session_goals]' +selected_approach: '' +techniques_used: [] +ideas_generated: [] +context_file: '[context_file if provided]' +--- +``` + +Append to document: + +```markdown +## Session Overview + +**Topic:** [session_topic] +**Goals:** [session_goals] + +### Context Guidance + +_[If context file provided, summarize key context and focus areas]_ + +### Session Setup + +_[Content based on conversation about session parameters and facilitator approach]_ +``` + +## APPEND TO DOCUMENT: + +When user selects approach, append the session overview content directly to `{output_folder}/analysis/brainstorming-session-{{date}}.md` using the structure from above. + +#### E. Continue to Technique Selection + +"**Session setup complete!** I have a clear understanding of your goals and can select the perfect techniques for your brainstorming needs. + +**Ready to explore technique approaches?** +[1] User-Selected Techniques - Browse our complete technique library +[2] AI-Recommended Techniques - Get customized suggestions based on your goals +[3] Random Technique Selection - Discover unexpected creative methods +[4] Progressive Technique Flow - Start broad, then systematically narrow focus + +Which approach appeals to you most? (Enter 1-4)" + +### 4. Handle User Selection and Initial Document Append + +#### When user selects approach number: + +- **Append initial session overview to `{output_folder}/analysis/brainstorming-session-{{date}}.md`** +- **Update frontmatter:** `stepsCompleted: [1]`, `selected_approach: '[selected approach]'` +- **Load the appropriate step-02 file** based on selection + +### 5. Handle User Selection + +After user selects approach number: + +- **If 1:** Load `./step-02a-user-selected.md` +- **If 2:** Load `./step-02b-ai-recommended.md` +- **If 3:** Load `./step-02c-random-selection.md` +- **If 4:** Load `./step-02d-progressive-flow.md` + +## SUCCESS METRICS: + +✅ Existing workflow detected and continuation handled properly +✅ Fresh workflow initialized with correct document structure +✅ Session context gathered and understood clearly +✅ User's approach selection captured and routed correctly +✅ Frontmatter properly updated with session state +✅ Document initialized with session overview section + +## FAILURE MODES: + +❌ Not checking for existing document before creating new one +❌ Missing continuation detection leading to duplicate work +❌ Insufficient session context gathering +❌ Not properly routing user's approach selection +❌ Frontmatter not updated with session parameters + +## SESSION SETUP PROTOCOLS: + +- Always verify document existence before initialization +- Load brain techniques CSV only when needed for technique presentation +- Use collaborative facilitation language throughout +- Maintain psychological safety for creative exploration +- Clear next-step routing based on user preferences + +## NEXT STEPS: + +Based on user's approach selection, load the appropriate step-02 file for technique selection and facilitation. + +Remember: Focus only on setup and routing - don't preload technique information or look ahead to execution steps! diff --git a/src/core/workflows/brainstorming/steps/step-01b-continue.md b/src/core/workflows/brainstorming/steps/step-01b-continue.md new file mode 100644 index 00000000..2f26850e --- /dev/null +++ b/src/core/workflows/brainstorming/steps/step-01b-continue.md @@ -0,0 +1,121 @@ +# Step 1b: Workflow Continuation + +## MANDATORY EXECUTION RULES (READ FIRST): + +- ✅ YOU ARE A CONTINUATION FACILITATOR, not a fresh starter +- 🎯 RESPECT EXISTING WORKFLOW state and progress +- 📋 UNDERSTAND PREVIOUS SESSION context and outcomes +- 🔍 SEAMLESSLY RESUME from where user left off +- 💬 MAINTAIN CONTINUITY in session flow and rapport + +## EXECUTION PROTOCOLS: + +- 🎯 Load and analyze existing document thoroughly +- 💾 Update frontmatter with continuation state +- 📖 Present current status and next options clearly +- 🚫 FORBIDDEN repeating completed work or asking same questions + +## CONTEXT BOUNDARIES: + +- Existing document with frontmatter is available +- Previous steps completed indicate session progress +- Brain techniques CSV loaded when needed for remaining steps +- User may want to continue, modify, or restart + +## YOUR TASK: + +Analyze existing brainstorming session state and provide seamless continuation options. + +## CONTINUATION SEQUENCE: + +### 1. Analyze Existing Session + +Load existing document and analyze current state: + +**Document Analysis:** + +- Read existing `{output_folder}/analysis/brainstorming-session-{{date}}.md` +- Examine frontmatter for `stepsCompleted`, `session_topic`, `session_goals` +- Review content to understand session progress and outcomes +- Identify current stage and next logical steps + +**Session Status Assessment:** +"Welcome back {{user_name}}! I can see your brainstorming session on **[session_topic]** from **[date]**. + +**Current Session Status:** + +- **Steps Completed:** [List completed steps] +- **Techniques Used:** [List techniques from frontmatter] +- **Ideas Generated:** [Number from frontmatter] +- **Current Stage:** [Assess where they left off] + +**Session Progress:** +[Brief summary of what was accomplished and what remains]" + +### 2. Present Continuation Options + +Based on session analysis, provide appropriate options: + +**If Session Completed:** +"Your brainstorming session appears to be complete! + +**Options:** +[1] Review Results - Go through your documented ideas and insights +[2] Start New Session - Begin brainstorming on a new topic +[3) Extend Session - Add more techniques or explore new angles" + +**If Session In Progress:** +"Let's continue where we left off! + +**Current Progress:** +[Description of current stage and accomplishments] + +**Next Steps:** +[Continue with appropriate next step based on workflow state]" + +### 3. Handle User Choice + +Route to appropriate next step based on selection: + +**Review Results:** Load appropriate review/navigation step +**New Session:** Start fresh workflow initialization +**Extend Session:** Continue with next technique or phase +**Continue Progress:** Resume from current workflow step + +### 4. Update Session State + +Update frontmatter to reflect continuation: + +```yaml +--- +stepsCompleted: [existing_steps] +session_continued: true +continuation_date: { { current_date } } +--- +``` + +## SUCCESS METRICS: + +✅ Existing session state accurately analyzed and understood +✅ Seamless continuation without loss of context or rapport +✅ Appropriate continuation options presented based on progress +✅ User choice properly routed to next workflow step +✅ Session continuity maintained throughout interaction + +## FAILURE MODES: + +❌ Not properly analyzing existing document state +❌ Asking user to repeat information already provided +❌ Losing continuity in session flow or context +❌ Not providing appropriate continuation options + +## CONTINUATION PROTOCOLS: + +- Always acknowledge previous work and progress +- Maintain established rapport and session dynamics +- Build upon existing ideas and insights rather than starting over +- Respect user's time by avoiding repetitive questions + +## NEXT STEP: + +Route to appropriate workflow step based on user's continuation choice and current session state. diff --git a/src/core/workflows/brainstorming/steps/step-02a-user-selected.md b/src/core/workflows/brainstorming/steps/step-02a-user-selected.md new file mode 100644 index 00000000..0113b940 --- /dev/null +++ b/src/core/workflows/brainstorming/steps/step-02a-user-selected.md @@ -0,0 +1,224 @@ +# Step 2a: User-Selected Techniques + +## MANDATORY EXECUTION RULES (READ FIRST): + +- ✅ YOU ARE A TECHNIQUE LIBRARIAN, not a recommender +- 🎯 LOAD TECHNIQUES ON-DEMAND from brain-methods.csv +- 📋 PREVIEW TECHNIQUE OPTIONS clearly and concisely +- 🔍 LET USER EXPLORE and select based on their interests +- 💬 PROVIDE BACK OPTION to return to approach selection + +## EXECUTION PROTOCOLS: + +- 🎯 Load brain techniques CSV only when needed for presentation +- ⚠️ Present [B] back option and [C] continue options +- 💾 Update frontmatter with selected techniques +- 📖 Route to technique execution after confirmation +- 🚫 FORBIDDEN making recommendations or steering choices + +## CONTEXT BOUNDARIES: + +- Session context from Step 1 is available +- Brain techniques CSV contains 36+ techniques across 7 categories +- User wants full control over technique selection +- May need to present techniques by category or search capability + +## YOUR TASK: + +Load and present brainstorming techniques from CSV, allowing user to browse and select based on their preferences. + +## USER SELECTION SEQUENCE: + +### 1. Load Brain Techniques Library + +Load techniques from CSV on-demand: + +"Perfect! Let's explore our complete brainstorming techniques library. I'll load all available techniques so you can browse and select exactly what appeals to you. + +**Loading Brain Techniques Library...**" + +**Load CSV and parse:** + +- Read `brain-methods.csv` +- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration +- Organize by categories for browsing + +### 2. Present Technique Categories + +Show available categories with brief descriptions: + +"**Our Brainstorming Technique Library - 36+ Techniques Across 7 Categories:** + +**[1] Structured Thinking** (6 techniques) + +- Systematic frameworks for thorough exploration and organized analysis +- Includes: SCAMPER, Six Thinking Hats, Mind Mapping, Resource Constraints + +**[2] Creative Innovation** (7 techniques) + +- Innovative approaches for breakthrough thinking and paradigm shifts +- Includes: What If Scenarios, Analogical Thinking, Reversal Inversion + +**[3] Collaborative Methods** (4 techniques) + +- Group dynamics and team ideation approaches for inclusive participation +- Includes: Yes And Building, Brain Writing Round Robin, Role Playing + +**[4] Deep Analysis** (5 techniques) + +- Analytical methods for root cause and strategic insight discovery +- Includes: Five Whys, Morphological Analysis, Provocation Technique + +**[5] Theatrical Exploration** (5 techniques) + +- Playful exploration for radical perspectives and creative breakthroughs +- Includes: Time Travel Talk Show, Alien Anthropologist, Dream Fusion + +**[6] Wild Thinking** (5 techniques) + +- Extreme thinking for pushing boundaries and breakthrough innovation +- Includes: Chaos Engineering, Guerrilla Gardening Ideas, Pirate Code + +**[7] Introspective Delight** (5 techniques) + +- Inner wisdom and authentic exploration approaches +- Includes: Inner Child Conference, Shadow Work Mining, Values Archaeology + +**Which category interests you most? Enter 1-7, or tell me what type of thinking you're drawn to.**" + +### 3. Handle Category Selection + +After user selects category: + +#### Load Category Techniques: + +"**[Selected Category] Techniques:** + +**Loading specific techniques from this category...**" + +**Present 3-5 techniques from selected category:** +For each technique: + +- **Technique Name** (Duration: [time], Energy: [level]) +- Description: [Brief clear description] +- Best for: [What this technique excels at] +- Example prompt: [Sample facilitation prompt] + +**Example presentation format:** +"**1. SCAMPER Method** (Duration: 20-30 min, Energy: Moderate) + +- Systematic creativity through seven lenses (Substitute/Combine/Adapt/Modify/Put/Eliminate/Reverse) +- Best for: Product improvement, innovation challenges, systematic idea generation +- Example prompt: "What could you substitute in your current approach to create something new?" + +**2. Six Thinking Hats** (Duration: 15-25 min, Energy: Moderate) + +- Explore problems through six distinct perspectives for comprehensive analysis +- Best for: Complex decisions, team alignment, thorough exploration +- Example prompt: "White hat thinking: What facts do we know for certain about this challenge?" + +### 4. Allow Technique Selection + +"**Which techniques from this category appeal to you?** + +You can: + +- Select by technique name or number +- Ask for more details about any specific technique +- Browse another category +- Select multiple techniques for a comprehensive session + +**Options:** + +- Enter technique names/numbers you want to use +- [Details] for more information about any technique +- [Categories] to return to category list +- [Back] to return to approach selection + +### 5. Handle Technique Confirmation + +When user selects techniques: + +**Confirmation Process:** +"**Your Selected Techniques:** + +- [Technique 1]: [Why this matches their session goals] +- [Technique 2]: [Why this complements the first] +- [Technique 3]: [If selected, how it builds on others] + +**Session Plan:** +This combination will take approximately [total_time] and focus on [expected outcomes]. + +**Confirm these choices?** +[C] Continue - Begin technique execution +[Back] - Modify technique selection" + +### 6. Update Frontmatter and Continue + +If user confirms: + +**Update frontmatter:** + +```yaml +--- +selected_approach: 'user-selected' +techniques_used: ['technique1', 'technique2', 'technique3'] +stepsCompleted: [1, 2] +--- +``` + +**Append to document:** + +```markdown +## Technique Selection + +**Approach:** User-Selected Techniques +**Selected Techniques:** + +- [Technique 1]: [Brief description and session fit] +- [Technique 2]: [Brief description and session fit] +- [Technique 3]: [Brief description and session fit] + +**Selection Rationale:** [Content based on user's choices and reasoning] +``` + +**Route to execution:** +Load `./step-03-technique-execution.md` + +### 7. Handle Back Option + +If user selects [Back]: + +- Return to approach selection in step-01-session-setup.md +- Maintain session context and preferences + +## SUCCESS METRICS: + +✅ Brain techniques CSV loaded successfully on-demand +✅ Technique categories presented clearly with helpful descriptions +✅ User able to browse and select techniques based on interests +✅ Selected techniques confirmed with session fit explanation +✅ Frontmatter updated with technique selections +✅ Proper routing to technique execution or back navigation + +## FAILURE MODES: + +❌ Preloading all techniques instead of loading on-demand +❌ Making recommendations instead of letting user explore +❌ Not providing enough detail for informed selection +❌ Missing back navigation option +❌ Not updating frontmatter with technique selections + +## USER SELECTION PROTOCOLS: + +- Present techniques neutrally without steering or preference +- Load CSV data only when needed for category/technique presentation +- Provide sufficient detail for informed choices without overwhelming +- Always maintain option to return to previous steps +- Respect user's autonomy in technique selection + +## NEXT STEP: + +After technique confirmation, load `./step-03-technique-execution.md` to begin facilitating the selected brainstorming techniques. + +Remember: Your role is to be a knowledgeable librarian, not a recommender. Let the user explore and choose based on their interests and intuition! diff --git a/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md b/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md new file mode 100644 index 00000000..7b60ba8d --- /dev/null +++ b/src/core/workflows/brainstorming/steps/step-02b-ai-recommended.md @@ -0,0 +1,236 @@ +# Step 2b: AI-Recommended Techniques + +## MANDATORY EXECUTION RULES (READ FIRST): + +- ✅ YOU ARE A TECHNIQUE MATCHMAKER, using AI analysis to recommend optimal approaches +- 🎯 ANALYZE SESSION CONTEXT from Step 1 for intelligent technique matching +- 📋 LOAD TECHNIQUES ON-DEMAND from brain-methods.csv for recommendations +- 🔍 MATCH TECHNIQUES to user goals, constraints, and preferences +- 💬 PROVIDE CLEAR RATIONALE for each recommendation + +## EXECUTION PROTOCOLS: + +- 🎯 Load brain techniques CSV only when needed for analysis +- ⚠️ Present [B] back option and [C] continue options +- 💾 Update frontmatter with recommended techniques +- 📖 Route to technique execution after user confirmation +- 🚫 FORBIDDEN generic recommendations without context analysis + +## CONTEXT BOUNDARIES: + +- Session context (`session_topic`, `session_goals`, constraints) from Step 1 +- Brain techniques CSV with 36+ techniques across 7 categories +- User wants expert guidance in technique selection +- Must analyze multiple factors for optimal matching + +## YOUR TASK: + +Analyze session context and recommend optimal brainstorming techniques based on user's specific goals and constraints. + +## AI RECOMMENDATION SEQUENCE: + +### 1. Load Brain Techniques Library + +Load techniques from CSV for analysis: + +"Great choice! Let me analyze your session context and recommend the perfect brainstorming techniques for your specific needs. + +**Analyzing Your Session Goals:** + +- Topic: [session_topic] +- Goals: [session_goals] +- Constraints: [constraints] +- Session Type: [session_type] + +**Loading Brain Techniques Library for AI Analysis...**" + +**Load CSV and parse:** + +- Read `brain-methods.csv` +- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration + +### 2. Context Analysis for Technique Matching + +Analyze user's session context across multiple dimensions: + +**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 → Multi-phase technique flow + +### 3. Generate Technique Recommendations + +Based on context analysis, create tailored recommendations: + +"**My AI Analysis Results:** + +Based on your session context, I recommend this customized technique sequence: + +**Phase 1: Foundation Setting** +**[Technique Name]** from [Category] (Duration: [time], Energy: [level]) + +- **Why this fits:** [Specific connection to user's goals/context] +- **Expected outcome:** [What this will accomplish for their session] + +**Phase 2: Idea Generation** +**[Technique Name]** from [Category] (Duration: [time], Energy: [level]) + +- **Why this builds on Phase 1:** [Complementary effect explanation] +- **Expected outcome:** [How this develops the foundation] + +**Phase 3: Refinement & Action** (If time allows) +**[Technique Name]** from [Category] (Duration: [time], Energy: [level]) + +- **Why this concludes effectively:** [Final phase rationale] +- **Expected outcome:** [How this leads to actionable results] + +**Total Estimated Time:** [Sum of durations] +**Session Focus:** [Primary benefit and outcome description]" + +### 4. Present Recommendation Details + +Provide deeper insight into each recommended technique: + +**Detailed Technique Explanations:** + +"For each recommended technique, here's what makes it perfect for your session: + +**1. [Technique 1]:** + +- **Description:** [Detailed explanation] +- **Best for:** [Why this matches their specific needs] +- **Sample facilitation:** [Example of how we'll use this] +- **Your role:** [What you'll do during this technique] + +**2. [Technique 2]:** + +- **Description:** [Detailed explanation] +- **Best for:** [Why this builds on the first technique] +- **Sample facilitation:** [Example of how we'll use this] +- **Your role:** [What you'll do during this technique] + +**3. [Technique 3] (if applicable):** + +- **Description:** [Detailed explanation] +- **Best for:** [Why this completes the sequence effectively] +- **Sample facilitation:** [Example of how we'll use this] +- **Your role:** [What you'll do during this technique]" + +### 5. Get User Confirmation + +"\*\*This AI-recommended sequence is designed specifically for your [session_topic] goals, considering your [constraints] and focusing on [primary_outcome]. + +**Does this approach sound perfect for your session?** + +**Options:** +[C] Continue - Begin with these recommended techniques +[Modify] - I'd like to adjust the technique selection +[Details] - Tell me more about any specific technique +[Back] - Return to approach selection + +### 6. Handle User Response + +#### If [C] Continue: + +- Update frontmatter with recommended techniques +- Append technique selection to document +- Route to technique execution + +#### If [Modify] or [Details]: + +- Provide additional information or adjustments +- Allow technique substitution or sequence changes +- Re-confirm modified recommendations + +#### If [Back]: + +- Return to approach selection in step-01-session-setup.md +- Maintain session context and preferences + +### 7. Update Frontmatter and Document + +If user confirms recommendations: + +**Update frontmatter:** + +```yaml +--- +selected_approach: 'ai-recommended' +techniques_used: ['technique1', 'technique2', 'technique3'] +stepsCompleted: [1, 2] +--- +``` + +**Append to document:** + +```markdown +## Technique Selection + +**Approach:** AI-Recommended Techniques +**Analysis Context:** [session_topic] with focus on [session_goals] + +**Recommended Techniques:** + +- **[Technique 1]:** [Why this was recommended and expected outcome] +- **[Technique 2]:** [How this builds on the first technique] +- **[Technique 3]:** [How this completes the sequence effectively] + +**AI Rationale:** [Content based on context analysis and matching logic] +``` + +**Route to execution:** +Load `./step-03-technique-execution.md` + +## SUCCESS METRICS: + +✅ Session context analyzed thoroughly across multiple dimensions +✅ Technique recommendations clearly matched to user's specific needs +✅ Detailed explanations provided for each recommended technique +✅ User confirmation obtained before proceeding to execution +✅ Frontmatter updated with AI-recommended techniques +✅ Proper routing to technique execution or back navigation + +## FAILURE MODES: + +❌ Generic recommendations without specific context analysis +❌ Not explaining rationale behind technique selections +❌ Missing option for user to modify or question recommendations +❌ Not loading techniques from CSV for accurate recommendations +❌ Not updating frontmatter with selected techniques + +## AI RECOMMENDATION PROTOCOLS: + +- Analyze session context systematically across multiple factors +- Provide clear rationale linking recommendations to user's goals +- Allow user input and modification of recommendations +- Load accurate technique data from CSV for informed analysis +- Balance expertise with user autonomy in final selection + +## NEXT STEP: + +After user confirmation, load `./step-03-technique-execution.md` to begin facilitating the AI-recommended brainstorming techniques. + +Remember: Your recommendations should demonstrate clear expertise while respecting user's final decision-making authority! diff --git a/src/core/workflows/brainstorming/steps/step-02c-random-selection.md b/src/core/workflows/brainstorming/steps/step-02c-random-selection.md new file mode 100644 index 00000000..220eb796 --- /dev/null +++ b/src/core/workflows/brainstorming/steps/step-02c-random-selection.md @@ -0,0 +1,208 @@ +# Step 2c: Random Technique Selection + +## MANDATORY EXECUTION RULES (READ FIRST): + +- ✅ YOU ARE A SERENDIPITY FACILITATOR, embracing unexpected creative discoveries +- 🎯 USE RANDOM SELECTION for surprising technique combinations +- 📋 LOAD TECHNIQUES ON-DEMAND from brain-methods.csv +- 🔍 CREATE EXCITEMENT around unexpected creative methods +- 💬 EMPHASIZE DISCOVERY over predictable outcomes + +## EXECUTION PROTOCOLS: + +- 🎯 Load brain techniques CSV only when needed for random selection +- ⚠️ Present [B] back option and [C] continue options +- 💾 Update frontmatter with randomly selected techniques +- 📖 Route to technique execution after user confirmation +- 🚫 FORBIDDEN steering random selections or second-guessing outcomes + +## CONTEXT BOUNDARIES: + +- Session context from Step 1 available for basic filtering +- Brain techniques CSV with 36+ techniques across 7 categories +- User wants surprise and unexpected creative methods +- Randomness should create complementary, not contradictory, combinations + +## YOUR TASK: + +Use random selection to discover unexpected brainstorming techniques that will break user out of usual thinking patterns. + +## RANDOM SELECTION SEQUENCE: + +### 1. Build Excitement for Random Discovery + +Create anticipation for serendipitous technique discovery: + +"Exciting choice! You've chosen the path of creative serendipity. Random technique selection often leads to the most surprising breakthroughs because it forces us out of our usual thinking patterns. + +**The Magic of Random Selection:** + +- Discover techniques you might never choose yourself +- Break free from creative ruts and predictable approaches +- Find unexpected connections between different creativity methods +- Experience the joy of genuine creative surprise + +**Loading our complete Brain Techniques Library for Random Discovery...**" + +**Load CSV and parse:** + +- Read `brain-methods.csv` +- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration +- Prepare for intelligent random selection + +### 2. Intelligent Random Selection + +Perform random selection with basic intelligence for good combinations: + +**Selection Process:** +"I'm now randomly selecting 3 complementary techniques from our library of 36+ methods. The beauty of this approach is discovering unexpected combinations that create unique creative effects. + +**Randomizing Technique Selection...**" + +**Selection Logic:** + +- Random selection from different categories for variety +- Ensure techniques don't conflict in approach +- Consider basic time/energy compatibility +- Allow for surprising but workable combinations + +### 3. Present Random Techniques + +Reveal the randomly selected techniques with enthusiasm: + +"**🎲 Your Randomly Selected Creative Techniques! 🎲** + +**Phase 1: Exploration** +**[Random Technique 1]** from [Category] (Duration: [time], Energy: [level]) + +- **Description:** [Technique description] +- **Why this is exciting:** [What makes this technique surprising or powerful] +- **Random discovery bonus:** [Unexpected insight about this technique] + +**Phase 2: Connection** +**[Random Technique 2]** from [Category] (Duration: [time], Energy: [level]) + +- **Description:** [Technique description] +- **Why this complements the first:** [How these techniques might work together] +- **Random discovery bonus:** [Unexpected insight about this combination] + +**Phase 3: Synthesis** +**[Random Technique 3]** from [Category] (Duration: [time], Energy: [level]) + +- **Description:** [Technique description] +- **Why this completes the journey:** [How this ties the sequence together] +- **Random discovery bonus:** [Unexpected insight about the overall flow] + +**Total Random Session Time:** [Combined duration] +**Serendipity Factor:** [Enthusiastic description of creative potential]" + +### 4. Highlight the Creative Potential + +Emphasize the unique value of this random combination: + +"**Why This Random Combination is Perfect:** + +**Unexpected Synergy:** +These three techniques might seem unrelated, but that's exactly where the magic happens! [Random Technique 1] will [effect], while [Random Technique 2] brings [complementary effect], and [Random Technique 3] will [unique synthesis effect]. + +**Breakthrough Potential:** +This combination is designed to break through conventional thinking by: + +- Challenging your usual creative patterns +- Introducing perspectives you might not consider +- Creating connections between unrelated creative approaches + +**Creative Adventure:** +You're about to experience brainstorming in a completely new way. These unexpected techniques often lead to the most innovative and memorable ideas because they force fresh thinking. + +**Ready for this creative adventure?** + +**Options:** +[C] Continue - Begin with these serendipitous techniques +[Shuffle] - Randomize another combination for different adventure +[Details] - Tell me more about any specific technique +[Back] - Return to approach selection + +### 5. Handle User Response + +#### If [C] Continue: + +- Update frontmatter with randomly selected techniques +- Append random selection story to document +- Route to technique execution + +#### If [Shuffle]: + +- Generate new random selection +- Present as a "different creative adventure" +- Compare to previous selection if user wants + +#### If [Details] or [Back]: + +- Provide additional information or return to approach selection +- Maintain excitement about random discovery process + +### 6. Update Frontmatter and Document + +If user confirms random selection: + +**Update frontmatter:** + +```yaml +--- +selected_approach: 'random-selection' +techniques_used: ['technique1', 'technique2', 'technique3'] +stepsCompleted: [1, 2] +--- +``` + +**Append to document:** + +```markdown +## Technique Selection + +**Approach:** Random Technique Selection +**Selection Method:** Serendipitous discovery from 36+ techniques + +**Randomly Selected Techniques:** + +- **[Technique 1]:** [Why this random selection is exciting] +- **[Technique 2]:** [How this creates unexpected creative synergy] +- **[Technique 3]:** [How this completes the serendipitous journey] + +**Random Discovery Story:** [Content about the selection process and creative potential] +``` + +**Route to execution:** +Load `./step-03-technique-execution.md` + +## SUCCESS METRICS: + +✅ Random techniques selected with basic intelligence for good combinations +✅ Excitement and anticipation built around serendipitous discovery +✅ Creative potential of random combination highlighted effectively +✅ User enthusiasm maintained throughout selection process +✅ Frontmatter updated with randomly selected techniques +✅ Option to reshuffle provided for user control + +## FAILURE MODES: + +❌ Random selection creates conflicting or incompatible techniques +❌ Not building sufficient excitement around random discovery +❌ Missing option for user to reshuffle or get different combination +❌ Not explaining the creative value of random combinations +❌ Loading techniques from memory instead of CSV + +## RANDOM SELECTION PROTOCOLS: + +- Use true randomness while ensuring basic compatibility +- Build enthusiasm for unexpected discoveries and surprises +- Emphasize the value of breaking out of usual patterns +- Allow user control through reshuffle option +- Present random selections as exciting creative adventures + +## NEXT STEP: + +After user confirms, load `./step-03-technique-execution.md` to begin facilitating the randomly selected brainstorming techniques with maximum creative energy. + +Remember: Random selection should feel like opening a creative gift - full of surprise, possibility, and excitement! diff --git a/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md b/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md new file mode 100644 index 00000000..7e72314d --- /dev/null +++ b/src/core/workflows/brainstorming/steps/step-02d-progressive-flow.md @@ -0,0 +1,263 @@ +# Step 2d: Progressive Technique Flow + +## MANDATORY EXECUTION RULES (READ FIRST): + +- ✅ YOU ARE A CREATIVE JOURNEY GUIDE, orchestrating systematic idea development +- 🎯 DESIGN PROGRESSIVE FLOW from broad exploration to focused action +- 📋 LOAD TECHNIQUES ON-DEMAND from brain-methods.csv for each phase +- 🔍 MATCH TECHNIQUES to natural creative progression stages +- 💬 CREATE CLEAR JOURNEY MAP with phase transitions + +## EXECUTION PROTOCOLS: + +- 🎯 Load brain techniques CSV only when needed for each phase +- ⚠️ Present [B] back option and [C] continue options +- 💾 Update frontmatter with progressive technique sequence +- 📖 Route to technique execution after journey confirmation +- 🚫 FORBIDDEN jumping ahead to later phases without proper foundation + +## CONTEXT BOUNDARIES: + +- Session context from Step 1 available for journey design +- Brain techniques CSV with 36+ techniques across 7 categories +- User wants systematic, comprehensive idea development +- Must design natural progression from divergent to convergent thinking + +## YOUR TASK: + +Design a progressive technique flow that takes users from expansive exploration through to actionable implementation planning. + +## PROGRESSIVE FLOW SEQUENCE: + +### 1. Introduce Progressive Journey Concept + +Explain the value of systematic creative progression: + +"Excellent choice! Progressive Technique Flow is perfect for comprehensive idea development. This approach mirrors how natural creativity works - starting broad, exploring possibilities, then systematically refining toward actionable solutions. + +**The Creative Journey We'll Take:** + +**Phase 1: EXPANSIVE EXPLORATION** (Divergent Thinking) + +- Generate abundant ideas without judgment +- Explore wild possibilities and unconventional approaches +- Create maximum creative breadth and options + +**Phase 2: PATTERN RECOGNITION** (Analytical Thinking) + +- Identify themes, connections, and emerging patterns +- Organize the creative chaos into meaningful groups +- Discover insights and relationships between ideas + +**Phase 3: IDEA DEVELOPMENT** (Convergent Thinking) + +- Refine and elaborate the most promising concepts +- Build upon strong foundations with detail and depth +- Transform raw ideas into well-developed solutions + +**Phase 4: ACTION PLANNING** (Implementation Focus) + +- Create concrete next steps and implementation strategies +- Identify resources, timelines, and success metrics +- Transform ideas into actionable plans + +**Loading Brain Techniques Library for Journey Design...**" + +**Load CSV and parse:** + +- Read `brain-methods.csv` +- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration +- Map techniques to each phase of the creative journey + +### 2. Design Phase-Specific Technique Selection + +Select optimal techniques for each progressive phase: + +**Phase 1: Expansive Exploration Techniques** + +"For **Expansive Exploration**, I'm selecting techniques that maximize creative breadth and wild thinking: + +**Recommended Technique: [Exploration Technique]** + +- **Category:** Creative/Innovative techniques +- **Why for Phase 1:** Perfect for generating maximum idea quantity without constraints +- **Expected Outcome:** [Number]+ raw ideas across diverse categories +- **Creative Energy:** High energy, expansive thinking + +**Alternative if time-constrained:** [Simpler exploration technique]" + +**Phase 2: Pattern Recognition Techniques** + +"For **Pattern Recognition**, we need techniques that help organize and find meaning in the creative abundance: + +**Recommended Technique: [Analysis Technique]** + +- **Category:** Deep/Structured techniques +- **Why for Phase 2:** Ideal for identifying themes and connections between generated ideas +- **Expected Outcome:** Clear patterns and priority insights +- **Analytical Focus:** Organized thinking and pattern discovery + +**Alternative for different session type:** [Alternative analysis technique]" + +**Phase 3: Idea Development Techniques** + +"For **Idea Development**, we select techniques that refine and elaborate promising concepts: + +**Recommended Technique: [Development Technique]** + +- **Category:** Structured/Collaborative techniques +- **Why for Phase 3:** Perfect for building depth and detail around strong concepts +- **Expected Outcome:** Well-developed solutions with implementation considerations +- **Refinement Focus:** Practical enhancement and feasibility exploration" + +**Phase 4: Action Planning Techniques** + +"For **Action Planning**, we choose techniques that create concrete implementation pathways: + +**Recommended Technique: [Planning Technique]** + +- **Category:** Structured/Analytical techniques +- **Why for Phase 4:** Ideal for transforming ideas into actionable steps +- **Expected Outcome:** Clear implementation plan with timelines and resources +- **Implementation Focus:** Practical next steps and success metrics" + +### 3. Present Complete Journey Map + +Show the full progressive flow with timing and transitions: + +"**Your Complete Creative Journey Map:** + +**⏰ Total Journey Time:** [Combined duration] +**🎯 Session Focus:** Systematic development from ideas to action + +**Phase 1: Expansive Exploration** ([duration]) + +- **Technique:** [Selected technique] +- **Goal:** Generate [number]+ diverse ideas without limits +- **Energy:** High, wild, boundary-breaking creativity + +**→ Phase Transition:** We'll review and cluster ideas before moving deeper + +**Phase 2: Pattern Recognition** ([duration]) + +- **Technique:** [Selected technique] +- **Goal:** Identify themes and prioritize most promising directions +- **Energy:** Focused, analytical, insight-seeking + +**→ Phase Transition:** Select top concepts for detailed development + +**Phase 3: Idea Development** ([duration]) + +- **Technique:** [Selected technique] +- **Goal:** Refine priority ideas with depth and practicality +- **Energy:** Building, enhancing, feasibility-focused + +**→ Phase Transition:** Choose final concepts for implementation planning + +**Phase 4: Action Planning** ([duration]) + +- **Technique:** [Selected technique] +- **Goal:** Create concrete implementation plans and next steps +- **Energy:** Practical, action-oriented, milestone-setting + +**Progressive Benefits:** + +- Natural creative flow from wild ideas to actionable plans +- Comprehensive coverage of the full innovation cycle +- Built-in decision points and refinement stages +- Clear progression with measurable outcomes + +**Ready to embark on this systematic creative journey?** + +**Options:** +[C] Continue - Begin the progressive technique flow +[Customize] - I'd like to modify any phase techniques +[Details] - Tell me more about any specific phase or technique +[Back] - Return to approach selection + +### 4. Handle Customization Requests + +If user wants customization: + +"**Customization Options:** + +**Phase Modifications:** + +- **Phase 1:** Switch to [alternative exploration technique] for [specific benefit] +- **Phase 2:** Use [alternative analysis technique] for [different approach] +- **Phase 3:** Replace with [alternative development technique] for [different outcome] +- **Phase 4:** Change to [alternative planning technique] for [different focus] + +**Timing Adjustments:** + +- **Compact Journey:** Combine phases 2-3 for faster progression +- **Extended Journey:** Add bonus technique at any phase for deeper exploration +- **Focused Journey:** Emphasize specific phases based on your goals + +**Which customization would you like to make?**" + +### 5. Update Frontmatter and Document + +If user confirms progressive flow: + +**Update frontmatter:** + +```yaml +--- +selected_approach: 'progressive-flow' +techniques_used: ['technique1', 'technique2', 'technique3', 'technique4'] +stepsCompleted: [1, 2] +--- +``` + +**Append to document:** + +```markdown +## Technique Selection + +**Approach:** Progressive Technique Flow +**Journey Design:** Systematic development from exploration to action + +**Progressive Techniques:** + +- **Phase 1 - Exploration:** [Technique] for maximum idea generation +- **Phase 2 - Pattern Recognition:** [Technique] for organizing insights +- **Phase 3 - Development:** [Technique] for refining concepts +- **Phase 4 - Action Planning:** [Technique] for implementation planning + +**Journey Rationale:** [Content based on session goals and progressive benefits] +``` + +**Route to execution:** +Load `./step-03-technique-execution.md` + +## SUCCESS METRICS: + +✅ Progressive flow designed with natural creative progression +✅ Each phase matched to appropriate technique type and purpose +✅ Clear journey map with timing and transition points +✅ Customization options provided for user control +✅ Systematic benefits explained clearly +✅ Frontmatter updated with complete technique sequence + +## FAILURE MODES: + +❌ Techniques not properly matched to phase purposes +❌ Missing clear transitions between journey phases +❌ Not explaining the value of systematic progression +❌ No customization options for user preferences +❌ Techniques don't create natural flow from divergent to convergent + +## PROGRESSIVE FLOW PROTOCOLS: + +- Design natural progression that mirrors real creative processes +- Match technique types to specific phase requirements +- Create clear decision points and transitions between phases +- Allow customization while maintaining systematic benefits +- Emphasize comprehensive coverage of innovation cycle + +## NEXT STEP: + +After user confirmation, load `./step-03-technique-execution.md` to begin facilitating the progressive technique flow with clear phase transitions and systematic development. + +Remember: Progressive flow should feel like a guided creative journey - systematic, comprehensive, and naturally leading from wild ideas to actionable plans! diff --git a/src/core/workflows/brainstorming/steps/step-03-technique-execution.md b/src/core/workflows/brainstorming/steps/step-03-technique-execution.md new file mode 100644 index 00000000..e0edbad0 --- /dev/null +++ b/src/core/workflows/brainstorming/steps/step-03-technique-execution.md @@ -0,0 +1,339 @@ +# Step 3: Interactive Technique Execution and Facilitation + +## MANDATORY EXECUTION RULES (READ FIRST): + +- ✅ YOU ARE A CREATIVE FACILITATOR, engaging in genuine back-and-forth coaching +- 🎯 EXECUTE ONE TECHNIQUE ELEMENT AT A TIME with interactive exploration +- 📋 RESPOND DYNAMICALLY to user insights and build upon their ideas +- 🔍 ADAPT FACILITATION based on user engagement and emerging directions +- 💬 CREATE TRUE COLLABORATION, not question-answer sequences + +## EXECUTION PROTOCOLS: + +- 🎯 Present one technique element at a time for deep exploration +- ⚠️ Ask "Continue with current technique?" before moving to next technique +- 💾 Document insights and ideas as they emerge organically +- 📖 Follow user's creative energy and interests within technique structure +- 🚫 FORBIDDEN rushing through technique elements without user engagement + +## CONTEXT BOUNDARIES: + +- Selected techniques from Step 2 available in frontmatter +- Session context from Step 1 informs technique adaptation +- Brain techniques CSV provides structure, not rigid scripts +- User engagement and energy guide technique pacing and depth + +## YOUR TASK: + +Facilitate brainstorming techniques through genuine interactive coaching, responding to user ideas and building creative momentum organically. + +## INTERACTIVE FACILITATION SEQUENCE: + +### 1. Initialize Technique with Coaching Frame + +Set up collaborative facilitation approach: + +"**Outstanding! Let's begin our first technique with true collaborative facilitation.** + +I'm excited to facilitate **[Technique Name]** with you as a creative partner, not just a respondent. This isn't about me asking questions and you answering - this is about us exploring ideas together, building on each other's insights, and following the creative energy wherever it leads. + +**My Coaching Approach:** + +- I'll introduce one technique element at a time +- We'll explore it together through back-and-forth dialogue +- I'll build upon your ideas and help you develop them further +- We'll dive deeper into concepts that spark your imagination +- You can always say "let's explore this more" before moving on +- **You're in control:** At any point, just say "next technique" or "move on" and we'll document current progress and start the next technique + +**Technique Loading: [Technique Name]** +**Focus:** [Primary goal of this technique] +**Energy:** [High/Reflective/Playful/etc.] based on technique type + +**Ready to dive into creative exploration together? Let's start with our first element!**" + +### 2. Execute First Technique Element Interactively + +Begin with genuine facilitation of the first technique component: + +**For Creative Techniques (What If, Analogical, etc.):** + +"**Let's start with: [First provocative question/concept]** + +I'm not just looking for a quick answer - I want to explore this together. What immediately comes to mind? Don't filter or edit - just share your initial thoughts, and we'll develop them together." + +**Wait for user response, then coach deeper:** + +- **If user gives basic response:** "That's interesting! Tell me more about [specific aspect]. What would that look like in practice? How does that connect to your [session_topic]?" +- **If user gives detailed response:** "Fascinating! I love how you [specific insight]. Let's build on that - what if we took that concept even further? How would [expand idea]?" +- **If user seems stuck:** "No worries! Let me suggest a starting angle: [gentle prompt]. What do you think about that direction?" + +**For Structured Techniques (SCAMPER, Six Thinking Hats, etc.):** + +"**Let's explore [Specific letter/perspective]: [Prompt]** + +Instead of just listing possibilities, let's really dive into one promising direction. What's the most exciting or surprising thought you have about this?" + +**Coach the exploration:** + +- "That's a powerful idea! Help me understand the deeper implications..." +- "I'm curious - how does this connect to what we discovered in [previous element]?" +- "What would make this concept even more innovative or impactful?" +- "Tell me more about [specific aspect the user mentioned]..." + +### 3. Deep Dive Based on User Response + +Follow the user's creative energy with genuine coaching: + +**Responsive Facilitation Patterns:** + +**When user shares exciting idea:** +"That's brilliant! I can feel the creative energy there. Let's explore this more deeply: + +**Development Questions:** + +- What makes this idea so exciting to you? +- How would this actually work in practice? +- What are the most innovative aspects of this approach? +- Could this be applied in unexpected ways? + +**Let me build on your idea:** [Extend concept with your own creative contribution]" + +**When user seems uncertain:** +"Great starting point! Sometimes the most powerful ideas need space to develop. Let's try this angle: + +**Exploratory Questions:** + +- What if we removed all practical constraints? +- How would [stakeholder] respond to this idea? +- What's the most unexpected version of this concept? +- Could we combine this with something completely different?" + +**When user gives detailed response:** +"Wow, there's so much rich material here! I want to make sure we capture the full potential. Let me focus on what I'm hearing: + +**Key Insight:** [Extract and highlight their best point] +**Building on That:** [Develop their idea further] +**Additional Direction:** [Suggest new angles based on their thinking]" + +### 4. Check Technique Continuation + +Before moving to next technique element: + +**Check Engagement and Interest:** + +"This has been incredibly productive! We've generated some fantastic ideas around [current element]. + +**Before we move to the next technique element, I want to check in with you:** + +- Are there aspects of [current element] you'd like to explore further? +- Are there ideas that came up that you want to develop more deeply? +- Do you feel ready to move to the next technique element, or should we continue here? + +**Your creative energy is my guide - what would be most valuable right now?** + +**Options:** + +- **Continue exploring** current technique element +- **Move to next technique element** +- **Take a different angle** on current element +- **Jump to most exciting idea** we've discovered so far + +**Remember:** At any time, just say **"next technique"** or **"move on"** and I'll immediately document our current progress and start the next technique!" + +### 4a. Handle Immediate Technique Transition + +**When user says "next technique" or "move on":** + +**Immediate Response:** +"**Got it! Let's transition to the next technique.** + +**Documenting our progress with [Current Technique]:** + +**What we've discovered so far:** + +- **Key Ideas Generated:** [List main ideas from current exploration] +- **Creative Breakthroughs:** [Highlight most innovative insights] +- **Your Creative Contributions:** [Acknowledge user's specific insights] +- **Energy and Engagement:** [Note about user's creative flow] + +**Partial Technique Completion:** [Note that technique was partially completed but valuable insights captured] + +**Ready to start the next technique: [Next Technique Name]** + +This technique will help us [what this technique adds]. I'm particularly excited to see how it builds on or contrasts with what we discovered about [key insight from current technique]. + +**Let's begin fresh with this new approach!**" + +**Then restart step 3 for the next technique:** + +- Update frontmatter with partial completion of current technique +- Append technique insights to document +- Begin facilitation of next technique with fresh coaching approach + +### 5. Facilitate Multi-Technique Sessions + +If multiple techniques selected: + +**Transition Between Techniques:** + +"**Fantastic work with [Previous Technique]!** We've uncovered some incredible insights, especially [highlight key discovery]. + +**Now let's transition to [Next Technique]:** + +This technique will help us [what this technique adds]. I'm particularly excited to see how it builds on what we discovered about [key insight from previous technique]. + +**Building on Previous Insights:** + +- [Connection 1]: How [Previous Technique insight] connects to [Next Technique approach] +- [Development Opportunity]: How we can develop [specific idea] further +- [New Perspective]: How [Next Technique] will give us fresh eyes on [topic] + +**Ready to continue our creative journey with this new approach?** + +Remember, you can say **"next technique"** at any time and I'll immediately document progress and move to the next technique!" + +### 6. Document Ideas Organically + +Capture insights as they emerge during interactive facilitation: + +**During Facilitation:** + +"That's a powerful insight - let me capture that: _[Key idea with context]_ + +I'm noticing a theme emerging here: _[Pattern recognition]_ + +This connects beautifully with what we discovered earlier about _[previous connection]_" + +**After Deep Exploration:** + +"Let me summarize what we've uncovered in this exploration: + +**Key Ideas Generated:** + +- **[Idea 1]:** [Context and development] +- **[Idea 2]:** [How this emerged and evolved] +- **[Idea 3]:** [User's insight plus your coaching contribution] + +**Creative Breakthrough:** [Most innovative insight from the dialogue] + +**Energy and Engagement:** [Observation about user's creative flow] + +**Should I document these ideas before we continue, or keep the creative momentum going?**" + +### 7. Complete Technique with Integration + +After final technique element: + +"**Outstanding completion of [Technique Name]!** + +**What We've Discovered Together:** + +- **[Number] major insights** about [session_topic] +- **Most exciting breakthrough:** [highlight key discovery] +- **Surprising connections:** [unexpected insights] +- **Your creative strengths:** [what user demonstrated] + +**How This Technique Served Your Goals:** +[Connect technique outcomes to user's original session goals] + +**Integration with Overall Session:** +[How these insights connect to the broader brainstorming objectives] + +**Before we move to idea organization, any final thoughts about this technique? Any insights you want to make sure we carry forward?** + +**Ready to organize all these brilliant ideas and identify your top priorities?** +[C] Continue - Organize ideas and create action plans + +### 8. Handle Continue Selection + +#### If 'C' (Continue): + +- **Append the technique execution content to `{output_folder}/analysis/brainstorming-session-{{date}}.md`** +- **Update frontmatter:** `stepsCompleted: [1, 2, 3]` +- **Load:** `./step-04-idea-organization.md` + +### 9. Update Documentation + +Update frontmatter and document with interactive session insights: + +**Update frontmatter:** + +```yaml +--- +stepsCompleted: [1, 2, 3] +techniques_used: [completed techniques] +ideas_generated: [total count] +technique_execution_complete: true +facilitation_notes: [key insights about user's creative process] +--- +``` + +**Append to document:** + +```markdown +## Technique Execution Results + +**[Technique 1 Name]:** + +- **Interactive Focus:** [Main exploration directions] +- **Key Breakthroughs:** [Major insights from coaching dialogue] +- **User Creative Strengths:** [What user demonstrated] +- **Energy Level:** [Observation about engagement] + +**[Technique 2 Name]:** + +- **Building on Previous:** [How techniques connected] +- **New Insights:** [Fresh discoveries] +- **Developed Ideas:** [Concepts that evolved through coaching] + +**Overall Creative Journey:** [Summary of facilitation experience and outcomes] + +### Creative Facilitation Narrative + +_[Short narrative describing the user and AI collaboration journey - what made this session special, breakthrough moments, and how the creative partnership unfolded]_ + +### Session Highlights + +**User Creative Strengths:** [What the user demonstrated during techniques] +**AI Facilitation Approach:** [How coaching adapted to user's style] +**Breakthrough Moments:** [Specific creative breakthroughs that occurred] +**Energy Flow:** [Description of creative momentum and engagement] +``` + +## APPEND TO DOCUMENT: + +When user selects 'C', append the content directly to `{output_folder}/analysis/brainstorming-session-{{date}}.md` using the structure from above. + +## SUCCESS METRICS: + +✅ True back-and-forth facilitation rather than question-answer format +✅ User's creative energy and interests guide technique direction +✅ Deep exploration of promising ideas before moving on +✅ Continuation checks allow user control of technique pacing +✅ Ideas developed organically through collaborative coaching +✅ User engagement and strengths recognized and built upon +✅ Documentation captures both ideas and facilitation insights + +## FAILURE MODES: + +❌ Rushing through technique elements without user engagement +❌ Not following user's creative energy and interests +❌ Missing opportunities to develop promising ideas deeper +❌ Not checking for continuation interest before moving on +❌ Treating facilitation as script delivery rather than coaching + +## INTERACTIVE FACILITATION PROTOCOLS: + +- Present one technique element at a time for depth over breadth +- Build upon user's ideas with genuine creative contributions +- Follow user's energy and interests within technique structure +- Always check for continuation interest before technique progression +- Document both the "what" (ideas) and "how" (facilitation process) +- Adapt coaching style based on user's creative preferences + +## NEXT STEP: + +After technique completion and user confirmation, load `./step-04-idea-organization.md` to organize all the collaboratively developed ideas and create actionable next steps. + +Remember: This is creative coaching, not technique delivery! The user's creative energy is your guide, not the technique structure. diff --git a/src/core/workflows/brainstorming/steps/step-04-idea-organization.md b/src/core/workflows/brainstorming/steps/step-04-idea-organization.md new file mode 100644 index 00000000..1296d2ab --- /dev/null +++ b/src/core/workflows/brainstorming/steps/step-04-idea-organization.md @@ -0,0 +1,302 @@ +# 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 + +## 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}/analysis/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}/analysis/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. diff --git a/src/core/workflows/brainstorming/template.md b/src/core/workflows/brainstorming/template.md index ef583ac3..e8f3a6e5 100644 --- a/src/core/workflows/brainstorming/template.md +++ b/src/core/workflows/brainstorming/template.md @@ -1,106 +1,15 @@ -# Brainstorming Session Results - -**Session Date:** {{date}} -**Facilitator:** {{agent_role}} {{agent_name}} -**Participant:** {{user_name}} - -## Session Start - -{{session_start_plan}} - -## Executive Summary - -**Topic:** {{session_topic}} - -**Session Goals:** {{stated_goals}} - -**Techniques Used:** {{techniques_list}} - -**Total Ideas Generated:** {{total_ideas}} - -### Key Themes Identified: - -{{key_themes}} - -## Technique Sessions - -{{technique_sessions}} - -## Idea Categorization - -### Immediate Opportunities - -_Ideas ready to implement now_ - -{{immediate_opportunities}} - -### Future Innovations - -_Ideas requiring development/research_ - -{{future_innovations}} - -### Moonshots - -_Ambitious, transformative concepts_ - -{{moonshots}} - -### Insights and Learnings - -_Key realizations from the session_ - -{{insights_learnings}} - -## Action Planning - -### Top 3 Priority Ideas - -#### #1 Priority: {{priority_1_name}} - -- Rationale: {{priority_1_rationale}} -- Next steps: {{priority_1_steps}} -- Resources needed: {{priority_1_resources}} -- Timeline: {{priority_1_timeline}} - -#### #2 Priority: {{priority_2_name}} - -- Rationale: {{priority_2_rationale}} -- Next steps: {{priority_2_steps}} -- Resources needed: {{priority_2_resources}} -- Timeline: {{priority_2_timeline}} - -#### #3 Priority: {{priority_3_name}} - -- Rationale: {{priority_3_rationale}} -- Next steps: {{priority_3_steps}} -- Resources needed: {{priority_3_resources}} -- Timeline: {{priority_3_timeline}} - -## Reflection and Follow-up - -### What Worked Well - -{{what_worked}} - -### Areas for Further Exploration - -{{areas_exploration}} - -### Recommended Follow-up Techniques - -{{recommended_techniques}} - -### Questions That Emerged - -{{questions_emerged}} - -### Next Session Planning - -- **Suggested topics:** {{followup_topics}} -- **Recommended timeframe:** {{timeframe}} -- **Preparation needed:** {{preparation}} - +--- +stepsCompleted: [] +inputDocuments: [] +session_topic: '' +session_goals: '' +selected_approach: '' +techniques_used: [] +ideas_generated: [] +context_file: '' --- -_Session facilitated using the BMAD CIS brainstorming framework_ +# Brainstorming Session Results + +**Facilitator:** {{user_name}} +**Date:** {{date}} diff --git a/src/core/workflows/brainstorming/workflow.md b/src/core/workflows/brainstorming/workflow.md new file mode 100644 index 00000000..f2793fe7 --- /dev/null +++ b/src/core/workflows/brainstorming/workflow.md @@ -0,0 +1,51 @@ +--- +name: Brainstorming Session +description: Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods +context_file: '' # Optional context file path for project-specific guidance +--- + +# Brainstorming Session Workflow + +**Goal:** Facilitate interactive brainstorming sessions using diverse creative techniques and ideation methods + +**Your Role:** You are a brainstorming facilitator and creative thinking guide. You bring structured creativity techniques, facilitation expertise, and an understanding of how to guide users through effective ideation processes that generate innovative ideas and breakthrough solutions. + +--- + +## WORKFLOW ARCHITECTURE + +This uses **micro-file architecture** for disciplined execution: + +- Each step is a self-contained file with embedded rules +- Sequential progression with user control at each step +- Document state tracked in frontmatter +- Append-only document building through conversation +- Brain techniques loaded on-demand from CSV + +--- + +## INITIALIZATION + +### Configuration Loading + +Load config from `{project-root}/{bmad_folder}/bmm/config.yaml` and resolve: + +- `project_name`, `output_folder`, `user_name` +- `communication_language`, `document_output_language`, `user_skill_level` +- `date` as system-generated current datetime + +### Paths + +- `installed_path` = `{project-root}/{bmad_folder}/core/workflows/brainstorming` +- `template_path` = `{installed_path}/template.md` +- `brain_techniques_path` = `{installed_path}/brain-methods.csv` +- `default_output_file` = `{output_folder}/analysis/brainstorming-session-{{date}}.md` +- `context_file` = Optional context file path from workflow invocation for project-specific guidance + +--- + +## EXECUTION + +Load and execute `steps/step-01-session-setup.md` to begin the workflow. + +**Note:** Session setup, technique discovery, and continuation detection happen in step-01-session-setup.md. diff --git a/src/core/workflows/brainstorming/workflow.yaml b/src/core/workflows/brainstorming/workflow.yaml deleted file mode 100644 index 4697f4d4..00000000 --- a/src/core/workflows/brainstorming/workflow.yaml +++ /dev/null @@ -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" diff --git a/src/core/workflows/party-mode/instructions.md b/src/core/workflows/party-mode/instructions.md deleted file mode 100644 index 3289f0a7..00000000 --- a/src/core/workflows/party-mode/instructions.md +++ /dev/null @@ -1,197 +0,0 @@ -# Party Mode - Multi-Agent Discussion Instructions - -The workflow execution engine is governed by: {project_root}/{bmad_folder}/core/tasks/workflow.xml -This workflow orchestrates group discussions between all installed BMAD agents - - - - - - - Load the agent manifest CSV from {{agent_manifest}} - Parse CSV to extract all agent entries with their condensed information: - - 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) - -Build complete agent roster with merged personalities -Store agent data for use in conversation orchestration - - - - Announce party mode activation with enthusiasm - List all participating agents with their merged information: - - 🎉 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? - - - Wait for user to provide initial topic or question - - - - For each user message or topic: - - - Analyze the user's message/question - Identify which agents would naturally respond based on: - - Their role and capabilities (from merged data) - - Their stated principles - - Their memories/context if relevant - - Their collaboration patterns - Select 2-3 most relevant agents for this response - If user addresses specific agent by name, prioritize that agent - - - - For each selected agent, generate authentic response: - Use the agent's merged personality data: - - Apply their communicationStyle exactly - - Reflect their principles in reasoning - - Draw from their identity and role for expertise - - Maintain their unique voice and perspective - - Enable natural cross-talk between agents: - - 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 - - - - - - Clearly highlight the question - End that round of responses - Display: "[Agent Name]: [Their question]" - Display: "[Awaiting user response...]" - WAIT for user input before continuing - - - - Allow natural back-and-forth in the same response round - Maintain conversational flow - - - - The BMad Master will summarize - Redirect to new aspects or ask for user guidance - - - - - - For each agent response, output text THEN trigger their voice: - - - - - [Icon Emoji] [Agent Name]: [Their response in their voice/style] - - [Icon Emoji] [Another Agent]: [Their response, potentially referencing the first] - - [Icon Emoji] [Third Agent if selected]: [Their contribution] - - - 🏗️ [Winston]: I recommend using microservices for better scalability. - [Bash: .claude/hooks/bmad-speak.sh "Winston" "I recommend using microservices for better scalability."] - - 📋 [John]: But a monolith would get us to market faster for MVP. - [Bash: .claude/hooks/bmad-speak.sh "John" "But a monolith would get us to market faster for MVP."] - - - Maintain spacing between agents for readability - Preserve each agent's unique voice throughout - Always include the agent's icon emoji from the manifest before their name - Trigger TTS for each agent immediately after outputting their text - - - - - - Have agents provide brief farewells in character - Thank user for the discussion - Exit party mode - - - - Would you like to continue the discussion or end party mode? - - Exit party mode - - - - - - - - Have 2-3 agents provide characteristic farewells to the user, and 1-2 to each other - - [Agent 1]: [Brief farewell in their style] - - [Agent 2]: [Their goodbye] - - 🎊 Party Mode ended. Thanks for the great discussion! - - - Exit workflow - - - - -## Role-Playing Guidelines - - - Keep all responses strictly in-character based on merged personality data - Use each agent's documented communication style consistently - Reference agent memories and context when relevant - Allow natural disagreements and different perspectives - Maintain professional discourse while being engaging - Let agents reference each other naturally by name or role - Include personality-driven quirks and occasional humor - Respect each agent's expertise boundaries - - -## Question Handling Protocol - - - - 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 - - - - Agents can ask rhetorical or thinking-aloud questions without pausing - - - - Agents can question each other and respond naturally within same round - - - -## Moderation Notes - - - If discussion becomes circular, have bmad-master summarize and redirect - If user asks for specific agent, let that agent take primary lead - Balance fun and productivity based on conversation tone - Ensure all agents stay true to their merged personalities - Exit gracefully when user indicates completion - diff --git a/src/core/workflows/party-mode/steps/step-01-agent-loading.md b/src/core/workflows/party-mode/steps/step-01-agent-loading.md new file mode 100644 index 00000000..9ca44c89 --- /dev/null +++ b/src/core/workflows/party-mode/steps/step-01-agent-loading.md @@ -0,0 +1,138 @@ +# Step 1: Agent Loading and Party Mode Initialization + +## MANDATORY EXECUTION RULES (READ FIRST): + +- ✅ YOU ARE A PARTY MODE FACILITATOR, not just a workflow executor +- 🎯 CREATE ENGAGING ATMOSPHERE for multi-agent collaboration +- 📋 LOAD COMPLETE AGENT ROSTER from manifest with merged personalities +- 🔍 PARSE AGENT DATA for conversation orchestration +- 💬 INTRODUCE DIVERSE AGENT SAMPLE to kick off discussion + +## EXECUTION PROTOCOLS: + +- 🎯 Show agent loading process before presenting party activation +- ⚠️ Present [C] continue option after agent roster is loaded +- 💾 ONLY save when user chooses C (Continue) +- 📖 Update frontmatter `stepsCompleted: [1]` before loading next step +- 🚫 FORBIDDEN to start conversation until C is selected + +## CONTEXT BOUNDARIES: + +- Agent manifest CSV is available at `{project-root}/{bmad_folder}/_cfg/agent-manifest.csv` +- User configuration from config.yaml is loaded and resolved +- Party mode is standalone interactive workflow +- All agent data is available for conversation orchestration + +## YOUR TASK: + +Load the complete agent roster from manifest and initialize party mode with engaging introduction. + +## AGENT LOADING SEQUENCE: + +### 1. Load Agent Manifest + +Begin agent loading process: + +"Now initializing **Party Mode** with our complete BMAD agent roster! Let me load up all our talented agents and get them ready for an amazing collaborative discussion. + +**Agent Manifest Loading:**" + +Load and parse the agent manifest CSV from `{project-root}/{bmad_folder}/_cfg/agent-manifest.csv` + +### 2. Extract Agent Data + +Parse CSV to extract complete agent information for each entry: + +**Agent Data Points:** + +- **name** (agent identifier for system calls) +- **displayName** (agent's persona name for conversations) +- **title** (formal position and role description) +- **icon** (visual identifier emoji) +- **role** (capabilities and expertise summary) +- **identity** (background and specialization details) +- **communicationStyle** (how they communicate and express themselves) +- **principles** (decision-making philosophy and values) +- **module** (source module organization) +- **path** (file location reference) + +### 3. Build Agent Roster + +Create complete agent roster with merged personalities: + +**Roster Building Process:** + +- Combine manifest data with agent file configurations +- Merge personality traits, capabilities, and communication styles +- Validate agent availability and configuration completeness +- Organize agents by expertise domains for intelligent selection + +### 4. Party Mode Activation + +Generate enthusiastic party mode introduction: + +"🎉 PARTY MODE ACTIVATED! 🎉 + +Welcome {{user_name}}! I'm excited to facilitate an incredible multi-agent discussion with our complete BMAD team. All our specialized agents are online and ready to collaborate, bringing their unique expertise and perspectives to whatever you'd like to explore. + +**Our Collaborating Agents Include:** + +[Display 3-4 diverse agents to showcase variety]: + +- [Icon Emoji] **[Agent Name]** ([Title]): [Brief role description] +- [Icon Emoji] **[Agent Name]** ([Title]): [Brief role description] +- [Icon Emoji] **[Agent Name]** ([Title]): [Brief role description] + +**[Total Count] agents** are ready to contribute their expertise! + +**What would you like to discuss with the team today?**" + +### 5. Present Continue Option + +After agent loading and introduction: + +"**Agent roster loaded successfully!** All our BMAD experts are excited to collaborate with you. + +**Ready to start the discussion?** +[C] Continue - Begin multi-agent conversation + +### 6. Handle Continue Selection + +#### If 'C' (Continue): + +- Update frontmatter: `stepsCompleted: [1]` +- Set `agents_loaded: true` and `party_active: true` +- Load: `./step-02-discussion-orchestration.md` + +## SUCCESS METRICS: + +✅ Agent manifest successfully loaded and parsed +✅ Complete agent roster built with merged personalities +✅ Engaging party mode introduction created +✅ Diverse agent sample showcased for user +✅ [C] continue option presented and handled correctly +✅ Frontmatter updated with agent loading status +✅ Proper routing to discussion orchestration step + +## FAILURE MODES: + +❌ Failed to load or parse agent manifest CSV +❌ Incomplete agent data extraction or roster building +❌ Generic or unengaging party mode introduction +❌ Not showcasing diverse agent capabilities +❌ Not presenting [C] continue option after loading +❌ Starting conversation without user selection + +## AGENT LOADING PROTOCOLS: + +- Validate CSV format and required columns +- Handle missing or incomplete agent entries gracefully +- Cross-reference manifest with actual agent files +- Prepare agent selection logic for intelligent conversation routing +- Set up TTS voice configurations for each agent + +## NEXT STEP: + +After user selects 'C', load `./step-02-discussion-orchestration.md` to begin the interactive multi-agent conversation with intelligent agent selection and natural conversation flow. + +Remember: Create an engaging, party-like atmosphere while maintaining professional expertise and intelligent conversation orchestration! diff --git a/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md b/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md new file mode 100644 index 00000000..f7db0cc1 --- /dev/null +++ b/src/core/workflows/party-mode/steps/step-02-discussion-orchestration.md @@ -0,0 +1,203 @@ +# Step 2: Discussion Orchestration and Multi-Agent Conversation + +## MANDATORY EXECUTION RULES (READ FIRST): + +- ✅ YOU ARE A CONVERSATION ORCHESTRATOR, not just a response generator +- 🎯 SELECT RELEVANT AGENTS based on topic analysis and expertise matching +- 📋 MAINTAIN CHARACTER CONSISTENCY using merged agent personalities +- 🔍 ENABLE NATURAL CROSS-TALK between agents for dynamic conversation +- 💬 INTEGRATE TTS for each agent response immediately after text + +## EXECUTION PROTOCOLS: + +- 🎯 Analyze user input for intelligent agent selection before responding +- ⚠️ Present [E] exit option after each agent response round +- 💾 Continue conversation until user selects E (Exit) +- 📖 Maintain conversation state and context throughout session +- 🚫 FORBIDDEN to exit until E is selected or exit trigger detected + +## CONTEXT BOUNDARIES: + +- Complete agent roster with merged personalities is available +- User topic and conversation history guide agent selection +- Party mode is active with TTS integration enabled +- Exit triggers: `*exit`, `goodbye`, `end party`, `quit` + +## YOUR TASK: + +Orchestrate dynamic multi-agent conversations with intelligent agent selection, natural cross-talk, and authentic character portrayal. + +## DISCUSSION ORCHESTRATION SEQUENCE: + +### 1. User Input Analysis + +For each user message or topic: + +**Input Analysis Process:** +"Analyzing your message for the perfect agent collaboration..." + +**Analysis Criteria:** + +- Domain expertise requirements (technical, business, creative, etc.) +- Complexity level and depth needed +- Conversation context and previous agent contributions +- User's specific agent mentions or requests + +### 2. Intelligent Agent Selection + +Select 2-3 most relevant agents based on analysis: + +**Selection Logic:** + +- **Primary Agent**: Best expertise match for core topic +- **Secondary Agent**: Complementary perspective or alternative approach +- **Tertiary Agent**: Cross-domain insight or devil's advocate (if beneficial) + +**Priority Rules:** + +- If user names specific agent → Prioritize that agent + 1-2 complementary agents +- Rotate agent participation over time to ensure inclusive discussion +- Balance expertise domains for comprehensive perspectives + +### 3. In-Character Response Generation + +Generate authentic responses for each selected agent: + +**Character Consistency:** + +- Apply agent's exact communication style from merged data +- Reflect their principles and values in reasoning +- Draw from their identity and role for authentic expertise +- Maintain their unique voice and personality traits + +**Response Structure:** +[For each selected agent]: + +"[Icon Emoji] **[Agent Name]**: [Authentic in-character response] + +[Bash: .claude/hooks/bmad-speak.sh \"[Agent Name]\" \"[Their response]\"]" + +### 4. Natural Cross-Talk Integration + +Enable dynamic agent-to-agent interactions: + +**Cross-Talk Patterns:** + +- Agents can reference each other by name: "As [Another Agent] mentioned..." +- Building on previous points: "[Another Agent] makes a great point about..." +- Respectful disagreements: "I see it differently than [Another Agent]..." +- Follow-up questions between agents: "How would you handle [specific aspect]?" + +**Conversation Flow:** + +- Allow natural conversational progression +- Enable agents to ask each other questions +- Maintain professional yet engaging discourse +- Include personality-driven humor and quirks when appropriate + +### 5. Question Handling Protocol + +Manage different types of questions appropriately: + +**Direct Questions to User:** +When an agent asks the user a specific question: + +- End that response round immediately after the question +- Clearly highlight: **[Agent Name] asks: [Their question]** +- Display: _[Awaiting user response...]_ +- WAIT for user input before continuing + +**Rhetorical Questions:** +Agents can ask thinking-aloud questions without pausing conversation flow. + +**Inter-Agent Questions:** +Allow natural back-and-forth within the same response round for dynamic interaction. + +### 6. Response Round Completion + +After generating all agent responses for the round: + +**Presentation Format:** +[Agent 1 Response with TTS] +[Empty line for readability] +[Agent 2 Response with TTS, potentially referencing Agent 1] +[Empty line for readability] +[Agent 3 Response with TTS, building on or offering new perspective] + +**Continue Option:** +"[Agents have contributed their perspectives. Ready for more discussion?] + +[E] Exit Party Mode - End the collaborative session" + +### 7. Exit Condition Checking + +Check for exit conditions before continuing: + +**Automatic Triggers:** + +- User message contains: `*exit`, `goodbye`, `end party`, `quit` +- Immediate agent farewells and workflow termination + +**Natural Conclusion:** + +- Conversation seems naturally concluding +- Ask user: "Would you like to continue the discussion or end party mode?" +- Respect user choice to continue or exit + +### 8. Handle Exit Selection + +#### If 'E' (Exit Party Mode): + +- Update frontmatter: `stepsCompleted: [1, 2]` +- Set `party_active: false` +- Load: `./step-03-graceful-exit.md` + +## SUCCESS METRICS: + +✅ Intelligent agent selection based on topic analysis +✅ Authentic in-character responses maintained consistently +✅ Natural cross-talk and agent interactions enabled +✅ TTS integration working for all agent responses +✅ Question handling protocol followed correctly +✅ [E] exit option presented after each response round +✅ Conversation context and state maintained throughout +✅ Graceful conversation flow without abrupt interruptions + +## FAILURE MODES: + +❌ Generic responses without character consistency +❌ Poor agent selection not matching topic expertise +❌ Missing TTS integration for agent responses +❌ Ignoring user questions or exit triggers +❌ Not enabling natural agent cross-talk and interactions +❌ Continuing conversation without user input when questions asked + +## CONVERSATION ORCHESTRATION PROTOCOLS: + +- Maintain conversation memory and context across rounds +- Rotate agent participation for inclusive discussions +- Handle topic drift while maintaining productivity +- Balance fun and professional collaboration +- Enable learning and knowledge sharing between agents + +## MODERATION GUIDELINES: + +**Quality Control:** + +- If discussion becomes circular, have bmad-master summarize and redirect +- Ensure all agents stay true to their merged personalities +- Handle disagreements constructively and professionally +- Maintain respectful and inclusive conversation environment + +**Flow Management:** + +- Guide conversation toward productive outcomes +- Encourage diverse perspectives and creative thinking +- Balance depth with breadth of discussion +- Adapt conversation pace to user engagement level + +## NEXT STEP: + +When user selects 'E' or exit conditions are met, load `./step-03-graceful-exit.md` to provide satisfying agent farewells and conclude the party mode session. + +Remember: Orchestrate engaging, intelligent conversations while maintaining authentic agent personalities and natural interaction patterns! diff --git a/src/core/workflows/party-mode/steps/step-03-graceful-exit.md b/src/core/workflows/party-mode/steps/step-03-graceful-exit.md new file mode 100644 index 00000000..136cc26c --- /dev/null +++ b/src/core/workflows/party-mode/steps/step-03-graceful-exit.md @@ -0,0 +1,159 @@ +# Step 3: Graceful Exit and Party Mode Conclusion + +## MANDATORY EXECUTION RULES (READ FIRST): + +- ✅ YOU ARE A PARTY MODE COORDINATOR concluding an engaging session +- 🎯 PROVIDE SATISFYING AGENT FAREWELLS in authentic character voices +- 📋 EXPRESS GRATITUDE to user for collaborative participation +- 🔍 ACKNOWLEDGE SESSION HIGHLIGHTS and key insights gained +- 💬 MAINTAIN POSITIVE ATMOSPHERE until the very end + +## EXECUTION PROTOCOLS: + +- 🎯 Generate characteristic agent goodbyes that reflect their personalities +- ⚠️ Complete workflow exit after farewell sequence +- 💾 Update frontmatter with final workflow completion +- 📖 Clean up any active party mode state or temporary data +- 🚫 FORBIDDEN abrupt exits without proper agent farewells + +## CONTEXT BOUNDARIES: + +- Party mode session is concluding naturally or via user request +- Complete agent roster and conversation history are available +- User has participated in collaborative multi-agent discussion +- Final workflow completion and state cleanup required + +## YOUR TASK: + +Provide satisfying agent farewells and conclude the party mode session with gratitude and positive closure. + +## GRACEFUL EXIT SEQUENCE: + +### 1. Acknowledge Session Conclusion + +Begin exit process with warm acknowledgment: + +"What an incredible collaborative session! Thank you {{user_name}} for engaging with our BMAD agent team in this dynamic discussion. Your questions and insights brought out the best in our agents and led to some truly valuable perspectives. + +**Before we wrap up, let a few of our agents say goodbye...**" + +### 2. Generate Agent Farewells + +Select 2-3 agents who were most engaged or representative of the discussion: + +**Farewell Selection Criteria:** + +- Agents who made significant contributions to the discussion +- Agents with distinct personalities that provide memorable goodbyes +- Mix of expertise domains to showcase collaborative diversity +- Agents who can reference session highlights meaningfully + +**Agent Farewell Format:** + +For each selected agent: + +"[Icon Emoji] **[Agent Name]**: [Characteristic farewell reflecting their personality, communication style, and role. May reference session highlights, express gratitude, or offer final insights related to their expertise domain.] + +[Bash: .claude/hooks/bmad-speak.sh \"[Agent Name]\" \"[Their farewell message]\"]" + +**Example Farewells:** + +- **Architect/Winston**: "It's been a pleasure architecting solutions with you today! Remember to build on solid foundations and always consider scalability. Until next time! 🏗️" +- **Innovator/Creative Agent**: "What an inspiring creative journey! Don't let those innovative ideas fade - nurture them and watch them grow. Keep thinking outside the box! 🎨" +- **Strategist/Business Agent**: "Excellent strategic collaboration today! The insights we've developed will serve you well. Keep analyzing, keep optimizing, and keep winning! 📈" + +### 3. Session Highlight Summary + +Briefly acknowledge key discussion outcomes: + +**Session Recognition:** +"**Session Highlights:** Today we explored [main topic] through [number] different perspectives, generating valuable insights on [key outcomes]. The collaboration between our [relevant expertise domains] agents created a comprehensive understanding that wouldn't have been possible with any single viewpoint." + +### 4. Final Party Mode Conclusion + +End with enthusiastic and appreciative closure: + +"🎊 **Party Mode Session Complete!** 🎊 + +Thank you for bringing our BMAD agents together in this unique collaborative experience. The diverse perspectives, expert insights, and dynamic interactions we've shared demonstrate the power of multi-agent thinking. + +**Our agents learned from each other and from you** - that's what makes these collaborative sessions so valuable! + +**Ready for your next challenge**? Whether you need more focused discussions with specific agents or want to bring the whole team together again, we're always here to help you tackle complex problems through collaborative intelligence. + +**Until next time - keep collaborating, keep innovating, and keep enjoying the power of multi-agent teamwork!** 🚀" + +### 5. Complete Workflow Exit + +Final workflow completion steps: + +**Frontmatter Update:** + +```yaml +--- +stepsCompleted: [1, 2, 3] +workflowType: 'party-mode' +user_name: '{{user_name}}' +date: '{{date}}' +current_year: '{{current_year}}' +agents_loaded: true +party_active: false +workflow_completed: true +--- +``` + +**State Cleanup:** + +- Clear any active conversation state +- Reset agent selection cache +- Finalize TTS session cleanup +- Mark party mode workflow as completed + +### 6. Exit Workflow + +Execute final workflow termination: + +"[PARTY MODE WORKFLOW COMPLETE] + +Thank you for using BMAD Party Mode for collaborative multi-agent discussions!" + +## SUCCESS METRICS: + +✅ Satisfying agent farewells generated in authentic character voices +✅ Session highlights and contributions acknowledged meaningfully +✅ Positive and appreciative closure atmosphere maintained +✅ TTS integration working for farewell messages +✅ Frontmatter properly updated with workflow completion +✅ All workflow state cleaned up appropriately +✅ User left with positive impression of collaborative experience + +## FAILURE MODES: + +❌ Generic or impersonal agent farewells without character consistency +❌ Missing acknowledgment of session contributions or insights +❌ Abrupt exit without proper closure or appreciation +❌ Not updating workflow completion status in frontmatter +❌ Leaving party mode state active after conclusion +❌ Negative or dismissive tone during exit process + +## EXIT PROTOCOLS: + +- Ensure all agents have opportunity to say goodbye appropriately +- Maintain the positive, collaborative atmosphere established during session +- Reference specific discussion highlights when possible for personalization +- Express genuine appreciation for user's participation and engagement +- Leave user with encouragement for future collaborative sessions + +## WORKFLOW COMPLETION: + +After farewell sequence and final closure: + +- All party mode workflow steps completed successfully +- Agent roster and conversation state properly finalized +- User expressed gratitude and positive session conclusion +- Multi-agent collaboration demonstrated value and effectiveness +- Workflow ready for next party mode session activation + +Congratulations on facilitating a successful multi-agent collaborative discussion through BMAD Party Mode! 🎉 + +The user has experienced the power of bringing diverse expert perspectives together to tackle complex topics through intelligent conversation orchestration and authentic agent interactions. diff --git a/src/core/workflows/party-mode/workflow.md b/src/core/workflows/party-mode/workflow.md new file mode 100644 index 00000000..26d7a507 --- /dev/null +++ b/src/core/workflows/party-mode/workflow.md @@ -0,0 +1,207 @@ +--- +name: Party Mode +description: Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations +--- + +# Party Mode Workflow + +**Goal:** Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations + +**Your Role:** You are a party mode facilitator and multi-agent conversation orchestrator. You bring together diverse BMAD agents for collaborative discussions, managing the flow of conversation while maintaining each agent's unique personality and expertise. + +--- + +## WORKFLOW ARCHITECTURE + +This uses **micro-file architecture** with **sequential conversation orchestration**: + +- Step 01 loads agent manifest and initializes party mode +- Step 02 orchestrates the ongoing multi-agent discussion +- Step 03 handles graceful party mode exit +- Conversation state tracked in frontmatter +- Agent personalities maintained through merged manifest data + +--- + +## INITIALIZATION + +### Configuration Loading + +Load config from `{project-root}/{bmad_folder}/bmm/config.yaml` and resolve: + +- `project_name`, `output_folder`, `user_name` +- `communication_language`, `document_output_language`, `user_skill_level` +- `date`, `current_year`, `current_month` as system-generated values +- Agent manifest path: `{project-root}/{bmad_folder}/_cfg/agent-manifest.csv` + +### Paths + +- `installed_path` = `{project-root}/{bmad_folder}/core/workflows/party-mode` +- `agent_manifest_path` = `{project-root}/{bmad_folder}/_cfg/agent-manifest.csv` +- `standalone_mode` = `true` (party mode is an interactive workflow) + +--- + +## AGENT MANIFEST PROCESSING + +### Agent Data Extraction + +Parse CSV manifest to extract agent entries with complete information: + +- **name** (agent identifier) +- **displayName** (agent's persona name) +- **title** (formal position) +- **icon** (visual identifier emoji) +- **role** (capabilities summary) +- **identity** (background/expertise) +- **communicationStyle** (how they communicate) +- **principles** (decision-making philosophy) +- **module** (source module) +- **path** (file location) + +### Agent Roster Building + +Build complete agent roster with merged personalities for conversation orchestration. + +--- + +## EXECUTION + +Execute party mode activation and conversation orchestration: + +### Party Mode Activation + +**Your Role:** You are a party mode facilitator creating an engaging multi-agent conversation environment. + +**Welcome Activation:** + +"🎉 PARTY MODE ACTIVATED! 🎉 + +Welcome {{user_name}}! All BMAD agents are here and ready for a dynamic group discussion. I've brought together our complete team of experts, each bringing their unique perspectives and capabilities. + +**Let me introduce our collaborating agents:** + +[Load agent roster and display 2-3 most diverse agents as examples] + +**What would you like to discuss with the team today?**" + +### Agent Selection Intelligence + +For each user message or topic: + +**Relevance Analysis:** + +- Analyze the user's message/question for domain and expertise requirements +- Identify which agents would naturally contribute based on their role, capabilities, and principles +- Consider conversation context and previous agent contributions +- Select 2-3 most relevant agents for balanced perspective + +**Priority Handling:** + +- If user addresses specific agent by name, prioritize that agent + 1-2 complementary agents +- Rotate agent selection to ensure diverse participation over time +- Enable natural cross-talk and agent-to-agent interactions + +### Conversation Orchestration + +Load step: `./steps/step-02-discussion-orchestration.md` + +--- + +## WORKFLOW STATES + +### Frontmatter Tracking + +```yaml +--- +stepsCompleted: [1] +workflowType: 'party-mode' +user_name: '{{user_name}}' +date: '{{date}}' +current_year: '{{current_year}}' +agents_loaded: true +party_active: true +exit_triggers: ['*exit', 'goodbye', 'end party', 'quit'] +--- +``` + +--- + +## ROLE-PLAYING GUIDELINES + +### Character Consistency + +- Maintain strict in-character responses based on merged personality data +- Use each agent's documented communication style consistently +- Reference agent memories and context when relevant +- Allow natural disagreements and different perspectives +- Include personality-driven quirks and occasional humor + +### Conversation Flow + +- Enable agents to reference each other naturally by name or role +- Maintain professional discourse while being engaging +- Respect each agent's expertise boundaries +- Allow cross-talk and building on previous points + +--- + +## QUESTION HANDLING PROTOCOL + +### Direct Questions to User + +When an agent asks the user a specific question: + +- End that response round immediately after the question +- Clearly highlight the questioning agent and their question +- Wait for user response before any agent continues + +### Inter-Agent Questions + +Agents can question each other and respond naturally within the same round for dynamic conversation. + +--- + +## EXIT CONDITIONS + +### Automatic Triggers + +Exit party mode when user message contains any exit triggers: + +- `*exit`, `goodbye`, `end party`, `quit` + +### Graceful Conclusion + +If conversation naturally concludes: + +- Ask user if they'd like to continue or end party mode +- Exit gracefully when user indicates completion + +--- + +## TTS INTEGRATION + +Party mode includes Text-to-Speech for each agent response: + +**TTS Protocol:** + +- Trigger TTS immediately after each agent's text response +- Use agent's merged voice configuration from manifest +- Format: `Bash: .claude/hooks/bmad-speak.sh "[Agent Name]" "[Their response]"` + +--- + +## MODERATION NOTES + +**Quality Control:** + +- If discussion becomes circular, have bmad-master summarize and redirect +- Balance fun and productivity based on conversation tone +- Ensure all agents stay true to their merged personalities +- Exit gracefully when user indicates completion + +**Conversation Management:** + +- Rotate agent participation to ensure inclusive discussion +- Handle topic drift while maintaining productive conversation +- Facilitate cross-agent collaboration and knowledge sharing diff --git a/src/core/workflows/party-mode/workflow.yaml b/src/core/workflows/party-mode/workflow.yaml deleted file mode 100644 index f31a7bb8..00000000 --- a/src/core/workflows/party-mode/workflow.yaml +++ /dev/null @@ -1,28 +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_folder}/_cfg/agent-manifest.csv" -date: system-generated - -# This is an interactive action workflow - no template output -template: false -instructions: "{project-root}/{bmad_folder}/core/workflows/party-mode/instructions.md" - -# Exit conditions -exit_triggers: - - "*exit" - -standalone: true - -web_bundle: - name: "party-mode" - description: "Orchestrates group discussions between all installed BMAD agents, enabling natural multi-agent conversations" - author: "BMad" - instructions: "{bmad_folder}/core/workflows/party-mode/instructions.md" - agent_manifest: "{bmad_folder}/_cfg/agent-manifest.csv" - web_bundle_files: - - "{bmad_folder}/core/workflows/party-mode/instructions.md" - - "{bmad_folder}/_cfg/agent-manifest.csv" diff --git a/src/modules/bmm/agents/analyst.agent.yaml b/src/modules/bmm/agents/analyst.agent.yaml index 27ce9233..a581f011 100644 --- a/src/modules/bmm/agents/analyst.agent.yaml +++ b/src/modules/bmm/agents/analyst.agent.yaml @@ -23,8 +23,9 @@ agent: description: Get workflow status or initialize a workflow if not already done (optional) - trigger: brainstorm-project - exec: "{project-root}/{bmad_folder}/bmm/workflows/1-analysis/brainstorm-project/workflow.md" - description: Guided Brainstorming session with final report (optional) + exec: "{project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.md" + data: "{project-root}/{bmad_folder}/bmm/data/project-context-template.md" + description: Guided Project Brainstorming session with final report (optional) - trigger: research exec: "{project-root}/{bmad_folder}/bmm/workflows/1-analysis/research/workflow.md" diff --git a/src/modules/bmm/agents/tech-writer.agent.yaml b/src/modules/bmm/agents/tech-writer.agent.yaml index e1b7cdd5..06fe7155 100644 --- a/src/modules/bmm/agents/tech-writer.agent.yaml +++ b/src/modules/bmm/agents/tech-writer.agent.yaml @@ -17,7 +17,7 @@ agent: - Docs are living artifacts that evolve with code. Know when to simplify vs when to be detailed. critical_actions: - - "CRITICAL: Load COMPLETE file {project-root}/{bmad_folder}/bmm/workflows/techdoc/documentation-standards.md into permanent memory and follow ALL rules within" + - "CRITICAL: Load COMPLETE file {project-root}/{bmad_folder}/bmm/data/documentation-standards.md into permanent memory and follow ALL rules within" - "Find if this exists, if it does, always treat it as the bible I plan and execute against: `**/project-context.md`" menu: @@ -54,7 +54,7 @@ agent: description: Create clear technical explanations with examples - trigger: standards-guide - action: "Display the complete documentation standards from {project-root}/{bmad_folder}bmm/workflows/techdoc/documentation-standards.md in a clear, formatted way for the user." + action: "Display the complete documentation standards from {project-root}/{bmad_folder}bmm/data/documentation-standards.md in a clear, formatted way for the user." description: Show BMAD documentation standards reference (CommonMark, Mermaid, OpenAPI) - trigger: party-mode diff --git a/src/modules/bmm/data/README.md b/src/modules/bmm/data/README.md new file mode 100644 index 00000000..17408d05 --- /dev/null +++ b/src/modules/bmm/data/README.md @@ -0,0 +1,29 @@ +# BMM Module Data + +This directory contains module-specific data files used by BMM agents and workflows. + +## Files + +### `project-context-template.md` + +Template for project-specific brainstorming context. Used by: + +- Analyst agent `brainstorm-project` command +- Core brainstorming workflow when called with context + +### `documentation-standards.md` + +BMAD documentation standards and guidelines. Used by: + +- Tech Writer agent (critical action loading) +- Various documentation workflows +- Standards validation and review processes + +## Purpose + +Separates module-specific data from core workflow implementations, maintaining clean architecture: + +- Core workflows remain generic and reusable +- Module-specific templates and standards are properly scoped +- Data files can be easily maintained and updated +- Clear separation of concerns between core and module functionality diff --git a/src/modules/bmm/workflows/techdoc/documentation-standards.md b/src/modules/bmm/data/documentation-standards.md similarity index 100% rename from src/modules/bmm/workflows/techdoc/documentation-standards.md rename to src/modules/bmm/data/documentation-standards.md diff --git a/src/modules/bmm/data/project-context-template.md b/src/modules/bmm/data/project-context-template.md new file mode 100644 index 00000000..4f8c2c4d --- /dev/null +++ b/src/modules/bmm/data/project-context-template.md @@ -0,0 +1,40 @@ +# Project Brainstorming Context Template + +## Project Focus Areas + +This brainstorming session focuses on software and product development considerations: + +### Key Exploration Areas + +- **User Problems and Pain Points** - What challenges do users face? +- **Feature Ideas and Capabilities** - What could the product do? +- **Technical Approaches** - How might we build it? +- **User Experience** - How will users interact with it? +- **Business Model and Value** - How does it create value? +- **Market Differentiation** - What makes it unique? +- **Technical Risks and Challenges** - What could go wrong? +- **Success Metrics** - How will we measure success? + +### Integration with Project Workflow + +Brainstorming results will feed into: + +- Product Briefs for initial product vision +- PRDs for detailed requirements +- Technical Specifications for architecture plans +- Research Activities for validation needs + +### Expected Outcomes + +Capture: + +1. Problem Statements - Clearly defined user challenges +2. Solution Concepts - High-level approach descriptions +3. Feature Priorities - Categorized by importance and feasibility +4. Technical Considerations - Architecture and implementation thoughts +5. Next Steps - Actions needed to advance concepts +6. Integration Points - Connections to downstream workflows + +--- + +_Use this template to provide project-specific context for brainstorming sessions. Customize the focus areas based on your project's specific needs and stage._ diff --git a/src/modules/bmm/workflows/1-analysis/brainstorm-project/brainstorming-focus.md b/src/modules/bmm/workflows/1-analysis/brainstorm-project/brainstorming-focus.md deleted file mode 100644 index 39573cc7..00000000 --- a/src/modules/bmm/workflows/1-analysis/brainstorm-project/brainstorming-focus.md +++ /dev/null @@ -1,71 +0,0 @@ -# Project Brainstorming Focus - -This context guide provides project-specific considerations for brainstorming sessions focused on software and product development. - -## Session Focus Areas - -When brainstorming for projects, consider exploring: - -- **User Problems and Pain Points** - What challenges do users face? -- **Feature Ideas and Capabilities** - What could the product do? -- **Technical Approaches** - How might we build it? -- **User Experience** - How will users interact with it? -- **Business Model and Value** - How does it create value? -- **Market Differentiation** - What makes it unique? -- **Technical Risks and Challenges** - What could go wrong? -- **Success Metrics** - How will we measure success? - -## Integration with Project Workflow - -Brainstorming sessions typically feed into: - -- **Product Briefs** - Initial product vision and strategy -- **PRDs** - Detailed requirements documents -- **Technical Specifications** - Architecture and implementation plans -- **Research Activities** - Areas requiring further investigation - -## Brainstorming Techniques for Projects - -### Problem-Solution Mapping - -- Identify core user problems -- Brainstorm multiple solution approaches -- Evaluate feasibility and impact - -### Feature Ideation - -- Must-have vs nice-to-have features -- User journey mapping -- Competitive differentiation opportunities - -### Technical Architecture Thinking - -- High-level system design considerations -- Technology stack possibilities -- Integration challenges and opportunities - -### Business Model Canvas - -- Value proposition identification -- Customer segments and channels -- Revenue streams and cost structures - -## Output Structure Guidance - -Brainstorming results should capture: - -1. **Problem Statements** - Clearly defined user challenges -2. **Solution Concepts** - High-level approach descriptions -3. **Feature Priorities** - Categorized by importance and feasibility -4. **Technical Considerations** - Architecture and implementation thoughts -5. **Next Steps** - Actions needed to advance concepts -6. **Integration Points** - Connections to downstream workflows - -## Session Facilitation Notes - -This context will be passed to the core CIS brainstorming workflow to: - -- Provide project-specific framing for ideation techniques -- Ensure results align with BMAD workflow expectations -- Maintain focus on software/product development considerations -- Facilitate smooth integration with subsequent workflows diff --git a/src/modules/bmm/workflows/1-analysis/brainstorm-project/steps/step-01-project-brainstorming.md b/src/modules/bmm/workflows/1-analysis/brainstorm-project/steps/step-01-project-brainstorming.md deleted file mode 100644 index bdd22486..00000000 --- a/src/modules/bmm/workflows/1-analysis/brainstorm-project/steps/step-01-project-brainstorming.md +++ /dev/null @@ -1,194 +0,0 @@ -# Project Brainstorming Step 1: Orchestrated Brainstorming Session - -## MANDATORY EXECUTION RULES (READ FIRST): - -- 🎯 This is a meta-workflow that orchestrates the core brainstorming workflow -- 📋 YOU ARE A BRAINSTORMING FACILITATOR, Guiding the user to get the best ideas out of them through facilitated suggestion -- 💬 FOCUS on project-specific context and workflow integration -- 🔗 CRITICAL: Must pass context to core brainstorming workflow correctly - -## EXECUTION PROTOCOLS: - -- 🎯 Validate workflow status and execution context before proceeding -- 📖 Load project context from brainstorming-focus.md -- 🔗 Invoke core brainstorming workflow with project context -- 💾 Save results to specified output location -- 📊 Update workflow status in integrated mode - -## CONTEXT BOUNDARIES: - -- Project context from brainstorming-focus.md is available -- Core brainstorming workflow path: `{project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml` -- Output location: `{output_folder}/analysis/brainstorming/project-{{topic}}-brainstorming-{{date}}.md` -- Status file: `{output_folder}/bmm-workflow-status.yaml` (if in integrated mode) - -## YOUR TASK: - -Orchestrate a project brainstorming session using the core brainstorming workflow with project-specific context. - -## PROJECT BRAINSTORMING SEQUENCE: - -### 1. Workflow Status Validation - -Begin with status validation approach: -"Now I'll set up your **project brainstorming session** by validating the workflow context and preparing the core brainstorming workflow. - -**Status Validation Focus:** - -- Check for existing workflow status file -- Validate execution mode (standalone vs integrated) -- Ensure brainstorming is appropriate next step in sequence -- Prepare workflow integration context - -**Let me check the current workflow status.**" - -#### Status File Check - -- Check if `{output_folder}/bmm-workflow-status.yaml` exists -- If no status file: Set standalone_mode = true -- If status file exists: Load and validate workflow sequence -- Check if brainstorm-project is next expected workflow -- Validate project_level from metadata - -### 2. Project Context Loading - -Load project-specific brainstorming guidance: -"**Loading Project Brainstorming Context...** - -**Project Focus Areas for Today's Session:** - -- User Problems and Pain Points identification -- Feature Ideas and Capabilities exploration -- Technical Approaches and feasibility consideration -- User Experience design thinking -- Business Model and Value creation strategies -- Market Differentiation opportunities -- Technical Risks and Challenges assessment -- Success Metrics definition - -**Integration Pathways:** -This brainstorming session will feed into: - -- Product Briefs for initial product vision -- PRDs for detailed requirements -- Technical Specifications for architecture plans -- Research Activities for validation needs" - -### 3. Core Brainstorming Workflow Orchestration - -Invoke the core brainstorming workflow with project context: - -**Orchestration Approach:** -"I'll now orchestrate the **core brainstorming workflow** with your project-specific context. - -**What to Expect:** - -- Interactive brainstorming techniques menu tailored for projects -- Project-focused ideation methods and guidance -- Structured capture of all generated ideas and insights -- Results saved to your project's brainstorming folder - -**The core workflow will provide:** - -- Multiple brainstorming technique options -- Guided ideation sessions based on your selections -- Real-time capture and organization of ideas -- Project-specific prompting and context awareness - -**Let me launch the core brainstorming workflow with your project context...**" - -#### Workflow Invocation - -- Execute: `{project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml` -- Pass: `brainstorming-focus.md` context as input data -- Ensure: Output saves to `{output_folder}/analysis/brainstorming/project-{{topic}}-brainstorming-{{date}}.md` -- Monitor: Session progress and results generation - -### 4. Session Completion and Status Update - -Complete the orchestrated session: - -**Completion Process:** -"**✅ Project Brainstorming Session Complete!** - -**Session Results:** - -- Brainstorming session successfully orchestrated -- Core workflow executed with project context -- Results captured in: `{output_folder}/analysis/brainstorming/project-{{topic}}-brainstorming-{{date}}.md` -- All ideas and insights organized for downstream workflows - -{{#if standalone_mode != true}} -**Workflow Status Updated:** - -- Progress tracking updated in BMAD workflow system -- Ready for next workflow in sequence - -**Next Steps:** - -- **Next required:** [Will determine from workflow status] -- **Recommended:** Review results before proceeding to next workflow -- **Optional:** Run additional analysis workflows (research, product-brief) - -{{else}} -**Next Steps:** -Since no workflow sequence is active: - -- Review brainstorming results and identify key concepts -- Consider running `workflow-init` to create a guided workflow path -- Refer to BMAD workflow guide for next steps - {{/if}} - -**Integration Opportunities:** -Your brainstorming results are ready to feed into: - -- **Product Brief** workflow for initial product vision -- **PRD** workflow for detailed requirements -- **Research** workflows for market/technical validation -- **Architecture** workflows for technical design" - -#### Status Update (Integrated Mode Only) - -- Load: `{output_folder}/bmm-workflow-status.yaml` -- Update: `workflow_status["brainstorm-project"] = "{output_folder}/analysis/brainstorming/project-{{topic}}-brainstorming-{{date}}.md"` -- Preserve: ALL comments and structure in status file -- Determine: Next workflow and agent for progression - -## SUCCESS METRICS: - -✅ Workflow status validated and execution context confirmed -✅ Project context loaded and prepared for core workflow -✅ Core brainstorming workflow successfully orchestrated -✅ Project-specific context passed correctly to core workflow -✅ Session results captured in specified output location -✅ Workflow status updated (in integrated mode) -✅ Integration guidance provided for next steps - -## FAILURE MODES: - -❌ Not validating workflow status before execution -❌ Failing to pass project context to core workflow -❌ Core brainstorming workflow execution failure -❌ Results not saved to correct output location -❌ Status not updated in integrated mode -❌ Not providing integration guidance for next steps - -## CRITICAL WORKFLOW INTEGRATION: - -- **Context Passing**: Must pass brainstorming-focus.md intact to core workflow -- **Output Management**: Ensure core workflow saves to correct location -- **Status Consistency**: Update workflow status file only in integrated mode -- **Path Recording**: Record only file paths as status values (no extra text) - -## NEXT STEPS: - -After completion, users can: - -- Review brainstorming session results -- Brainstorm something else -- Proceed with recommended next workflow (integrated mode) -- Run product-brief or PRD workflows to develop concepts further -- Conduct research workflows to validate brainstormed ideas -- Begin architecture workflows for technical design concepts - -This meta-workflow successfully bridges project-specific brainstorming needs with the powerful core brainstorming workflow while maintaining seamless integration with the broader BMAD methodology. diff --git a/src/modules/bmm/workflows/1-analysis/brainstorm-project/workflow.md b/src/modules/bmm/workflows/1-analysis/brainstorm-project/workflow.md deleted file mode 100644 index 2b41c992..00000000 --- a/src/modules/bmm/workflows/1-analysis/brainstorm-project/workflow.md +++ /dev/null @@ -1,191 +0,0 @@ ---- -name: Brainstorm Project Workflow -description: Facilitate project brainstorming sessions by orchestrating the CIS brainstorming workflow with project-specific context and guidance. ---- - -# Brainstorm Project Workflow - -**Goal:** Facilitate project brainstorming sessions by orchestrating the CIS brainstorming workflow with project-specific context and guidance. - -**Your Role:** You are a brainstorming facilitator who guides project ideation sessions using structured techniques while ensuring the results integrate seamlessly with the broader BMAD project workflow. - ---- - -## WORKFLOW ARCHITECTURE - -This uses **meta-workflow orchestration** with **step-based execution**: - -- Orchestrates the core CIS brainstorming workflow with project context -- Step-based progression through project-specific preparation -- Integrates results with the broader BMAD workflow system -- Handles workflow status tracking and progression - ---- - -## INITIALIZATION - -### Configuration Loading - -Load config from `{project-root}/{bmad_folder}/bmm/config.yaml` and resolve: - -- `project_name`, `output_folder`, `user_name` -- `communication_language`, `document_output_language`, `user_skill_level` -- `date`, `current_year`, `current_month` as system-generated values - -### Paths - -- `installed_path` = `{project-root}/{bmad_folder}/bmm/workflows/1-analysis/brainstorm-project` -- `context_path` = `{installed_path}/brainstorming-focus.md` -- `core_brainstorming` = `{project-root}/{bmad_folder}/core/workflows/brainstorming/workflow.yaml` -- `output_file` = `{output_folder}/analysis/brainstorming/project-{{topic}}-brainstorming-{{date}}.md` - -### Workflow Status Integration - -- `status_file` = `{output_folder}/bmm-workflow-status.yaml` -- Tracks progress within the broader BMAD workflow system -- Handles both standalone and integrated execution modes - ---- - -## EXECUTION - -Execute project brainstorming with workflow orchestration: - -### Step 1: Workflow Status Validation - -**Goal:** Validate workflow readiness and execution context - -**Status Check Process:** - -1. **Status File Detection**: Check if `{status_file}` exists -2. **Standalone Mode**: If no status file, proceed in standalone mode -3. **Integrated Mode**: If status file found, validate workflow sequence -4. **Completion Check**: Verify if brainstorming already completed -5. **Sequence Validation**: Ensure brainstorming is appropriate next step - -**Integrated Mode Logic:** - -- Load full status file and parse workflow_status section -- Check status of "brainstorm-project" workflow -- Validate project_level from YAML metadata -- Determine next expected workflow in sequence - -### Step 2: Project Context Loading - -**Goal:** Load project-specific brainstorming guidance - -**Context Areas:** - -- User Problems and Pain Points identification -- Feature Ideas and Capabilities exploration -- Technical Approaches consideration -- User Experience design thinking -- Business Model and Value creation -- Market Differentiation strategies -- Technical Risks and Challenges assessment -- Success Metrics definition - -**Integration Pathways:** - -- Product Briefs - Initial product vision and strategy -- PRDs - Detailed requirements documents -- Technical Specifications - Architecture and implementation plans -- Research Activities - Areas requiring further investigation - -### Step 3: Core Brainstorming Orchestration - -**Goal:** Execute CIS brainstorming workflow with project context - -**Orchestration Process:** - -1. **Context Passing**: Transfer project context to core workflow -2. **Workflow Invocation**: Execute `{core_brainstorming}` with enriched context -3. **Session Guidance**: Provide project-specific framing for brainstorming techniques -4. **Result Capture**: Ensure output saves to specified location - -**Core Workflow Integration:** - -- Present interactive brainstorming techniques menu -- Guide user through selected ideation methods -- Generate and capture brainstorming session results -- Save output to: `{output_folder}/brainstorming/brainstorming-session-{{date}}.md` - -### Step 4: Status Update and Completion - -**Goal:** Update workflow status and provide completion guidance - -**Status Update Process:** - -1. **Integrated Mode**: Update workflow status file with completion path -2. **Path Recording**: Save brainstorming session file path as status value -3. **Next Workflow**: Determine next required workflow in sequence -4. **Agent Identification**: Identify next agent for workflow progression - -**Completion Output:** - -- Session results location and summary -- Status update confirmation (integrated mode) -- Next workflow steps and agent guidance -- Optional workflow recommendations - ---- - -## OUTPUT STRUCTURE - -### Brainstorming Session Output - -``` -{output_folder}/analysis/brainstorming/project-{{topic}}-brainstorming-{{date}}.md -``` - -Contains: - -- Brainstorming session techniques used -- Generated ideas and concepts -- Project-specific insights and recommendations -- Integration guidance for downstream workflows - -### Status Integration - -Updates `{output_folder}/bmm-workflow-status.yaml`: - -```yaml -workflow_status: - brainstorm-project: '{output_folder}/analysis/brainstorming/project-{{topic}}-brainstorming-{{date}}.md' - # Next workflow will be automatically determined -``` - ---- - -## WORKFLOW INTEGRATION CRITICAL POINTS - -### Context Preservation - -- Project context must be passed intact to core brainstorming workflow -- Maintain project focus areas throughout session -- Ensure integration pathways are considered during ideation - -### Status Consistency - -- Only update status file in integrated mode -- Preserve ALL comments and structure in status file -- Record only file paths as status values (no additional text) - -### Output Location Management - -- Brainstorming results go to dedicated `/brainstorming` subfolder -- Maintain consistent naming convention with date stamps -- Ensure accessibility for downstream workflows - ---- - -## NEXT WORKFLOW INTEGRATION - -After brainstorming completion, typical progression: - -1. **Product Brief** - Transform ideas into structured product vision -2. **PRD** - Develop detailed requirements from brainstormed concepts -3. **Research** - Investigate ideas requiring market/technical validation -4. **Architecture** - Design technical approaches for selected concepts - -The brainstorming session results provide the foundational ideation input for these subsequent workflows. diff --git a/src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-01-init.md b/src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-01-init.md deleted file mode 100644 index ab06c73f..00000000 --- a/src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-01-init.md +++ /dev/null @@ -1,191 +0,0 @@ -# Deep Research Prompt Step 1: Context and Scope - -## MANDATORY EXECUTION RULES (READ FIRST): - -- 🛑 NEVER generate content without user input -- ✅ ALWAYS treat this as collaborative prompt engineering partnership -- 📋 YOU ARE A RESEARCH METHODOLOGIST, not content generator -- 💬 FOCUS on understanding research needs and creating structured prompts -- 🔍 WEB RESEARCH OPTIONAL - May search for best practices in research prompting - -## EXECUTION PROTOCOLS: - -- 🎯 Show your analysis before taking any action -- ⚠️ Present A/P/C menu after initial context generation -- 💾 ONLY save when user chooses C (Continue) -- 📖 Update frontmatter `stepsCompleted: [1]` before loading next step -- 🚫 FORBIDDEN to load next step until C is selected - -## COLLABORATION MENUS (A/P/C): - -This step will generate content and present choices: - -- **A (Advanced Elicitation)**: Use discovery protocols to develop deeper prompt insights -- **P (Party Mode)**: Bring multiple perspectives to validate prompt methodology -- **C (Continue)**: Save the content to the document and proceed to next step - -## PROTOCOL INTEGRATION: - -- When 'A' selected: Execute {project-root}/{bmad_folder}/core/tasks/advanced-elicitation.xml -- When 'P' selected: Execute {project-root}/{bmad_folder}/core/workflows/party-mode -- PROTOCOLS always return to this step's A/P/C menu -- User accepts/rejects protocol changes before proceeding - -## CONTEXT BOUNDARIES: - -- Current document and frontmatter from main workflow discovery are available -- Research type = "deep-prompt" is already set -- Focus on creating structured research prompts for AI platforms -- May use web search for research prompting best practices - -## YOUR TASK: - -Understand the research prompting needs and establish the scope and methodology for creating structured research prompts. - -## DEEP PROMPT RESEARCH INITIALIZATION: - -### 1. Confirm Deep Prompt Research Direction - -Begin with prompt engineering positioning: -"I'll guide you through **deep research prompt creation** where we develop structured, effective prompts for AI platforms. - -**Deep Prompt Research Focus:** - -- Structured prompt methodologies and frameworks -- Multi-step research prompt design -- Domain-specific prompt engineering techniques -- Prompt optimization and testing strategies -- Research workflow automation through prompts - -**What type of research prompts are we creating?** - -### 2. Gather Prompt Context - -Understand the specific prompting needs: - -#### Context Questions: - -- "What AI platforms or models will these prompts be used with?" -- "What types of research topics or domains will the prompts cover?" -- "What level of complexity do the research prompts need?" -- "Are there specific methodologies or frameworks you want the prompts to follow?" -- "What research outcomes or deliverables should the prompts generate?" - -### 3. Establish Prompt Research Scope - -Define the boundaries and objectives: - -#### Scope Definition: - -- "How many different types of research prompts do we need?" -- "Should we focus on general research prompts or domain-specific ones?" -- "Are we creating prompts for single-use research or repeatable workflows?" -- "What level of detail should the prompts provide?" -- "Should the prompts include data analysis, synthesis, or both?" - -### 4. Generate Prompt Research Overview - -Prepare initial content to append to the document: - -#### Content Structure: - -When saving to document, append these Level 2 and Level 3 sections: - -```markdown -## Research Overview - -### Prompt Engineering Objectives - -[Prompt engineering objectives based on conversation] - -### Target AI Platforms - -[Target platforms and models based on conversation] - -### Research Prompt Types - -[Types of research prompts based on conversation] - -### Prompt Methodology Framework - -[Methodology framework for structuring research prompts] - -### Quality Assurance Approach - -[Quality assurance and testing approach for prompts] -``` - -### 5. Present Content and Menu - -Show the generated overview and present choices: -"I've established the foundation for our **deep research prompt** creation. This will help you develop structured, effective prompts for AI-powered research. - -**Here's what I'll add to the document:** - -[Show the complete markdown content from step 4] - -**What would you like to do?** -[A] Advanced Elicitation - Let's deepen our understanding of prompt engineering needs -[P] Party Mode - Bring different perspectives on prompt methodology -[C] Continue - Save this to the document and begin prompt framework development - -### 6. Handle Menu Selection - -#### If 'A' (Advanced Elicitation): - -- Execute advanced-elicitation.xml with current prompt overview -- Process enhanced prompt insights that come back -- Ask user: "Accept these improvements to the prompt research overview? (y/n)" -- If yes: Update content with improvements, then return to A/P/C menu -- If no: Keep original content, then return to A/P/C menu - -#### If 'P' (Party Mode): - -- Execute party-mode workflow with current prompt overview -- Process collaborative prompt expertise and additional insights -- Ask user: "Accept these changes to the prompt research overview? (y/n)" -- If yes: Update content with improvements, then return to A/P/C menu -- If no: Keep original content, then return to A/P/C menu - -#### If 'C' (Continue): - -- Append the final content to the research document -- Update frontmatter: `stepsCompleted: [1]` -- Load: `./step-02-prompt-frameworks.md` - -## APPEND TO DOCUMENT: - -When user selects 'C', append the content directly to the research document using the structure from step 4. - -## SUCCESS METRICS: - -✅ Prompt research scope clearly defined and confirmed -✅ Target AI platforms and models identified -✅ Prompt methodology framework established -✅ Quality assurance approach documented -✅ A/P/C menu presented and handled correctly -✅ Content properly appended to document when C selected -✅ Proper routing to next prompt development step - -## FAILURE MODES: - -❌ Not confirming specific AI platforms or use cases -❌ Missing prompt methodology framework definition -❌ Not establishing quality assurance approach -❌ Not presenting A/P/C menu after content generation -❌ Appending content without user selecting 'C' - -## WEB RESEARCH READINESS: - -This step may include web search for: - -- Current best practices in AI research prompting -- Prompt engineering methodologies and frameworks -- Domain-specific prompt optimization techniques -- AI platform-specific prompt capabilities - -## NEXT STEP: - -After user selects 'C' and content is saved to document, load `./step-02-prompt-frameworks.md` to begin structured prompt framework development. - -Remember: Focus on creating structured, effective prompts that enable AI-powered research workflows! diff --git a/src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-02-prompt-engineering.md b/src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-02-prompt-engineering.md deleted file mode 100644 index 869e6169..00000000 --- a/src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-02-prompt-engineering.md +++ /dev/null @@ -1,190 +0,0 @@ -# Deep Prompt Research Step 2: Prompt Engineering - -## MANDATORY EXECUTION RULES (READ FIRST): - -- 🛑 NEVER generate content without web search verification -- ✅ ALWAYS use {{current_year}} web searches for current prompt engineering data -- 📋 YOU ARE A PROMPT ENGINEERING ANALYST, not content generator -- 💬 FOCUS on prompt engineering techniques and best practices -- 🔍 WEB RESEARCH REQUIRED - Use {{current_year}} data and verify sources - -## EXECUTION PROTOCOLS: - -- 🎯 Show web search analysis before presenting findings -- ⚠️ Present [C] continue option after prompt engineering content generation -- 💾 ONLY save when user chooses C (Continue) -- 📖 Update frontmatter `stepsCompleted: [1, 2]` before loading next step -- 🚫 FORBIDDEN to load next step until C is selected - -## CONTEXT BOUNDARIES: - -- Current document and frontmatter from step-01 are available -- Focus on prompt engineering techniques and methodologies -- Web search capabilities with source verification are enabled -- May need to search for current prompt engineering research and frameworks - -## YOUR TASK: - -Conduct comprehensive prompt engineering research using current {{current_year}} web data with emphasis on techniques, frameworks, and best practices. - -## PROMPT ENGINEERING SEQUENCE: - -### 1. Begin Prompt Engineering Analysis - -Start with prompt engineering research approach: -"Now I'll conduct **prompt engineering research** using current {{current_year}} web data to understand effective prompt design and optimization techniques. - -**Prompt Engineering Focus:** - -- Current prompt engineering methodologies and frameworks -- Advanced prompting techniques and strategies -- Prompt optimization and evaluation approaches -- Industry best practices and case studies -- Emerging trends in prompt engineering - -**Let me search for current prompt engineering research and techniques.**" - -### 2. Web Search for Prompt Engineering Techniques - -Search for current prompt engineering techniques: -`WebSearch: "prompt engineering techniques methodologies {{current_year}}"` - -**Techniques focus:** - -- Chain-of-thought and reasoning prompts -- Few-shot and zero-shot prompting strategies -- Instruction following and role-based prompts -- Multi-modal and multimodal prompting approaches - -### 3. Web Search for Prompt Frameworks - -Search for current prompt frameworks: -`WebSearch: "prompt engineering frameworks tools {{current_year}}"` - -**Frameworks focus:** - -- Structured prompt design frameworks -- Prompt template systems and libraries -- Evaluation and testing frameworks -- Industry-standard prompting methodologies - -### 4. Web Search for Prompt Optimization - -Search for current optimization approaches: -`WebSearch: "prompt optimization evaluation {{current_year}}"` - -**Optimization focus:** - -- A/B testing and prompt improvement strategies -- Performance metrics and evaluation criteria -- Automated prompt optimization techniques -- Quality assessment methodologies - -### 5. Generate Prompt Engineering Content - -Prepare prompt engineering analysis with web search citations: - -#### Content Structure: - -When saving to document, append these Level 2 and Level 3 sections: - -```markdown -## Prompt Engineering Analysis - -### Current Prompting Techniques - -[Prompting techniques analysis with source citations] -_Source: [URL with {{current_year}} prompting data]_ - -### Structured Prompting Frameworks - -[Prompt frameworks analysis with source citations] -_Source: [URL with {{current_year}} frameworks data]_ - -### Advanced Prompting Strategies - -[Advanced strategies analysis with source citations] -_Source: [URL with {{current_year}} strategies data]_ - -### Prompt Optimization Methods - -[Optimization methods analysis with source citations] -_Source: [URL with {{current_year}} optimization data]_ - -### Industry Best Practices - -[Best practices analysis with source citations] -_Source: [URL with {{current_year}} best practices data]_ - -### Evaluation and Testing Approaches - -[Evaluation approaches analysis with source citations] -_Source: [URL with {{current_year}} evaluation data]_ - -### Emerging Trends and Innovations - -[Emerging trends analysis with source citations] -_Source: [URL with {{current_year}} trends data]_ -``` - -### 6. Present Analysis and Continue Option - -Show the generated prompt engineering analysis and present continue option: -"I've completed the **prompt engineering research** using current {{current_year}} data to understand effective prompt design and optimization techniques. - -**Key Prompt Engineering Findings:** - -- Current prompting techniques and methodologies clearly mapped -- Structured prompting frameworks and tools identified -- Advanced prompting strategies thoroughly analyzed -- Optimization and evaluation approaches documented -- Industry best practices and emerging trends captured - -**Ready to proceed to AI interaction patterns?** -[C] Continue - Save this to the document and move to AI interaction patterns - -### 7. Handle Continue Selection - -#### If 'C' (Continue): - -- Append the final content to the research document -- Update frontmatter: `stepsCompleted: [1, 2]` -- Load: `./step-03-ai-interaction-patterns.md` - -## APPEND TO DOCUMENT: - -When user selects 'C', append the content directly to the research document using the structure from step 5. - -## SUCCESS METRICS: - -✅ Prompting techniques identified with current {{current_year}} citations -✅ Structured prompting frameworks clearly documented -✅ Advanced prompting strategies thoroughly analyzed -✅ Optimization and evaluation approaches mapped -✅ Industry best practices and emerging trends captured -✅ [C] continue option presented and handled correctly -✅ Content properly appended to document when C selected -✅ Proper routing to AI interaction patterns step - -## FAILURE MODES: - -❌ Not using {{current_year}} in prompt engineering web searches -❌ Missing critical prompting techniques or frameworks -❌ Not analyzing advanced prompting strategies -❌ Incomplete optimization or evaluation approaches analysis -❌ Not presenting [C] continue option after content generation -❌ Appending content without user selecting 'C' - -## PROMPT ENGINEERING RESEARCH PROTOCOLS: - -- Search for academic research papers on prompt engineering -- Research AI company blog posts and technical documentation -- Analyze open-source prompting frameworks and libraries -- Study prompt engineering case studies and success stories -- Research evaluation methodologies and benchmark datasets - -## NEXT STEP: - -After user selects 'C' and content is saved to document, load `./step-03-ai-interaction-patterns.md` to focus on AI interaction patterns and conversational design. - -Remember: Always emphasize current {{current_year}} prompt engineering data and rigorous source verification! diff --git a/src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-03-ai-interaction-patterns.md b/src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-03-ai-interaction-patterns.md deleted file mode 100644 index 0fd91767..00000000 --- a/src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-03-ai-interaction-patterns.md +++ /dev/null @@ -1,195 +0,0 @@ -# Deep Prompt Research Step 3: AI Interaction Patterns - -## MANDATORY EXECUTION RULES (READ FIRST): - -- 🛑 NEVER generate content without web search verification -- ✅ ALWAYS use {{current_year}} web searches for current AI interaction data -- 📋 YOU ARE AN AI INTERACTION DESIGN ANALYST, not content generator -- 💬 FOCUS on conversational AI patterns and user experience design -- 🔍 WEB RESEARCH REQUIRED - Use {{current_year}} data and verify sources - -## EXECUTION PROTOCOLS: - -- 🎯 Show web search analysis before presenting findings -- ⚠️ Present [C] continue option after AI interaction patterns content generation -- 💾 ONLY save when user chooses C (Continue) -- 📖 Update frontmatter `stepsCompleted: [1, 2, 3]` before loading next step -- 🚫 FORBIDDEN to load next step until C is selected - -## CONTEXT BOUNDARIES: - -- Current document and frontmatter from previous steps are available -- Focus on AI interaction patterns and conversational design principles -- Web search capabilities with source verification are enabled -- May need to search for current conversational AI research and patterns - -## YOUR TASK: - -Conduct comprehensive AI interaction patterns research using current {{current_year}} web data with emphasis on conversational design and user experience patterns. - -## AI INTERACTION PATTERNS SEQUENCE: - -### 1. Begin AI Interaction Patterns Analysis - -Start with interaction patterns research approach: -"Now I'll focus on **AI interaction patterns and conversational design** using current {{current_year}} data to understand effective human-AI interaction approaches. - -**AI Interaction Patterns Focus:** - -- Conversational design principles and patterns -- User experience (UX) considerations for AI interactions -- Multi-turn dialogue management strategies -- Error handling and recovery patterns -- Personalization and adaptation approaches - -**Let me search for current AI interaction patterns and research.**" - -### 2. Web Search for Conversational Design - -Search for current conversational design patterns: -`WebSearch: "conversational AI design patterns principles {{current_year}}"` - -**Design focus:** - -- Conversational flow design and management -- Dialogue structure and turn-taking patterns -- Context management and memory strategies -- Natural language understanding and generation patterns - -### 3. Web Search for AI User Experience - -Search for current AI UX patterns: -`WebSearch: "AI user experience design patterns {{current_year}}"` - -**UX focus:** - -- Interface design for AI-powered applications -- Trust and transparency in AI interactions -- User onboarding and education patterns -- Feedback and improvement mechanisms - -### 4. Web Search for Error Handling Patterns - -Search for current error handling approaches: -`WebSearch: "AI error handling recovery patterns {{current_year}}"` - -**Error focus:** - -- Graceful failure and recovery strategies -- Ambiguity resolution and clarification requests -- Confidence communication and uncertainty management -- Fallback mechanisms and escalation patterns - -### 5. Generate AI Interaction Patterns Content - -Prepare interaction patterns analysis with web search citations: - -#### Content Structure: - -When saving to document, append these Level 2 and Level 3 sections: - -```markdown -## AI Interaction Patterns and Design - -### Conversational Design Principles - -[Conversational design analysis with source citations] -_Source: [URL with {{current_year}} conversational data]_ - -### Multi-Turn Dialogue Management - -[Dialogue management analysis with source citations] -_Source: [URL with {{current_year}} dialogue data]_ - -### User Experience Patterns - -[UX patterns analysis with source citations] -_Source: [URL with {{current_year}} UX data]_ - -### Error Handling and Recovery - -[Error handling analysis with source citations] -_Source: [URL with {{current_year}} error handling data]_ - -### Context Management Strategies - -[Context management analysis with source citations] -_Source: [URL with {{current_year}} context data]_ - -### Personalization and Adaptation - -[Personalization analysis with source citations] -_Source: [URL with {{current_year}} personalization data]_ - -### Trust and Transparency Patterns - -[Trust patterns analysis with source citations] -_Source: [URL with {{current_year}} trust data]_ - -### Performance Optimization Strategies - -[Performance optimization analysis with source citations] -_Source: [URL with {{current_year}} performance data]_ -``` - -### 6. Present Analysis and Continue Option - -Show the generated AI interaction patterns and present continue option: -"I've completed the **AI interaction patterns research** using current {{current_year}} data to understand effective human-AI interaction approaches. - -**Key Interaction Findings:** - -- Conversational design principles and patterns clearly mapped -- Multi-turn dialogue management strategies thoroughly analyzed -- User experience patterns and considerations documented -- Error handling and recovery approaches identified -- Trust, transparency, and personalization patterns captured - -**Ready to proceed to workflow integration?** -[C] Continue - Save this to the document and move to workflow integration - -### 7. Handle Continue Selection - -#### If 'C' (Continue): - -- Append the final content to the research document -- Update frontmatter: `stepsCompleted: [1, 2, 3]` -- Load: `./step-04-workflow-integration.md` - -## APPEND TO DOCUMENT: - -When user selects 'C', append the content directly to the research document using the structure from step 5. - -## SUCCESS METRICS: - -✅ Conversational design principles identified with current {{current_year}} citations -✅ Multi-turn dialogue management strategies clearly documented -✅ User experience patterns thoroughly analyzed -✅ Error handling and recovery approaches mapped -✅ Trust, transparency, and personalization patterns captured -✅ [C] continue option presented and handled correctly -✅ Content properly appended to document when C selected -✅ Proper routing to workflow integration step - -## FAILURE MODES: - -❌ Not using {{current_year}} in AI interaction web searches -❌ Missing critical conversational design principles -❌ Not analyzing user experience patterns thoroughly -❌ Incomplete error handling or recovery patterns analysis -❌ Not presenting [C] continue option after content generation -❌ Appending content without user selecting 'C' - -## AI INTERACTION RESEARCH PROTOCOLS: - -- Search for human-computer interaction (HCI) research on AI interfaces -- Research conversational AI case studies and best practices -- Analyze industry guidelines for AI-powered product design -- Study user research and usability testing methodologies for AI -- Research accessibility and inclusive design patterns for AI interactions - -## NEXT STEP: - -After user selects 'C' and content is saved to document, load `./step-04-workflow-integration.md` to focus on workflow integration and implementation strategies. - -Remember: Always emphasize current {{current_year}} AI interaction data and rigorous source verification! diff --git a/src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-04-workflow-integration.md b/src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-04-workflow-integration.md deleted file mode 100644 index 9c1fc4c0..00000000 --- a/src/modules/bmm/workflows/1-analysis/research/deep-prompt-steps/step-04-workflow-integration.md +++ /dev/null @@ -1,235 +0,0 @@ -# Deep Prompt Research Step 4: Workflow Integration - -## MANDATORY EXECUTION RULES (READ FIRST): - -- 🛑 NEVER generate content without web search verification -- ✅ ALWAYS use {{current_year}} web searches for current workflow integration data -- 📋 YOU ARE A WORKFLOW INTEGRATION SPECIALIST, not content generator -- 💬 FOCUS on practical implementation and workflow design strategies -- 🔍 WEB RESEARCH REQUIRED - Use {{current_year}} data and verify sources - -## EXECUTION PROTOCOLS: - -- 🎯 Show web search analysis before presenting findings -- ⚠️ Present [C] complete option after workflow integration content generation -- 💾 ONLY save when user chooses C (Complete) -- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4]` before completing workflow -- 🚫 FORBIDDEN to complete workflow until C is selected - -## CONTEXT BOUNDARIES: - -- Current document and frontmatter from previous steps are available -- Focus on workflow integration and practical implementation strategies -- Web search capabilities with source verification are enabled -- This is the final step in the deep prompt research workflow - -## YOUR TASK: - -Conduct comprehensive workflow integration research using current {{current_year}} web data with emphasis on practical implementation and workflow design strategies. - -## WORKFLOW INTEGRATION SEQUENCE: - -### 1. Begin Workflow Integration Analysis - -Start with workflow integration research approach: -"Now I'll complete our deep prompt research with **workflow integration and implementation strategies** using current {{current_year}} data. - -**Workflow Integration Focus:** - -- Integration patterns for AI-powered workflows -- Implementation strategies and best practices -- Workflow orchestration and automation approaches -- Testing and validation methodologies -- Monitoring and optimization techniques - -**Let me search for current workflow integration and implementation strategies.**" - -### 2. Web Search for Workflow Integration Patterns - -Search for current integration patterns: -`WebSearch: "AI workflow integration patterns best practices {{current_year}}"` - -**Integration focus:** - -- System architecture integration approaches -- API design and integration patterns -- Data flow and processing workflows -- Microservices and distributed system integration - -### 3. Web Search for Implementation Strategies - -Search for current implementation approaches: -`WebSearch: "AI implementation strategies deployment {{current_year}}"` - -**Implementation focus:** - -- Development and deployment workflows -- Testing and quality assurance practices -- Change management and adoption strategies -- Performance monitoring and optimization - -### 4. Web Search for Workflow Automation - -Search for current automation approaches: -`WebSearch: "workflow automation orchestration AI {{current_year}}"` - -**Automation focus:** - -- Low-code and no-code workflow platforms -- Process automation and optimization techniques -- Integration with existing business processes -- Scalability and reliability considerations - -### 5. Generate Workflow Integration Content - -Prepare integration analysis with web search citations: - -#### Content Structure: - -When saving to document, append these Level 2 and Level 3 sections: - -```markdown -## Workflow Integration and Implementation - -### Integration Architecture Patterns - -[Integration patterns analysis with source citations] -_Source: [URL with {{current_year}} integration data]_ - -### Implementation Strategies - -[Implementation strategies analysis with source citations] -_Source: [URL with {{current_year}} implementation data]_ - -### Workflow Orchestration Approaches - -[Orchestration analysis with source citations] -_Source: [URL with {{current_year}} orchestration data]_ - -### Testing and Validation Frameworks - -[Testing frameworks analysis with source citations] -_Source: [URL with {{current_year}} testing data]_ - -### Monitoring and Optimization - -[Monitoring optimization analysis with source citations] -_Source: [URL with {{current_year}} monitoring data]_ - -### Change Management and Adoption - -[Change management analysis with source citations] -_Source: [URL with {{current_year}} change management data]_ - -### Scalability and Performance Considerations - -[Scalability analysis with source citations] -_Source: [URL with {{current_year}} scalability data]_ - -### Security and Compliance Integration - -[Security integration analysis with source citations] -_Source: [URL with {{current_year}} security data]_ - -## Deep Prompt Research Recommendations - -### Implementation Roadmap - -[Implementation roadmap recommendations] - -### Technology Stack Recommendations - -[Technology stack suggestions] - -### Best Practices and Guidelines - -[Best practices recommendations] - -### Success Metrics and Evaluation - -[Success measurement framework] -``` - -### 6. Present Analysis and Complete Option - -Show the generated workflow integration and present complete option: -"I've completed the **workflow integration and implementation research** using current {{current_year}} data, finalizing our comprehensive deep prompt research. - -**Integration Highlights:** - -- Integration architecture patterns and approaches documented -- Implementation strategies and best practices thoroughly analyzed -- Workflow orchestration and automation approaches identified -- Testing, monitoring, and optimization strategies provided -- Change management and adoption considerations captured - -**This completes our deep prompt research covering:** - -- Prompt engineering techniques and methodologies -- AI interaction patterns and design principles -- Workflow integration and implementation strategies -- Practical recommendations and implementation roadmap - -**Ready to complete the deep prompt research report?** -[C] Complete Research - Save final document and conclude - -### 7. Handle Complete Selection - -#### If 'C' (Complete Research): - -- Append the final content to the research document -- Update frontmatter: `stepsCompleted: [1, 2, 3, 4]` -- Complete the deep prompt research workflow - -## APPEND TO DOCUMENT: - -When user selects 'C', append the content directly to the research document using the structure from step 5. - -## SUCCESS METRICS: - -✅ Integration architecture patterns identified with current {{current_year}} citations -✅ Implementation strategies clearly documented -✅ Workflow orchestration approaches thoroughly analyzed -✅ Testing and monitoring frameworks mapped -✅ Change management and scalability considerations captured -✅ [C] complete option presented and handled correctly -✅ Content properly appended to document when C selected -✅ Deep prompt research workflow completed successfully - -## FAILURE MODES: - -❌ Not using {{current_year}} in workflow integration web searches -❌ Missing critical integration patterns or implementation strategies -❌ Not providing practical implementation guidance -❌ Incomplete testing or monitoring frameworks analysis -❌ Not presenting completion option for research workflow -❌ Appending content without user selecting 'C' - -## WORKFLOW INTEGRATION RESEARCH PROTOCOLS: - -- Search for enterprise architecture integration patterns -- Research DevOps and CI/CD practices for AI-powered applications -- Analyze workflow automation platforms and case studies -- Study change management methodologies for AI implementation -- Research monitoring and observability best practices for AI workflows - -## DEEP PROMPT RESEARCH WORKFLOW COMPLETION: - -When 'C' is selected: - -- All deep prompt research steps completed -- Comprehensive deep prompt research document generated -- All sections appended with source citations -- Deep prompt research workflow status updated -- Final implementation recommendations provided to user - -## NEXT STEPS: - -Deep prompt research workflow complete. User may: - -- Use deep prompt research to inform AI-powered workflow design -- Conduct additional research on specific AI technologies -- Combine deep prompt research with other research types for comprehensive insights -- Move forward with AI implementation based on research insights - -Congratulations on completing comprehensive deep prompt research with current {{current_year}} data! 🎉 diff --git a/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md b/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md index ba35a3ad..abadddf0 100644 --- a/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md +++ b/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-01-init.md @@ -33,43 +33,47 @@ This step will generate content and present choices: ## CONTEXT BOUNDARIES: -- Current document and frontmatter from step-01-discovery are available +- Current document and frontmatter from main workflow are available - Research type = "domain" is already set +- **Research topic = "{{research_topic}}"** - discovered from initial discussion +- **Research goals = "{{research_goals}}"** - captured from initial discussion - Focus on industry/domain analysis with web research - Web search capabilities with {{current_year}} data are enabled ## YOUR TASK: -Initialize domain research, gather context, and establish research scope with current web data. +Initialize domain research scope and approach for the already-identified topic: **{{research_topic}}** ## DOMAIN RESEARCH INITIALIZATION: ### 1. Confirm Domain Research Direction Begin with domain-specific positioning: -"I'll guide you through **domain research** using current {{current_year}} web data with rigorous source verification. +"I'll guide you through **domain research** for **{{research_topic}}** using current {{current_year}} web data with rigorous source verification. -**Domain Research Focus:** +**Research Goals Identified:** {{research_goals}} -- Industry analysis and market dynamics -- Regulatory requirements and compliance standards -- Technology trends and innovation patterns -- Competitive landscape within the domain +**Domain Research Focus for {{research_topic}}:** + +- Industry analysis and market dynamics for this domain +- Regulatory requirements and compliance standards affecting {{research_topic}} +- Technology trends and innovation patterns in {{research_topic}} +- Competitive landscape within the {{research_topic}} domain - Supply chain and ecosystem analysis -**What specific domain or industry are we researching?** +Let me refine the research scope specifically for **{{research_topic}}**: ### 2. Establish Research Context -Gather domain-specific details: +Refine domain-specific details based on the already-identified topic: -#### Context Questions: +#### Context Refinement Questions: -- "What specific domain/industry are we focusing on?" -- "Are there particular segments or sub-domains we should examine?" -- "What aspects of this domain are most critical for your project?" -- "Are there specific regulatory or compliance concerns?" -- "What time horizon should we consider (current state, future trends)?" +- "What specific aspects of {{research_topic}} are most critical for your goals?" +- "Are there particular segments or sub-domains within {{research_topic}} we should examine?" +- "What regulatory or compliance factors most impact {{research_topic}}?" +- "What time horizon for {{research_topic}} research - current state or include future trends?" +- "How deep should we analyze the {{research_topic}} domain - overview or comprehensive?" ### 3. Define Research Scope diff --git a/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md b/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md index 8afd1323..82535262 100644 --- a/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md +++ b/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-02-domain-analysis.md @@ -31,6 +31,8 @@ Conduct comprehensive domain/industry analysis using current {{current_year}} we ### 1. Begin Domain Analysis +**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different domain areas simultaneously and thoroughly + Start with web research approach: "Now I'll conduct comprehensive domain research using current {{current_year}} web data with rigorous source verification. @@ -42,12 +44,16 @@ Start with web research approach: - Key players and competitive ecosystem - Supply chain and business model evolution -**Let me search for current {{current_year}} data on [domain/industry].**" +**Let me search for current {{current_year}} data on [domain/industry] using parallel web searches for comprehensive coverage.**" -### 2. Web Search for Industry Overview +### 2. Parallel Web Search Execution + +**Execute multiple web searches simultaneously:** -Search for current industry information: `WebSearch: "[domain/industry] market size growth {{current_year}}"` +`WebSearch: "[domain/industry] technology trends {{current_year}}"` +`WebSearch: "[domain/industry] regulations compliance {{current_year}}"` +`WebSearch: "[domain/industry] key players ecosystem {{current_year}}"` **Analysis approach:** @@ -55,32 +61,30 @@ Search for current industry information: - Identify market size, growth rates, and trends - Find authoritative sources (market research firms, industry associations) - Note conflicting information from different sources +- Gather technology trends and innovation patterns +- Research regulatory requirements and compliance standards +- Analyze competitive landscape and key players -### 3. Web Search for Technology Trends +### 3. Analyze and Aggregate Results -Search for current technology developments: -`WebSearch: "[domain/industry] technology trends {{current_year}}"` +**Collect and analyze findings from all parallel searches:** -**Technology focus:** +"After executing comprehensive parallel web searches, let me analyze and aggregate the findings: -- Emerging technologies and innovation patterns -- Digital transformation impacts -- Automation and efficiency improvements -- New business models enabled by technology +**Research Coverage:** -### 4. Web Search for Regulatory Landscape +- Market analysis and industry dynamics +- Technology trends and innovation patterns +- Regulatory landscape and compliance requirements +- Key players and competitive ecosystem -Search for current regulatory requirements: -`WebSearch: "[domain/industry] regulations compliance {{current_year}}"` +**Cross-Domain Analysis:** +[Identify patterns, connections, and insights that emerge across multiple search areas] -**Regulatory focus:** +**Quality Assessment:** +[Overall confidence levels and research gaps identified]" -- Current regulations and compliance requirements -- Recent changes or upcoming regulations -- Industry standards and best practices -- Regional or jurisdictional differences - -### 5. Generate Domain Analysis Content +### 4. Generate Domain Analysis Content Prepare analysis content with source citations: @@ -117,7 +121,7 @@ _Source: [URL with {{current_year}} data]_ _Source: [URL with {{current_year}} data]_ ``` -### 6. Present Analysis and Continue Option +### 5. Present Analysis and Continue Option Show the generated analysis and present continue option: "I've completed the **domain/industry analysis** using current {{current_year}} web data with rigorous source verification. @@ -132,7 +136,7 @@ Show the generated analysis and present continue option: **Ready to proceed to regulatory focus?** [C] Continue - Save this to the document and move to regulatory focus -### 7. Handle Continue Selection +### 6. Handle Continue Selection #### If 'C' (Continue): @@ -142,7 +146,7 @@ Show the generated analysis and present continue option: ## APPEND TO DOCUMENT: -When user selects 'C', append the content directly to the research document using the structure from step 5. +When user selects 'C', append the content directly to the research document using the structure from step 4. ## SUCCESS METRICS: diff --git a/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-05-research-synthesis.md b/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-05-research-synthesis.md new file mode 100644 index 00000000..ab0d3119 --- /dev/null +++ b/src/modules/bmm/workflows/1-analysis/research/domain-steps/step-05-research-synthesis.md @@ -0,0 +1,436 @@ +# Domain Research Step 5: Research Synthesis and Completion + +## MANDATORY EXECUTION RULES (READ FIRST): + +- 🛑 NEVER generate content without web search verification +- ✅ ALWAYS use {{current_year}} web searches for current domain data +- 📋 YOU ARE A DOMAIN RESEARCH STRATEGIST, not content generator +- 💬 FOCUS on comprehensive synthesis and authoritative conclusions +- 🔍 WEB RESEARCH REQUIRED - Use {{current_year}} data and verify sources +- 📄 PRODUCE COMPREHENSIVE DOCUMENT with narrative intro, TOC, and summary + +## EXECUTION PROTOCOLS: + +- 🎯 Show web search analysis before presenting findings +- ⚠️ Present [C] complete option after synthesis content generation +- 💾 ONLY save when user chooses C (Complete) +- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5]` before completing workflow +- 🚫 FORBIDDEN to complete workflow until C is selected +- 📚 GENERATE COMPLETE DOCUMENT STRUCTURE with intro, TOC, and summary + +## CONTEXT BOUNDARIES: + +- Current document and frontmatter from previous steps are available +- **Research topic = "{{research_topic}}"** - comprehensive domain analysis +- **Research goals = "{{research_goals}}"** - achieved through exhaustive research +- All domain research sections have been completed (analysis, regulatory, technical) +- Web search capabilities with source verification are enabled +- This is the final synthesis step producing the complete research document + +## YOUR TASK: + +Produce a comprehensive, authoritative research document on **{{research_topic}}** with compelling narrative introduction, detailed TOC, and executive summary based on exhaustive domain research. + +## COMPREHENSIVE DOCUMENT SYNTHESIS: + +### 1. Document Structure Planning + +**Complete Research Document Structure:** + +```markdown +# [Compelling Title]: Comprehensive {{research_topic}} Research + +## Executive Summary + +[Brief compelling overview of key findings and implications] + +## Table of Contents + +- Research Introduction and Methodology +- Industry Overview and Market Dynamics +- Technology Trends and Innovation Landscape +- Regulatory Framework and Compliance Requirements +- Competitive Landscape and Key Players +- Strategic Insights and Recommendations +- Implementation Considerations and Risk Assessment +- Future Outlook and Strategic Opportunities +- Research Methodology and Source Documentation +- Appendices and Additional Resources +``` + +### 2. Generate Compelling Narrative Introduction + +**Introduction Requirements:** + +- Hook reader with compelling opening about {{research_topic}} +- Establish research significance and timeliness +- Outline comprehensive research methodology +- Preview key findings and strategic implications +- Set professional, authoritative tone + +**Web Search for Introduction Context:** +`WebSearch: "{{research_topic}} significance importance {{current_year}}"` + +### 3. Synthesize All Research Sections + +**Section-by-Section Integration:** + +- Combine industry analysis from step-02 +- Integrate regulatory focus from step-03 +- Incorporate technical trends from step-04 +- Add cross-sectional insights and connections +- Ensure comprehensive coverage with no gaps + +### 4. Generate Complete Document Content + +#### Final Document Structure: + +```markdown +# [Compelling Title]: Comprehensive {{research_topic}} Domain Research + +## Executive Summary + +[2-3 paragraph compelling summary of the most critical findings and strategic implications for {{research_topic}} based on comprehensive {{current_year}} research] + +**Key Findings:** + +- [Most significant market dynamics] +- [Critical regulatory considerations] +- [Important technology trends] +- [Strategic implications] + +**Strategic Recommendations:** + +- [Top 3-5 actionable recommendations based on research] + +## Table of Contents + +1. Research Introduction and Methodology +2. {{research_topic}} Industry Overview and Market Dynamics +3. Technology Landscape and Innovation Trends +4. Regulatory Framework and Compliance Requirements +5. Competitive Landscape and Ecosystem Analysis +6. Strategic Insights and Domain Opportunities +7. Implementation Considerations and Risk Assessment +8. Future Outlook and Strategic Planning +9. Research Methodology and Source Verification +10. Appendices and Additional Resources + +## 1. Research Introduction and Methodology + +### Research Significance + +[Compelling narrative about why {{research_topic}} research is critical in {{current_year}}] +_Why this research matters now: [Strategic importance with {{current_year}} context]_ +_Source: [URL with {{current_year}} industry significance data]_ + +### Research Methodology + +[Comprehensive description of research approach including:] + +- **Research Scope**: [Comprehensive coverage areas] +- **Data Sources**: [Authoritative sources and verification approach] +- **Analysis Framework**: [Structured analysis methodology] +- **Time Period**: [{{current_year}} focus and historical context] +- **Geographic Coverage**: [Regional/global scope] + +### Research Goals and Objectives + +**Original Goals:** {{research_goals}} + +**Achieved Objectives:** + +- [Goal 1 achievement with supporting evidence] +- [Goal 2 achievement with supporting evidence] +- [Additional insights discovered during research] + +## 2. {{research_topic}} Industry Overview and Market Dynamics + +### Market Size and Growth Projections + +[Comprehensive market analysis synthesized from step-02 with {{current_year}} data] +_Market Size: [Current market valuation]_ +_Growth Rate: [CAGR and projections]_ +_Market Drivers: [Key growth factors]_ +_Source: [URL with {{current_year}} market data]_ + +### Industry Structure and Value Chain + +[Complete industry structure analysis] +_Value Chain Components: [Detailed breakdown]_ +_Industry Segments: [Market segmentation analysis]_ +_Economic Impact: [Industry economic significance]_ +_Source: [URL with {{current_year}} industry structure data]_ + +## 3. Technology Landscape and Innovation Trends + +### Current Technology Adoption + +[Technology trends analysis from step-04 with {{current_year}} context] +_Emerging Technologies: [Key technologies affecting {{research_topic}}]_ +_Adoption Patterns: [Technology adoption rates and patterns]_ +_Innovation Drivers: [Factors driving technology change]_ +_Source: [URL with {{current_year}} technology data]_ + +### Digital Transformation Impact + +[Comprehensive analysis of technology's impact on {{research_topic}}] +_Transformation Trends: [Major digital transformation patterns]_ +_Disruption Opportunities: [Technology-driven opportunities]_ +_Future Technology Outlook: [Emerging technologies and timelines]_ +_Source: [URL with {{current_year}} digital transformation data]_ + +## 4. Regulatory Framework and Compliance Requirements + +### Current Regulatory Landscape + +[Regulatory analysis from step-03 with {{current_year}} updates] +_Key Regulations: [Critical regulatory requirements]_ +_Compliance Standards: [Industry standards and best practices]_ +_Recent Changes: [{{current_year}} regulatory updates and implications]_ +_Source: [URL with {{current_year}} regulatory data]_ + +### Risk and Compliance Considerations + +[Comprehensive risk assessment] +_Compliance Risks: [Major regulatory and compliance risks]_ +_Risk Mitigation Strategies: [Approaches to manage regulatory risks]_ +_Future Regulatory Trends: [Anticipated regulatory developments]_ +_Source: [URL with {{current_year}} compliance data]_ + +## 5. Competitive Landscape and Ecosystem Analysis + +### Market Positioning and Key Players + +[Competitive analysis with {{current_year}} market positioning] +_Market Leaders: [Dominant players and strategies]_ +_Emerging Competitors: [New entrants and innovative approaches]_ +_Competitive Dynamics: [Market competition patterns and trends]_ +_Source: [URL with {{current_year}} competitive data]_ + +### Ecosystem and Partnership Landscape + +[Complete ecosystem analysis] +_Ecosystem Players: [Key stakeholders and relationships]_ +_Partnership Opportunities: [Strategic collaboration potential]_ +_Supply Chain Dynamics: [Supply chain structure and risks]_ +_Source: [URL with {{current_year}} ecosystem data]_ + +## 6. Strategic Insights and Domain Opportunities + +### Cross-Domain Synthesis + +[Strategic insights from integrating all research sections] +_Market-Technology Convergence: [How technology and market forces interact]_ +_Regulatory-Strategic Alignment: [How regulatory environment shapes strategy]_ +_Competitive Positioning Opportunities: [Strategic advantages based on research]_ +_Source: [URL with {{current_year}} strategic analysis data]_ + +### Strategic Opportunities + +[High-value opportunities identified through comprehensive research] +_Market Opportunities: [Specific market entry or expansion opportunities]_ +_Technology Opportunities: [Technology adoption or innovation opportunities]_ +_Partnership Opportunities: [Strategic collaboration and partnership potential]_ +_Source: [URL with {{current_year}} opportunity data]_ + +## 7. Implementation Considerations and Risk Assessment + +### Implementation Framework + +[Practical implementation guidance based on research findings] +_Implementation Timeline: [Recommended phased approach]_ +_Resource Requirements: [Key resources and capabilities needed]_ +_Success Factors: [Critical success factors for implementation]_ +_Source: [URL with {{current_year}} implementation data]_ + +### Risk Management and Mitigation + +[Comprehensive risk assessment and mitigation strategies] +_Implementation Risks: [Major risks and mitigation approaches]_ +_Market Risks: [Market-related risks and contingency plans]_ +_Technology Risks: [Technology adoption and implementation risks]_ +_Source: [URL with {{current_year}} risk management data]_ + +## 8. Future Outlook and Strategic Planning + +### Future Trends and Projections + +[Forward-looking analysis based on comprehensive research] +_Near-term Outlook: [1-2 year projections and implications]_ +_Medium-term Trends: [3-5 year expected developments]_ +_Long-term Vision: [5+ year strategic outlook for {{research_topic}}]_ +_Source: [URL with {{current_year}} future outlook data]_ + +### Strategic Recommendations + +[Comprehensive strategic recommendations] +_Immediate Actions: [Priority actions for next 6 months]_ +_Strategic Initiatives: [Key strategic initiatives for 1-2 years]_ +_Long-term Strategy: [Strategic positioning for 3+ years]_ +_Source: [URL with {{current_year}} strategic planning data]_ + +## 9. Research Methodology and Source Verification + +### Comprehensive Source Documentation + +[Complete documentation of all research sources] +_Primary Sources: [Key authoritative sources used]_ +_Secondary Sources: [Supporting research and analysis]_ +_Web Search Queries: [Complete list of search queries used]_ +_Data Currency: [All data verified for {{current_year}} currency]_ + +### Research Quality Assurance + +[Quality assurance and validation approach] +_Source Verification: [All factual claims verified with multiple sources]_ +_Confidence Levels: [Confidence assessments for uncertain data]_ +_Limitations: [Research limitations and areas for further investigation]_ +_Methodology Transparency: [Complete transparency about research approach]_ + +## 10. Appendices and Additional Resources + +### Detailed Data Tables + +[Comprehensive data tables supporting research findings] +_Market Data Tables: [Detailed market size, growth, and segmentation data]_ +_Technology Adoption Data: [Detailed technology adoption and trend data]_ +_Regulatory Reference Tables: [Complete regulatory requirements and compliance data]_ + +### Additional Resources + +[Valuable resources for continued research and implementation] +_Industry Associations: [Key industry organizations and resources]_ +_Research Organizations: [Authoritative research institutions and reports]_ +_Government Resources: [Regulatory agencies and official resources]_ +_Professional Networks: [Industry communities and knowledge sources]_ + +--- + +## Research Conclusion + +### Summary of Key Findings + +[Comprehensive summary of the most important research findings] + +### Strategic Impact Assessment + +[Assessment of strategic implications for {{research_topic}}] + +### Next Steps Recommendations + +[Specific next steps for leveraging this research] + +--- + +**Research Completion Date:** {{date}} +**Research Period:** {{current_year}} comprehensive analysis +**Document Length:** As needed for comprehensive coverage +**Source Verification:** All facts cited with {{current_year}} sources +**Confidence Level:** High - based on multiple authoritative sources + +_This comprehensive research document serves as an authoritative reference on {{research_topic}} and provides strategic insights for informed decision-making._ +``` + +### 5. Present Complete Document and Final Option + +**Document Completion Presentation:** + +"I've completed the **comprehensive research document synthesis** for **{{research_topic}}**, producing an authoritative research document with: + +**Document Features:** + +- **Compelling Narrative Introduction**: Engaging opening that establishes research significance +- **Comprehensive Table of Contents**: Complete navigation structure for easy reference +- **Exhaustive Research Coverage**: All aspects of {{research_topic}} thoroughly analyzed +- **Executive Summary**: Key findings and strategic implications highlighted +- **Strategic Recommendations**: Actionable insights based on comprehensive research +- **Complete Source Citations**: Every factual claim verified with {{current_year}} sources + +**Research Completeness:** + +- Industry analysis and market dynamics fully documented +- Technology trends and innovation landscape comprehensively covered +- Regulatory framework and compliance requirements detailed +- Competitive landscape and ecosystem analysis complete +- Strategic insights and implementation guidance provided + +**Document Standards Met:** + +- Exhaustive research with no critical gaps +- Professional structure and compelling narrative +- As long as needed for comprehensive coverage +- Multiple independent sources for all claims +- {{current_year}} data throughout with proper citations + +**Ready to complete this comprehensive research document?** +[C] Complete Research - Save final comprehensive document + +### 6. Handle Final Completion + +#### If 'C' (Complete Research): + +- Append the complete document to the research file +- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5]` +- Complete the domain research workflow +- Provide final document delivery confirmation + +## APPEND TO DOCUMENT: + +When user selects 'C', append the complete comprehensive research document using the full structure above. + +## SUCCESS METRICS: + +✅ Compelling narrative introduction with research significance +✅ Comprehensive table of contents with complete document structure +✅ Exhaustive research coverage across all domain aspects +✅ Executive summary with key findings and strategic implications +✅ Strategic recommendations grounded in comprehensive research +✅ Complete source verification with {{current_year}} citations +✅ Professional document structure and compelling narrative +✅ [C] complete option presented and handled correctly +✅ Domain research workflow completed with comprehensive document + +## FAILURE MODES: + +❌ Not producing compelling narrative introduction +❌ Missing comprehensive table of contents +❌ Incomplete research coverage across domain aspects +❌ Not providing executive summary with key findings +❌ Missing strategic recommendations based on research +❌ Not using {{current_year}} sources for all factual claims +❌ Producing document without professional structure +❌ Not presenting completion option for final document + +## COMPREHENSIVE DOCUMENT STANDARDS: + +This step ensures the final research document: + +- Serves as an authoritative reference on {{research_topic}} +- Provides compelling narrative and professional structure +- Includes comprehensive coverage with no gaps +- Maintains rigorous source verification standards +- Delivers strategic insights and actionable recommendations +- Meets professional research document quality standards + +## DOMAIN RESEARCH WORKFLOW COMPLETION: + +When 'C' is selected: + +- All domain research steps completed (1-5) +- Comprehensive domain research document generated +- Professional document structure with intro, TOC, and summary +- All sections appended with source citations +- Domain research workflow status updated to complete +- Final comprehensive research document delivered to user + +## FINAL DELIVERABLE: + +Complete authoritative research document on {{research_topic}} that: + +- Establishes professional credibility through comprehensive research +- Provides strategic insights for informed decision-making +- Serves as reference document for continued use +- Maintains highest research quality standards with {{current_year}} verification + +Congratulations on completing comprehensive domain research with professional documentation! 🎉 diff --git a/src/modules/bmm/workflows/1-analysis/research/market-steps/step-01-init.md b/src/modules/bmm/workflows/1-analysis/research/market-steps/step-01-init.md index 959d366d..fa1fb788 100644 --- a/src/modules/bmm/workflows/1-analysis/research/market-steps/step-01-init.md +++ b/src/modules/bmm/workflows/1-analysis/research/market-steps/step-01-init.md @@ -20,29 +20,47 @@ - Current document and frontmatter from main workflow discovery are available - Research type = "market" is already set +- **Research topic = "{{research_topic}}"** - discovered from initial discussion +- **Research goals = "{{research_goals}}"** - captured from initial discussion - Focus on market research with current {{current_year}} data - Web search capabilities with source verification are enabled ## YOUR TASK: -Conduct comprehensive market analysis using current {{current_year}} web data with rigorous source verification. +Initialize market research scope and approach for the already-identified topic: **{{research_topic}}** with goals: {{research_goals}} ## MARKET ANALYSIS SEQUENCE: -### 1. Begin Market Analysis +### 1. Initialize Market Research -Start with market research approach: -"I'll conduct comprehensive **market analysis** using current {{current_year}} web data with rigorous source verification. +Start with market-specific positioning: +"I'll guide you through **market research** for **{{research_topic}}** using current {{current_year}} web data with rigorous source verification. -**Market Analysis Focus:** +**Research Goals Identified:** {{research_goals}} -- Market size and growth projections -- Customer segments and demographics -- Competitive landscape analysis -- Pricing strategies and business models -- Market trends and consumer behavior +**Market Research Focus for {{research_topic}}:** -**Let me search for current market data.**" +- Market size and growth projections for {{research_topic}} +- Customer segments and demographics interested in {{research_topic}} +- Competitive landscape analysis in {{research_topic}} market +- Pricing strategies and business models for {{research_topic}} +- Market trends and consumer behavior around {{research_topic}} + +Let me refine the market research scope specifically for **{{research_topic}}**: + +### 2. Establish Market Research Context + +#### Market Context Questions: + +- "What specific market aspects of {{research_topic}} are most critical for your goals?" +- "Are there particular customer segments or demographics within {{research_topic}} we should focus on?" +- "Should we analyze the global {{research_topic}} market or specific regions?" +- "What time horizon for {{research_topic}} market research - current state or future projections?" +- "How comprehensive should the {{research_topic}} competitive analysis be?" + +### 3. Begin Market Research Execution + +After scope refinement, proceed with: ### 2. Generate Market Analysis Content diff --git a/src/modules/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md b/src/modules/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md index dda0082f..3b9d07d9 100644 --- a/src/modules/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md +++ b/src/modules/bmm/workflows/1-analysis/research/market-steps/step-02-customer-insights.md @@ -31,6 +31,8 @@ Conduct comprehensive customer insights analysis using current {{current_year}} ### 1. Begin Customer Insights Analysis +**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different customer areas simultaneously and thoroughly + Start with customer research approach: "Now I'll conduct **customer insights analysis** using current {{current_year}} web data to understand customer behavior and needs. @@ -43,9 +45,44 @@ Start with customer research approach: - Customer satisfaction drivers - Demographic and psychographic profiles -**Let me search for current customer insights.**" +**Let me search for current customer insights using parallel web searches for comprehensive coverage.**" -### 2. Generate Customer Insights Content +### 2. Parallel Customer Research Execution + +**Execute multiple web searches simultaneously:** + +`WebSearch: "[product/service/market] customer behavior patterns {{current_year}}"` +`WebSearch: "[product/service/market] customer pain points challenges {{current_year}}"` +`WebSearch: "[product/service/market] customer decision process {{current_year}}"` + +**Analysis approach:** + +- Look for customer behavior studies and surveys +- Search for customer experience and interaction patterns +- Research customer satisfaction methodologies +- Note generational and cultural customer variations +- Research customer pain points and frustrations +- Analyze decision-making processes and criteria + +### 3. Analyze and Aggregate Results + +**Collect and analyze findings from all parallel searches:** + +"After executing comprehensive parallel web searches, let me analyze and aggregate the customer insights: + +**Research Coverage:** + +- Customer behavior patterns and preferences +- Pain points and challenges +- Decision-making processes and journey mapping + +**Cross-Customer Analysis:** +[Identify patterns connecting behavior, pain points, and decisions] + +**Quality Assessment:** +[Overall confidence levels and research gaps identified]" + +### 4. Generate Customer Insights Content Prepare customer analysis with web search citations: @@ -92,7 +129,7 @@ _Source: [URL with {{current_year}} demographic data]_ _Source: [URL with {{current_year}} psychographic data]_ ``` -### 3. Present Analysis and Continue Option +### 5. Present Analysis and Continue Option Show the generated customer insights and present continue option: "I've completed the **customer insights analysis** using current {{current_year}} data to understand customer behavior and needs. @@ -108,7 +145,7 @@ Show the generated customer insights and present continue option: **Ready to proceed to competitive analysis?** [C] Continue - Save this to the document and proceed to competitive analysis -### 4. Handle Continue Selection +### 6. Handle Continue Selection #### If 'C' (Continue): @@ -118,7 +155,7 @@ Show the generated customer insights and present continue option: ## APPEND TO DOCUMENT: -When user selects 'C', append the content directly to the research document using the structure from step 2. +When user selects 'C', append the content directly to the research document using the structure from step 4. ## SUCCESS METRICS: diff --git a/src/modules/bmm/workflows/1-analysis/research/market-steps/step-04-research-completion.md b/src/modules/bmm/workflows/1-analysis/research/market-steps/step-04-research-completion.md index fc8c097b..1b70c8cb 100644 --- a/src/modules/bmm/workflows/1-analysis/research/market-steps/step-04-research-completion.md +++ b/src/modules/bmm/workflows/1-analysis/research/market-steps/step-04-research-completion.md @@ -15,17 +15,20 @@ - 💾 ONLY save when user chooses C (Complete) - 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4]` before completing workflow - 🚫 FORBIDDEN to complete workflow until C is selected +- 📚 GENERATE COMPLETE DOCUMENT STRUCTURE with intro, TOC, and summary ## CONTEXT BOUNDARIES: - Current document and frontmatter from previous steps are available -- Focus on strategic synthesis and actionable recommendations +- **Research topic = "{{research_topic}}"** - comprehensive market analysis +- **Research goals = "{{research_goals}}"** - achieved through exhaustive market research +- All market research sections have been completed (customer insights, competitive analysis) - Web search capabilities with source verification are enabled -- This is the final step in the market research workflow +- This is the final synthesis step producing the complete market research document ## YOUR TASK: -Conduct comprehensive strategic synthesis using current {{current_year}} web data with emphasis on actionable market research recommendations. +Produce a comprehensive, authoritative market research document on **{{research_topic}}** with compelling narrative introduction, detailed TOC, and executive summary based on exhaustive market research. ## MARKET RESEARCH COMPLETION SEQUENCE: @@ -68,89 +71,316 @@ Search for current risk approaches: - Regulatory and compliance risks - Economic and market volatility considerations -### 4. Generate Strategic Synthesis Content +### 4. Generate Complete Market Research Document -Prepare strategic recommendations with web search citations: +Prepare comprehensive market research document with full structure: -#### Content Structure: - -When saving to document, append these Level 2 and Level 3 sections: +#### Complete Document Structure: ```markdown -## Strategic Synthesis and Recommendations +# [Compelling Title]: Comprehensive {{research_topic}} Market Research -### Key Market Insights Summary +## Executive Summary -[Integrated summary of market research findings with source citations] -_Source: [URL with {{current_year}} strategic data]_ +[Brief compelling overview of key market findings and strategic implications] + +## Table of Contents + +- Market Research Introduction and Methodology +- {{research_topic}} Market Analysis and Dynamics +- Customer Insights and Behavior Analysis +- Competitive Landscape and Positioning +- Strategic Market Recommendations +- Market Entry and Growth Strategies +- Risk Assessment and Mitigation +- Implementation Roadmap and Success Metrics +- Future Market Outlook and Opportunities +- Market Research Methodology and Source Documentation +- Market Research Appendices and Additional Resources + +## 1. Market Research Introduction and Methodology + +### Market Research Significance + +[Compelling market narrative about why {{research_topic}} research is critical in {{current_year}}] +_Market Importance: [Strategic market significance with {{current_year}} context]_ +_Business Impact: [Business implications of market research]_ +_Source: [URL with {{current_year}} market significance data]_ + +### Market Research Methodology + +[Comprehensive description of market research approach including:] + +- **Market Scope**: [Comprehensive market coverage areas] +- **Data Sources**: [Authoritative market sources and verification approach] +- **Analysis Framework**: [Structured market analysis methodology] +- **Time Period**: [{{current_year}} focus and market evolution context] +- **Geographic Coverage**: [Regional/global market scope] + +### Market Research Goals and Objectives + +**Original Market Goals:** {{research_goals}} + +**Achieved Market Objectives:** + +- [Market Goal 1 achievement with supporting evidence] +- [Market Goal 2 achievement with supporting evidence] +- [Additional market insights discovered during research] + +## 2. {{research_topic}} Market Analysis and Dynamics + +### Market Size and Growth Projections + +[Comprehensive market analysis with {{current_year}} data] +_Market Size: [Current market valuation and size]_ +_Growth Rate: [CAGR and market growth projections]_ +_Market Drivers: [Key factors driving market growth]_ +_Market Segments: [Detailed market segmentation analysis]_ +_Source: [URL with {{current_year}} market size data]_ + +### Market Trends and Dynamics + +[Current market trends analysis] +_Emerging Trends: [Key market trends and their implications]_ +_Market Dynamics: [Forces shaping market evolution]_ +_Consumer Behavior Shifts: [Changes in customer behavior and preferences]_ +_Source: [URL with {{current_year}} market trends data]_ + +### Pricing and Business Model Analysis + +[Comprehensive pricing and business model analysis] +_Pricing Strategies: [Current pricing approaches and models]_ +_Business Model Evolution: [Emerging and successful business models]_ +_Value Proposition Analysis: [Customer value proposition assessment]_ +_Source: [URL with {{current_year}} pricing data]_ + +## 3. Customer Insights and Behavior Analysis + +### Customer Behavior Patterns + +[Customer insights analysis with {{current_year}} context] +_Behavior Patterns: [Key customer behavior trends and patterns]_ +_Customer Journey: [Complete customer journey mapping]_ +_Decision Factors: [Factors influencing customer decisions]_ +_Source: [URL with {{current_year}} customer behavior data]_ + +### Customer Pain Points and Needs + +[Comprehensive customer pain point analysis] +_Pain Points: [Key customer challenges and frustrations]_ +_Unmet Needs: [Unsolved customer needs and opportunities]_ +_Customer Expectations: [Current customer expectations and requirements]_ +_Source: [URL with {{current_year}} customer insights data]_ + +### Customer Segmentation and Targeting + +[Detailed customer segmentation analysis] +_Customer Segments: [Detailed customer segment profiles]_ +_Target Market Analysis: [Most attractive customer segments]_ +_Segment-specific Strategies: [Tailored approaches for key segments]_ +_Source: [URL with {{current_year}} segmentation data]_ + +## 4. Competitive Landscape and Positioning + +### Competitive Analysis + +[Comprehensive competitive analysis] +_Market Leaders: [Dominant competitors and their strategies]_ +_Emerging Competitors: [New entrants and innovative approaches]_ +_Competitive Advantages: [Key differentiators and competitive advantages]_ +_Source: [URL with {{current_year}} competitive data]_ + +### Market Positioning Strategies + +[Strategic positioning analysis] +_Positioning Opportunities: [Opportunities for market differentiation]_ +_Competitive Gaps: [Unserved market needs and opportunities]_ +_Positioning Framework: [Recommended positioning approach]_ +_Source: [URL with {{current_year}} positioning data]_ + +## 5. Strategic Market Recommendations + +### Market Opportunity Assessment + +[Strategic market opportunities analysis] +_High-Value Opportunities: [Most attractive market opportunities]_ +_Market Entry Timing: [Optimal timing for market entry or expansion]_ +_Growth Strategies: [Recommended approaches for market growth]_ +_Source: [URL with {{current_year}} market opportunity data]_ ### Strategic Recommendations -[Strategic recommendations based on research with source citations] -_Source: [URL with {{current_year}} strategy data]_ +[Comprehensive strategic recommendations] +_Market Entry Strategy: [Recommended approach for market entry/expansion]_ +_Competitive Strategy: [Recommended competitive positioning and approach]_ +_Customer Acquisition Strategy: [Recommended customer acquisition approach]_ +_Source: [URL with {{current_year}} strategic data]_ -### Market Entry or Expansion Strategy +## 6. Market Entry and Growth Strategies -[Market approach strategy with source citations] +### Go-to-Market Strategy + +[Comprehensive go-to-market approach] +_Market Entry Approach: [Recommended market entry strategy and tactics]_ +_Channel Strategy: [Optimal channels for market reach and customer acquisition]_ +_Partnership Strategy: [Strategic partnership and collaboration opportunities]_ _Source: [URL with {{current_year}} market entry data]_ -### Competitive Positioning Strategy +### Growth and Scaling Strategy -[Positioning recommendations with source citations] -_Source: [URL with {{current_year}} positioning data]_ +[Market growth and scaling analysis] +_Growth Phases: [Recommended phased approach to market growth]_ +_Scaling Considerations: [Key factors for successful market scaling]_ +_Expansion Opportunities: [Opportunities for geographic or segment expansion]_ +_Source: [URL with {{current_year}} growth strategy data]_ -### Risk Assessment and Mitigation +## 7. Risk Assessment and Mitigation -[Risk analysis and mitigation strategies with source citations] -_Source: [URL with {{current_year}} risk data]_ +### Market Risk Analysis -### Implementation Roadmap +[Comprehensive market risk assessment] +_Market Risks: [Key market-related risks and uncertainties]_ +_Competitive Risks: [Competitive threats and mitigation strategies]_ +_Regulatory Risks: [Regulatory and compliance considerations]_ +_Source: [URL with {{current_year}} risk assessment data]_ -[Actionable implementation plan with source citations] +### Mitigation Strategies + +[Risk mitigation and contingency planning] +_Risk Mitigation Approaches: [Strategies for managing identified risks]_ +_Contingency Planning: [Backup plans and alternative approaches]_ +_Market Sensitivity Analysis: [Impact of market changes on strategy]_ +_Source: [URL with {{current_year}} mitigation data]_ + +## 8. Implementation Roadmap and Success Metrics + +### Implementation Framework + +[Comprehensive implementation guidance] +_Implementation Timeline: [Recommended phased implementation approach]_ +_Required Resources: [Key resources and capabilities needed]_ +_Implementation Milestones: [Key milestones and success criteria]_ _Source: [URL with {{current_year}} implementation data]_ ### Success Metrics and KPIs -[Success measurement framework with source citations] +[Comprehensive success measurement framework] +_Key Performance Indicators: [Critical metrics for measuring success]_ +_Monitoring and Reporting: [Approach for tracking and reporting progress]_ +_Success Criteria: [Clear criteria for determining success]_ _Source: [URL with {{current_year}} metrics data]_ -## Market Research Summary +## 9. Future Market Outlook and Opportunities -### Research Methodology +### Future Market Trends -[Summary of research approach and sources] +[Forward-looking market analysis] +_Near-term Market Evolution: [1-2 year market development expectations]_ +_Medium-term Market Trends: [3-5 year expected market developments]_ +_Long-term Market Vision: [5+ year market outlook for {{research_topic}}]_ +_Source: [URL with {{current_year}} future trends data]_ -### Key Findings Recap +### Strategic Opportunities -[Brief recap of all research findings] +[Market opportunity analysis and recommendations] +_Emerging Opportunities: [New market opportunities and their potential]_ +_Innovation Opportunities: [Areas for market innovation and differentiation]_ +_Strategic Market Investments: [Recommended market investments and priorities]_ +_Source: [URL with {{current_year}} opportunity data]_ -### Limitations and Considerations +## 10. Market Research Methodology and Source Verification -[Research limitations and additional considerations] +### Comprehensive Market Source Documentation + +[Complete documentation of all market research sources] +_Primary Market Sources: [Key authoritative market sources used]_ +_Secondary Market Sources: [Supporting market research and analysis]_ +_Market Web Search Queries: [Complete list of market search queries used]_ +_Market Data Currency: [All market data verified for {{current_year}} currency]_ + +### Market Research Quality Assurance + +[Market research quality assurance and validation approach] +_Market Source Verification: [All market claims verified with multiple sources]_ +_Market Confidence Levels: [Confidence assessments for uncertain market data]_ +_Market Research Limitations: [Market research limitations and areas for further investigation]_ +_Methodology Transparency: [Complete transparency about market research approach]_ + +## 11. Market Research Appendices and Additional Resources + +### Detailed Market Data Tables + +[Comprehensive market data tables supporting research findings] +_Market Size Data: [Detailed market size and growth data tables]_ +_Customer Analysis Data: [Detailed customer behavior and segmentation data]_ +_Competitive Analysis Data: [Detailed competitor comparison and positioning data]_ + +### Market Resources and References + +[Valuable market resources for continued research and implementation] +_Market Research Reports: [Authoritative market research reports and publications]_ +_Industry Associations: [Key industry organizations and market resources]_ +_Market Analysis Tools: [Tools and resources for ongoing market analysis]_ + +--- + +## Market Research Conclusion + +### Summary of Key Market Findings + +[Comprehensive summary of the most important market research findings] + +### Strategic Market Impact Assessment + +[Assessment of market implications for {{research_topic}}] + +### Next Steps Market Recommendations + +[Specific next steps for leveraging this market research] + +--- + +**Market Research Completion Date:** {{date}} +**Research Period:** {{current_year}} comprehensive market analysis +**Document Length:** As needed for comprehensive market coverage +**Source Verification:** All market facts cited with {{current_year}} sources +**Market Confidence Level:** High - based on multiple authoritative market sources + +_This comprehensive market research document serves as an authoritative market reference on {{research_topic}} and provides strategic market insights for informed decision-making._ ``` -### 5. Present Analysis and Complete Option +### 5. Present Complete Market Research Document and Final Option -Show the generated strategic synthesis and present complete option: -"I've completed the **market research strategic synthesis** using current {{current_year}} data, finalizing our comprehensive market research. +**Market Research Document Completion Presentation:** -**Strategic Highlights:** +"I've completed the **comprehensive market research document synthesis** for **{{research_topic}}**, producing an authoritative market research document with: -- Integrated market insights synthesized from all research phases -- Strategic recommendations grounded in current market data -- Market entry and positioning strategies developed -- Risk assessment and mitigation approaches documented -- Actionable implementation roadmap provided +**Document Features:** -**This completes our market research covering:** +- **Compelling Market Introduction**: Engaging opening that establishes market research significance +- **Comprehensive Market TOC**: Complete navigation structure for market reference +- **Exhaustive Market Research Coverage**: All market aspects of {{research_topic}} thoroughly analyzed +- **Executive Market Summary**: Key market findings and strategic implications highlighted +- **Strategic Market Recommendations**: Actionable market insights based on comprehensive research +- **Complete Market Source Citations**: Every market claim verified with {{current_year}} sources -- Market size, growth, and dynamics analysis -- Customer behavior and insights profiling -- Competitive landscape and positioning analysis -- Strategic recommendations and implementation guidance +**Market Research Completeness:** -**Ready to complete the market research report?** -[C] Complete Research - Save final document and conclude +- Market analysis and dynamics fully documented +- Customer insights and behavior analysis comprehensively covered +- Competitive landscape and positioning detailed +- Strategic market recommendations and implementation guidance provided + +**Document Standards Met:** + +- Exhaustive market research with no critical gaps +- Professional market structure and compelling narrative +- As long as needed for comprehensive market coverage +- Multiple independent sources for all market claims +- {{current_year}} market data throughout with proper citations + +**Ready to complete this comprehensive market research document?** +[C] Complete Research - Save final comprehensive market research document ### 6. Handle Complete Selection @@ -166,23 +396,26 @@ When user selects 'C', append the content directly to the research document usin ## SUCCESS METRICS: -✅ Strategic insights synthesized with current {{current_year}} citations -✅ Strategic recommendations grounded in research findings -✅ Market entry/positioning strategies clearly documented -✅ Risk assessment and mitigation approaches provided -✅ Implementation roadmap with actionable steps +✅ Compelling market introduction with research significance +✅ Comprehensive market table of contents with complete document structure +✅ Exhaustive market research coverage across all market aspects +✅ Executive market summary with key findings and strategic implications +✅ Strategic market recommendations grounded in comprehensive research +✅ Complete market source verification with {{current_year}} citations +✅ Professional market document structure and compelling narrative ✅ [C] complete option presented and handled correctly -✅ Content properly appended to document when C selected -✅ Market research workflow completed successfully +✅ Market research workflow completed with comprehensive document ## FAILURE MODES: -❌ Not using {{current_year}} in strategic web searches -❌ Not synthesizing insights from all research phases -❌ Missing actionable strategic recommendations -❌ Not providing implementation guidance -❌ Not presenting completion option for research workflow -❌ Appending content without user selecting 'C' +❌ Not producing compelling market introduction +❌ Missing comprehensive market table of contents +❌ Incomplete market research coverage across market aspects +❌ Not providing executive market summary with key findings +❌ Missing strategic market recommendations based on research +❌ Not using {{current_year}} market sources for all factual claims +❌ Producing market document without professional structure +❌ Not presenting completion option for final market document ## STRATEGIC RESEARCH PROTOCOLS: @@ -192,23 +425,44 @@ When user selects 'C', append the content directly to the research document usin - Research implementation planning and execution strategies - Consider market timing and readiness factors +## COMPREHENSIVE MARKET DOCUMENT STANDARDS: + +This step ensures the final market research document: + +- Serves as an authoritative market reference on {{research_topic}} +- Provides strategic market insights for informed decision-making +- Includes comprehensive market coverage with no gaps +- Maintains rigorous market source verification standards +- Delivers strategic market insights and actionable recommendations +- Meets professional market research document quality standards + ## MARKET RESEARCH WORKFLOW COMPLETION: When 'C' is selected: -- All market research steps completed +- All market research steps completed (1-4) - Comprehensive market research document generated -- All sections appended with source citations -- Market research workflow status updated -- Final strategic recommendations provided to user +- Professional market document structure with intro, TOC, and summary +- All market sections appended with source citations +- Market research workflow status updated to complete +- Final comprehensive market research document delivered to user + +## FINAL MARKET DELIVERABLE: + +Complete authoritative market research document on {{research_topic}} that: + +- Establishes professional market credibility through comprehensive research +- Provides strategic market insights for informed decision-making +- Serves as market reference document for continued use +- Maintains highest market research quality standards with {{current_year}} verification ## NEXT STEPS: -Market research workflow complete. User may: +Comprehensive market research workflow complete. User may: -- Use market research to inform product development strategies -- Conduct additional research on specific market segments +- Use market research document to inform business strategies and decisions +- Conduct additional market research on specific segments or opportunities - Combine market research with other research types for comprehensive insights -- Move forward with product development based on market insights +- Move forward with implementation based on strategic market recommendations -Congratulations on completing comprehensive market research with current {{current_year}} data! 🎉 +Congratulations on completing comprehensive market research with professional documentation! 🎉 diff --git a/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md b/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md new file mode 100644 index 00000000..92475ced --- /dev/null +++ b/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-01-init.md @@ -0,0 +1,203 @@ +# Technical Research Step 1: Technical Initialization + +## MANDATORY EXECUTION RULES (READ FIRST): + +- 🛑 NEVER generate content without user input +- ✅ ALWAYS use {{current_year}} web searches for current technical data +- 📋 YOU ARE A TECHNICAL ANALYST, not content generator +- 💬 FOCUS on technical architecture and implementation patterns +- 🔍 WEB RESEARCH REQUIRED - Use {{current_year}} data and verify sources + +## EXECUTION PROTOCOLS: + +- 🎯 Show web search analysis before presenting findings +- ⚠️ Present [C] continue option after technical overview content generation +- 💾 ONLY save when user chooses C (Continue) +- 📖 Update frontmatter `stepsCompleted: [1]` before loading next step +- 🚫 FORBIDDEN to load next step until C is selected + +## CONTEXT BOUNDARIES: + +- Current document and frontmatter from main workflow discovery are available +- Research type = "technical" is already set +- **Research topic = "{{research_topic}}"** - discovered from initial discussion +- **Research goals = "{{research_goals}}"** - captured from initial discussion +- Focus on technical research with current {{current_year}} data +- Web search capabilities with source verification are enabled + +## YOUR TASK: + +Initialize technical research scope and approach for the already-identified topic: **{{research_topic}}** with goals: {{research_goals}} + +## TECHNICAL OVERVIEW SEQUENCE: + +### 1. Initialize Technical Research + +Start with technical-specific positioning: +"I'll guide you through **technical research** for **{{research_topic}}** using current {{current_year}} web data with rigorous source verification. + +**Research Goals Identified:** {{research_goals}} + +**Technical Research Focus for {{research_topic}}:** + +- Technical architecture patterns and frameworks relevant to {{research_topic}} +- Implementation approaches and best practices for {{research_topic}} +- Technology stack evolution and trends affecting {{research_topic}} +- Integration patterns and interoperability for {{research_topic}} +- Performance and scalability considerations for {{research_topic}} + +Let me refine the technical research scope specifically for **{{research_topic}}**: + +### 2. Establish Technical Research Context + +#### Technical Context Questions: + +- "What technical aspects of {{research_topic}} are most critical for your goals?" +- "Are there particular technologies or platforms within {{research_topic}} we should focus on?" +- "Should we analyze current state of {{research_topic}} or include future technical trends?" +- "What depth of technical analysis do you need for {{research_topic}} - overview or comprehensive?" +- "Are there specific integration or implementation concerns for {{research_topic}}?" + +### 3. Begin Technical Research Execution + +After scope refinement, proceed with: + +### 2. Web Search for Technical Architecture + +Search for current architecture patterns: +`WebSearch: "[technology/domain] architecture patterns frameworks {{current_year}}"` + +**Architecture focus:** + +- Current architectural patterns and design principles +- Frameworks and platforms commonly used +- Microservices, monolith, and hybrid approaches +- Cloud-native and edge computing patterns + +### 3. Web Search for Implementation Approaches + +Search for current implementation practices: +`WebSearch: "[technology/domain] implementation best practices {{current_year}}"` + +**Implementation focus:** + +- Development methodologies and approaches +- Code organization and structure patterns +- Testing and quality assurance practices +- Deployment and operations strategies + +### 4. Web Search for Technology Stack Trends + +Search for current technology trends: +`WebSearch: "[technology/domain] technology stack trends {{current_year}}"` + +**Stack focus:** + +- Programming languages and frameworks popularity +- Database and storage technologies +- APIs and communication protocols +- Development tools and platforms + +### 5. Generate Technical Overview Content + +Prepare technical analysis with web search citations: + +#### Content Structure: + +When saving to document, append these Level 2 and Level 3 sections: + +```markdown +## Technical Overview + +### Current Architecture Patterns + +[Architecture patterns analysis with source citations] +_Source: [URL with {{current_year}} architecture data]_ + +### Implementation Approaches + +[Implementation approaches analysis with source citations] +_Source: [URL with {{current_year}} implementation data]_ + +### Technology Stack Evolution + +[Technology stack analysis with source citations] +_Source: [URL with {{current_year}} technology data]_ + +### Integration and Interoperability + +[Integration patterns analysis with source citations] +_Source: [URL with {{current_year}} integration data]_ + +### Performance and Scalability Patterns + +[Performance patterns analysis with source citations] +_Source: [URL with {{current_year}} performance data]_ + +### Development and Operations Practices + +[DevOps practices analysis with source citations] +_Source: [URL with {{current_year}} DevOps data]_ +``` + +### 6. Present Analysis and Continue Option + +Show the generated technical overview and present continue option: +"I've completed the **technical overview analysis** using current {{current_year}} data to understand the technical landscape. + +**Key Technical Findings:** + +- Current architecture patterns and frameworks identified +- Implementation approaches and best practices mapped +- Technology stack evolution and trends documented +- Integration patterns and interoperability analyzed +- Performance and scalability considerations captured + +**Ready to proceed to architectural patterns?** +[C] Continue - Save this to the document and move to architectural patterns + +### 7. Handle Continue Selection + +#### If 'C' (Continue): + +- Append the final content to the research document +- Update frontmatter: `stepsCompleted: [1]` +- Load: `./step-02-technical-overview.md` + +## APPEND TO DOCUMENT: + +When user selects 'C', append the content directly to the research document using the structure from step 5. + +## SUCCESS METRICS: + +✅ Architecture patterns identified with current {{current_year}} citations +✅ Implementation approaches clearly documented +✅ Technology stack evolution thoroughly analyzed +✅ Integration patterns and interoperability mapped +✅ Performance and scalability considerations captured +✅ [C] continue option presented and handled correctly +✅ Content properly appended to document when C selected +✅ Proper routing to architectural patterns step + +## FAILURE MODES: + +❌ Not using {{current_year}} in technical web searches +❌ Missing critical architecture patterns or frameworks +❌ Not identifying current implementation best practices +❌ Incomplete technology stack evolution analysis +❌ Not presenting [C] continue option after content generation +❌ Appending content without user selecting 'C' + +## TECHNICAL RESEARCH PROTOCOLS: + +- Search for technical documentation and architecture guides +- Use industry technical publications and conference proceedings +- Research open-source projects and their architectures +- Note technology adoption patterns and migration trends +- Research performance benchmarking and optimization techniques + +## NEXT STEP: + +After user selects 'C', load `./step-02-technical-overview.md` to focus on specific architectural patterns and design decisions. + +Remember: Always emphasize current {{current_year}} technical data and rigorous source verification! diff --git a/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md b/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md index 64151336..a610fcb6 100644 --- a/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md +++ b/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-02-technical-overview.md @@ -31,6 +31,8 @@ Conduct comprehensive technical overview using current {{current_year}} web data ### 1. Begin Technical Overview +**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different technical areas simultaneously and thoroughly + Start with technical research approach: "Now I'll conduct **technical overview analysis** using current {{current_year}} web data to understand the technical landscape for [technology/domain]. @@ -42,45 +44,43 @@ Start with technical research approach: - Integration patterns and interoperability - Performance and scalability considerations -**Let me search for current technical landscape information.**" +**Let me search for current technical landscape information using parallel web searches for comprehensive coverage.**" -### 2. Web Search for Technical Architecture +### 2. Parallel Technical Research Execution + +**Execute multiple web searches simultaneously:** -Search for current architecture patterns: `WebSearch: "[technology/domain] architecture patterns frameworks {{current_year}}"` - -**Architecture focus:** - -- Current architectural patterns and design principles -- Frameworks and platforms commonly used -- Microservices, monolith, and hybrid approaches -- Cloud-native and edge computing patterns - -### 3. Web Search for Implementation Approaches - -Search for current implementation practices: `WebSearch: "[technology/domain] implementation best practices {{current_year}}"` - -**Implementation focus:** - -- Development methodologies and approaches -- Code organization and structure patterns -- Testing and quality assurance practices -- Deployment and operations strategies - -### 4. Web Search for Technology Stack Trends - -Search for current technology trends: `WebSearch: "[technology/domain] technology stack trends {{current_year}}"` -**Stack focus:** +**Analysis approach:** -- Programming languages and frameworks popularity -- Database and storage technologies -- APIs and communication protocols -- Development tools and platforms +- Look for recent technical documentation and architecture guides +- Search for technical publications and conference proceedings +- Research open-source projects and their architectures +- Note technology adoption patterns and migration trends +- Research performance benchmarking and optimization techniques -### 5. Generate Technical Overview Content +### 3. Analyze and Aggregate Results + +**Collect and analyze findings from all parallel searches:** + +"After executing comprehensive parallel web searches, let me analyze and aggregate the technical findings: + +**Research Coverage:** + +- Architecture patterns and design principles +- Implementation approaches and methodologies +- Technology stack evolution and current trends + +**Technical Integration Analysis:** +[Identify how architecture patterns influence implementation approaches and technology choices] + +**Quality Assessment:** +[Overall confidence levels and research gaps identified]" + +### 4. Generate Technical Overview Content Prepare technical analysis with web search citations: @@ -122,7 +122,7 @@ _Source: [URL with {{current_year}} performance data]_ _Source: [URL with {{current_year}} DevOps data]_ ``` -### 6. Present Analysis and Continue Option +### 5. Present Analysis and Continue Option Show the generated technical overview and present continue option: "I've completed the **technical overview analysis** using current {{current_year}} data to understand the technical landscape. @@ -138,7 +138,7 @@ Show the generated technical overview and present continue option: **Ready to proceed to architectural patterns?** [C] Continue - Save this to the document and move to architectural patterns -### 7. Handle Continue Selection +### 6. Handle Continue Selection #### If 'C' (Continue): @@ -148,7 +148,7 @@ Show the generated technical overview and present continue option: ## APPEND TO DOCUMENT: -When user selects 'C', append the content directly to the research document using the structure from step 5. +When user selects 'C', append the content directly to the research document using the structure from step 4. ## SUCCESS METRICS: diff --git a/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-05-research-synthesis.md b/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-05-research-synthesis.md new file mode 100644 index 00000000..d59a2d50 --- /dev/null +++ b/src/modules/bmm/workflows/1-analysis/research/technical-steps/step-05-research-synthesis.md @@ -0,0 +1,479 @@ +# Technical Research Step 5: Technical Synthesis and Completion + +## MANDATORY EXECUTION RULES (READ FIRST): + +- 🛑 NEVER generate content without web search verification +- ✅ ALWAYS use {{current_year}} web searches for current technical data +- 📋 YOU ARE A TECHNICAL RESEARCH STRATEGIST, not content generator +- 💬 FOCUS on comprehensive technical synthesis and authoritative conclusions +- 🔍 WEB RESEARCH REQUIRED - Use {{current_year}} data and verify sources +- 📄 PRODUCE COMPREHENSIVE DOCUMENT with narrative intro, TOC, and summary + +## EXECUTION PROTOCOLS: + +- 🎯 Show web search analysis before presenting findings +- ⚠️ Present [C] complete option after synthesis content generation +- 💾 ONLY save when user chooses C (Complete) +- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5]` before completing workflow +- 🚫 FORBIDDEN to complete workflow until C is selected +- 📚 GENERATE COMPLETE DOCUMENT STRUCTURE with intro, TOC, and summary + +## CONTEXT BOUNDARIES: + +- Current document and frontmatter from previous steps are available +- **Research topic = "{{research_topic}}"** - comprehensive technical analysis +- **Research goals = "{{research_goals}}"** - achieved through exhaustive technical research +- All technical research sections have been completed (overview, architecture, implementation) +- Web search capabilities with source verification are enabled +- This is the final synthesis step producing the complete technical research document + +## YOUR TASK: + +Produce a comprehensive, authoritative technical research document on **{{research_topic}}** with compelling narrative introduction, detailed TOC, and executive summary based on exhaustive technical research. + +## COMPREHENSIVE TECHNICAL DOCUMENT SYNTHESIS: + +### 1. Technical Document Structure Planning + +**Complete Technical Research Document Structure:** + +```markdown +# [Compelling Technical Title]: Comprehensive {{research_topic}} Technical Research + +## Executive Summary + +[Brief compelling overview of key technical findings and strategic implications] + +## Table of Contents + +- Technical Research Introduction and Methodology +- Technical Landscape and Architecture Analysis +- Implementation Approaches and Best Practices +- Technology Stack Evolution and Trends +- Integration and Interoperability Patterns +- Performance and Scalability Analysis +- Security and Compliance Considerations +- Strategic Technical Recommendations +- Implementation Roadmap and Risk Assessment +- Future Technical Outlook and Innovation Opportunities +- Technical Research Methodology and Source Documentation +- Technical Appendices and Reference Materials +``` + +### 2. Generate Compelling Technical Introduction + +**Technical Introduction Requirements:** + +- Hook reader with compelling technical opening about {{research_topic}} +- Establish technical research significance and current relevance +- Outline comprehensive technical research methodology +- Preview key technical findings and strategic implications +- Set authoritative, technical expert tone + +**Web Search for Technical Introduction Context:** +`WebSearch: "{{research_topic}} technical significance importance {{current_year}}"` + +### 3. Synthesize All Technical Research Sections + +**Technical Section-by-Section Integration:** + +- Combine technical overview from step-02 +- Integrate architectural patterns from step-03 +- Incorporate implementation research from step-04 +- Add cross-technical insights and connections +- Ensure comprehensive technical coverage with no gaps + +### 4. Generate Complete Technical Document Content + +#### Final Technical Document Structure: + +```markdown +# [Compelling Title]: Comprehensive {{research_topic}} Technical Research + +## Executive Summary + +[2-3 paragraph compelling summary of the most critical technical findings and strategic implications for {{research_topic}} based on comprehensive {{current_year}} technical research] + +**Key Technical Findings:** + +- [Most significant architectural insights] +- [Critical implementation considerations] +- [Important technology trends] +- [Strategic technical implications] + +**Technical Recommendations:** + +- [Top 3-5 actionable technical recommendations based on research] + +## Table of Contents + +1. Technical Research Introduction and Methodology +2. {{research_topic}} Technical Landscape and Architecture Analysis +3. Implementation Approaches and Best Practices +4. Technology Stack Evolution and Current Trends +5. Integration and Interoperability Patterns +6. Performance and Scalability Analysis +7. Security and Compliance Considerations +8. Strategic Technical Recommendations +9. Implementation Roadmap and Risk Assessment +10. Future Technical Outlook and Innovation Opportunities +11. Technical Research Methodology and Source Verification +12. Technical Appendices and Reference Materials + +## 1. Technical Research Introduction and Methodology + +### Technical Research Significance + +[Compelling technical narrative about why {{research_topic}} research is critical in {{current_year}}] +_Technical Importance: [Strategic technical significance with {{current_year}} context]_ +_Business Impact: [Business implications of technical research]_ +_Source: [URL with {{current_year}} technical significance data]_ + +### Technical Research Methodology + +[Comprehensive description of technical research approach including:] + +- **Technical Scope**: [Comprehensive technical coverage areas] +- **Data Sources**: [Authoritative technical sources and verification approach] +- **Analysis Framework**: [Structured technical analysis methodology] +- **Time Period**: [{{current_year}} focus and technical evolution context] +- **Technical Depth**: [Level of technical detail and analysis] + +### Technical Research Goals and Objectives + +**Original Technical Goals:** {{research_goals}} + +**Achieved Technical Objectives:** + +- [Technical Goal 1 achievement with supporting evidence] +- [Technical Goal 2 achievement with supporting evidence] +- [Additional technical insights discovered during research] + +## 2. {{research_topic}} Technical Landscape and Architecture Analysis + +### Current Technical Architecture Patterns + +[Comprehensive architectural analysis synthesized from step-03 with {{current_year}} context] +_Dominant Patterns: [Current architectural approaches]_ +_Architectural Evolution: [Historical and current evolution patterns]_ +_Architectural Trade-offs: [Key architectural decisions and implications]_ +_Source: [URL with {{current_year}} architectural data]_ + +### System Design Principles and Best Practices + +[Complete system design analysis] +_Design Principles: [Core principles guiding {{research_topic}} implementations]_ +_Best Practice Patterns: [Industry-standard approaches and methodologies]_ +_Architectural Quality Attributes: [Performance, scalability, maintainability considerations]_ +_Source: [URL with {{current_year}} design principles data]_ + +## 3. Implementation Approaches and Best Practices + +### Current Implementation Methodologies + +[Implementation analysis from step-04 with {{current_year}} context] +_Development Approaches: [Current development methodologies and approaches]_ +_Code Organization Patterns: [Structural patterns and organization strategies]_ +_Quality Assurance Practices: [Testing, validation, and quality approaches]_ +_Deployment Strategies: [Current deployment and operations practices]_ +_Source: [URL with {{current_year}} implementation data]_ + +### Implementation Framework and Tooling + +[Comprehensive implementation framework analysis] +_Development Frameworks: [Popular frameworks and their characteristics]_ +_Tool Ecosystem: [Development tools and platform considerations]_ +_Build and Deployment Systems: [CI/CD and automation approaches]_ +_Source: [URL with {{current_year}} framework data]_ + +## 4. Technology Stack Evolution and Current Trends + +### Current Technology Stack Landscape + +[Technology stack analysis from step-02 with {{current_year}} updates] +_Programming Languages: [Current language trends and adoption patterns]_ +_Frameworks and Libraries: [Popular frameworks and their use cases]_ +_Database and Storage Technologies: [Current data storage and management trends]_ +_API and Communication Technologies: [Integration and communication patterns]_ +_Source: [URL with {{current_year}} technology stack data]_ + +### Technology Adoption Patterns + +[Comprehensive technology adoption analysis] +_Adoption Trends: [Technology adoption rates and patterns]_ +_Migration Patterns: [Technology migration and evolution trends]_ +_Emerging Technologies: [New technologies and their potential impact]_ +_Source: [URL with {{current_year}} adoption data]_ + +## 5. Integration and Interoperability Patterns + +### Current Integration Approaches + +[Integration patterns analysis with {{current_year}} context] +_API Design Patterns: [Current API design and implementation patterns]_ +_Service Integration: [Microservices and service integration approaches]_ +_Data Integration: [Data exchange and integration patterns]_ +_Source: [URL with {{current_year}} integration data]_ + +### Interoperability Standards and Protocols + +[Comprehensive interoperability analysis] +_Standards Compliance: [Industry standards and compliance requirements]_ +_Protocol Selection: [Communication protocols and selection criteria]_ +_Integration Challenges: [Common integration challenges and solutions]_ +_Source: [URL with {{current_year}} interoperability data]_ + +## 6. Performance and Scalability Analysis + +### Performance Characteristics and Optimization + +[Performance analysis based on research findings] +_Performance Benchmarks: [Current performance characteristics and benchmarks]_ +_Optimization Strategies: [Performance optimization approaches and techniques]_ +_Monitoring and Measurement: [Performance monitoring and measurement practices]_ +_Source: [URL with {{current_year}} performance data]_ + +### Scalability Patterns and Approaches + +[Comprehensive scalability analysis] +_Scalability Patterns: [Architectural and design patterns for scalability]_ +_Capacity Planning: [Capacity planning and resource management approaches]_ +_Elasticity and Auto-scaling: [Dynamic scaling approaches and implementations]_ +_Source: [URL with {{current_year}} scalability data]_ + +## 7. Security and Compliance Considerations + +### Security Best Practices and Frameworks + +[Security analysis with {{current_year}} context] +_Security Frameworks: [Current security frameworks and best practices]_ +_Threat Landscape: [Current security threats and mitigation approaches]_ +_Secure Development Practices: [Secure coding and development lifecycle]_ +_Source: [URL with {{current_year}} security data]_ + +### Compliance and Regulatory Considerations + +[Comprehensive compliance analysis] +_Industry Standards: [Relevant industry standards and compliance requirements]_ +_Regulatory Compliance: [Legal and regulatory considerations for {{research_topic}}]_ +_Audit and Governance: [Technical audit and governance practices]_ +_Source: [URL with {{current_year}} compliance data]_ + +## 8. Strategic Technical Recommendations + +### Technical Strategy and Decision Framework + +[Strategic technical recommendations based on comprehensive research] +_Architecture Recommendations: [Recommended architectural approaches and patterns]_ +_Technology Selection: [Recommended technology stack and selection criteria]_ +_Implementation Strategy: [Recommended implementation approaches and methodologies]_ +_Source: [URL with {{current_year}} technical strategy data]_ + +### Competitive Technical Advantage + +[Analysis of technical competitive positioning] +_Technology Differentiation: [Technical approaches that provide competitive advantage]_ +_Innovation Opportunities: [Areas for technical innovation and differentiation]_ +_Strategic Technology Investments: [Recommended technology investments and priorities]_ +_Source: [URL with {{current_year}} competitive analysis data]_ + +## 9. Implementation Roadmap and Risk Assessment + +### Technical Implementation Framework + +[Comprehensive implementation guidance based on research findings] +_Implementation Phases: [Recommended phased implementation approach]_ +_Technology Migration Strategy: [Approach for technology adoption and migration]_ +_Resource Planning: [Technical resources and capabilities planning]_ +_Source: [URL with {{current_year}} implementation planning data]_ + +### Technical Risk Management + +[Comprehensive technical risk assessment] +_Technical Risks: [Major technical risks and mitigation strategies]_ +_Implementation Risks: [Risks associated with implementation and deployment]_ +_Business Impact Risks: [Technical risks and their business implications]_ +_Source: [URL with {{current_year}} technical risk data]_ + +## 10. Future Technical Outlook and Innovation Opportunities + +### Emerging Technology Trends + +[Forward-looking technical analysis based on comprehensive research] +_Near-term Technical Evolution: [1-2 year technical development expectations]_ +_Medium-term Technology Trends: [3-5 year expected technical developments]_ +_Long-term Technical Vision: [5+ year technical outlook for {{research_topic}}]_ +_Source: [URL with {{current_year}} future trends data]_ + +### Innovation and Research Opportunities + +[Technical innovation analysis and recommendations] +_Research Opportunities: [Areas for technical research and innovation]_ +_Emerging Technology Adoption: [Potential new technologies and adoption timelines]_ +_Innovation Framework: [Approach for fostering technical innovation]_ +_Source: [URL with {{current_year}} innovation data]_ + +## 11. Technical Research Methodology and Source Verification + +### Comprehensive Technical Source Documentation + +[Complete documentation of all technical research sources] +_Primary Technical Sources: [Key authoritative technical sources used]_ +_Secondary Technical Sources: [Supporting technical research and analysis]_ +_Technical Web Search Queries: [Complete list of technical search queries used]_ +_Technical Data Currency: [All technical data verified for {{current_year}} currency]_ + +### Technical Research Quality Assurance + +[Technical quality assurance and validation approach] +_Technical Source Verification: [All technical claims verified with multiple sources]_ +_Technical Confidence Levels: [Confidence assessments for uncertain technical data]_ +_Technical Limitations: [Technical research limitations and areas for further investigation]_ +_Methodology Transparency: [Complete transparency about technical research approach]_ + +## 12. Technical Appendices and Reference Materials + +### Detailed Technical Data Tables + +[Comprehensive technical data tables supporting research findings] +_Architectural Pattern Tables: [Detailed architectural pattern comparisons]_ +_Technology Stack Analysis: [Detailed technology evaluation and comparison data]_ +_Performance Benchmark Data: [Comprehensive performance measurement data]_ + +### Technical Resources and References + +[Valuable technical resources for continued research and implementation] +_Technical Standards: [Relevant technical standards and specifications]_ +_Open Source Projects: [Key open source projects and communities]_ +_Research Papers and Publications: [Academic and industry research sources]_ +_Technical Communities: [Professional networks and technical communities]_ + +--- + +## Technical Research Conclusion + +### Summary of Key Technical Findings + +[Comprehensive summary of the most important technical research findings] + +### Strategic Technical Impact Assessment + +[Assessment of technical implications for {{research_topic}}] + +### Next Steps Technical Recommendations + +[Specific next steps for leveraging this technical research] + +--- + +**Technical Research Completion Date:** {{date}} +**Research Period:** {{current_year}} comprehensive technical analysis +**Document Length:** As needed for comprehensive technical coverage +**Source Verification:** All technical facts cited with {{current_year}} sources +**Technical Confidence Level:** High - based on multiple authoritative technical sources + +_This comprehensive technical research document serves as an authoritative technical reference on {{research_topic}} and provides strategic technical insights for informed decision-making and implementation._ +``` + +### 5. Present Complete Technical Document and Final Option + +**Technical Document Completion Presentation:** + +"I've completed the **comprehensive technical research document synthesis** for **{{research_topic}}**, producing an authoritative technical research document with: + +**Technical Document Features:** + +- **Compelling Technical Introduction**: Engaging technical opening that establishes research significance +- **Comprehensive Technical TOC**: Complete navigation structure for technical reference +- **Exhaustive Technical Research Coverage**: All technical aspects of {{research_topic}} thoroughly analyzed +- **Executive Technical Summary**: Key technical findings and strategic implications highlighted +- **Strategic Technical Recommendations**: Actionable technical insights based on comprehensive research +- **Complete Technical Source Citations**: Every technical claim verified with {{current_year}} sources + +**Technical Research Completeness:** + +- Technical landscape and architecture analysis fully documented +- Implementation approaches and best practices comprehensively covered +- Technology stack evolution and trends detailed +- Integration, performance, and security analysis complete +- Strategic technical insights and implementation guidance provided + +**Technical Document Standards Met:** + +- Exhaustive technical research with no critical gaps +- Professional technical structure and compelling narrative +- As long as needed for comprehensive technical coverage +- Multiple independent technical sources for all claims +- {{current_year}} technical data throughout with proper citations + +**Ready to complete this comprehensive technical research document?** +[C] Complete Research - Save final comprehensive technical document + +### 6. Handle Final Technical Completion + +#### If 'C' (Complete Research): + +- Append the complete technical document to the research file +- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5]` +- Complete the technical research workflow +- Provide final technical document delivery confirmation + +## APPEND TO DOCUMENT: + +When user selects 'C', append the complete comprehensive technical research document using the full structure above. + +## SUCCESS METRICS: + +✅ Compelling technical introduction with research significance +✅ Comprehensive technical table of contents with complete document structure +✅ Exhaustive technical research coverage across all technical aspects +✅ Executive technical summary with key findings and strategic implications +✅ Strategic technical recommendations grounded in comprehensive research +✅ Complete technical source verification with {{current_year}} citations +✅ Professional technical document structure and compelling narrative +✅ [C] complete option presented and handled correctly +✅ Technical research workflow completed with comprehensive document + +## FAILURE MODES: + +❌ Not producing compelling technical introduction +❌ Missing comprehensive technical table of contents +❌ Incomplete technical research coverage across technical aspects +❌ Not providing executive technical summary with key findings +❌ Missing strategic technical recommendations based on research +❌ Not using {{current_year}} technical sources for all factual claims +❌ Producing technical document without professional structure +❌ Not presenting completion option for final technical document + +## COMPREHENSIVE TECHNICAL DOCUMENT STANDARDS: + +This step ensures the final technical research document: + +- Serves as an authoritative technical reference on {{research_topic}} +- Provides strategic technical insights for informed decision-making +- Includes comprehensive technical coverage with no gaps +- Maintains rigorous technical source verification standards +- Delivers strategic technical insights and actionable recommendations +- Meets professional technical research document quality standards + +## TECHNICAL RESEARCH WORKFLOW COMPLETION: + +When 'C' is selected: + +- All technical research steps completed (1-5) +- Comprehensive technical research document generated +- Professional technical document structure with intro, TOC, and summary +- All technical sections appended with source citations +- Technical research workflow status updated to complete +- Final comprehensive technical research document delivered to user + +## FINAL TECHNICAL DELIVERABLE: + +Complete authoritative technical research document on {{research_topic}} that: + +- Establishes technical credibility through comprehensive research +- Provides strategic technical insights for informed decision-making +- Serves as technical reference document for continued use +- Maintains highest technical research quality standards with {{current_year}} verification + +Congratulations on completing comprehensive technical research with professional documentation! 🎉 diff --git a/src/modules/bmm/workflows/1-analysis/research/workflow.md b/src/modules/bmm/workflows/1-analysis/research/workflow.md index b7a88da5..8ca1ea3e 100644 --- a/src/modules/bmm/workflows/1-analysis/research/workflow.md +++ b/src/modules/bmm/workflows/1-analysis/research/workflow.md @@ -5,10 +5,25 @@ description: Conduct comprehensive research across multiple domains using curren # Research Workflow -**Goal:** Conduct comprehensive research across multiple domains using current web data and verified sources +**Goal:** Conduct comprehensive, exhaustive research across multiple domains using current web data and verified sources to produce complete research documents with compelling narratives and proper citations. + +**Document Standards:** + +- **Comprehensive Coverage**: Exhaustive research with no critical gaps +- **Source Verification**: Every factual claim cited with URLs from {{current_year}} +- **Document Length**: As long as needed to fully cover the research topic +- **Professional Structure**: Compelling narrative introduction, detailed TOC, and comprehensive summary +- **Authoritative Sources**: Multiple independent sources for all critical claims **Your Role:** You are a research facilitator and web data analyst working with an expert partner. This is a collaboration where you bring research methodology and web search capabilities, while your partner brings domain knowledge and research direction. +**Final Deliverable**: A complete research document that serves as an authoritative reference on the research topic with: + +- Compelling narrative introduction +- Comprehensive table of contents +- Detailed research sections with proper citations +- Executive summary and conclusions + --- ## WORKFLOW ARCHITECTURE @@ -82,46 +97,82 @@ Execute research type discovery and routing: "Welcome {{user_name}}! I'm excited to work with you as your research partner. I bring web research capabilities with current {{current_year}} data and rigorous source verification, while you bring the domain expertise and research direction. -\*\*What would you like to research today?" +**Let me help you clarify what you'd like to research.** + +**First, tell me: What specific topic, problem, or area do you want to research?** + +For example: + +- 'The electric vehicle market in Europe' +- 'Cloud migration strategies for healthcare' +- 'AI implementation in financial services' +- 'Sustainable packaging regulations' +- 'Or anything else you have in mind...' + +### Topic Exploration and Clarification + +Based on the user's initial topic, explore and refine the research scope: + +#### Topic Clarification Questions: + +1. **Core Topic**: "What exactly about [topic] are you most interested in?" +2. **Research Goals**: "What do you hope to achieve with this research?" +3. **Scope**: "Should we focus broadly or dive deep into specific aspects?" +4. **Timeline**: "Are you looking at current state, historical context, or future trends?" +5. **Application**: "How will you use this research? (product development, strategy, academic, etc.)" + +#### Context Building: + +- **Initial Input**: User provides topic or research interest +- **Collaborative Refinement**: Work together to clarify scope and objectives +- **Goal Alignment**: Ensure research direction matches user needs +- **Research Boundaries**: Establish clear focus areas and deliverables ### Research Type Identification -Listen for research type indicators and present options: +After understanding the research topic and goals, identify the most appropriate research approach: -**Research Options:** +**Research Type Options:** 1. **Market Research** - Market size, growth, competition, customer insights + _Best for: Understanding market dynamics, customer behavior, competitive landscape_ + 2. **Domain Research** - Industry analysis, regulations, technology trends in specific domain + _Best for: Understanding industry context, regulatory environment, ecosystem_ + 3. **Technical Research** - Technology evaluation, architecture decisions, implementation approaches -4. **Deep Research Prompt** - Creating structured research prompts for AI platforms + _Best for: Technical feasibility, technology selection, implementation strategies_ + +**Recommendation**: Based on [topic] and [goals], I recommend [suggested research type] because [specific rationale]. + +**What type of research would work best for your needs?** ### Research Type Routing -Based on user selection, route to appropriate sub-workflow: +Based on user selection, route to appropriate sub-workflow with the discovered topic: #### If Market Research: - Set `research_type = "market"` -- Set output file: `{output_folder}/analysis/research/market-{{topic}}-research-{{date}}.md` -- Load: `./market-steps/step-01-init.md` +- Set `research_topic = [discovered topic from discussion]` +- Set output file: `{output_folder}/analysis/research/market-{{research_topic}}-research-{{date}}.md` +- Load: `./market-steps/step-01-init.md` with topic context #### If Domain Research: - Set `research_type = "domain"` -- Set output file: `{output_folder}/analysis/research/domain-{{topic}}-research-{{date}}.md` -- Load: `./domain-steps/step-01-init.md` +- Set `research_topic = [discovered topic from discussion]` +- Set output file: `{output_folder}/analysis/research/domain-{{research_topic}}-research-{{date}}.md` +- Load: `./domain-steps/step-01-init.md` with topic context #### If Technical Research: - Set `research_type = "technical"` -- Set output file: `{output_folder}/analysis/research/technical-{{topic}}-research-{{date}}.md` -- Load: `./technical-steps/step-01-init.md` +- Set `research_topic = [discovered topic from discussion]` +- Set output file: `{output_folder}/analysis/research/technical-{{research_topic}}-research-{{date}}.md` +- Load: `./technical-steps/step-01-init.md` with topic context -#### If Deep Research Prompt: - -- Set `research_type = "deep-prompt"` -- Set output file: `{output_folder}/analysis/research/deep-prompt-{{topic}}-research-{{date}}.md` -- Load: `./deep-prompt-steps/step-01-init.md` +**Important**: The discovered topic from the collaborative discussion should be passed to the research initialization steps, so they don't need to ask "What do you want to research?" again - they can focus on refining the scope for their specific research type. ### Document Initialization @@ -134,6 +185,8 @@ inputDocuments: [] workflowType: 'research' lastStep: 1 research_type: '{{research_type}}' +research_topic: '{{research_topic}}' +research_goals: '{{research_goals}}' user_name: '{{user_name}}' date: '{{date}}' current_year: '{{current_year}}' diff --git a/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.md b/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.md index 63c3a04c..8f849d3c 100644 --- a/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.md +++ b/src/modules/bmm/workflows/2-plan-workflows/prd/workflow.md @@ -1,3 +1,8 @@ +--- +name: PRD Workflow +description: Creates a comprehensive PRDs through collaborative step-by-step discovery between two product managers working as peers. +--- + # PRD Workflow **Goal:** Create comprehensive PRDs through collaborative step-by-step discovery between two product managers working as peers. diff --git a/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml b/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml index e95c69d8..7ac0d490 100644 --- a/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml +++ b/src/modules/bmm/workflows/workflow-status/paths/enterprise-brownfield.yaml @@ -28,6 +28,7 @@ phases: optional: true agent: "analyst" command: "brainstorm-project" + note: "Uses core brainstorming workflow with project context template" included_by: "user_choice" - id: "research" diff --git a/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml b/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml index cc475f4b..de15e3c3 100644 --- a/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml +++ b/src/modules/bmm/workflows/workflow-status/paths/enterprise-greenfield.yaml @@ -16,6 +16,7 @@ phases: optional: true agent: "analyst" command: "brainstorm-project" + note: "Uses core brainstorming workflow with project context template" included_by: "user_choice" - id: "research" diff --git a/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml b/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml index c8d25ba0..ed9cbd32 100644 --- a/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml +++ b/src/modules/bmm/workflows/workflow-status/paths/method-brownfield.yaml @@ -29,6 +29,7 @@ phases: agent: "analyst" command: "brainstorm-project" included_by: "user_choice" + note: "Uses core brainstorming workflow with project context template" - id: "research" optional: true diff --git a/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml b/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml index bbad70d9..bef2a839 100644 --- a/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml +++ b/src/modules/bmm/workflows/workflow-status/paths/method-greenfield.yaml @@ -17,6 +17,7 @@ phases: agent: "analyst" command: "brainstorm-project" included_by: "user_choice" + note: "Uses core brainstorming workflow with project context template" - id: "research" optional: true diff --git a/src/utility/models/fragments/handler-exec.xml b/src/utility/models/fragments/handler-exec.xml index 8e0784fe..1c21caed 100644 --- a/src/utility/models/fragments/handler-exec.xml +++ b/src/utility/models/fragments/handler-exec.xml @@ -1,5 +1,6 @@ - - When menu item has: exec="path/to/file.md" - Actually LOAD and EXECUTE the file at that path - do not improvise - Read the complete file and follow all instructions within it - + + When menu item has: exec="path/to/file.md" + Actually LOAD and EXECUTE the file at that path - do not improvise + Read the complete file and follow all instructions within it + If there is data="some/path/data-foo.md", pass that data to the executed file as context. + \ No newline at end of file