ma-agents 2.15.0 → 2.16.1

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

@@ -1,444 +0,0 @@
-# Domain Research Step 6: Research Synthesis and Completion
-
-## MANDATORY EXECUTION RULES (READ FIRST):
-
-- 🛑 NEVER generate content without web search verification
-
-- 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
-- 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
-- ✅ Search the web to verify and supplement your knowledge with current facts
-- 📋 YOU ARE A DOMAIN RESEARCH STRATEGIST, not content generator
-- 💬 FOCUS on comprehensive synthesis and authoritative conclusions
-- 🔍 WEB SEARCH REQUIRED - verify current facts against live sources
-- 📄 PRODUCE COMPREHENSIVE DOCUMENT with narrative intro, TOC, and summary
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-
-## 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, 6]` 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:**
-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
-
-**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
-- Proper citations throughout
-
-**Ready to complete this comprehensive research document?**
-[C] Complete Research - Save final comprehensive document
-
-### 6. Handle Final Completion
-
-#### 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]`
-- 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.
-
-## 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 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
-❌ Relying solely on training data without web verification for current facts
-❌ Producing document without professional structure
-❌ Not presenting completion option for final document
-
-❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
-❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
-❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
-
-## 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
-
-Congratulations on completing comprehensive domain research! 🎉

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

@@ -1,182 +0,0 @@
-# Market Research Step 1: Market Research Initialization
-
-## MANDATORY EXECUTION RULES (READ FIRST):
-
-- 🛑 NEVER generate research content in init step
-- ✅ ALWAYS confirm understanding of user's research goals
-- 📋 YOU ARE A MARKET RESEARCH FACILITATOR, not content generator
-- 💬 FOCUS on clarifying scope and approach
-- 🔍 NO WEB RESEARCH in init - that's for later steps
-- 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete research
-- 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-
-## EXECUTION PROTOCOLS:
-
-- 🎯 Confirm research understanding before proceeding
-- ⚠️ Present [C] continue option after scope clarification
-- 💾 Write initial scope document immediately
-- 📖 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 = "market" is already set
-- **Research topic = "{{research_topic}}"** - discovered from initial discussion
-- **Research goals = "{{research_goals}}"** - captured from initial discussion
-- Focus on market research scope clarification
-- Web search capabilities are enabled for later steps
-
-## YOUR TASK:
-
-Initialize market research by confirming understanding of {{research_topic}} and establishing clear research scope.
-
-## 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
-
-**Does this accurately capture what you're looking for?**"
-
-### 2. Refine Research Scope
-
-Gather any clarifications needed:
-
-#### Scope Clarification Questions:
-
-- "Are there specific customer segments or aspects of {{research_topic}} we should prioritize?"
-- "Should we focus on specific geographic regions or global market?"
-- "Is this for market entry, expansion, product development, or other business purpose?"
-- "Any competitors or market segments you specifically want us to analyze?"
-
-### 3. 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. Present Confirmation and Continue Option
-
-Show initial scope document and present continue option:
-"I've documented our understanding and initial scope for **{{research_topic}}** market research.
-
-**What I've established:**
-
-- Research topic and goals confirmed
-- Market analysis focus areas defined
-- Research methodology verification
-- Clear workflow progression
-
-**Document Status:** Initial scope written to research file for your review
-
-**Ready to begin detailed market research?**
-[C] Continue - Confirm scope and proceed to customer insights analysis
-[Modify] Suggest changes to research scope before proceeding
-
-### 5. Handle User Response
-
-#### If 'C' (Continue):
-
-- Update frontmatter: `stepsCompleted: [1]`
-- Add confirmation note to document: "Scope confirmed by user on {{date}}"
-- Load: `{project-root}/_bmad/bmm/workflows/1-analysis/research/market-steps/step-02-customer-behavior.md`
-
-#### If 'Modify':
-
-- Gather user changes to scope
-- Update document with modifications
-- Re-present updated scope for confirmation
-
-## SUCCESS METRICS:
-
-✅ Research topic and goals accurately understood
-✅ Market research scope clearly defined
-✅ Initial scope document written immediately
-✅ User opportunity to review and modify scope
-✅ [C] continue option presented and handled correctly
-✅ Document properly updated with scope confirmation
-
-## FAILURE MODES:
-
-❌ Not confirming understanding of research topic and goals
-❌ Generating research content instead of just scope clarification
-❌ Not writing initial scope document to file
-❌ Not providing opportunity for user to modify scope
-❌ Proceeding to next step without user confirmation
-❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor research decisions
-❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
-❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
-
-## INITIALIZATION PRINCIPLES:
-
-This step ensures:
-
-- Clear mutual understanding of research objectives
-- Well-defined research scope and approach
-- Immediate documentation for user review
-- User control over research direction before detailed work begins
-
-## NEXT STEP:
-
-After user confirmation and scope finalization, 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.
-
-Remember: Init steps confirm understanding and scope, not generate research content!