pig-farm-controller/bmad/bmm/workflows/1-analysis/research/instructions-market.md

Market Research Workflow Instructions

The workflow execution engine is governed by: {project_root}/bmad/core/tasks/workflow.xml You MUST have already loaded and processed: {installed_path}/workflow.yaml This is an INTERACTIVE workflow with web research capabilities. Engage the user at key decision points.

Welcome the user and explain the market research journey ahead

Ask the user these critical questions to shape the research:

1. What is the product/service you're researching?

   • Name and brief description
   • Current stage (idea, MVP, launched, scaling)

2. What are your primary research objectives?

   • Market sizing and opportunity assessment?
   • Competitive intelligence gathering?
   • Customer segment validation?
   • Go-to-market strategy development?
   • Investment/fundraising support?
   • Product-market fit validation?

3. Research depth preference:

   • Quick scan (2-3 hours) - High-level insights
   • Standard analysis (4-6 hours) - Comprehensive coverage
   • Deep dive (8+ hours) - Exhaustive research with modeling

4. Do you have any existing research or documents to build upon?

product_name product_description research_objectives research_depth

Help the user precisely define the market scope

Work with the user to establish:

1. Market Category Definition

   • Primary category/industry
   • Adjacent or overlapping markets
   • Where this fits in the value chain

2. Geographic Scope

   • Global, regional, or country-specific?
   • Primary markets vs. expansion markets
   • Regulatory considerations by region

3. Customer Segment Boundaries

   • B2B, B2C, or B2B2C?
   • Primary vs. secondary segments
   • Segment size estimates

Should we include adjacent markets in the TAM calculation? This could significantly increase market size but may be less immediately addressable.

market_definition geographic_scope segment_boundaries

Conduct real-time web research to gather current market data

This step performs ACTUAL web searches to gather live market intelligence

Conduct systematic research across multiple sources:

Search for latest industry reports, market size data, and growth projections Search queries to execute: - "[market_category] market size [geographic_scope] [current_year]" - "[market_category] industry report Gartner Forrester IDC McKinsey" - "[market_category] market growth rate CAGR forecast" - "[market_category] market trends [current_year]"

{project-root}/bmad/core/tasks/adv-elicit.xml

Search government databases and regulatory sources Search for: - Government statistics bureaus - Industry associations - Regulatory body reports - Census and economic data Gather recent news, funding announcements, and market events Search for articles from the last 6-12 months about: - Major deals and acquisitions - Funding rounds in the space - New market entrants - Regulatory changes - Technology disruptions Search for academic research and white papers Look for peer-reviewed studies on: - Market dynamics - Technology adoption patterns - Customer behavior research

market_intelligence_raw key_data_points source_credibility_notes

Calculate market sizes using multiple methodologies for triangulation

Use actual data gathered in previous steps, not hypothetical numbers

**Method 1: Top-Down Approach** - Start with total industry size from research - Apply relevant filters and segments - Show calculation: Industry Size × Relevant Percentage

Method 2: Bottom-Up Approach

• Number of potential customers × Average revenue per customer
• Build from unit economics

Method 3: Value Theory Approach

• Value created × Capturable percentage
• Based on problem severity and alternative costs

Which TAM calculation method seems most credible given our data? Should we use multiple methods and triangulate?

tam_calculation tam_methodology

Calculate Serviceable Addressable Market

Apply constraints to TAM:

• Geographic limitations (markets you can serve)
• Regulatory restrictions
• Technical requirements (e.g., internet penetration)
• Language/cultural barriers
• Current business model limitations

SAM = TAM × Serviceable Percentage Show the calculation with clear assumptions.

sam_calculation

Calculate realistic market capture

Consider competitive dynamics:

• Current market share of competitors
• Your competitive advantages
• Resource constraints
• Time to market considerations
• Customer acquisition capabilities

Create 3 scenarios:

1. Conservative (1-2% market share)
2. Realistic (3-5% market share)
3. Optimistic (5-10% market share)

som_scenarios

Develop detailed understanding of target customers For each major segment, research and define:

Demographics/Firmographics:

• Size and scale characteristics
• Geographic distribution
• Industry/vertical (for B2B)

Psychographics:

• Values and priorities
• Decision-making process
• Technology adoption patterns

Behavioral Patterns:

• Current solutions used
• Purchasing frequency
• Budget allocation

{project-root}/bmad/core/tasks/adv-elicit.xml segmentprofile{{segment_number}}

Apply JTBD framework to understand customer needs

For primary segment, identify:

Functional Jobs:

• Main tasks to accomplish
• Problems to solve
• Goals to achieve

Emotional Jobs:

• Feelings sought
• Anxieties to avoid
• Status desires

Social Jobs:

• How they want to be perceived
• Group dynamics
• Peer influences

Would you like to conduct actual customer interviews or surveys to validate these jobs? (We can create an interview guide)

jobs_to_be_done

Research and estimate pricing sensitivity

Analyze:

• Current spending on alternatives
• Budget allocation for this category
• Value perception indicators
• Price points of substitutes

pricing_analysis

Conduct comprehensive competitive analysis Create comprehensive competitor list

Search for and categorize:

1. Direct Competitors - Same solution, same market
2. Indirect Competitors - Different solution, same problem
3. Potential Competitors - Could enter market
4. Substitute Products - Alternative approaches

Do you have a specific list of competitors to analyze, or should I discover them through research?

For top 5 competitors, research and analyze

Gather intelligence on:

• Company overview and history
• Product features and positioning
• Pricing strategy and models
• Target customer focus
• Recent news and developments
• Funding and financial health
• Team and leadership
• Customer reviews and sentiment

{project-root}/bmad/core/tasks/adv-elicit.xml competitoranalysis{{competitor_number}}

Create positioning analysis

Map competitors on key dimensions:

• Price vs. Value
• Feature completeness vs. Ease of use
• Market segment focus
• Technology approach
• Business model

Identify:

• Gaps in the market
• Over-served areas
• Differentiation opportunities

competitive_positioning

Apply Porter's Five Forces framework

Use specific evidence from research, not generic assessments

Analyze each force with concrete examples:

Rate: [Low/Medium/High] - Key suppliers and dependencies - Switching costs - Concentration of suppliers - Forward integration threat Rate: [Low/Medium/High] - Customer concentration - Price sensitivity - Switching costs for customers - Backward integration threat Rate: [Low/Medium/High] - Number and strength of competitors - Industry growth rate - Exit barriers - Differentiation levels Rate: [Low/Medium/High] - Capital requirements - Regulatory barriers - Network effects - Brand loyalty Rate: [Low/Medium/High] - Alternative solutions - Switching costs to substitutes - Price-performance trade-offs

porters_five_forces

Identify trends and future market dynamics

Research and analyze:

Technology Trends:

• Emerging technologies impacting market
• Digital transformation effects
• Automation possibilities

Social/Cultural Trends:

• Changing customer behaviors
• Generational shifts
• Social movements impact

Economic Trends:

• Macroeconomic factors
• Industry-specific economics
• Investment trends

Regulatory Trends:

• Upcoming regulations
• Compliance requirements
• Policy direction

Should we explore any specific emerging technologies or disruptions that could reshape this market?

market_trends future_outlook

Synthesize research into strategic opportunities Based on all research, identify top 3-5 opportunities:

For each opportunity:

• Description and rationale
• Size estimate (from SOM)
• Resource requirements
• Time to market
• Risk assessment
• Success criteria

{project-root}/bmad/core/tasks/adv-elicit.xml market_opportunities

Develop GTM strategy based on research:

Positioning Strategy:

• Value proposition refinement
• Differentiation approach
• Messaging framework

Target Segment Sequencing:

• Beachhead market selection
• Expansion sequence
• Segment-specific approaches

Channel Strategy:

• Distribution channels
• Partnership opportunities
• Marketing channels

Pricing Strategy:

• Model recommendation
• Price points
• Value metrics

gtm_strategy

Identify and assess key risks:

Market Risks:

• Demand uncertainty
• Market timing
• Economic sensitivity

Competitive Risks:

• Competitor responses
• New entrants
• Technology disruption

Execution Risks:

• Resource requirements
• Capability gaps
• Scaling challenges

For each risk: Impact (H/M/L) × Probability (H/M/L) = Risk Score Provide mitigation strategies.

risk_assessment

Create financial model based on market research

Would you like to create a financial model with revenue projections based on the market analysis?

Build 3-year projections:

• Revenue model based on SOM scenarios
• Customer acquisition projections
• Unit economics
• Break-even analysis
• Funding requirements

financial_projections

Synthesize all findings into executive summary

Write this AFTER all other sections are complete

Create compelling executive summary with:

Market Opportunity:

• TAM/SAM/SOM summary
• Growth trajectory

Key Insights:

• Top 3-5 findings
• Surprising discoveries
• Critical success factors

Competitive Landscape:

• Market structure
• Positioning opportunity

Strategic Recommendations:

• Priority actions
• Go-to-market approach
• Investment requirements

Risk Summary:

• Major risks
• Mitigation approach

executive_summary

Compile full report and review with user

Generate the complete market research report using the template Review all sections for completeness and consistency Ensure all data sources are properly cited

Would you like to review any specific sections before finalizing? Are there any additional analyses you'd like to include?

Return to refine opportunities

final_report_ready

Would you like to include detailed appendices with calculations, full competitor profiles, or raw research data? Create appendices with:

• Detailed TAM/SAM/SOM calculations
• Full competitor profiles
• Customer interview notes
• Data sources and methodology
• Financial model details
• Glossary of terms

appendices

Load the FULL file: {output_folder}/bmm-workflow-status.yaml Find workflow_status key "research" ONLY write the file path as the status value - no other text, notes, or metadata Update workflow_status["research"] = "{output_folder}/bmm-research-{{research_mode}}-{{date}}.md" Save file, preserving ALL comments and structure including STATUS DEFINITIONS

Find first non-completed workflow in workflow_status (next workflow to do) Determine next agent from path file based on next workflow

✅ Research Complete ({{research_mode}} mode)

Research Report:

• Research report generated and saved to {output_folder}/bmm-research-{{research_mode}}-{{date}}.md

{{#if standalone_mode != true}} Status Updated:

• Progress tracking updated: research marked complete
• Next workflow: {{next_workflow}} {{else}} Note: Running in standalone mode (no progress tracking) {{/if}}

Next Steps:

{{#if standalone_mode != true}}

• Next workflow: {{next_workflow}} ({{next_agent}} agent)
• Optional: Review findings with stakeholders, or run additional analysis workflows (product-brief, game-brief, etc.)

Check status anytime with: workflow-status {{else}} Since no workflow is in progress:

• Review research findings
• Refer to the BMM workflow guide if unsure what to do next
• Or run workflow-init to create a workflow path and get guided next steps {{/if}}