npm - ma-agents - Versions diffs - 3.4.8 → 3.5.0 - Mend

ma-agents 3.4.8 → 3.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (762) hide show

package/.opencode/skills/bmad-market-research/steps/step-03-customer-pain-points.md DELETED Viewed

@@ -1,251 +0,0 @@
-# Market Research Step 3: Customer Pain Points and Needs
-## 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 CUSTOMER NEEDS ANALYST, not content generator
-- 💬 FOCUS on customer pain points, challenges, and unmet needs
-- 🔍 WEB SEARCH REQUIRED - verify current facts against live sources
-- 📝 WRITE CONTENT IMMEDIATELY TO DOCUMENT
-- ✅ 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] continue option after pain points content generation
-- 📝 WRITE CUSTOMER PAIN POINTS ANALYSIS TO DOCUMENT IMMEDIATELY
-- 💾 ONLY proceed when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3]` before loading next step
-- 🚫 FORBIDDEN to load next step until C is selected
-## CONTEXT BOUNDARIES:
-- Current document and frontmatter from previous steps are available
-- Customer behavior analysis completed in previous step
-- Focus on customer pain points, challenges, and unmet needs
-- Web search capabilities with source verification are enabled
-- **Research topic = "{{research_topic}}"** - established from initial discussion
-- **Research goals = "{{research_goals}}"** - established from initial discussion
-## YOUR TASK:
-Conduct customer pain points and needs analysis with emphasis on challenges and frustrations.
-## CUSTOMER PAIN POINTS ANALYSIS SEQUENCE:
-### 1. Begin Customer Pain Points Analysis
-**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different customer pain point areas simultaneously and thoroughly.
-Start with customer pain points research approach:
-"Now I'll conduct **customer pain points analysis** for **{{research_topic}}** to understand customer challenges.
-**Customer Pain Points Focus:**
-- Customer challenges and frustrations
-- Unmet needs and unaddressed problems
-- Barriers to adoption or usage
-- Service and support pain points
-- Customer satisfaction gaps
-**Let me search for current customer pain points insights.**"
-### 2. Parallel Pain Points Research Execution
-**Execute multiple web searches simultaneously:**
-Search the web: "{{research_topic}} customer pain points challenges"
-Search the web: "{{research_topic}} customer frustrations"
-Search the web: "{{research_topic}} unmet customer needs"
-Search the web: "{{research_topic}} customer barriers to adoption"
-**Analysis approach:**
-- Look for customer satisfaction surveys and reports
-- Search for customer complaints and reviews
-- Research customer support and service issues
-- Analyze barriers to customer adoption
-- Study unmet needs and market gaps
-### 3. Analyze and Aggregate Results
-**Collect and analyze findings from all parallel searches:**
-"After executing comprehensive parallel web searches, let me analyze and aggregate customer pain points findings:
-**Research Coverage:**
-- Customer challenges and frustrations
-- Unmet needs and unaddressed problems
-- Barriers to adoption or usage
-- Service and support pain points
-**Cross-Pain Points Analysis:**
-[Identify patterns connecting different types of pain points]
-**Quality Assessment:**
-[Overall confidence levels and research gaps identified]"
-### 4. Generate Customer Pain Points Content
-**WRITE IMMEDIATELY TO DOCUMENT**
-Prepare customer pain points analysis with web search citations:
-#### Content Structure:
-When saving to document, append these Level 2 and Level 3 sections:
-```markdown
-## Customer Pain Points and Needs
-### Customer Challenges and Frustrations
-[Customer challenges analysis with source citations]
-_Primary Frustrations: [Major customer frustrations identified]_
-_Usage Barriers: [Barriers preventing effective usage]_
-_Service Pain Points: [Customer service and support issues]_
-_Frequency Analysis: [How often these challenges occur]_
-_Source: [URL]_
-### Unmet Customer Needs
-[Unmet needs analysis with source citations]
-_Critical Unmet Needs: [Most important unaddressed needs]_
-_Solution Gaps: [Opportunities to address unmet needs]_
-_Market Gaps: [Market opportunities from unmet needs]_
-_Priority Analysis: [Which needs are most critical]_
-_Source: [URL]_
-### Barriers to Adoption
-[Adoption barriers analysis with source citations]
-_Price Barriers: [Cost-related barriers to adoption]_
-_Technical Barriers: [Complexity or technical barriers]_
-_Trust Barriers: [Trust and credibility issues]_
-_Convenience Barriers: [Ease of use or accessibility issues]_
-_Source: [URL]_
-### Service and Support Pain Points
-[Service pain points analysis with source citations]
-_Customer Service Issues: [Common customer service problems]_
-_Support Gaps: [Areas where customer support is lacking]_
-_Communication Issues: [Communication breakdowns and frustrations]_
-_Response Time Issues: [Slow response and resolution problems]_
-_Source: [URL]_
-### Customer Satisfaction Gaps
-[Satisfaction gap analysis with source citations]
-_Expectation Gaps: [Differences between expectations and reality]_
-_Quality Gaps: [Areas where quality expectations aren't met]_
-_Value Perception Gaps: [Perceived value vs actual value]_
-_Trust and Credibility Gaps: [Trust issues affecting satisfaction]_
-_Source: [URL]_
-### Emotional Impact Assessment
-[Emotional impact analysis with source citations]
-_Frustration Levels: [Customer frustration severity assessment]_
-_Loyalty Risks: [How pain points affect customer loyalty]_
-_Reputation Impact: [Impact on brand or product reputation]_
-_Customer Retention Risks: [Risk of customer loss from pain points]_
-_Source: [URL]_
-### Pain Point Prioritization
-[Pain point prioritization with source citations]
-_High Priority Pain Points: [Most critical pain points to address]_
-_Medium Priority Pain Points: [Important but less critical pain points]_
-_Low Priority Pain Points: [Minor pain points with lower impact]_
-_Opportunity Mapping: [Pain points with highest solution opportunity]_
-_Source: [URL]_
-```
-### 5. Present Analysis and Continue Option
-**Show analysis and present continue option:**
-"I've completed **customer pain points analysis** for {{research_topic}}, focusing on customer challenges.
-**Key Pain Points Findings:**
-- Customer challenges and frustrations thoroughly documented
-- Unmet needs and solution gaps clearly identified
-- Adoption barriers and service pain points analyzed
-- Customer satisfaction gaps assessed
-- Pain points prioritized by impact and opportunity
-**Ready to proceed to customer decision processes?**
-[C] Continue - Save this to document and proceed to decision processes analysis
-**HALT — wait for user response before proceeding.**
-### 6. Handle Continue Selection
-#### If 'C' (Continue):
-- **CONTENT ALREADY WRITTEN TO DOCUMENT**
-- Update frontmatter: `stepsCompleted: [1, 2, 3]`
-- Load: `./step-04-customer-decisions.md`
-## APPEND TO DOCUMENT:
-Content is already written to document when generated in step 4. No additional append needed.
-## SUCCESS METRICS:
-✅ Customer challenges and frustrations clearly documented
-✅ Unmet needs and solution gaps identified
-✅ Adoption barriers and service pain points analyzed
-✅ Customer satisfaction gaps assessed
-✅ Pain points prioritized by impact and opportunity
-✅ Content written immediately to document
-✅ [C] continue option presented and handled correctly
-✅ Proper routing to next step (customer decisions)
-✅ Research goals alignment maintained
-## FAILURE MODES:
-❌ Relying solely on training data without web verification for current facts
-❌ Missing critical customer challenges or frustrations
-❌ Not identifying unmet needs or solution gaps
-❌ Incomplete adoption barriers analysis
-❌ Not writing content immediately to document
-❌ Not presenting [C] continue option after content generation
-❌ Not routing to customer decisions analysis step
-❌ **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
-## CUSTOMER PAIN POINTS RESEARCH PROTOCOLS:
-- Research customer satisfaction surveys and reviews
-- Use customer feedback and complaint data
-- Analyze customer support and service issues
-- Study barriers to customer adoption
-- Focus on current pain point data
-- Present conflicting information when sources disagree
-- Apply confidence levels appropriately
-## PAIN POINTS ANALYSIS STANDARDS:
-- Always cite URLs for web search results
-- Use authoritative customer research sources
-- Note data currency and potential limitations
-- Present multiple perspectives when sources conflict
-- Apply confidence levels to uncertain data
-- Focus on actionable pain point insights
-## NEXT STEP:
-After user selects 'C', load `./step-04-customer-decisions.md` to analyze customer decision processes, journey mapping, and decision factors for {{research_topic}}.
-Remember: Always write research content to document immediately and emphasize current customer pain points data with rigorous source verification!

package/.opencode/skills/bmad-market-research/steps/step-04-customer-decisions.md DELETED Viewed

@@ -1,261 +0,0 @@
-# Market Research Step 4: Customer Decisions and Journey
-## 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 CUSTOMER DECISION ANALYST, not content generator
-- 💬 FOCUS on customer decision processes and journey mapping
-- 🔍 WEB SEARCH REQUIRED - verify current facts against live sources
-- 📝 WRITE CONTENT IMMEDIATELY TO DOCUMENT
-- ✅ 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] continue option after decision processes content generation
-- 📝 WRITE CUSTOMER DECISIONS ANALYSIS TO DOCUMENT IMMEDIATELY
-- 💾 ONLY proceed when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4]` before loading next step
-- 🚫 FORBIDDEN to load next step until C is selected
-## CONTEXT BOUNDARIES:
-- Current document and frontmatter from previous steps are available
-- Customer behavior and pain points analysis completed in previous steps
-- Focus on customer decision processes and journey mapping
-- Web search capabilities with source verification are enabled
-- **Research topic = "{{research_topic}}"** - established from initial discussion
-- **Research goals = "{{research_goals}}"** - established from initial discussion
-## YOUR TASK:
-Conduct customer decision processes and journey analysis with emphasis on decision factors and journey mapping.
-## CUSTOMER DECISIONS ANALYSIS SEQUENCE:
-### 1. Begin Customer Decisions Analysis
-**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different customer decision areas simultaneously and thoroughly.
-Start with customer decisions research approach:
-"Now I'll conduct **customer decision processes analysis** for **{{research_topic}}** to understand customer decision-making.
-**Customer Decisions Focus:**
-- Customer decision-making processes
-- Decision factors and criteria
-- Customer journey mapping
-- Purchase decision influencers
-- Information gathering patterns
-**Let me search for current customer decision insights.**"
-### 2. Parallel Decisions Research Execution
-**Execute multiple web searches simultaneously:**
-Search the web: "{{research_topic}} customer decision process"
-Search the web: "{{research_topic}} buying criteria factors"
-Search the web: "{{research_topic}} customer journey mapping"
-Search the web: "{{research_topic}} decision influencing factors"
-**Analysis approach:**
-- Look for customer decision research studies
-- Search for buying criteria and factor analysis
-- Research customer journey mapping methodologies
-- Analyze decision influence factors and channels
-- Study information gathering and evaluation patterns
-### 3. Analyze and Aggregate Results
-**Collect and analyze findings from all parallel searches:**
-"After executing comprehensive parallel web searches, let me analyze and aggregate customer decision findings:
-**Research Coverage:**
-- Customer decision-making processes
-- Decision factors and criteria
-- Customer journey mapping
-- Decision influence factors
-**Cross-Decisions Analysis:**
-[Identify patterns connecting decision factors and journey stages]
-**Quality Assessment:**
-[Overall confidence levels and research gaps identified]"
-### 4. Generate Customer Decisions Content
-**WRITE IMMEDIATELY TO DOCUMENT**
-Prepare customer decisions analysis with web search citations:
-#### Content Structure:
-When saving to document, append these Level 2 and Level 3 sections:
-```markdown
-## Customer Decision Processes and Journey
-### Customer Decision-Making Processes
-[Decision processes analysis with source citations]
-_Decision Stages: [Key stages in customer decision making]_
-_Decision Timelines: [Timeframes for different decisions]_
-_Complexity Levels: [Decision complexity assessment]_
-_Evaluation Methods: [How customers evaluate options]_
-_Source: [URL]_
-### Decision Factors and Criteria
-[Decision factors analysis with source citations]
-_Primary Decision Factors: [Most important factors in decisions]_
-_Secondary Decision Factors: [Supporting factors influencing decisions]_
-_Weighing Analysis: [How different factors are weighed]_
-_Evoluton Patterns: [How factors change over time]_
-_Source: [URL]_
-### Customer Journey Mapping
-[Journey mapping analysis with source citations]
-_Awareness Stage: [How customers become aware of {{research_topic}}]_
-_Consideration Stage: [Evaluation and comparison process]_
-_Decision Stage: [Final decision-making process]_
-_Purchase Stage: [Purchase execution and completion]_
-_Post-Purchase Stage: [Post-decision evaluation and behavior]_
-_Source: [URL]_
-### Touchpoint Analysis
-[Touchpoint analysis with source citations]
-_Digital Touchpoints: [Online and digital interaction points]_
-_Offline Touchpoints: [Physical and in-person interaction points]_
-_Information Sources: [Where customers get information]_
-_Influence Channels: [What influences customer decisions]_
-_Source: [URL]_
-### Information Gathering Patterns
-[Information patterns analysis with source citations]
-_Research Methods: [How customers research options]_
-_Information Sources Trusted: [Most trusted information sources]_
-_Research Duration: [Time spent gathering information]_
-_Evaluation Criteria: [How customers evaluate information]_
-_Source: [URL]_
-### Decision Influencers
-[Decision influencer analysis with source citations]
-_Peer Influence: [How friends and family influence decisions]_
-_Expert Influence: [How expert opinions affect decisions]_
-_Media Influence: [How media and marketing affect decisions]_
-_Social Proof Influence: [How reviews and testimonials affect decisions]_
-_Source: [URL]_
-### Purchase Decision Factors
-[Purchase decision factors analysis with source citations]
-_Immediate Purchase Drivers: [Factors triggering immediate purchase]_
-_Delayed Purchase Drivers: [Factors causing purchase delays]_
-_Brand Loyalty Factors: [Factors driving repeat purchases]_
-_Price Sensitivity: [How price affects purchase decisions]_
-_Source: [URL]_
-### Customer Decision Optimizations
-[Decision optimization analysis with source citations]
-_Friction Reduction: [Ways to make decisions easier]_
-_Trust Building: [Building customer trust in decisions]_
-_Conversion Optimization: [Optimizing decision-to-purchase rates]_
-_Loyalty Building: [Building long-term customer relationships]_
-_Source: [URL]_
-```
-### 5. Present Analysis and Continue Option
-**Show analysis and present continue option:**
-"I've completed **customer decision processes analysis** for {{research_topic}}, focusing on customer decision-making.
-**Key Decision Findings:**
-- Customer decision-making processes clearly mapped
-- Decision factors and criteria thoroughly analyzed
-- Customer journey mapping completed across all stages
-- Decision influencers and touchpoints identified
-- Information gathering patterns documented
-**Ready to proceed to competitive analysis?**
-[C] Continue - Save this to document and proceed to competitive analysis
-**HALT — wait for user response before proceeding.**
-### 6. Handle Continue Selection
-#### If 'C' (Continue):
-- **CONTENT ALREADY WRITTEN TO DOCUMENT**
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4]`
-- Load: `./step-05-competitive-analysis.md`
-## APPEND TO DOCUMENT:
-Content is already written to document when generated in step 4. No additional append needed.
-## SUCCESS METRICS:
-✅ Customer decision-making processes clearly mapped
-✅ Decision factors and criteria thoroughly analyzed
-✅ Customer journey mapping completed across all stages
-✅ Decision influencers and touchpoints identified
-✅ Information gathering patterns documented
-✅ Content written immediately to document
-✅ [C] continue option presented and handled correctly
-✅ Proper routing to next step (competitive analysis)
-✅ Research goals alignment maintained
-## FAILURE MODES:
-❌ Relying solely on training data without web verification for current facts
-❌ Missing critical decision-making process stages
-❌ Not identifying key decision factors
-❌ Incomplete customer journey mapping
-❌ Not writing content immediately to document
-❌ Not presenting [C] continue option after content generation
-❌ Not routing to competitive analysis step
-❌ **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
-## CUSTOMER DECISIONS RESEARCH PROTOCOLS:
-- Research customer decision studies and psychology
-- Use customer journey mapping methodologies
-- Analyze buying criteria and decision factors
-- Study decision influence and touchpoint analysis
-- Focus on current decision data
-- Present conflicting information when sources disagree
-- Apply confidence levels appropriately
-## DECISION ANALYSIS STANDARDS:
-- Always cite URLs for web search results
-- Use authoritative customer decision research sources
-- Note data currency and potential limitations
-- Present multiple perspectives when sources conflict
-- Apply confidence levels to uncertain data
-- Focus on actionable decision insights
-## NEXT STEP:
-After user selects 'C', load `./step-05-competitive-analysis.md` to analyze competitive landscape, market positioning, and competitive strategies for {{research_topic}}.
-Remember: Always write research content to document immediately and emphasize current customer decision data with rigorous source verification!

package/.opencode/skills/bmad-market-research/steps/step-05-competitive-analysis.md DELETED Viewed

@@ -1,173 +0,0 @@
-# Market Research Step 5: Competitive Analysis
-## 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 COMPETITIVE ANALYST, not content generator
-- 💬 FOCUS on competitive landscape and market positioning
-- 🔍 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 competitive analysis content generation
-- 💾 ONLY save when user chooses C (Complete)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4, 5]` before completing workflow
-- 🚫 FORBIDDEN to complete workflow until C is selected
-## CONTEXT BOUNDARIES:
-- Current document and frontmatter from previous steps are available
-- Focus on competitive landscape and market positioning analysis
-- Web search capabilities with source verification are enabled
-- May need to search for specific competitor information
-## YOUR TASK:
-Conduct comprehensive competitive analysis with emphasis on market positioning.
-## COMPETITIVE ANALYSIS SEQUENCE:
-### 1. Begin Competitive Analysis
-Start with competitive research approach:
-"Now I'll conduct **competitive analysis** to understand the competitive landscape.
-**Competitive Analysis Focus:**
-- Key players and market share
-- Competitive positioning strategies
-- Strengths and weaknesses analysis
-- Market differentiation opportunities
-- Competitive threats and challenges
-**Let me search for current competitive information.**"
-### 2. Generate Competitive Analysis Content
-Prepare competitive analysis with web search citations:
-#### Content Structure:
-When saving to document, append these Level 2 and Level 3 sections:
-```markdown
-## Competitive Landscape
-### Key Market Players
-[Key players analysis with market share data]
-_Source: [URL]_
-### Market Share Analysis
-[Market share analysis with source citations]
-_Source: [URL]_
-### Competitive Positioning
-[Positioning analysis with source citations]
-_Source: [URL]_
-### Strengths and Weaknesses
-[SWOT analysis with source citations]
-_Source: [URL]_
-### Market Differentiation
-[Differentiation analysis with source citations]
-_Source: [URL]_
-### Competitive Threats
-[Threats analysis with source citations]
-_Source: [URL]_
-### Opportunities
-[Competitive opportunities analysis with source citations]
-_Source: [URL]_
-```
-### 3. Present Analysis and Complete Option
-Show the generated competitive analysis and present complete option:
-"I've completed the **competitive analysis** for the competitive landscape.
-**Key Competitive Findings:**
-- Key market players and market share identified
-- Competitive positioning strategies mapped
-- Strengths and weaknesses thoroughly analyzed
-- Market differentiation opportunities identified
-- Competitive threats and challenges documented
-**Ready to complete the market research?**
-[C] Complete Research - Save competitive analysis and proceed to research completion
-**HALT — wait for user response before proceeding.**
-### 4. Handle Complete Selection
-#### If 'C' (Complete Research):
-- Append the final content to the research document
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4, 5]`
-- Load: `./step-06-research-completion.md`
-## APPEND TO DOCUMENT:
-When user selects 'C', append the content directly to the research document using the structure from step 2.
-## SUCCESS METRICS:
-✅ Key market players identified
-✅ Market share analysis completed with source verification
-✅ Competitive positioning strategies clearly mapped
-✅ Strengths and weaknesses thoroughly analyzed
-✅ Market differentiation opportunities identified
-✅ [C] complete option presented and handled correctly
-✅ Content properly appended to document when C selected
-✅ Market research workflow completed successfully
-## FAILURE MODES:
-❌ Relying solely on training data without web verification for current facts
-❌ Missing key market players or market share data
-❌ Incomplete competitive positioning analysis
-❌ Not identifying market differentiation opportunities
-❌ Not presenting completion option for research workflow
-❌ Appending content without user selecting 'C'
-❌ **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
-## COMPETITIVE RESEARCH PROTOCOLS:
-- Search for industry reports and competitive intelligence
-- Use competitor company websites and annual reports
-- Research market research firm competitive analyses
-- Note competitive advantages and disadvantages
-- Search for recent market developments and disruptions
-## MARKET RESEARCH COMPLETION:
-When 'C' is selected:
-- All market research steps completed
-- Comprehensive market research document generated
-- All sections appended with source citations
-- Market research workflow status updated
-- Final recommendations provided to user
-## NEXT STEP:
-After user selects 'C', load `./step-06-research-completion.md` to produce the final comprehensive market research document with strategic synthesis, executive summary, and complete document structure.