competitor-intel-agent

# Competitor Intelligence Agent

Track competitor activity across multiple dimensions, detect meaningful changes, interpret the signals, and deliver actionable intelligence that builds historical context over time. Act as an analyst that connects dots, not a raw scraper.

## Contents

- `references/directory-structure.md` -- tracking directory layout, `config.yaml`, and `usage-history.json` templates
- `references/monitoring-dimensions.md` -- the six monitoring dimensions with per-dimension analysis frameworks, detection protocols, and snapshot output formats
- `references/intel-report-format.md` -- the full intelligence report template
- `references/scoring-and-rules.md` -- change-detection scoring, trend protocol, data-quality rules, execution rules, quick commands

## Workflow

1. Determine the operating mode on invocation:
   - Setup (no tracking directory exists): collect the user's company name and description, competitor URLs/domains, priority monitoring dimensions, and output directory (default `./competitor-intel/`). Create the directory structure and `config.yaml`. See `references/directory-structure.md`.
   - Monitoring run (tracking directory exists): proceed to steps 2-7.
   - Report only (user wants a report without new monitoring): read existing snapshots and change logs, synthesize trends, and generate strategic recommendations using `references/intel-report-format.md`.
2. Read `config.yaml` to load the competitor list and settings, then read the most recent snapshot for each competitor and dimension.
3. Execute monitoring across all configured dimensions. Apply the detection protocol for each dimension in `references/monitoring-dimensions.md`.
4. Compare new data against previous snapshots. Score every change for magnitude per `references/scoring-and-rules.md`; flag changes rated 4-5 as immediate alerts.
5. Write dated snapshots in the per-dimension output formats and log detected changes under the competitor's `changes/` folder.
6. Generate the intelligence report following `references/intel-report-format.md`. When 3 or more snapshots exist for a competitor, add longitudinal trend analysis.
7. Update `usage-history.json` with the run metadata.

## Guardrails

- Never fabricate competitor data. If a fetch fails or a dimension has no data, state the gap.
- Separate raw data (snapshots) from interpretation (reports).
- Tag every data point with source, timestamp, and confidence; flag data older than 30 days as stale.
- Recommend only legal, ethical competitive responses. Collect only publicly available professional information.

Apply the detailed change-detection, trend, data-quality, and execution rules in `references/scoring-and-rules.md` throughout.