competitors: [
  {
    name: "Competitor A"
    website: "https://competitora.com"
    tier: "primary"                   # Track deeply
    slug: "competitor-a"              # Folder name
  },
  {
    name: "Competitor B"
    website: "https://competitorb.com"
    tier: "secondary"                 # Track lightly
    slug: "competitor-b"
  }
]
profile_directory: "clients/<client>/competitors/"

competitors: [...]                    # From config
profile_directory: string             # From config
mode: "update" | "review"            # Update = periodic scan. Review = full deep dive.
trigger: string | null                # e.g., "Competitor A launched new pricing" — focuses the scan

competitor_scans: [
  {
    competitor: {
      name: string
      slug: string
      tier: string
      website: string
    }
    current_state: {
      positioning: {
        headline: string
        description: string
        value_propositions: string[]
        target_audience: string
        customer_logos: string[]
        comparison_pages: string[]
      }
      product: {
        key_features: string[]
        recent_launches: [ { feature: string, date: string, description: string } ]
        integrations: string[]
      }
      pricing: {
        model: string                  # "per seat", "per usage", "flat rate"
        tiers: [ { name: string, price: string, key_features: string[] } ]
        free_tier: boolean
        enterprise_tier: boolean
      }
      content: {
        blog_themes: string[]          # Top themes from recent posts
        social_top_posts: [ { platform: string, topic: string, engagement: string, url: string } ]
        content_formats: string[]      # Video, long-form, infographic, etc.
        posting_frequency: string      # "3x/week", "daily", "sporadic"
      }
      market_signals: {
        recent_funding: string | null
        hiring_patterns: string[]
        partnerships: string[]
        recent_reviews_sentiment: string
      }
    }
    changes_detected: [
      {
        dimension: string              # "positioning", "product", "pricing", "content", "market"
        change: string                 # What changed
        previous: string               # What it was before
        current: string                # What it is now
        detected_date: string
        significance: "high" | "medium" | "low"
        implication: string            # What this means for you
      }
    ]
    scan_date: string
  }
]

## Competitive Scan Results
 
### Changes Detected
 
| Competitor | Dimension | Change | Significance |
|-----------|-----------|--------|-------------|
| Competitor A | Pricing | Dropped starter tier from $99 → $49/mo | High — undercutting our entry price |
| Competitor A | Product | Launched AI feature X | Medium — we have this, they're catching up |
| Competitor B | Positioning | New tagline: "Enterprise-grade Y" | Medium — moving upmarket |
| Competitor B | Content | 3 blog posts on [your category topic] | Low — entering your content territory |
 
### No Changes
| Competitor | Last Scan |
|-----------|-----------|
| Competitor C | [date] — no material changes |
 
Proceed with profile updates and strategic analysis? (Y/n)

competitor_scans: [...]               # From Step 1
profile_directory: string             # From config

clients/<client>/competitors/
├── competitor-a/
│   ├── profile.md                    # Current-state profile (overwritten each update)
│   ├── timeline.md                   # Append-only change log
│   ├── social-analysis.md            # Latest social content analysis
│   └── snapshots/
│       ├── 2026-01.md                # Monthly snapshot
│       ├── 2026-02.md
│       └── 2026-03.md
├── competitor-b/
│   └── ...
└── landscape-summary.md              # Cross-competitor overview

# [Competitor Name] — Competitive Profile
**Last updated:** [date]
**Website:** [url]
**Tier:** [primary/secondary]
 
## Positioning
**Headline:** [their current tagline]
**Description:** [what they say they do]
**Target audience:** [who they sell to]
**Key value props:**
1. [value prop 1]
2. [value prop 2]
3. [value prop 3]
 
## Product
**Core features:**
- [feature 1]
- [feature 2]
- [feature 3]
 
**Recent launches:**
| Date | Feature | Description |
|------|---------|-------------|
| [date] | [feature] | [what it does] |
 
**Integrations:** [list]
 
## Pricing
| Tier | Price | Key Features |
|------|-------|-------------|
| [tier] | [price] | [features] |
 
**Model:** [per seat / per usage / flat rate]
**Free tier:** [yes/no]
 
## Social & Content
**Primary channels:** [where they post]
**Posting frequency:** [how often]
**Top themes:** [what they talk about]
**Best-performing content:** [topics/formats that get engagement]
 
## Market Position
**Funding:** [total raised, last round]
**Team size:** [approximate]
**Key customers:** [logos]
**Recent reviews sentiment:** [positive/mixed/negative]
 
## Our Positioning vs. Them
**Where we win:** [differentiators]
**Where they win:** [their advantages]
**Whitespace:** [areas neither covers well]

# [Competitor Name] — Change Timeline
 
## 2026-03-05 — Pricing Change
**What changed:** Dropped starter tier from $99/mo to $49/mo
**Previous:** $99/mo for starter plan
**Current:** $49/mo for starter plan
**Significance:** High
**Our interpretation:** Likely losing deals at the entry level. Competing on price suggests
they can't compete on value at this tier. We should NOT match — instead, emphasize what
our $99 tier includes that their $49 doesn't.
 
---
 
## 2026-02-20 — Feature Launch
**What changed:** Launched AI-powered analytics dashboard
**Previous:** Manual reporting only
**Current:** AI-generated insights from campaign data
**Significance:** Medium
**Our interpretation:** Closing a gap we had. Our analytics are still deeper, but the
"AI-powered" positioning is compelling. Consider adding AI framing to our analytics messaging.
 
---
 
## 2026-01-15 — Positioning Shift
**What changed:** Homepage tagline changed from "Simple outreach tool" to "Enterprise-grade outreach platform"
**Previous:** "Simple outreach tool"
**Current:** "Enterprise-grade outreach platform"
**Significance:** High
**Our interpretation:** Moving upmarket. Will start competing for enterprise deals. Their
product may not back this claim yet — watch for enterprise feature launches. This opens
up the "simple/easy" positioning for us or other competitors at the SMB tier.

updated_profiles: [
  {
    competitor: string
    profile_path: string
    timeline_path: string
    changes_logged: integer
    snapshot_saved: boolean
  }
]

competitor_scans: [...]               # From Step 1
your_company: {
  positioning: string
  tagline: string
  differentiators: string[]
  pricing: string
  features: string[]
  icp: string
  channels: string[]
}
timelines: [...]                      # Historical change data from profiles

competitive_analysis: {
  positioning_map: {
    players: [ { name: string, audience: string, promise: string, price_tier: string, motion: string, differentiator: string } ]
    collision_risks: string[]
    positioning_gaps: string[]
  }
 
  feature_gaps: {
    your_advantages: [ { feature: string, competitors_lacking: string[] } ]
    parity_features: [ { feature: string, note: string } ]
    their_advantages: [ { feature: string, who_has_it: string[], recommendation: string } ]
    whitespace: [ { opportunity: string, description: string } ]
  }
 
  pricing_landscape: {
    your_position: string
    dynamics: string[]
    recommendations: string[]
  }
 
  social_analysis: {
    competitor_strengths: [ { competitor: string, strength: string, evidence: string } ]
    your_content_gaps: string[]
    format_opportunities: string[]
    topics_to_own: string[]
    topics_to_enter: string[]
  }
 
  trend_patterns: [
    { pattern: string, implication: string, recommendation: string }
  ]
}

competitive_analysis: { ... }        # From Step 3
your_company: { ... }                # From config
changes_detected: [...]              # From Step 1

Current positioning: "[your current tagline]"
Recommended adjustment: "[suggested new framing]"
Rationale: "[why, based on competitive data]"
Urgency: [high/medium/low]

Angle: "[competitive angle name]"
When to use: "[which campaigns or call types]"
Messaging: "[specific copy suggestion]"
Proof point: "[evidence to back it up]"
Replace: "[what this replaces in current outreach]" or "New addition"

recommendations: {
  positioning: [
    {
      priority: "high" | "medium" | "low"
      current: string
      recommended: string
      rationale: string
      triggered_by: string            # Which competitive change triggered this
    }
  ]
 
  messaging_angles: [
    {
      angle_name: string
      when_to_use: string
      messaging: string
      proof_point: string
      replaces: string | null
      triggered_by: string
    }
  ]
 
  pricing: [
    {
      recommendation: string
      rationale: string
      urgency: string
      triggered_by: string
    }
  ]
 
  content: [
    {
      recommendation: string
      topic_or_format: string
      rationale: string
      effort: "low" | "medium" | "high"
    }
  ]
 
  product: [
    {
      recommendation: string
      type: "build" | "position_around" | "double_down" | "stop_leading_with"
      rationale: string
    }
  ]
}

# Competitive Strategy Report — [Date]
**Period covered:** [last scan date] to [current date]
**Competitors tracked:** [count]
 
---
 
## Executive Summary
 
**Market movement:** [2-3 sentences on what competitors did this period]
**Biggest threat:** [The most significant competitive change and what it means]
**Biggest opportunity:** [The gap or weakness you should exploit]
**Top recommendation:** [Single most impactful thing to do]
 
---
 
## Changes Since Last Review
 
| Date | Competitor | Change | Significance | Our Response |
|------|-----------|--------|-------------|-------------|
| [date] | [name] | [what changed] | [H/M/L] | [recommended action] |
 
---
 
## Competitive Landscape
 
### Positioning Map
| Player | Audience | Promise | Price Tier | Motion | Differentiator |
|--------|----------|---------|-----------|--------|---------------|
| **You** | [who] | [what] | [tier] | [motion] | [what] |
| [Comp] | [who] | [what] | [tier] | [motion] | [what] |
 
### Feature Comparison
| Feature | You | Comp A | Comp B | Status |
|---------|-----|--------|--------|--------|
| [feature] | [Y/N] | [Y/N] | [Y/N] | [advantage/parity/gap] |
 
### Pricing Landscape
| Player | Entry | Mid | Enterprise | Model |
|--------|-------|-----|-----------|-------|
| [name] | [price] | [price] | [price] | [model] |
 
---
 
## Competitor Deep Dives
 
### [Competitor A] — [Tier]
**What they did this period:** [summary]
**Key changes:** [list]
**Their strengths:** [what they're good at]
**Their weaknesses:** [where they struggle]
**Threat level:** [high/medium/low] — [why]
**Our positioning vs. them:** [how to differentiate]
 
[Repeat per competitor]
 
---
 
## Social & Content Intelligence
 
### What's Working for Competitors
| Competitor | Top Topic | Format | Engagement | Takeaway |
|-----------|-----------|--------|-----------|----------|
| [name] | [topic] | [format] | [level] | [what to learn] |
 
### Content Gaps & Opportunities
| Opportunity | Description | Effort | Impact |
|------------|-------------|--------|--------|
| [topic/format] | [why it's an opportunity] | [L/M/H] | [L/M/H] |
 
### Your Content vs. Theirs
| Dimension | You | Best Competitor | Gap |
|-----------|-----|----------------|-----|
| Posting frequency | [X/week] | [Y/week] | [behind/ahead] |
| Top engagement topic | [topic] | [topic] | [overlap/different] |
| Format diversity | [formats] | [formats] | [assessment] |
 
---
 
## Strategic Recommendations
 
### Positioning & Messaging
1. **[Recommendation]** — [Priority]
   Triggered by: [what happened]
   Action: [specific thing to do]
 
### Outreach Angle Updates
| # | Angle | When to Use | Copy Suggestion |
|---|-------|------------|-----------------|
| 1 | [angle name] | [context] | "[specific messaging]" |
 
### Pricing
1. **[Recommendation]** — [urgency]
 
### Content & Social
1. **[Recommendation]** — [effort level]
 
### Product
1. **[Recommendation]** — [type]
 
---
 
## Trends Over Time
 
[Analysis of patterns from timeline data across multiple review periods]
 
| Pattern | Period Observed | Direction | Implication |
|---------|----------------|-----------|------------|
| [trend] | [since when] | [accelerating/stable/slowing] | [what it means] |
 
---
 
## Action Items
 
| # | Action | Owner | Deadline | Category |
|---|--------|-------|----------|----------|
| 1 | [action] | [who] | [when] | Messaging |
| 2 | [action] | [who] | [when] | Content |
| 3 | [action] | [who] | [when] | Product |

[Executive Summary rendered]
 
---
 
Key changes detected: X across Y competitors
High-significance changes: Z
 
Top 3 recommended actions:
1. [Messaging] — [action + trigger]
2. [Content] — [action + trigger]
3. [Positioning] — [action + trigger]
 
Full report includes:
- Competitor deep dives with profile updates
- Feature gap analysis
- Pricing landscape comparison
- Social content intelligence
- Timeline trend analysis
- Specific messaging angle suggestions
 
View the full report? Or act on a specific recommendation?