bmad-studio 0.1.0 → 1.0.0

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

@@ -1,476 +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
-
-### 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/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 -->

package/_bmad/bmm/workflows/2-plan-workflows/bmad-create-ux-design/SKILL.md

@@ -1,6 +0,0 @@
----
-name: bmad-create-ux-design
-description: 'Plan UX patterns and design specifications. Use when the user says "lets create UX design" or "create UX specifications" or "help me plan the UX"'
----
-
-Follow the instructions in ./workflow.md.

package/_bmad/bmm/workflows/2-plan-workflows/bmad-create-ux-design/bmad-skill-manifest.yaml

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

package/_bmad/bmm/workflows/2-plan-workflows/bmad-create-ux-design/steps/step-01-init.md

@@ -1,135 +0,0 @@
-# Step 1: UX Design Workflow Initialization
-
-## MANDATORY EXECUTION RULES (READ FIRST):
-
-- 🛑 NEVER generate content without user input
-
-- 📖 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
-- ✅ ALWAYS treat this as collaborative discovery between UX facilitator and stakeholder
-- 📋 YOU ARE A UX FACILITATOR, not a content generator
-- 💬 FOCUS on initialization and setup only - don't look ahead to future steps
-- 🚪 DETECT existing workflow state and handle continuation properly
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-
-## EXECUTION PROTOCOLS:
-
-- 🎯 Show your analysis before taking any action
-- 💾 Initialize document and update frontmatter
-- 📖 Set up frontmatter `stepsCompleted: [1]` before loading next step
-- 🚫 FORBIDDEN to load next step until setup is complete
-
-## CONTEXT BOUNDARIES:
-
-- Variables from workflow.md are available in memory
-- Previous context = what's in output document + frontmatter
-- Don't assume knowledge from other steps
-- Input document discovery happens in this step
-
-## YOUR TASK:
-
-Initialize the UX design workflow by detecting continuation state and setting up the design specification document.
-
-## INITIALIZATION SEQUENCE:
-
-### 1. Check for Existing Workflow
-
-First, check if the output document already exists:
-
-- Look for file at `{planning_artifacts}/*ux-design-specification*.md`
-- If exists, read the complete file including frontmatter
-- If not exists, this is a fresh workflow
-
-### 2. Handle Continuation (If Document Exists)
-
-If the document exists and has frontmatter with `stepsCompleted`:
-
-- **STOP here** and load `./step-01b-continue.md` immediately
-- Do not proceed with any initialization tasks
-- Let step-01b handle the continuation logic
-
-### 3. Fresh Workflow Setup (If No Document)
-
-If no document exists or no `stepsCompleted` in frontmatter:
-
-#### A. Input Document Discovery
-
-Discover and load context documents using smart discovery. Documents can be in the following locations:
-- {planning_artifacts}/**
-- {output_folder}/**
-- {product_knowledge}/**
-- {project-root}/docs/**
-
-Also - when searching - documents can be a single markdown file, or a folder with an index and multiple files. For Example, if searching for `*foo*.md` and not found, also search for a folder called *foo*/index.md (which indicates sharded content)
-
-Try to discover the following:
-- Product Brief (`*brief*.md`)
-- Research Documents (`*prd*.md`)
-- Project Documentation (generally multiple documents might be found for this in the `{product_knowledge}` or `docs` folder.)
-- Project Context (`**/project-context.md`)
-
-<critical>Confirm what you have found with the user, along with asking if the user wants to provide anything else. Only after this confirmation will you proceed to follow the loading rules</critical>
-
-**Loading Rules:**
-
-- Load ALL discovered files completely that the user confirmed or provided (no offset/limit)
-- If there is a project context, whatever is relevant should try to be biased in the remainder of this whole workflow process
-- For sharded folders, load ALL files to get complete picture, using the index first to potentially know the potential of each document
-- index.md is a guide to what's relevant whenever available
-- Track all successfully loaded files in frontmatter `inputDocuments` array
-
-#### B. Create Initial Document
-
-Copy the template from `../ux-design-template.md` to `{planning_artifacts}/ux-design-specification.md`
-Initialize frontmatter in the template.
-
-#### C. Complete Initialization and Report
-
-Complete setup and report to user:
-
-**Document Setup:**
-
-- Created: `{planning_artifacts}/ux-design-specification.md` from template
-- Initialized frontmatter with workflow state
-
-**Input Documents Discovered:**
-Report what was found:
-"Welcome {{user_name}}! I've set up your UX design workspace for {{project_name}}.
-
-**Documents Found:**
-
-- PRD: {number of PRD files loaded or "None found"}
-- Product brief: {number of brief files loaded or "None found"}
-- Other context: {number of other files loaded or "None found"}
-
-**Files loaded:** {list of specific file names or "No additional documents found"}
-
-Do you have any other documents you'd like me to include, or shall we continue to the next step?
-
-[C] Continue to UX discovery"
-
-## NEXT STEP:
-
-After user selects [C] to continue, ensure the file `{planning_artifacts}/ux-design-specification.md` has been created and saved, and then load `./step-02-discovery.md` to begin the UX discovery phase.
-
-Remember: Do NOT proceed to step-02 until output file has been updated and user explicitly selects [C] to continue!
-
-## SUCCESS METRICS:
-
-✅ Existing workflow detected and handed off to step-01b correctly
-✅ Fresh workflow initialized with template and frontmatter
-✅ Input documents discovered and loaded using sharded-first logic
-✅ All discovered files tracked in frontmatter `inputDocuments`
-✅ User confirmed document setup and can proceed
-
-## FAILURE MODES:
-
-❌ Proceeding with fresh initialization when existing workflow exists
-❌ Not updating frontmatter with discovered input documents
-❌ Creating document without proper template
-❌ Not checking sharded folders first before whole files
-❌ Not reporting what documents were found to user
-
-❌ **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