competitor-diff

name	competitor-diff
description	Daily competitor-watch loop for {{watch_list}}. Fetches each tracked page, diffs it against the last run's stored snapshot, filters cosmetic edits from meaningful ones, and posts a short summary to {{slack_channel}} — or nothing on a quiet day.

Watch competitor sites, changelogs, and pricing pages without turning into an alert firehose. A daily cron re-prompts a persistent session that fetches each page on the watch list, diffs it against the stored snapshot from the previous run, filters out cosmetic noise, and posts a short summary of what actually changed to {{slack_channel}}. On a day nothing moved, the channel stays quiet.

Proactive and schedule-driven; read-only against the public web, with a single Slack channel as the only output.

- The daily cron fires the competitor-watch run. - A human asks for a manual check of the watch list. - The watch list itself needs updating (a competitor added, dropped, or a tracked page's URL changed).

Step 0 — Orient and resume

cat .kortix/memory/competitor-watch-log.md 2>/dev/null || echo "(no ledger yet — first run)"

Read the last snapshot recorded for each tracked page. If this is the first run ever, there is nothing to diff against — fetch, store the snapshot, and skip reporting (nothing to compare yet).

Step 1 — Load the watch list

The watch list lives in {{watch_list}} (competitor name → URL, one per line, e.g. Acme — pricing: https://acme.com/pricing). Treat it as the source of truth for exactly which pages to fetch this run — no more, no less.

Step 2 — Fetch each tracked page

Fetch every URL in the watch list over plain HTTP(S) GET. No auth, no credentials — these are public pages.

curl -sL --max-time 20 "$URL"

If a fetch fails (timeout, 404, page moved), note it in the ledger as a blocker for next run rather than failing the whole sweep.

Step 3 — Normalize before comparing

Strip what varies without meaning anything: nav, footer, ads, timestamps, session-specific query params, whitespace. Reduce each page to its meaningful text content (main content area, changelog entries, pricing table rows) before computing a diff or hash.

Step 4 — Diff against the last snapshot

Compare the normalized content to the snapshot stored in .kortix/memory/competitor-watch-log.md for that URL. A byte-identical normalized page is "no change" — move on without reporting it.

Step 5 — Filter cosmetic from meaningful

Not every text diff is worth a Slack message. Report:

• A pricing tier, price point, or plan name that changed.
• A new changelog entry or shipped feature.
• A rewritten headline, tagline, or positioning statement on a landing page.

Drop:

• Typo fixes, formatting, reflowed layout with the same words.
• Date/time stamps, view counts, or other page furniture.
• Reordering of existing content with no wording change.

When in doubt whether a diff is meaningful, err toward including it — under-reporting defeats the point of the watch.

Step 6 — Compose and post the summary

One message to {{slack_channel}} per run:

• Something changed: a short bullet per meaningful change — competitor, what changed, and the page it happened on. Keep it scannable, not a raw diff dump.
• Nothing changed: a single brief line ("No meaningful competitor changes today.") or skip the post entirely per the project's preference — never post per-page "no change" noise.

Step 7 — Update the ledger

Update .kortix/memory/competitor-watch-log.md with today's normalized snapshot for every fetched page (so the next run has something to diff against) and a dated log line of what was reported or skipped.

Lives at `.kortix/memory/competitor-watch-log.md`. Every run updates, per tracked URL: the competitor name, the URL, the normalized snapshot (or a hash of it) from this run, and the timestamp it was fetched. Below that, dated **Run log** entries with what was reported to {{slack_channel}} (or "quiet — no meaningful changes") and any fetch failures to retry next time. - **Read-only against the web.** GET requests to public pages only — no login, no credentials, no write of any kind to any external site. - **One output surface.** {{slack_channel}} is the only place this agent writes. It has no access to internal systems and takes no action beyond posting the summary. - **No noise.** Cosmetic edits are filtered before they ever reach a human; only pricing, feature, and messaging changes are worth a message. - **Watch list is code.** Changes to which competitors/pages are tracked go through the watch-list file and a reviewed change request, not an ad hoc edit mid-run. - **Secrets scoped.** If a future watch-list page needs auth, that credential is encrypted in the secrets manager and injected at runtime — scoped to this agent's grant. (None are needed today.)