npm - @pennyfarthing/core - Versions diffs - 9.2.0 → 9.3.0 - Mend

@pennyfarthing/core 9.2.0 → 9.3.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 (1039) hide show

package/pennyfarthing-dist/workflows/research/steps-market/step-03-customer-pain-points.md DELETED Viewed

@@ -1,275 +0,0 @@
-# Market Research Step 3: Customer Pain Points and Needs
-<purpose>
-Conduct customer pain points and needs analysis identifying customer challenges, unmet needs, adoption barriers, service pain points, satisfaction gaps, emotional impact, and pain point prioritization using verified web search data.
-</purpose>
-<instructions>
-1. Execute parallel web searches for customer pain points, frustrations, unmet needs, and barriers
-2. Analyze and aggregate pain points findings
-3. Generate pain points analysis content with seven subsections (Challenges and Frustrations, Unmet Needs, Adoption Barriers, Service Pain Points, Satisfaction Gaps, Emotional Impact, Pain Point Prioritization)
-4. Include source citations for all pain point data
-5. Write content immediately to document
-6. Present [C] continue option after content generation
-7. Update frontmatter stepsCompleted to [1, 2, 3] before loading next step
-</instructions>
-<output>
-Customer pain points analysis sections containing:
-- Customer challenges and frustrations with source citations
-- Unmet needs and solution gaps with source citations
-- Adoption barriers analysis with source citations
-- Service and support pain points with source citations
-- Customer satisfaction gaps assessment with source citations
-- Emotional impact analysis with source citations
-- Pain point prioritization with source citations
-- All content appended to research document
-</output>
-## 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
-### 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/pennyfarthing-dist/workflows/research/steps-market/step-04-customer-decisions.md DELETED Viewed

@@ -1,286 +0,0 @@
-# Market Research Step 4: Customer Decisions and Journey
-<purpose>
-Conduct customer decision processes analysis identifying decision-making processes, decision factors and criteria, customer journey mapping, touchpoint analysis, information gathering patterns, decision influencers, and purchase decision factors using verified web search data.
-</purpose>
-<instructions>
-1. Execute parallel web searches for customer decision processes, journey mapping, buying criteria, and influencers
-2. Analyze and aggregate decision findings
-3. Generate decision processes analysis content with eight subsections (Decision Processes, Decision Factors, Customer Journey, Touchpoint Analysis, Information Gathering, Decision Influencers, Purchase Factors, Decision Optimizations)
-4. Include source citations for all decision data
-5. Write content immediately to document
-6. Present [C] continue option after content generation
-7. Update frontmatter stepsCompleted to [1, 2, 3, 4] before loading next step
-</instructions>
-<output>
-Customer decision processes analysis sections containing:
-- Customer decision-making processes with source citations
-- Decision factors and criteria with source citations
-- Customer journey mapping across all stages with source citations
-- Touchpoint analysis with source citations
-- Information gathering patterns with source citations
-- Decision influencers identification with source citations
-- Purchase decision factors with source citations
-- Customer decision optimizations with source citations
-- All content appended to research document
-</output>
-## 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
-### 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!