opencode-skills-collection 3.1.0 → 3.1.2

package/bundled-skills/competitor-analysis/references/example-research.md

@@ -0,0 +1,130 @@
+# Example Competitor Research File
+
+## Contents
+- [Template](#template) — full worked example for a fictional "Rival Co"
+- [Field Rules](#field-rules) — frontmatter fields, body section order, mention/findings format
+- [Writing via Bash Heredoc](#writing-via-bash-heredoc) — required pattern for subagents to avoid permission prompts
+
+Each enrichment subagent writes one markdown file per competitor to `{OUTPUT_DIR}/{competitor-slug}.md`, where `{OUTPUT_DIR}` is the per-run Desktop directory set up by the main agent in Step 0 (e.g., `~/Desktop/acme_competitors_2026-04-23/`). The YAML frontmatter contains structured fields for report/matrix compilation. The body contains per-section research plus aggregated mentions and benchmarks.
+
+## Template
+
+```markdown
+---
+competitor_name: Rival Co
+website: https://rivalco.com
+tagline: The fastest way to give your agents the web
+positioning: Developer-first web search API
+product_description: Web search & retrieval API for AI agents and RAG pipelines
+target_customer: AI engineers, RAG/agent teams, SaaS companies
+pricing_model: Usage-based + seat tiers
+pricing_tiers: Free (1K searches) | Pro $99/mo | Scale $499/mo | Enterprise Contact
+key_features: web search API | neural/semantic search | site crawler | reranking | live crawl
+integrations: LangChain | LlamaIndex | Python SDK | TypeScript SDK
+headquarters: San Francisco, CA
+founded: 2023
+employee_estimate: 11-50
+funding_info: Seed, $5M (2024)
+strategic_diff: Similar retrieval API; weaker neural relevance, but cheaper entry tier
+---
+
+## Product
+Web search and retrieval API for AI agents. Exposes a REST search endpoint with both
+keyword and semantic/neural modes, plus a site crawler and live-crawl fallback.
+Positioned at AI engineers building RAG and agent pipelines.
+
+## Pricing
+- Free: 1K searches/month, 1 API key
+- Pro ($99/mo): 100K searches, reranking, basic support
+- Scale ($499/mo): 1M searches, neural search, live crawl, higher rate limits
+- Enterprise: custom pricing, SSO, dedicated support
+
+## Features
+- Keyword + neural/semantic search modes
+- Site crawler with scheduled recrawls
+- Result reranking and content highlights
+- Live-crawl fallback for fresh pages
+- REST API with JSON responses
+- Python and TypeScript SDKs
+
+## Positioning
+Marketing emphasizes "AI-native" and developer-first DX. Landing page hero:
+"Give your agents the web." Targets solo devs through mid-market AI teams.
+
+## Comparison vs {user_company}
+- **Overlaps**: Web search API, neural search mode, crawler, LangChain integration
+- **Gaps**: No dedicated research/answer endpoint, weaker neural relevance benchmarks, no news endpoint
+- **Where they win**: Lower entry price ($99 vs $199), simpler pricing tiers
+- **Where you win**: Stronger neural relevance (per public benchmarks), research API, larger integration ecosystem
+
+## Mentions
+- **[Benchmark]** retrieval-quality leaderboard — Rival Co 73% nDCG@10, 4th of 7 tested (source: https://github.com/example-org/search-bench/pull/92, 2026-03-14)
+- **[Comparison]** Exa vs Rival Co — side-by-side review (source: https://example.com/exa-vs-rivalco, 2026-02-01)
+- **[Reddit]** r/LangChain thread: "Moved from Rival Co to X after relevance issues" — 24 upvotes (source: https://reddit.com/r/LangChain/comments/abc123)
+- **[HN]** "Show HN: Rival Co raises seed to build..." — 112 points, 48 comments (source: https://news.ycombinator.com/item?id=12345)
+- **[LinkedIn]** CEO post on product launch — 412 reactions (source: https://linkedin.com/posts/rivalco-launch)
+- **[YouTube]** "Rival Co vs Exa" review by Dev YouTuber — 8.2K views (source: https://youtube.com/watch?v=xyz)
+- **[News]** TechCrunch coverage of seed round (source: https://techcrunch.com/2024/11/rival-co-seed)
+- **[Review]** G2 4.3/5 (31 reviews), main complaint: stale results (source: https://g2.com/products/rival-co)
+
+## Benchmarks
+- **search-bench PR #92** — Rival Co 73% nDCG@10 on retrieval quality, 4th of 7 tested (https://github.com/example-org/search-bench/pull/92)
+- **retrieval-latency blog** — Rival Co 480ms p50, 2nd fastest (https://example.com/search-latency-2026)
+
+## Research Findings
+- **[high]** Usage-based pricing starts at $99/mo for 100K searches (source: rivalco.com/pricing)
+- **[high]** Series seed, $5M raised Nov 2024 (source: TechCrunch)
+- **[medium]** CEO LinkedIn emphasizes AI-agent use cases (source: linkedin.com/in/rivalco-ceo)
+- **[low]** Possibly a team under 20 based on careers page (source: rivalco.com/careers)
+
+## Battle Card
+
+### Landmines
+- **Rival Co scores 73% nDCG@10 on the search-bench leaderboard (4th of 7 tested)** — use against relevance-sensitive prospects; they rank below Exa on the same test. (source: https://github.com/example-org/search-bench/pull/92)
+- **G2 average 4.3/5 with "stale results" as top complaint across 31 reviews** — cite when prospect raises freshness concerns. (source: https://g2.com/products/rival-co)
+
+### Objection Handlers
+- If they say: "Rival Co is $99/mo — cheaper than your Pro tier"
+  You say: "Cheaper upfront, but compare total cost of poor relevance — their 73% nDCG@10 means more irrelevant results your agent has to filter or re-query, and re-queries aren't free." (evidence: https://github.com/example-org/search-bench/pull/92)
+
+### Talk Tracks
+1. For RAG pipelines where relevance drives answer quality, Exa ships a neural index and a dedicated research/answer endpoint as table stakes; Rival Co has neither in their 2024 product set.
+```
+
+## Field Rules
+
+- **YAML frontmatter**: All structured fields go here. Extracted for matrix + CSV compilation.
+- **`pricing_tiers`**: Pipe-separated (`|`) with tier name + short price. `compile_report.mjs` parses on `|` for the matrix view.
+- **`key_features`**, **`integrations`**: Pipe-separated lists.
+- **`strategic_diff`**: One-line summary (shown in overview table).
+- **Body sections**: `## Product`, `## Pricing`, `## Features`, `## Positioning`, `## Comparison vs {user_company}`, `## Mentions`, `## Benchmarks`, `## Research Findings`, `## Battle Card` (deep/deeper modes only; synthesized by the Battle lane after fact-check).
+- **Mentions format**: `- **[SourceType]** title | snippet (source: url, date)` — `SourceType` is one of `Benchmark`, `Comparison`, `News`, `Reddit`, `HN`, `LinkedIn`, `YouTube`, `Review`, `Podcast`, `X`.
+- **Findings format**: `- **[confidence]** fact (source: url)` — `confidence` is `high`, `medium`, or `low`.
+- **Filename**: `{OUTPUT_DIR}/{competitor-slug}.md` where slug is lowercase, hyphenated.
+
+## Writing via Bash Heredoc
+
+Subagents write these files using bash heredoc to avoid security prompts. Use the full literal `{OUTPUT_DIR}` path — no `~` or `$HOME`:
+
+```bash
+cat << 'COMPETITOR_MD' > {OUTPUT_DIR}/rival-co.md
+---
+competitor_name: Rival Co
+website: https://rivalco.com
+...
+---
+
+## Product
+...
+
+## Pricing
+...
+
+## Mentions
+- **[Benchmark]** ...
+COMPETITOR_MD
+```
+
+Use `'COMPETITOR_MD'` (quoted) as the delimiter to prevent shell variable expansion.
+
+**IMPORTANT**: Write ALL competitor files in a SINGLE Bash call using chained heredocs to minimize permission prompts.

package/bundled-skills/competitor-analysis/references/report-template.html

@@ -0,0 +1,127 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>Competitor Analysis — {{TITLE}}</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
+<style>
+  :root {
+    --brand: #F03603;
+    --blue: #4DA9E4;
+    --green: #90C94D;
+    --amber: #F4BA41;
+    --black: #100D0D;
+    --gray: #514F4F;
+    --border: #edebeb;
+    --bg: #F9F6F4;
+    --card: #ffffff;
+    --text: #100D0D;
+    --muted: #514F4F;
+    --high: #5a8a1a;
+    --low: #F03603;
+  }
+  * { margin: 0; padding: 0; box-sizing: border-box; }
+  body { font-family: Inter, -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif; background: var(--bg); color: var(--text); line-height: 1.6; font-size: 16px; }
+  .container { max-width: 1200px; margin: 0 auto; padding: 2rem 1.5rem; }
+
+  header { margin-bottom: 2rem; display: flex; align-items: center; justify-content: space-between; }
+  .header-left h1 { font-size: 1.5rem; font-weight: 600; margin-bottom: 0.25rem; color: var(--black); }
+  .header-left .meta { color: var(--muted); font-size: 0.875rem; }
+
+  nav.views { display: flex; gap: 0.5rem; margin-bottom: 2rem; }
+  nav.views a { background: var(--card); border: 1px solid var(--border); border-radius: 4px; padding: 0.5rem 0.875rem; font-size: 0.8125rem; color: var(--muted); text-decoration: none; font-weight: 500; }
+  nav.views a:hover { border-color: var(--brand); color: var(--brand); }
+  nav.views a.active { background: var(--brand); color: #fff; border-color: var(--brand); }
+
+  .summary { display: flex; gap: 0.75rem; margin-bottom: 2rem; flex-wrap: wrap; }
+  .stat { background: var(--card); border: 1px solid var(--border); border-radius: 4px; padding: 1rem 1.25rem; flex: 1; min-width: 140px; }
+  .stat .label { font-size: 0.6875rem; text-transform: uppercase; letter-spacing: 0.05em; color: var(--muted); font-weight: 600; margin-bottom: 0.25rem; }
+  .stat .value { font-size: 1.5rem; font-weight: 700; color: var(--black); }
+
+  /* Strategic win/loss cards */
+  .strategic { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; margin-bottom: 2rem; }
+  @media (max-width: 720px) { .strategic { grid-template-columns: 1fr; } }
+  .strategic .card { background: var(--card); border: 1px solid var(--border); border-radius: 4px; padding: 1.25rem; }
+  .strategic .card.win { border-left: 3px solid var(--high); }
+  .strategic .card.loss { border-left: 3px solid var(--low); }
+  .strategic h3 { font-size: 0.9375rem; font-weight: 600; margin-bottom: 0.125rem; color: var(--black); display: flex; align-items: center; gap: 0.5rem; }
+  .strategic h3 .badge { font-size: 0.6875rem; font-weight: 700; padding: 2px 8px; border-radius: 999px; }
+  .strategic h3 .badge.win { background: rgba(144,201,77,0.12); color: #5a8a1a; border: 1px solid rgba(144,201,77,0.3); }
+  .strategic h3 .badge.loss { background: rgba(240,54,3,0.08); color: var(--low); border: 1px solid rgba(240,54,3,0.2); }
+  .strategic .sub { font-size: 0.8125rem; color: var(--muted); margin-bottom: 0.75rem; }
+  .strategic .prose { font-size: 0.9375rem; line-height: 1.6; color: var(--text); margin: 0.5rem 0 0; }
+  .strategic ul { list-style: none; }
+  .strategic li { padding: 0.375rem 0; font-size: 0.875rem; border-top: 1px solid var(--border); display: flex; justify-content: space-between; align-items: baseline; gap: 0.75rem; }
+  .strategic li:first-child { border-top: 0; }
+  .strategic li .who { color: var(--muted); font-size: 0.75rem; white-space: nowrap; }
+  .strategic .empty { color: var(--muted); font-size: 0.8125rem; padding: 0.5rem 0; }
+
+  .results-table { width: 100%; border-collapse: collapse; background: var(--card); border: 1px solid var(--border); border-radius: 4px; overflow: hidden; margin-bottom: 2rem; }
+  .results-table th { text-align: left; font-size: 0.6875rem; text-transform: uppercase; letter-spacing: 0.05em; color: var(--muted); font-weight: 600; padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); background: #fafafa; }
+  .results-table td { padding: 0.75rem 1rem; border-bottom: 1px solid var(--border); font-size: 0.875rem; vertical-align: top; }
+  .results-table tr:last-child td { border-bottom: none; }
+  .results-table tr:hover { background: #fdfcfb; }
+  .results-table a { color: var(--brand); text-decoration: none; font-weight: 500; }
+  .results-table a:hover { text-decoration: underline; }
+  .muted-line { color: var(--muted); font-size: 0.75rem; display: block; margin-top: 2px; }
+
+  .pill { display: inline-block; font-size: 0.6875rem; font-weight: 600; padding: 2px 8px; border-radius: 999px; margin-right: 4px; margin-bottom: 3px; }
+  .pill-feature { background: rgba(77,169,228,0.12); color: #2172a3; border: 1px solid rgba(77,169,228,0.3); }
+
+  footer { margin-top: 3rem; padding-top: 1.5rem; border-top: 1px solid var(--border); display: flex; align-items: center; justify-content: center; gap: 0.5rem; font-size: 0.75rem; color: var(--muted); }
+  footer a { color: var(--brand); text-decoration: none; font-weight: 500; }
+  footer a:hover { text-decoration: underline; }
+</style>
+</head>
+<body>
+<div class="container">
+  <header>
+    <div class="header-left">
+      <h1>{{TITLE}}</h1>
+      <div class="meta">{{META}}</div>
+    </div>
+    <a href="https://browserbase.com" target="_blank" rel="noopener" style="display:flex;align-items:center;gap:0.5rem;text-decoration:none;color:var(--muted);font-size:0.8125rem;font-weight:500;">
+      <span>Powered by Browserbase</span>
+      <svg width="32" height="32" viewBox="0 0 100 100" fill="none" xmlns="http://www.w3.org/2000/svg"><rect width="100" height="100" rx="8" fill="#F03603"/><path d="M36 72.2222V27.7778H51.2381C57.5873 27.7778 62.6667 32.8571 62.6667 39.2063V41.746C62.6667 44.6667 61.5873 47.3968 59.7461 49.3651C62.2858 51.4603 63.9366 54.6349 63.9366 58.254V60.7936C63.9366 67.1428 58.8572 72.2222 52.508 72.2222H36ZM42.3493 65.873H52.508C55.3651 65.873 57.5873 63.6508 57.5873 60.7936V58.254C57.5873 55.3968 55.3651 53.1746 52.508 53.1746H42.3493V65.873ZM42.3493 46.8254H51.2381C54.0953 46.8254 56.3175 44.6032 56.3175 41.746V39.2063C56.3175 36.3492 54.0953 34.127 51.2381 34.127H42.3493V46.8254Z" fill="white"/></svg>
+    </a>
+  </header>
+
+  <nav class="views">
+    <a href="index.html" class="active">Overview</a>
+    <a href="matrix.html">Matrix</a>
+    <a href="mentions.html">Mentions</a>
+  </nav>
+
+  <div class="summary">
+    <div class="stat"><div class="label">Competitors</div><div class="value">{{TOTAL}}</div></div>
+    <div class="stat"><div class="label">Mentions</div><div class="value">{{MENTION_COUNT}}</div></div>
+    <div class="stat"><div class="label">Benchmarks</div><div class="value">{{BENCHMARK_COUNT}}</div></div>
+    <div class="stat"><div class="label">With Pricing</div><div class="value">{{WITH_PRICING}}</div></div>
+  </div>
+
+  {{STRATEGIC_SUMMARY}}
+
+  <table class="results-table">
+    <thead>
+      <tr>
+        <th>Competitor</th>
+        <th>Positioning</th>
+        <th>Pricing</th>
+        <th>Key Features</th>
+        <th>Strategic Diff</th>
+      </tr>
+    </thead>
+    <tbody>
+      {{TABLE_ROWS}}
+    </tbody>
+  </table>
+</div>
+
+<footer>
+  <svg width="16" height="16" viewBox="0 0 100 100" fill="none" xmlns="http://www.w3.org/2000/svg"><rect width="100" height="100" rx="8" fill="#F03603"/><path d="M36 72.2222V27.7778H51.2381C57.5873 27.7778 62.6667 32.8571 62.6667 39.2063V41.746C62.6667 44.6667 61.5873 47.3968 59.7461 49.3651C62.2858 51.4603 63.9366 54.6349 63.9366 58.254V60.7936C63.9366 67.1428 58.8572 72.2222 52.508 72.2222H36ZM42.3493 65.873H52.508C55.3651 65.873 57.5873 63.6508 57.5873 60.7936V58.254C57.5873 55.3968 55.3651 53.1746 52.508 53.1746H42.3493V65.873ZM42.3493 46.8254H51.2381C54.0953 46.8254 56.3175 44.6032 56.3175 41.746V39.2063C56.3175 36.3492 54.0953 34.127 51.2381 34.127H42.3493V46.8254Z" fill="white"/></svg>
+  Generated by <a href="https://github.com/anthropics/skills">competitor-analysis</a> · Powered by <a href="https://browserbase.com">Browserbase</a>
+</footer>
+</body>
+</html>

package/bundled-skills/competitor-analysis/references/research-patterns.md

@@ -0,0 +1,217 @@
+# Competitor Analysis — Research Patterns
+
+## Contents
+- [Overview](#overview) — two research contexts (self vs target)
+- [Self-Research (User's Company)](#self-research-users-company) — sub-questions, page discovery, synthesis output (precise_category, include keywords, exclusion list)
+- [Competitor Research — 4 Research Lanes](#competitor-research--4-research-lanes) — Marketing / External / Benchmarks / Strategic Diff
+- [Depth Mode Behavior](#depth-mode-behavior) — quick / deep / deeper budgets and scope
+- [Finding Format (per lane)](#finding-format-per-lane) — JSON shape, confidence levels
+- [Research Loop Rules](#research-loop-rules) — 7 meta-rules for the research phase
+- [Synthesis Instructions](#synthesis-instructions) — turn findings into matrix cells
+
+## Overview
+
+Two research contexts:
+1. **Self-Research** (Step 1) — Deep research on the user's company so we know what "competitor" means for this run.
+2. **Competitor Research** (Step 4) — For each discovered/seeded competitor, run the 4-lane enrichment below.
+
+Both use the Plan → Research → Synthesize pattern. Self-research is identical in shape to the one in `company-research`, so profiles can be reused across skills.
+
+## Self-Research (User's Company)
+
+### Sub-Questions
+- "What does {company} sell and what specific problem does it solve?"
+- "Who are {company}'s existing customers? What industries, company sizes, use cases?"
+- "Who are {company}'s known competitors? What category do they compete in?"
+- "What pricing model does {company} use?"
+- "What features, integrations, and differentiators does {company}'s marketing emphasize?"
+
+### Page Discovery
+Dynamic via sitemap — do NOT hardcode `/about` or `/pricing`:
+1. `browse cloud fetch --allow-redirects "{company website}/sitemap.xml"` — primary source
+2. Scan for URLs with keywords: `pricing`, `customer`, `compare`, `vs`, `about`, `features`, `integrations`
+3. Optionally fetch `/llms.txt` for page descriptions
+4. Pick 3-5 most relevant URLs
+
+### External Research
+- `browse cloud search "{company} alternatives competitors vs"`
+- `browse cloud search "{company} review comparison"`
+- Fetch 1-2 most informative third-party pages
+
+### Synthesis Output
+Produce a profile with:
+- **Company**, **Product**, **Existing Customers**, **Competitors** (seed list), **Use Cases**
+- **precise_category** — one clear sentence that describes what category this product competes in. Avoid fuzzy words like "tools" or "platform". Good: "AI web search API for agents with neural + keyword retrieval". Bad: "search tools". This becomes the anchor for discovery queries and the gate.
+- **category_include_keywords** — 8-15 phrases that a *direct competitor's* marketing would very likely contain (title or hero). Include semantic variants. e.g. for Exa: `web search api`, `search api`, `neural search`, `semantic search`, `retrieval api`, `search for ai agents`, `search for llms`, `serp api`, `embeddings search`, `live crawling`, `answer api`, `research api`.
+- **exclusion_list** — phrases that indicate a *different* category, used by the gate to reject false positives. e.g. `vector database`, `enterprise search appliance`, `site search widget`, `observability`, `analytics platform`, `data warehouse`, `scraping platform` (full ETL/scraping suites, not retrieval APIs), `internal knowledge base`.
+
+The same `profiles/{company-slug}.json` shape used by `company-research`, extended with the three new fields. The `competitors` array becomes the seed list and the first inputs to the comparison-graph expansion in Step 3.
+
+---
+
+## Competitor Research — 4 Research Lanes
+
+For each competitor, run these four lanes (depth-gated):
+
+### Lane 1 — Marketing Surface (ALL depth modes)
+Goal: extract what the competitor says about themselves from their own site.
+
+**Sub-questions**:
+- "What does {competitor} sell, who is it for, and how is it positioned?"
+- "What are {competitor}'s pricing tiers and pricing model?"
+- "What key features, integrations, and platforms does {competitor} list?"
+
+**Pages to fetch** (via sitemap discovery — do NOT hardcode):
+1. Homepage
+2. `/pricing` (or equivalent from sitemap)
+3. `/features`, `/product`, `/platform`, `/solutions`
+4. `/integrations`, `/customers`, `/case-studies`
+
+**Extract into frontmatter fields**: `tagline`, `positioning`, `product_description`, `target_customer`, `pricing_model`, `pricing_tiers`, `key_features`, `integrations`.
+
+### Lane 2 — External Signal (deep + deeper)
+Goal: what the rest of the internet says about them.
+
+**Sub-questions**:
+- "What third-party comparison pages mention {competitor}?"
+- "What do users say on Reddit, HN, G2, Capterra?"
+- "What recent news, launches, or announcements?"
+- "Who is talking about them on LinkedIn or YouTube?"
+
+**Search queries**:
+```
+"{competitor} vs"
+"{competitor} alternatives"
+"{competitor} review"
+"{competitor} G2" / "{competitor} Capterra"
+"site:reddit.com {competitor}"
+"site:news.ycombinator.com {competitor}"
+"site:linkedin.com/posts {competitor}"
+"site:youtube.com {competitor}"
+"{competitor} launch 2025 OR 2026"
+"{competitor} funding announcement"
+```
+
+**Extraction rule**: From search results, harvest each hit as a `Mentions` entry. Classify source type from the URL:
+- `reddit.com` → `Reddit`
+- `news.ycombinator.com` → `HN`
+- `linkedin.com` → `LinkedIn`
+- `youtube.com` / `youtu.be` → `YouTube`
+- `g2.com` / `capterra.com` / `trustradius.com` → `Review`
+- `*vs*` in path or title → `Comparison`
+- news domains (techcrunch, theverge, venturebeat, forbes, businesswire, globenewswire) → `News`
+- `twitter.com` / `x.com` → `X`
+- `spotify.com/episode` / transistor/simplecast → `Podcast`
+
+For LinkedIn and YouTube, the snippet + URL from `browse cloud search` is enough. Do NOT try to deep-fetch individual LinkedIn posts (auth walls) — list them with title/snippet.
+
+### Lane 3 — Public Benchmarks (deeper only)
+Goal: find third-party benchmarks that measured this competitor's product.
+
+**Sub-questions**:
+- "Has {competitor} been included in any public benchmark?"
+- "Are there GitHub repos, PRs, or blog posts comparing {competitor} head-to-head on a measured axis (speed, accuracy, cost, pass rate)?"
+
+**Search queries**:
+```
+"{competitor} benchmark"
+"{competitor} performance test"
+"site:github.com {competitor} benchmark"
+"site:github.com {competitor} vs"
+"{competitor} vs {seed_competitor} benchmark"   # pairwise, use another known competitor as the seed
+"{category} benchmark {competitor}"             # e.g. "web search api benchmark {competitor}"
+```
+
+**Extraction**: Add each hit to `Benchmarks` section with: title, source, URL, key finding (one line). Also mirror into `Mentions` with type `Benchmark`.
+
+**Known benchmark repos to check directly** (if domain is on-topic):
+- Public retrieval-quality leaderboards (e.g. BEIR / MTEB-style repos) when a vendor publishes scores
+- Category-specific benchmark repos discovered via the first search wave
+
+### Lane 4 — Strategic Diff vs User's Company (deeper only)
+Goal: explicitly compare this competitor to the user's company.
+
+**Inputs**: `{user_company_profile}` (from Step 1) — specifically `product`, `use_cases`, `key_features` if available.
+
+**Sub-questions**:
+- "What features does {competitor} have that {user_company} does not?"
+- "What features does {user_company} have that {competitor} does not?"
+- "Who does {competitor} serve that {user_company} does not (and vice versa)?"
+- "Where does each one win on the marketing surface (price, feature depth, DX, ecosystem)?"
+
+**No new fetches required** for this lane — it's a synthesis step over Lane 1 + 2 + 3 findings plus the user's profile. Write as:
+
+```markdown
+## Comparison vs {user_company}
+- **Overlaps**: ...
+- **Gaps**: ...
+- **Where they win**: ...
+- **Where you win**: ...
+```
+
+Also populate the `strategic_diff` frontmatter field with a one-line summary for the overview table.
+
+---
+
+## Depth Mode Behavior
+
+### Quick Mode (~lots of competitors, cheap)
+- **Lanes**: 1 only
+- **Budget**: 2-3 tool calls per competitor (homepage + pricing page)
+- **Fields populated**: tagline, product_description, pricing_tiers, key_features
+- **Mentions / Benchmarks / Comparison**: skipped
+
+### Deep Mode (balanced, default)
+- **Lanes**: 1 + 2
+- **Budget**: 5-8 tool calls per competitor
+- **Everything in quick** + 5-10 mentions across source types
+
+### Deeper Mode (full intel)
+- **Lanes**: 1 + 2 + 3 + 4
+- **Budget**: 10-15 tool calls per competitor
+- **Everything in deep** + benchmarks section + strategic diff section
+
+---
+
+## Finding Format (per lane)
+
+Every finding is a factual statement tied to a source:
+
+```json
+{
+  "lane": "marketing | external | benchmark | strategic",
+  "fact": "Rival Co charges $99/mo for 10K search requests",
+  "sourceUrl": "https://rivalco.com/pricing",
+  "confidence": "high"
+}
+```
+
+**Confidence**:
+- `high`: Directly stated on the competitor's own website or official press
+- `medium`: Inferred from third-party articles, reviews, or job posts
+- `low`: Speculative / outdated sources
+
+## Research Loop Rules
+
+1. **Lane 1 first** — always start with the competitor's own site
+2. **Use sitemap, not hardcoded paths** — `/pricing` might be `/plans` or `/pricing-plans`
+3. **Rephrase, don't retry** — if a search returns generic junk, switch keywords
+4. **Fetch selectively** — pick the 1-2 most promising URLs per query
+5. **For LinkedIn/YouTube: search only, don't fetch** — snippet is enough, avoid auth walls
+6. **Respect step budget** per depth mode
+7. **Deduplicate mentions** — same URL should only appear once in `## Mentions`
+
+## Synthesis Instructions
+
+After the research loop completes for a competitor:
+
+1. Fill frontmatter fields from Lane 1 findings
+2. Write body sections: Product, Pricing, Features, Positioning (all from Lane 1)
+3. Append `## Mentions` from Lane 2 classified hits
+4. Append `## Benchmarks` from Lane 3 (deeper only)
+5. Append `## Comparison vs {user_company}` from Lane 4 synthesis (deeper only)
+6. Append `## Research Findings` as a raw-findings appendix with confidence tags
+
+No ICP score. No threat score. Pure intel.
+
+If a field has no supporting findings, leave it empty rather than guessing.