@devo-bmad-custom/agent-orchestration 1.0.0

package/src/bmm/workflows/1-analysis/research/domain-steps/step-06-research-synthesis.md

@@ -0,0 +1,345 @@
+# Domain Research Step 6: Research Synthesis and Completion
+
+## 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:**
+Search the web: "{{research_topic}} significance importance"
+
+### 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 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 right now]
+_Why this research matters now: [Strategic importance with current context]_
+_Source: [URL]_
+
+### 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 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 data]
+_Market Size: [Current market valuation]_
+_Growth Rate: [CAGR and projections]_
+_Market Drivers: [Key growth factors]_
+_Source: [URL]_
+
+### 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]_
+
+## 3. Technology Landscape and Innovation Trends
+
+### Current Technology Adoption
+
+[Technology trends analysis from step-04 with current context]
+_Emerging Technologies: [Key technologies affecting {{research_topic}}]_
+_Adoption Patterns: [Technology adoption rates and patterns]_
+_Innovation Drivers: [Factors driving technology change]_
+_Source: [URL]_
+
+### 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]_
+
+## 4. Regulatory Framework and Compliance Requirements
+
+### Current Regulatory Landscape
+
+[Regulatory analysis from step-03 with current updates]
+_Key Regulations: [Critical regulatory requirements]_
+_Compliance Standards: [Industry standards and best practices]_
+_Recent Changes: [current regulatory updates and implications]_
+_Source: [URL]_
+
+### 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]_
+
+## 5. Competitive Landscape and Ecosystem Analysis
+
+### Market Positioning and Key Players
+
+[Competitive analysis with current market positioning]
+_Market Leaders: [Dominant players and strategies]_
+_Emerging Competitors: [New entrants and innovative approaches]_
+_Competitive Dynamics: [Market competition patterns and trends]_
+_Source: [URL]_
+
+### 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]_
+
+## 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]_
+
+### 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]_
+
+## 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]_
+
+### 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]_
+
+## 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]_
+
+### 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]_
+
+## 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]_
+
+### 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:** Comprehensive analysis
+**Document Length:** As needed for comprehensive coverage
+**Source Verification:** All facts cited with 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 sources
+
+**Ready to complete this comprehensive research document?**
+[C] Complete Research - Save final comprehensive document
+
+### 6. Handle Final Completion
+
+#### If 'AR' (Adversarial Review):
+
+- IF AR: Execute {project-root}/_bmad/core/tasks/review-adversarial-general.xml — pass the current editPlan (or plan document in context) as the content to review; display findings with recommendations; then redisplay this menu
+
+#### If 'C' (Complete Research):
+
+- **Replace** the template placeholder `[Research overview and methodology will be appended here]` in the `## Research Overview` section near the top of the document with a concise 2-3 paragraph overview summarizing the research scope, key findings, and a pointer to the full executive summary in the Research Synthesis section
+- Append the complete document to the research file
+- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5, 6]`
+- 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. Also replace the `[Research overview and methodology will be appended here]` placeholder in the Research Overview section at the top of the document.
+
+## NEXT STEP:
+
+Write output to file then the domain research workflow is complete.

package/src/bmm/workflows/1-analysis/research/market-steps/step-01-init.md

@@ -0,0 +1,92 @@
+# Market Research Step 1: Market Research Initialization
+
+## YOUR TASK:
+
+Initialize market research by confirming understanding of {{research_topic}} and establishing clear research scope.
+
+## CONTEXT:
+
+- Research type = "market", topic = "{{research_topic}}", goals = "{{research_goals}}"
+- No web research in this step — scope clarification only
+
+## MARKET RESEARCH INITIALIZATION:
+
+### 1. Confirm Research Understanding
+
+**INITIALIZE - DO NOT RESEARCH YET**
+
+Start with research confirmation:
+"I understand you want to conduct **market research** for **{{research_topic}}** with these goals: {{research_goals}}
+
+**My Understanding of Your Research Needs:**
+
+- **Research Topic**: {{research_topic}}
+- **Research Goals**: {{research_goals}}
+- **Research Type**: Market Research
+- **Approach**: Comprehensive market analysis with source verification
+
+**Market Research Areas We'll Cover:**
+
+- Market size, growth dynamics, and trends
+- Customer insights and behavior analysis
+- Competitive landscape and positioning
+- Strategic recommendations and implementation guidance
+
+**Market research scope confirmed. Proceeding automatically.**
+
+### 2. Document Initial Scope
+
+**WRITE IMMEDIATELY TO DOCUMENT**
+
+Write initial research scope to document:
+
+```markdown
+# Market Research: {{research_topic}}
+
+## Research Initialization
+
+### Research Understanding Confirmed
+
+**Topic**: {{research_topic}}
+**Goals**: {{research_goals}}
+**Research Type**: Market Research
+**Date**: {{date}}
+
+### Research Scope
+
+**Market Analysis Focus Areas:**
+
+- Market size, growth projections, and dynamics
+- Customer segments, behavior patterns, and insights
+- Competitive landscape and positioning analysis
+- Strategic recommendations and implementation guidance
+
+**Research Methodology:**
+
+- Current web data with source verification
+- Multiple independent sources for critical claims
+- Confidence level assessment for uncertain data
+- Comprehensive coverage with no critical gaps
+
+### Next Steps
+
+**Research Workflow:**
+
+1. ✅ Initialization and scope setting (current step)
+2. Customer Insights and Behavior Analysis
+3. Competitive Landscape Analysis
+4. Strategic Synthesis and Recommendations
+
+**Research Status**: Scope confirmed, ready to proceed with detailed market analysis
+```
+
+### 4. Auto-Proceed
+
+Display scope summary to user, then immediately:
+
+- Update frontmatter: `stepsCompleted: [1]`
+- Load: `{project-root}/_bmad/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md`
+
+## NEXT STEP:
+
+Immediately after displaying scope confirmation and writing to the output file, load `{project-root}/_bmad/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md` to begin detailed market research with customer insights analysis.

package/src/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md

@@ -0,0 +1,164 @@
+# Market Research Step 2: Customer Behavior and Segments
+
+## YOUR TASK:
+
+Conduct customer behavior and segment analysis with emphasis on patterns and demographics.
+
+## CUSTOMER BEHAVIOR ANALYSIS SEQUENCE:
+
+### 1. Begin Customer Behavior Analysis
+
+**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different customer behavior areas simultaneously and thoroughly.
+
+Start with customer behavior research approach:
+"Now I'll conduct **customer behavior analysis** for **{{research_topic}}** to understand customer patterns.
+
+**Customer Behavior Focus:**
+
+- Customer behavior patterns and preferences
+- Demographic profiles and segmentation
+- Psychographic characteristics and values
+- Behavior drivers and influences
+- Customer interaction patterns and engagement
+
+**Let me search for current customer behavior insights.**"
+
+### 2. Parallel Customer Behavior Research Execution
+
+**Execute multiple web searches simultaneously:**
+
+Search the web: "{{research_topic}} customer behavior patterns"
+Search the web: "{{research_topic}} customer demographics"
+Search the web: "{{research_topic}} psychographic profiles"
+Search the web: "{{research_topic}} customer behavior drivers"
+
+**Analysis approach:**
+
+- Look for customer behavior studies and research reports
+- Search for demographic segmentation and analysis
+- Research psychographic profiling and value systems
+- Analyze behavior drivers and influencing factors
+- Study customer interaction and engagement patterns
+
+### 3. Analyze and Aggregate Results
+
+**Collect and analyze findings from all parallel searches:**
+
+"After executing comprehensive parallel web searches, let me analyze and aggregate customer behavior findings:
+
+**Research Coverage:**
+
+- Customer behavior patterns and preferences
+- Demographic profiles and segmentation
+- Psychographic characteristics and values
+- Behavior drivers and influences
+- Customer interaction patterns and engagement
+
+**Cross-Behavior Analysis:**
+[Identify patterns connecting demographics, psychographics, and behaviors]
+
+**Quality Assessment:**
+[Overall confidence levels and research gaps identified]"
+
+### 4. Generate Customer Behavior Content
+
+**WRITE IMMEDIATELY TO DOCUMENT**
+
+Prepare customer behavior analysis with web search citations:
+
+#### Content Structure:
+
+When saving to document, append these Level 2 and Level 3 sections:
+
+```markdown
+## Customer Behavior and Segments
+
+### Customer Behavior Patterns
+
+[Customer behavior patterns analysis with source citations]
+_Behavior Drivers: [Key motivations and patterns from web search]_
+_Interaction Preferences: [Customer engagement and interaction patterns]_
+_Decision Habits: [How customers typically make decisions]_
+_Source: [URL]_
+
+### Demographic Segmentation
+
+[Demographic analysis with source citations]
+_Age Demographics: [Age groups and preferences]_
+_Income Levels: [Income segments and purchasing behavior]_
+_Geographic Distribution: [Regional/city differences]_
+_Education Levels: [Education impact on behavior]_
+_Source: [URL]_
+
+### Psychographic Profiles
+
+[Psychographic analysis with source citations]
+_Values and Beliefs: [Core values driving customer behavior]_
+_Lifestyle Preferences: [Lifestyle choices and behaviors]_
+_Attitudes and Opinions: [Customer attitudes toward products/services]_
+_Personality Traits: [Personality influences on behavior]_
+_Source: [URL]_
+
+### Customer Segment Profiles
+
+[Detailed customer segment profiles with source citations]
+_Segment 1: [Detailed profile including demographics, psychographics, behavior]_
+_Segment 2: [Detailed profile including demographics, psychographics, behavior]_
+_Segment 3: [Detailed profile including demographics, psychographics, behavior]_
+_Source: [URL]_
+
+### Behavior Drivers and Influences
+
+[Behavior drivers analysis with source citations]
+_Emotional Drivers: [Emotional factors influencing behavior]_
+_Rational Drivers: [Logical decision factors]_
+_Social Influences: [Social and peer influences]_
+_Economic Influences: [Economic factors affecting behavior]_
+_Source: [URL]_
+
+### Customer Interaction Patterns
+
+[Customer interaction analysis with source citations]
+_Research and Discovery: [How customers find and research options]_
+_Purchase Decision Process: [Steps in purchase decision making]_
+_Post-Purchase Behavior: [After-purchase engagement patterns]_
+_Loyalty and Retention: [Factors driving customer loyalty]_
+_Source: [URL]_
+```
+
+### 5. Present Analysis and Continue Option
+
+**Show analysis and present continue option:**
+
+"I've completed **customer behavior analysis** for {{research_topic}}, focusing on customer patterns.
+
+**Key Customer Behavior Findings:**
+
+- Customer behavior patterns clearly identified with drivers
+- Demographic segmentation thoroughly analyzed
+- Psychographic profiles mapped and documented
+- Customer interaction patterns captured
+- Multiple sources verified for critical insights
+
+**Ready to proceed to customer pain points?**
+[AR] Adversarial Review [C] Continue - Save this to document and proceed to pain points analysis
+
+### 6. Handle Continue Selection
+
+#### If 'AR' (Adversarial Review):
+
+- IF AR: Execute {project-root}/_bmad/core/tasks/review-adversarial-general.xml — pass the current editPlan (or plan document in context) as the content to review; display findings with recommendations; then redisplay this menu
+
+#### If 'C' (Continue):
+
+- **CONTENT ALREADY WRITTEN TO DOCUMENT**
+- Update frontmatter: `stepsCompleted: [1, 2]`
+- Load: `{project-root}/_bmad/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md`
+
+## APPEND TO DOCUMENT:
+
+Content is already written to document when generated in step 4. No additional append needed.
+
+## NEXT STEP:
+
+After user selects 'C', load `{project-root}/_bmad/bmm/workflows/1-analysis/research/market-steps/step-03-customer-pain-points.md` to analyze customer pain points, challenges, and unmet needs for {{research_topic}}.