> ## Documentation Index
> Fetch the complete documentation index at: https://cofounder.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Competitor Move Detector

> Snapshots tracked competitors daily and flags meaningful changes in subtitle, keywords, version, rating, or pricing.

The agent snapshots every tracked competitor each run into `cofounder_competitor_snapshots`. The next run diffs today's snapshot against the previous one and surfaces meaningful changes.

## What counts as a "move"

Each diff is classified by significance:

| Field         | Significance                                                          |
| ------------- | --------------------------------------------------------------------- |
| `subtitle`    | High — usually deliberate ASO change                                  |
| `version`     | High — implies a release                                              |
| `keywords`    | High — direct ASO play                                                |
| `pricing`     | High (when [Pricing Intelligence](./pricing-intelligence) is enabled) |
| `rating`      | Medium — when changed by ≥ 0.1                                        |
| `description` | Low — only when length changed by > 30% (most edits are noise)        |

A competitor with **2+ changes** or **at least one high-significance change** is reported.

## What you see in the briefing

```
## 📡 Competitor Moves (since last run)
Acme Screenshots (123456789) — HIGH significance
    • subtitle: "Take amazing screenshots" → "AI-powered screenshot stitching"
    • version: "2.4.1" → "2.5.0"

PixelPro (987654321) — MEDIUM significance
    • description: "1840 chars" → "2580 chars"
    • rating: 4.2 → 4.4
```

## In the structured report

The `competitorMoves` array of `DailyReport` contains entries shaped like:

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "competitorAppId": "123456789",
  "competitorName": "Acme Screenshots",
  "changeType": "metadata_update",
  "description": "Acme rebranded subtitle around AI; shipped v2.5.0 same day.",
  "significance": "high"
}
```

These are LLM-summarized so you don't have to parse the raw diff yourself.

## Why this matters

Competitors don't broadcast ASO changes. By the time you notice, they've already been ranking for new keywords for weeks. Daily snapshots + auto-diff give you **first-day awareness** of:

* Subtitle pivots (often signal a positioning change)
* Keyword field changes (direct ASO move you may want to defend against)
* Sudden version cadence (release pace shifts)
* Pricing changes (margin pressure or experiment)

## Storage

Snapshots are kept indefinitely so you can run historical diffs (e.g., "show me every subtitle Acme has shipped this year"). They're scoped by `(owner_email, app_id, competitor_id, country, snapshot_date)`.