Files

2026-01-01 17:56:25 +05:30

9.5 KiB

Raw Blame History

Research Page UX Improvements & Preset Integration Analysis

Review Date: 2025-12-30

Current First-Time User Experience

What Users See on First Visit:

Research Page Loads → Shows "Quick Start Presets" section
Modal Appears Immediately → "Generate Research Persona" modal
User Options:
- Generate Persona (30-60 seconds) → Gets personalized presets
- Skip for Now → Uses generic sample presets

Current Flow:

First Visit
  ↓
Modal: "Generate Research Persona?"
  ↓
[User clicks "Generate Persona"]
  ↓
Loading... (30-60 seconds)
  ↓
Persona Generated ✅
  ↓
Presets Updated with AI-generated presets
  ↓
User can start researching

🔍 Current Preset System Analysis

How Presets Are Generated:

1. AI-Generated Presets (Best Experience)

Source: research_persona.recommended_presets
When Used: If research persona exists AND has recommended_presets

Benefits from Research Persona:

✅ Full Config: Complete ResearchConfig object with all Exa/Tavily options
✅ Personalized Keywords: Based on user's industry, audience, interests
✅ Industry-Specific: Uses default_industry and default_target_audience
✅ Provider Optimization: Uses suggested_exa_category, suggested_exa_domains, suggested_exa_search_type
✅ Research Mode: Uses default_research_mode
✅ Smart Defaults: All provider-specific settings from persona

Example AI Preset:

{
  "name": "Content Marketing Trends",
  "keywords": "Research latest content marketing automation tools and AI-powered content strategies",
  "industry": "Content Marketing",
  "target_audience": "Marketing professionals and content creators",
  "research_mode": "comprehensive",
  "config": {
    "mode": "comprehensive",
    "provider": "exa",
    "max_sources": 20,
    "exa_category": "company",
    "exa_search_type": "neural",
    "exa_include_domains": ["contentmarketinginstitute.com", "hubspot.com"],
    "include_statistics": true,
    "include_expert_quotes": true,
    "include_competitors": true,
    "include_trends": true
  },
  "description": "Discover latest trends in content marketing automation"
}

2. Rule-Based Presets (Fallback)

Source: generatePersonaPresets(persona_defaults)
When Used: If persona exists but has no recommended_presets

Benefits from Research Persona:

✅ Industry: Uses persona_defaults.industry
✅ Audience: Uses persona_defaults.target_audience
✅ Exa Category: Uses persona_defaults.suggested_exa_category
✅ Exa Domains: Uses persona_defaults.suggested_domains
⚠️ Limited: Only generates 3 generic presets with template keywords

Example Rule-Based Preset:

{
  name: "Content Marketing Trends",
  keywords: "Research latest trends and innovations in Content Marketing",
  industry: "Content Marketing",
  targetAudience: "Professionals and content consumers",
  researchMode: "comprehensive",
  config: {
    mode: "comprehensive",
    provider: "exa",
    exa_category: "company",
    exa_search_type: "neural",
    exa_include_domains: ["contentmarketinginstitute.com", ...]
  }
}

3. Sample Presets (No Personalization)

Source: Hardcoded samplePresets array
When Used: If no persona exists or persona has no industry

No Benefits from Research Persona:

❌ Generic presets (AI Marketing Tools, Small Business SEO, etc.)
❌ Not personalized to user
❌ Same for all users

🎯 What First-Time Users Expect

User Expectations:

Immediate Value: See something useful right away, not a modal
Clear Purpose: Understand what the page does
Quick Start: Be able to start researching without barriers
Personalization: See relevant presets for their industry
Progressive Enhancement: Get better experience after persona generation

Current Issues:

❌ Modal Blocks Action: User must interact with modal before seeing value
❌ Unclear Benefits: User doesn't know what they're getting
❌ Generic Presets Initially: Shows sample presets until persona generates
❌ No Preview: Can't see what personalized presets look like
❌ No Context: User doesn't understand why persona is needed

💡 Proposed UX Improvements

Current: Modal blocks entire page
Proposed:

Show presets immediately (even if generic)
Modal appears as a banner/notification at top, not blocking
Show preview of what personalized presets will look like
Allow user to start researching immediately with generic presets

Benefits:

✅ User can start immediately
✅ Persona generation is optional enhancement
✅ Less friction for first-time users

Improvement 2: Enhanced Persona Generation Prompt

Current Issues:

Prompt doesn't emphasize creating actionable, specific presets
Doesn't use competitor analysis data
Doesn't leverage research angles for preset names

Proposed Enhancements:

Use Competitor Analysis: Include competitor data in prompt to create competitive research presets
Leverage Research Angles: Use research_angles to create preset names and keywords
More Specific Instructions: Emphasize creating presets that user would actually want to use
Industry-Specific Examples: Include examples based on user's industry

Improvement 3: Progressive Enhancement Flow

Proposed Flow:

First Visit
  ↓
Show Generic Presets Immediately ✅
  ↓
Banner: "Personalize your research experience" (non-blocking)
  ↓
[User can click preset and start researching]
  OR
[User clicks "Generate Persona" in banner]
  ↓
Background Generation (doesn't block)
  ↓
Presets Update Automatically When Ready
  ↓
Notification: "Your personalized presets are ready!"

Improvement 4: Better Preset Generation

Enhancements:

Use Research Angles: Create presets from research_angles field
Competitor-Focused Presets: If competitor data exists, create competitive analysis presets
Query Enhancement Integration: Use query_enhancement_rules to create better preset keywords
Industry-Specific Templates: Use industry to select preset templates

Improvement 5: Visual Indicators

Add:

Badge on presets: "AI Personalized" vs "Generic"
Tooltip explaining what personalized presets include
Progress indicator during persona generation
Success animation when presets update

🔧 Technical Improvements Needed

1. Enhanced Prompt for Recommended Presets

Current Prompt Section (Line 115-124):

6. RECOMMENDED PRESETS:
   - "recommended_presets": Generate 3-5 personalized research preset templates...

Proposed Enhancement:

Include competitor analysis data in prompt
Use research_angles to inspire preset names
Add examples of good vs. bad presets
Emphasize actionability and specificity

2. Preset Generation Logic

Current:

AI generates presets OR rule-based fallback
No use of competitor data
No use of research angles

Proposed:

Use research_angles to create preset names/keywords
Use competitor data to create competitive analysis presets
Use query_enhancement_rules to improve preset keywords
Create presets that match user's content goals

3. Frontend UX Enhancements