bmad-method 5.1.2 → 6.0.0-alpha.0

package/src/modules/bmm/workflows/1-analysis/research/template-market.md

@@ -0,0 +1,311 @@
+# Market Research Report: {{product_name}}
+
+**Date:** {{date}}
+**Prepared by:** {{user_name}}
+**Research Depth:** {{research_depth}}
+
+---
+
+## Executive Summary
+
+{{executive_summary}}
+
+### Key Market Metrics
+
+- **Total Addressable Market (TAM):** {{tam_calculation}}
+- **Serviceable Addressable Market (SAM):** {{sam_calculation}}
+- **Serviceable Obtainable Market (SOM):** {{som_scenarios}}
+
+### Critical Success Factors
+
+{{key_success_factors}}
+
+---
+
+## 1. Research Objectives & Methodology
+
+### Research Objectives
+
+{{research_objectives}}
+
+### Scope and Boundaries
+
+- **Product/Service:** {{product_description}}
+- **Market Definition:** {{market_definition}}
+- **Geographic Scope:** {{geographic_scope}}
+- **Customer Segments:** {{segment_boundaries}}
+
+### Research Methodology
+
+{{research_methodology}}
+
+### Data Sources
+
+{{source_credibility_notes}}
+
+---
+
+## 2. Market Overview
+
+### Market Definition
+
+{{market_definition}}
+
+### Market Size and Growth
+
+#### Total Addressable Market (TAM)
+
+**Methodology:** {{tam_methodology}}
+
+{{tam_calculation}}
+
+#### Serviceable Addressable Market (SAM)
+
+{{sam_calculation}}
+
+#### Serviceable Obtainable Market (SOM)
+
+{{som_scenarios}}
+
+### Market Intelligence Summary
+
+{{market_intelligence_raw}}
+
+### Key Data Points
+
+{{key_data_points}}
+
+---
+
+## 3. Market Trends and Drivers
+
+### Key Market Trends
+
+{{market_trends}}
+
+### Growth Drivers
+
+{{growth_drivers}}
+
+### Market Inhibitors
+
+{{market_inhibitors}}
+
+### Future Outlook
+
+{{future_outlook}}
+
+---
+
+## 4. Customer Analysis
+
+### Target Customer Segments
+
+{{#segment_profile_1}}
+
+#### Segment 1
+
+{{segment_profile_1}}
+{{/segment_profile_1}}
+
+{{#segment_profile_2}}
+
+#### Segment 2
+
+{{segment_profile_2}}
+{{/segment_profile_2}}
+
+{{#segment_profile_3}}
+
+#### Segment 3
+
+{{segment_profile_3}}
+{{/segment_profile_3}}
+
+{{#segment_profile_4}}
+
+#### Segment 4
+
+{{segment_profile_4}}
+{{/segment_profile_4}}
+
+{{#segment_profile_5}}
+
+#### Segment 5
+
+{{segment_profile_5}}
+{{/segment_profile_5}}
+
+### Jobs-to-be-Done Analysis
+
+{{jobs_to_be_done}}
+
+### Pricing Analysis and Willingness to Pay
+
+{{pricing_analysis}}
+
+---
+
+## 5. Competitive Landscape
+
+### Market Structure
+
+{{market_structure}}
+
+### Competitor Analysis
+
+{{#competitor_analysis_1}}
+
+#### Competitor 1
+
+{{competitor_analysis_1}}
+{{/competitor_analysis_1}}
+
+{{#competitor_analysis_2}}
+
+#### Competitor 2
+
+{{competitor_analysis_2}}
+{{/competitor_analysis_2}}
+
+{{#competitor_analysis_3}}
+
+#### Competitor 3
+
+{{competitor_analysis_3}}
+{{/competitor_analysis_3}}
+
+{{#competitor_analysis_4}}
+
+#### Competitor 4
+
+{{competitor_analysis_4}}
+{{/competitor_analysis_4}}
+
+{{#competitor_analysis_5}}
+
+#### Competitor 5
+
+{{competitor_analysis_5}}
+{{/competitor_analysis_5}}
+
+### Competitive Positioning
+
+{{competitive_positioning}}
+
+---
+
+## 6. Industry Analysis
+
+### Porter's Five Forces Assessment
+
+{{porters_five_forces}}
+
+### Technology Adoption Lifecycle
+
+{{adoption_lifecycle}}
+
+### Value Chain Analysis
+
+{{value_chain_analysis}}
+
+---
+
+## 7. Market Opportunities
+
+### Identified Opportunities
+
+{{market_opportunities}}
+
+### Opportunity Prioritization Matrix
+
+{{opportunity_prioritization}}
+
+---
+
+## 8. Strategic Recommendations
+
+### Go-to-Market Strategy
+
+{{gtm_strategy}}
+
+#### Positioning Strategy
+
+{{positioning_strategy}}
+
+#### Target Segment Sequencing
+
+{{segment_sequencing}}
+
+#### Channel Strategy
+
+{{channel_strategy}}
+
+#### Pricing Strategy
+
+{{pricing_recommendations}}
+
+### Implementation Roadmap
+
+{{implementation_roadmap}}
+
+---
+
+## 9. Risk Assessment
+
+### Risk Analysis
+
+{{risk_assessment}}
+
+### Mitigation Strategies
+
+{{mitigation_strategies}}
+
+---
+
+## 10. Financial Projections
+
+{{#financial_projections}}
+{{financial_projections}}
+{{/financial_projections}}
+
+---
+
+## Appendices
+
+### Appendix A: Data Sources and References
+
+{{data_sources}}
+
+### Appendix B: Detailed Calculations
+
+{{detailed_calculations}}
+
+### Appendix C: Additional Analysis
+
+{{#appendices}}
+{{appendices}}
+{{/appendices}}
+
+### Appendix D: Glossary of Terms
+
+{{glossary}}
+
+---
+
+## Document Information
+
+**Workflow:** BMad Market Research Workflow v1.0
+**Generated:** {{date}}
+**Next Review:** {{next_review_date}}
+**Classification:** {{classification}}
+
+### Research Quality Metrics
+
+- **Data Freshness:** Current as of {{date}}
+- **Source Reliability:** {{source_reliability_score}}
+- **Confidence Level:** {{confidence_level}}
+
+---
+
+_This market research report was generated using the BMad Method Market Research Workflow, combining systematic analysis frameworks with real-time market intelligence gathering._

package/src/modules/bmm/workflows/1-analysis/research/template-technical.md

@@ -0,0 +1,210 @@
+# Technical Research Report: {{technical_question}}
+
+**Date:** {{date}}
+**Prepared by:** {{user_name}}
+**Project Context:** {{project_context}}
+
+---
+
+## Executive Summary
+
+{{recommendations}}
+
+### Key Recommendation
+
+**Primary Choice:** [Technology/Pattern Name]
+
+**Rationale:** [2-3 sentence summary]
+
+**Key Benefits:**
+
+- [Benefit 1]
+- [Benefit 2]
+- [Benefit 3]
+
+---
+
+## 1. Research Objectives
+
+### Technical Question
+
+{{technical_question}}
+
+### Project Context
+
+{{project_context}}
+
+### Requirements and Constraints
+
+#### Functional Requirements
+
+{{functional_requirements}}
+
+#### Non-Functional Requirements
+
+{{non_functional_requirements}}
+
+#### Technical Constraints
+
+{{technical_constraints}}
+
+---
+
+## 2. Technology Options Evaluated
+
+{{technology_options}}
+
+---
+
+## 3. Detailed Technology Profiles
+
+{{#tech_profile_1}}
+
+### Option 1: [Technology Name]
+
+{{tech_profile_1}}
+{{/tech_profile_1}}
+
+{{#tech_profile_2}}
+
+### Option 2: [Technology Name]
+
+{{tech_profile_2}}
+{{/tech_profile_2}}
+
+{{#tech_profile_3}}
+
+### Option 3: [Technology Name]
+
+{{tech_profile_3}}
+{{/tech_profile_3}}
+
+{{#tech_profile_4}}
+
+### Option 4: [Technology Name]
+
+{{tech_profile_4}}
+{{/tech_profile_4}}
+
+{{#tech_profile_5}}
+
+### Option 5: [Technology Name]
+
+{{tech_profile_5}}
+{{/tech_profile_5}}
+
+---
+
+## 4. Comparative Analysis
+
+{{comparative_analysis}}
+
+### Weighted Analysis
+
+**Decision Priorities:**
+{{decision_priorities}}
+
+{{weighted_analysis}}
+
+---
+
+## 5. Trade-offs and Decision Factors
+
+{{use_case_fit}}
+
+### Key Trade-offs
+
+[Comparison of major trade-offs between top options]
+
+---
+
+## 6. Real-World Evidence
+
+{{real_world_evidence}}
+
+---
+
+## 7. Architecture Pattern Analysis
+
+{{#architecture_pattern_analysis}}
+{{architecture_pattern_analysis}}
+{{/architecture_pattern_analysis}}
+
+---
+
+## 8. Recommendations
+
+{{recommendations}}
+
+### Implementation Roadmap
+
+1. **Proof of Concept Phase**
+   - [POC objectives and timeline]
+
+2. **Key Implementation Decisions**
+   - [Critical decisions to make during implementation]
+
+3. **Migration Path** (if applicable)
+   - [Migration approach from current state]
+
+4. **Success Criteria**
+   - [How to validate the decision]
+
+### Risk Mitigation
+
+{{risk_mitigation}}
+
+---
+
+## 9. Architecture Decision Record (ADR)
+
+{{architecture_decision_record}}
+
+---
+
+## 10. References and Resources
+
+### Documentation
+
+- [Links to official documentation]
+
+### Benchmarks and Case Studies
+
+- [Links to benchmarks and real-world case studies]
+
+### Community Resources
+
+- [Links to communities, forums, discussions]
+
+### Additional Reading
+
+- [Links to relevant articles, papers, talks]
+
+---
+
+## Appendices
+
+### Appendix A: Detailed Comparison Matrix
+
+[Full comparison table with all evaluated dimensions]
+
+### Appendix B: Proof of Concept Plan
+
+[Detailed POC plan if needed]
+
+### Appendix C: Cost Analysis
+
+[TCO analysis if performed]
+
+---
+
+## Document Information
+
+**Workflow:** BMad Research Workflow - Technical Research v2.0
+**Generated:** {{date}}
+**Research Type:** Technical/Architecture Research
+**Next Review:** [Date for review/update]
+
+---
+
+_This technical research report was generated using the BMad Method Research Workflow, combining systematic technology evaluation frameworks with real-time research and analysis._

package/src/modules/bmm/workflows/1-analysis/research/workflow.yaml

@@ -0,0 +1,149 @@
+# Research Workflow - Multi-Type Research System
+name: research
+description: "Adaptive research workflow supporting multiple research types: market research, deep research prompt generation, technical/architecture evaluation, competitive intelligence, user research, and domain analysis"
+author: "BMad"
+
+# Critical variables from config
+config_source: "{project-root}/bmad/bmm/config.yaml"
+output_folder: "{config_source}:output_folder"
+user_name: "{config_source}:user_name"
+date: system-generated
+
+# Workflow components - ROUTER PATTERN
+installed_path: "{project-root}/bmad/bmm/workflows/1-analysis/research"
+instructions: "{installed_path}/instructions-router.md" # Router loads specific instruction sets
+validation: "{installed_path}/checklist.md"
+
+# Research type specific instructions (loaded by router)
+instructions_market: "{installed_path}/instructions-market.md"
+instructions_deep_prompt: "{installed_path}/instructions-deep-prompt.md"
+instructions_technical: "{installed_path}/instructions-technical.md"
+
+# Templates (loaded based on research type)
+template_market: "{installed_path}/template-market.md"
+template_deep_prompt: "{installed_path}/template-deep-prompt.md"
+template_technical: "{installed_path}/template-technical.md"
+
+# Output configuration (dynamic based on research type)
+default_output_file: "{output_folder}/research-{{research_type}}-{{date}}.md"
+market_output: "{output_folder}/market-research-{{product_name_slug}}-{{date}}.md"
+deep_prompt_output: "{output_folder}/deep-research-prompt-{{date}}.md"
+technical_output: "{output_folder}/technical-research-{{date}}.md"
+
+# Research types supported
+research_types:
+  market:
+    name: "Market Research"
+    description: "Comprehensive market analysis with TAM/SAM/SOM"
+    instructions: "{instructions_market}"
+    template: "{template_market}"
+    output: "{market_output}"
+  deep_prompt:
+    name: "Deep Research Prompt Generator"
+    description: "Generate optimized prompts for AI research platforms"
+    instructions: "{instructions_deep_prompt}"
+    template: "{template_deep_prompt}"
+    output: "{deep_prompt_output}"
+  technical:
+    name: "Technical/Architecture Research"
+    description: "Technology evaluation and architecture pattern research"
+    instructions: "{instructions_technical}"
+    template: "{template_technical}"
+    output: "{technical_output}"
+  competitive:
+    name: "Competitive Intelligence"
+    description: "Deep competitor analysis"
+    instructions: "{instructions_market}" # Uses market with competitive focus
+    template: "{template_market}"
+    output: "{output_folder}/competitive-intelligence-{{date}}.md"
+  user:
+    name: "User Research"
+    description: "Customer insights and persona development"
+    instructions: "{instructions_market}" # Uses market with user focus
+    template: "{template_market}"
+    output: "{output_folder}/user-research-{{date}}.md"
+  domain:
+    name: "Domain/Industry Research"
+    description: "Industry and domain deep dives"
+    instructions: "{instructions_market}" # Uses market with domain focus
+    template: "{template_market}"
+    output: "{output_folder}/domain-research-{{date}}.md"
+
+# Research parameters (can be overridden at runtime)
+research_depth: "comprehensive" # Options: quick, standard, comprehensive
+enable_web_research: true
+enable_competitor_analysis: true
+enable_financial_modeling: true
+
+# Data sources and tools
+required_tools:
+  - web_search: "For real-time data gathering across all research types"
+  - calculator: "For calculations (TAM/SAM/SOM, TCO, etc.)"
+  - data_analysis: "For trends, patterns, and comparative analysis"
+
+# Recommended input documents (varies by research type)
+recommended_inputs:
+  market:
+    - product_brief: "Product or business description"
+    - target_customers: "Customer segment hypotheses"
+    - competitor_list: "Known competitors (optional)"
+  technical:
+    - requirements_doc: "Technical requirements"
+    - architecture_doc: "Current architecture (if brownfield)"
+    - constraints_list: "Technical constraints"
+  deep_prompt:
+    - research_question: "Initial research question or topic"
+    - context_docs: "Background documents for context"
+
+# Claude Code integration points
+claude_code_enhancements:
+  - injection_point: "research-subagents"
+  - available_subagents:
+      - market-researcher: "Deep market intelligence gathering"
+      - trend-spotter: "Emerging trends and weak signals"
+      - data-analyst: "Quantitative analysis"
+      - competitor-analyzer: "Competitive intelligence"
+      - user-researcher: "Customer insights"
+      - technical-evaluator: "Technology assessment"
+
+# Workflow configuration
+interactive: true # User checkpoints throughout
+autonomous: false # Requires user input
+allow_parallel: true # Can run research tasks in parallel
+
+# Research frameworks available (context dependent)
+frameworks:
+  market:
+    - "TAM/SAM/SOM Analysis"
+    - "Porter's Five Forces"
+    - "Jobs-to-be-Done"
+    - "Technology Adoption Lifecycle"
+    - "SWOT Analysis"
+    - "Value Chain Analysis"
+  technical:
+    - "Trade-off Analysis"
+    - "Architecture Decision Records (ADR)"
+    - "Technology Radar"
+    - "Comparison Matrix"
+    - "Cost-Benefit Analysis"
+  deep_prompt:
+    - "ChatGPT Deep Research Best Practices"
+    - "Gemini Deep Research Framework"
+    - "Grok DeepSearch Optimization"
+    - "Claude Projects Methodology"
+    - "Iterative Prompt Refinement"
+
+# Data sources (for web research)
+data_sources:
+  - "Industry reports and publications"
+  - "Government statistics and databases"
+  - "Financial reports and SEC filings"
+  - "News articles and press releases"
+  - "Academic research papers"
+  - "Technical documentation and RFCs"
+  - "GitHub repositories and discussions"
+  - "Stack Overflow and developer forums"
+  - "Market research firm reports"
+  - "Social media and communities"
+  - "Patent databases"
+  - "Benchmarking studies"