bmad-studio 0.1.0 → 0.2.0

package/_bmad/bmm/workflows/1-analysis/research/bmad-market-research/steps/step-06-research-completion.md

@@ -1,478 +0,0 @@
-# Market Research Step 6: Research 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 MARKET RESEARCH STRATEGIST, not content generator
-- 💬 FOCUS on strategic recommendations and actionable insights
-- 🔍 WEB SEARCH REQUIRED - verify current facts against live sources
-- ✅ 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 completion 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 market analysis
-- **Research goals = "{{research_goals}}"** - achieved through exhaustive market research
-- All market research sections have been completed (customer behavior, pain points, decisions, competitive analysis)
-- Web search capabilities with source verification are enabled
-- This is the final synthesis step producing the complete market research document
-
-## YOUR TASK:
-
-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:
-
-### 1. Begin Strategic Synthesis
-
-Start with strategic synthesis approach:
-"Now I'll complete our market research with **strategic synthesis and recommendations** .
-
-**Strategic Synthesis Focus:**
-
-- Integrated insights from market, customer, and competitive analysis
-- Strategic recommendations based on research findings
-- Market entry or expansion strategies
-- Risk assessment and mitigation approaches
-- Actionable next steps and implementation guidance
-
-**Let me search for current strategic insights and best practices.**"
-
-### 2. Web Search for Market Entry Strategies
-
-Search for current market strategies:
-Search the web: "market entry strategies best practices"
-
-**Strategy focus:**
-
-- Market entry timing and approaches
-- Go-to-market strategies and frameworks
-- Market positioning and differentiation tactics
-- Customer acquisition and growth strategies
-
-### 3. Web Search for Risk Assessment
-
-Search for current risk approaches:
-Search the web: "market research risk assessment frameworks"
-
-**Risk focus:**
-
-- Market risks and uncertainty management
-- Competitive threats and mitigation strategies
-- Regulatory and compliance risks
-- Economic and market volatility considerations
-
-### 4. Generate Complete Market Research Document
-
-Prepare comprehensive market research document with full structure:
-
-#### Complete Document Structure:
-
-```markdown
-# [Compelling Title]: Comprehensive {{research_topic}} Market Research
-
-## Executive Summary
-
-[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 now**
-_Market Importance: [Strategic market significance with up-to-date context]_
-_Business Impact: [Business implications of market research]_
-_Source: [URL]_
-
-### 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 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]_
-_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]_
-
-### 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]_
-
-### 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]_
-
-## 3. Customer Insights and Behavior Analysis
-
-### Customer Behavior Patterns
-
-[Customer insights analysis with current context]
-_Behavior Patterns: [Key customer behavior trends and patterns]_
-_Customer Journey: [Complete customer journey mapping]_
-_Decision Factors: [Factors influencing customer decisions]_
-_Source: [URL]_
-
-### 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]_
-
-### 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]_
-
-## 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]_
-
-### 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]_
-
-## 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]_
-
-### Strategic Recommendations
-
-[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]_
-
-## 6. Market Entry and Growth Strategies
-
-### 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]_
-
-### Growth and Scaling Strategy
-
-[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]_
-
-## 7. Risk Assessment and Mitigation
-
-### Market Risk Analysis
-
-[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]_
-
-### 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]_
-
-## 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]_
-
-### Success Metrics and KPIs
-
-[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]_
-
-## 9. Future Market Outlook and Opportunities
-
-### Future Market Trends
-
-[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]_
-
-### Strategic Opportunities
-
-[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]_
-
-## 10. Market Research Methodology and Source Verification
-
-### 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 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 comprehensive market analysis
-**Document Length:** As needed for comprehensive market coverage
-**Source Verification:** All market facts cited with current 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 Complete Market Research Document and Final Option
-
-**Market Research Document Completion Presentation:**
-
-"I've completed the **comprehensive market research document synthesis** for **{{research_topic}}**, producing an authoritative market research document with:
-
-**Document Features:**
-
-- **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 sources
-
-**Market Research Completeness:**
-
-- 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 market data throughout with proper citations
-
-**Ready to complete this comprehensive market research document?**
-[C] Complete Research - Save final comprehensive market research document
-
-**HALT — wait for user response before proceeding.**
-
-### 6. Handle Complete Selection
-
-#### 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 final content to the research document
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4]`
-- Complete the market research workflow
-
-## APPEND TO DOCUMENT:
-
-When user selects 'C', append the content directly to the research document using the structure from step 4. 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 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 citations
-✅ Professional market document structure and compelling narrative
-✅ [C] complete option presented and handled correctly
-✅ Market research workflow completed with comprehensive document
-
-## FAILURE MODES:
-
-❌ 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
-❌ Relying solely on training data without web verification for current facts
-❌ Producing market document without professional structure
-❌ Not presenting completion option for final market 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
-
-## STRATEGIC RESEARCH PROTOCOLS:
-
-- Search for current market strategy frameworks and best practices
-- Research successful market entry cases and approaches
-- Identify risk management methodologies and frameworks
-- 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 (1-4)
-- Comprehensive market research document generated
-- 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 verification
-
-## NEXT STEPS:
-
-Comprehensive market research workflow complete. User may:
-
-- 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 implementation based on strategic market recommendations
-
-Congratulations on completing comprehensive market research with professional documentation! 🎉

package/_bmad/bmm/workflows/1-analysis/research/bmad-market-research/workflow.md

@@ -1,49 +0,0 @@
-# Market Research Workflow
-
-**Goal:** Conduct comprehensive market research using current web data and verified sources to produce complete research documents with compelling narratives and proper citations.
-
-**Your Role:** You are a market research facilitator 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.
-
-## PREREQUISITE
-
-**⛔ Web search required.** If unavailable, abort and tell the user.
-
-## CONFIGURATION
-
-Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
-- `project_name`, `output_folder`, `planning_artifacts`, `user_name`
-- `communication_language`, `document_output_language`, `user_skill_level`
-- `date` as a system-generated value
-
-## QUICK TOPIC DISCOVERY
-
-"Welcome {{user_name}}! Let's get started with your **market research**.
-
-**What topic, problem, or area do you want to research?**
-
-For example:
-- 'The electric vehicle market in Europe'
-- 'Plant-based food alternatives market'
-- 'Mobile payment solutions in Southeast Asia'
-- 'Or anything else you have in mind...'"
-
-### Topic Clarification
-
-Based on the user's topic, briefly clarify:
-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?"
-
-## ROUTE TO MARKET RESEARCH STEPS
-
-After gathering the topic and goals:
-
-1. Set `research_type = "market"`
-2. Set `research_topic = [discovered topic from discussion]`
-3. Set `research_goals = [discovered goals from discussion]`
-4. Create the starter output file: `{planning_artifacts}/research/market-{{research_topic}}-research-{{date}}.md` with exact copy of the `./research.template.md` contents
-5. Load: `./steps/step-01-init.md` with topic context
-
-**Note:** The discovered topic from the discussion should be passed to the initialization step, so it doesn't need to ask "What do you want to research?" again - it can focus on refining the scope for market research.
-
-**✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`**

package/_bmad/bmm/workflows/1-analysis/research/bmad-technical-research/SKILL.md

@@ -1,6 +0,0 @@
----
-name: bmad-technical-research
-description: 'Conduct technical research on technologies and architecture. Use when the user says "create a technical research report on [topic]".'
----
-
-Follow the instructions in ./workflow.md.

package/_bmad/bmm/workflows/1-analysis/research/bmad-technical-research/bmad-skill-manifest.yaml

@@ -1 +0,0 @@
-type: skill

package/_bmad/bmm/workflows/1-analysis/research/bmad-technical-research/research.template.md

@@ -1,29 +0,0 @@
----
-stepsCompleted: []
-inputDocuments: []
-workflowType: 'research'
-lastStep: 1
-research_type: '{{research_type}}'
-research_topic: '{{research_topic}}'
-research_goals: '{{research_goals}}'
-user_name: '{{user_name}}'
-date: '{{date}}'
-web_research_enabled: true
-source_verification: true
----
-
-# Research Report: {{research_type}}
-
-**Date:** {{date}}
-**Author:** {{user_name}}
-**Research Type:** {{research_type}}
-
----
-
-## Research Overview
-
-[Research overview and methodology will be appended here]
-
----
-
-<!-- Content will be appended sequentially through research workflow steps -->