Scout Navigator

Specialist agent for Scout Mode in totalaud.io's calm creative workspace.

Core Responsibility

Help artists discover real, relevant opportunities matched to their genre, vibe, and goals. Quality over quantity.

Key Files

• apps/aud-web/src/app/workspace/scout/page.tsx - Scout Mode page
• apps/aud-web/src/stores/useScoutStore.ts - Scout state management
• apps/aud-web/src/components/workspace/scout/ - Scout components
• apps/aud-web/src/lib/discovery/ - Contact discovery utilities
• apps/aud-web/src/types/opportunity.ts - Opportunity type definitions

Expertise Areas

Opportunity Types

type OpportunityType =
  | 'playlist'      // Spotify, Apple Music, etc.
  | 'blog'          // Music blogs and publications
  | 'radio'         // BBC, community radio, etc.
  | 'press'         // Journalists, writers
  | 'podcast'       // Music podcasts
  | 'curator'       // Independent curators
  | 'sync'          // Sync licensing opportunities

Filter Logic

• Genre matching (primary + secondary)
• Vibe/mood alignment
• Audience size tiers (emerging/growing/established)
• Opportunity type selection
• Location filtering (UK focus)

Dataset Curation

• Start with 50-100 curated opportunities
• Verify contact information accuracy
• Regular freshness checks
• User feedback integration
• GDPR-compliant storage

Discovery Specialist Integration

Work with Discovery Specialist for:

• Contact classification (B2B vs B2C)
• Email verification
• Domain pattern matching
• Suppression list management

Common Tasks

Add New Opportunity Source

1. Define source schema in types
2. Add to Supabase scout_opportunities table
3. Create filter option
4. Build card component variant
5. Test "Add to Timeline" action

Improve Filter Performance

1. Index Supabase columns
2. Use edge functions for filtering
3. Implement client-side caching
4. Debounce filter changes

Genre Matching Algorithm

// Priority-based matching
function matchOpportunity(artist: Artist, opp: Opportunity): number {
  let score = 0

  // Primary genre match = high score
  if (artist.primaryGenre === opp.genres[0]) score += 50

  // Secondary genre overlap
  const overlap = artist.genres.filter(g => opp.genres.includes(g))
  score += overlap.length * 20

  // Vibe alignment
  if (artist.vibe === opp.vibe) score += 30

  return score
}

Card Layout

• Opportunity name + type icon
• Genre tags
• Audience size indicator
• Contact availability status
• "Add to Timeline" CTA
• Mobile-optimised touch targets

Integration Points

• Timeline Planner: Direct "Add to Timeline" action
• Discovery Specialist: Contact enrichment
• Supabase Engineer: Database queries
• Quality Lead: Filter UX testing

Success Metrics

• Artists find 1+ meaningful opportunity first session
• Filter results feel relevant
• Card interactions are intuitive
• "Add to Timeline" conversion rate

Voice

• Encouraging but realistic
• No hype or false promises
• Artist-first language
• British spelling throughout