opensquid 0.5.395

package/packs/builtin/seo-aeo-expert/fixtures/meta-quality-gate/title_ok_pass.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": false
+}

package/packs/builtin/seo-aeo-expert/fixtures/meta-quality-gate/title_ok_pass.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "meta-title-length",
+  "event": {
+    "tool": "Write",
+    "args": {
+      "file_path": "src/app/layout.tsx",
+      "content": "export const metadata = { title: 'Raum Pilates | Englewood Cliffs' }"
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/page-removal-guard/rm_other_pass.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": false
+}

package/packs/builtin/seo-aeo-expert/fixtures/page-removal-guard/rm_other_pass.input.json

@@ -0,0 +1,6 @@
+{
+  "if": "removing",
+  "bindings": {
+    "removing": false
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/page-removal-guard/rm_page_fire.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": true
+}

package/packs/builtin/seo-aeo-expert/fixtures/page-removal-guard/rm_page_fire.input.json

@@ -0,0 +1,6 @@
+{
+  "if": "removing",
+  "bindings": {
+    "removing": true
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/pre-push-seo-checklist/checklist_fire.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": true
+}

package/packs/builtin/seo-aeo-expert/fixtures/pre-push-seo-checklist/checklist_fire.input.json

@@ -0,0 +1,7 @@
+{
+  "if": "pushing && st == \"validated\"",
+  "bindings": {
+    "pushing": true,
+    "st": "validated"
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/pre-push-seo-checklist/checklist_shipped_pass.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": false
+}

package/packs/builtin/seo-aeo-expert/fixtures/pre-push-seo-checklist/checklist_shipped_pass.input.json

@@ -0,0 +1,7 @@
+{
+  "if": "pushing && st == \"validated\"",
+  "bindings": {
+    "pushing": true,
+    "st": "shipped"
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/pre-push-seo-checklist/push_fixing_fire.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": true
+}

package/packs/builtin/seo-aeo-expert/fixtures/pre-push-seo-checklist/push_fixing_fire.input.json

@@ -0,0 +1,7 @@
+{
+  "if": "pushing && (st == \"fixing\" || st == \"validating\")",
+  "bindings": {
+    "pushing": true,
+    "st": "fixing"
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/pre-push-seo-checklist/push_idle_pass.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": false
+}

package/packs/builtin/seo-aeo-expert/fixtures/pre-push-seo-checklist/push_idle_pass.input.json

@@ -0,0 +1,7 @@
+{
+  "if": "pushing && (st == \"fixing\" || st == \"validating\")",
+  "bindings": {
+    "pushing": true,
+    "st": "idle"
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/run.mjs

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+// Smoke-test harness for the seo-aeo-expert pack (spec §11 acceptance:
+// every rule ≥2 cases, trigger + non-trigger; exit non-zero on any failure).
+//
+// Two input shapes per case (fixtures/<skill>/<case>.input.json):
+//   1. Binding mode: { "if": "<expr>", "bindings": { ... } }
+//      — pre-computed bindings, evaluates the expression directly. Used for
+//      rules whose bindings come from match_command / read_fsm_state.
+//   2. Event mode:   { "rule": "<rule-id>", "event": { "tool": "...", "args": { ... } } }
+//      — loads ../skills/<skill>/skill.yaml, emulates every
+//      text_pattern_match step of that rule against the event (this
+//      exercises the REAL regexes), then evaluates the rule's final
+//      verdict/advance `if:`. Step `if:` gating is intentionally ignored
+//      (the verdict expression carries the logic), mirroring the
+//      sangmin-personal-rules fp-walk emulation.
+// Expected shape: { "verdict": true|false }.
+//
+// Invocation: node packs/builtin/seo-aeo-expert/fixtures/run.mjs
+
+import { readdir, readFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parse as parseYaml } from '/Users/slee/projects/loop/opensquid/node_modules/yaml/dist/index.js';
+import { evalCondition } from '/Users/slee/projects/loop/opensquid/dist/runtime/evaluator/expression/index.js';
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const SKILLS_DIR = join(dirname(HERE), 'skills');
+
+function bindingsToMap(obj) {
+  const m = new Map();
+  for (const [k, v] of Object.entries(obj || {})) m.set(k, v);
+  return m;
+}
+
+function readField(event, dottedField) {
+  if (!dottedField) return '';
+  return dottedField.split('.').reduce((acc, k) => (acc == null ? undefined : acc[k]), event) ?? '';
+}
+
+function matchPatterns(text, patterns) {
+  if (!text || typeof text !== 'string') return [];
+  const hits = [];
+  for (const p of patterns) {
+    try {
+      if (new RegExp(p, 'gi').test(text)) hits.push(p);
+    } catch {
+      /* invalid pattern — treated as no-match, same as runtime */
+    }
+  }
+  return hits;
+}
+
+async function evalEventCase(skillName, input) {
+  const skill = parseYaml(await readFile(join(SKILLS_DIR, skillName, 'skill.yaml'), 'utf8'));
+  const rule = (skill.rules || []).find((r) => r.id === input.rule);
+  if (!rule) throw new Error(`rule ${input.rule} not found in ${skillName}`);
+  const bindings = new Map();
+  let finalIf = null;
+  for (const step of rule.process || []) {
+    if (step.call === 'text_pattern_match' && step.as) {
+      const text = readField(input.event, step.args?.text_field);
+      bindings.set(step.as, { matched: matchPatterns(text, step.args?.patterns || []) });
+    }
+    if ((step.call === 'verdict' || step.call === 'advance_fsm') && step.if) finalIf = step.if;
+  }
+  if (!finalIf) throw new Error(`rule ${input.rule}: no verdict/advance if-expression`);
+  return evalCondition(finalIf, bindings);
+}
+
+async function loadFixturePairs(skillDir) {
+  const entries = await readdir(skillDir);
+  const cases = new Map();
+  for (const f of entries) {
+    const m = f.match(/^(.+)\.(input|expected)\.json$/);
+    if (!m) continue;
+    const [, name, kind] = m;
+    if (!cases.has(name)) cases.set(name, {});
+    cases.get(name)[kind] = JSON.parse(await readFile(join(skillDir, f), 'utf8'));
+  }
+  return [...cases.entries()].map(([name, pair]) => ({ name, ...pair }));
+}
+
+const skillDirs = (await readdir(HERE, { withFileTypes: true }))
+  .filter((d) => d.isDirectory())
+  .map((d) => d.name)
+  .sort();
+
+let total = 0;
+let pass = 0;
+for (const skillName of skillDirs) {
+  const pairs = await loadFixturePairs(join(HERE, skillName));
+  let sPass = 0;
+  const failures = [];
+  for (const { name, input, expected } of pairs) {
+    total++;
+    if (!input || !expected) {
+      failures.push(`${name}: missing input or expected`);
+      continue;
+    }
+    let got;
+    try {
+      got =
+        input.event !== undefined
+          ? await evalEventCase(skillName, input)
+          : evalCondition(input.if, bindingsToMap(input.bindings));
+    } catch (e) {
+      failures.push(`${name}: ERROR ${e.message}`);
+      continue;
+    }
+    if (got === expected.verdict) {
+      pass++;
+      sPass++;
+    } else {
+      failures.push(`${name}: expected=${expected.verdict} got=${got}`);
+    }
+  }
+  console.log(
+    `  ${failures.length === 0 ? 'PASS' : 'FAIL'} ${skillName}: ${sPass}/${pairs.length}`,
+  );
+  for (const f of failures) console.log(`    - ${f}`);
+}
+console.log(`=== TOTAL: ${pass}/${total} ===`);
+process.exit(pass === total ? 0 : 1);

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/lint_product_fire.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": true
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/lint_product_fire.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "schema-lint-product",
+  "event": {
+    "tool": "Write",
+    "args": {
+      "file_path": "src/components/ProductJsonLd.tsx",
+      "content": "{ \"@type\": \"Product\", \"name\": \"10-Class Reformer Pack\", \"offers\": { \"price\": \"450\" } }"
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/lint_product_pass.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": false
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/lint_product_pass.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "schema-lint-product",
+  "event": {
+    "tool": "Write",
+    "args": {
+      "file_path": "src/components/ProductJsonLd.tsx",
+      "content": "{ \"@type\": \"Product\", \"offers\": { \"price\": \"450\", \"priceValidUntil\": \"2026-12-31\" } }"
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/lint_rating_fire.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": true
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/lint_rating_fire.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "schema-lint-rating",
+  "event": {
+    "tool": "Edit",
+    "args": {
+      "file_path": "src/components/Reviews.tsx",
+      "new_string": "\"aggregateRating\": { \"ratingValue\": \"4.9\" }"
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/lint_rating_pass.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": false
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/lint_rating_pass.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "schema-lint-rating",
+  "event": {
+    "tool": "Edit",
+    "args": {
+      "file_path": "src/components/Reviews.tsx",
+      "new_string": "\"aggregateRating\": { \"ratingValue\": \"4.9\", \"reviewCount\": 27 }"
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/schema_touched_fire.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": true
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/schema_touched_fire.input.json

@@ -0,0 +1,12 @@
+{
+  "if": "(jsonld_w.matched.length > 0 || jsonld_e.matched.length > 0) && st == \"idle\"",
+  "bindings": {
+    "jsonld_w": {
+      "matched": ["application/ld\\+json"]
+    },
+    "jsonld_e": {
+      "matched": []
+    },
+    "st": "idle"
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/schema_touched_in_cycle_pass.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": false
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/schema_touched_in_cycle_pass.input.json

@@ -0,0 +1,12 @@
+{
+  "if": "(jsonld_w.matched.length > 0 || jsonld_e.matched.length > 0) && st == \"idle\"",
+  "bindings": {
+    "jsonld_w": {
+      "matched": ["application/ld\\+json"]
+    },
+    "jsonld_e": {
+      "matched": []
+    },
+    "st": "fixing"
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/validation_run_fire.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": true
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/validation_run_fire.input.json

@@ -0,0 +1,6 @@
+{
+  "if": "valrun",
+  "bindings": {
+    "valrun": true
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/validation_run_pass.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": false
+}

package/packs/builtin/seo-aeo-expert/fixtures/schema-validation-gate/validation_run_pass.input.json

@@ -0,0 +1,6 @@
+{
+  "if": "valrun",
+  "bindings": {
+    "valrun": false
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/ssr-regression-guard/fetch_effect_fire.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": true
+}

package/packs/builtin/seo-aeo-expert/fixtures/ssr-regression-guard/fetch_effect_fire.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "ssr-regression",
+  "event": {
+    "tool": "Write",
+    "args": {
+      "file_path": "src/app/staff/page.tsx",
+      "content": "useEffect(() => { fetch(\"/api/staff\").then(setStaff) }, [])"
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/ssr-regression-guard/organism_leaf_pass.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": false
+}

package/packs/builtin/seo-aeo-expert/fixtures/ssr-regression-guard/organism_leaf_pass.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "ssr-regression",
+  "event": {
+    "tool": "Edit",
+    "args": {
+      "file_path": "src/components/organisms/Header.tsx",
+      "new_string": "\"use client\";\nexport function Header() {}"
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/ssr-regression-guard/server_page_pass.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": false
+}

package/packs/builtin/seo-aeo-expert/fixtures/ssr-regression-guard/server_page_pass.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "ssr-regression",
+  "event": {
+    "tool": "Write",
+    "args": {
+      "file_path": "src/app/staff/page.tsx",
+      "content": "export default async function StaffPage() { const staff = await getStaff(); }"
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/ssr-regression-guard/use_client_page_fire.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": true
+}

package/packs/builtin/seo-aeo-expert/fixtures/ssr-regression-guard/use_client_page_fire.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "ssr-regression",
+  "event": {
+    "tool": "Edit",
+    "args": {
+      "file_path": "src/app/programs/page.tsx",
+      "new_string": "\"use client\";\nexport default function Page() {}"
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/stale-tactic-guard/clean_pass.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": false
+}

package/packs/builtin/seo-aeo-expert/fixtures/stale-tactic-guard/clean_pass.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "stale-tactic",
+  "event": {
+    "tool": "Write",
+    "args": {
+      "file_path": "src/app/page.tsx",
+      "content": "Boutique reformer pilates in Englewood Cliffs."
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/stale-tactic-guard/docs_exempt_pass.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": false
+}

package/packs/builtin/seo-aeo-expert/fixtures/stale-tactic-guard/docs_exempt_pass.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "stale-tactic",
+  "event": {
+    "tool": "Write",
+    "args": {
+      "file_path": "docs/specs/seo-plan.md",
+      "content": "Add an llms.txt file to boost AI citation visibility."
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/stale-tactic-guard/faq_schema_fire.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": true
+}

package/packs/builtin/seo-aeo-expert/fixtures/stale-tactic-guard/faq_schema_fire.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "stale-tactic",
+  "event": {
+    "tool": "Edit",
+    "args": {
+      "file_path": "src/components/organisms/FaqSection.tsx",
+      "new_string": "const jsonLd = { \"@type\": \"FAQPage\", mainEntity: [] }"
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fixtures/stale-tactic-guard/llms_claim_fire.expected.json

@@ -0,0 +1,3 @@
+{
+  "verdict": true
+}

package/packs/builtin/seo-aeo-expert/fixtures/stale-tactic-guard/llms_claim_fire.input.json

@@ -0,0 +1,10 @@
+{
+  "rule": "stale-tactic",
+  "event": {
+    "tool": "Write",
+    "args": {
+      "file_path": "src/app/blog/seo-tips/page.tsx",
+      "content": "Add an llms.txt file to boost AI citation visibility for the studio."
+    }
+  }
+}

package/packs/builtin/seo-aeo-expert/fsm.yaml

@@ -0,0 +1,43 @@
+# seo-aeo-expert ops lifecycle — audit → fix → validate → ship → measure as ONE
+# total FSM (spec §4.3). Makes "close the execution gap" mechanical: SEO-relevant
+# edits enter the cycle (fix_start), validation evidence advances it
+# (validation_passed), and the pre-push gate reads the state — push while
+# `fixing`/`validating` means unvalidated SEO work in flight.
+#
+# P0 wiring (deterministic only):
+#   fix_start          — fired by schema-validation-gate when JSON-LD is touched
+#   validation_passed  — fired when a schema-validation command runs (Bash)
+#   pushed             — fired by pre-push-seo-checklist from `validated`
+# audit_* / fixes_applied / validation_failed / measurement_logged transitions
+# are declared for the P1+ skills (cached_audit advance-on-proof, closed-loop
+# measurement) so the machine shape is stable across phases.
+#
+# Session-scoped (cleared at SessionEnd) — disciplines a working session; the
+# workgraph is the cross-session backlog (spec §4.4).
+initial: idle
+states:
+  - idle
+  - auditing
+  - audit_done
+  - fixing
+  - validating
+  - validated
+  - shipped
+  - measured
+transitions:
+  # Audit region (P1: profession-mode site audits)
+  - { from: '*', on: audit_start, to: auditing }
+  - { from: auditing, on: audit_complete, to: audit_done }
+  # Fix region — any SEO-relevant edit (re-)enters the fix cycle from anywhere,
+  # including validated/shipped (new fixes invalidate prior validation).
+  - { from: '*', on: fix_start, to: fixing }
+  - { from: fixing, on: fixes_applied, to: validating }
+  # Validation — P0 deterministic shortcut fires validation_passed straight
+  # from `fixing` (running the validator IS the P0 evidence proxy); P1 upgrades
+  # to exit-code/cached_audit proof via the `validating` station.
+  - { from: fixing, on: validation_passed, to: validated }
+  - { from: validating, on: validation_passed, to: validated }
+  - { from: validating, on: validation_failed, to: fixing }
+  # Ship + measure (closed loop, P3)
+  - { from: validated, on: pushed, to: shipped }
+  - { from: shipped, on: measurement_logged, to: measured }

package/packs/builtin/seo-aeo-expert/lessons/ai-mode-default-fanout/lesson.md

@@ -0,0 +1,16 @@
+# AI Mode is the default Google experience — optimize for query fan-out
+
+**Confidence: [H]** (Google primary sources)
+
+At I/O 2026 (2026-05-19) AI Mode became the global default Google Search
+experience (1B+ monthly users). Architecture per Google's own docs: RAG
+grounded in core Search ranking + **query fan-out** — one query expands into
+many concurrent sub-queries, each retrieving independently.
+
+**How to apply:** optimize pages to win fan-out _sub-queries_, not just head
+terms. Each self-contained section that fully answers one sub-question is a
+retrieval candidate. Coverage of the question-space around a topic beats one
+monolithic page targeting one phrase. See [[chunk-shape]].
+
+**Evidence:** https://developers.google.com/search/docs/fundamentals/ai-optimization-guide ·
+https://blog.google/products-and-platforms/products/search/search-io-2026/ (2026-05)

package/packs/builtin/seo-aeo-expert/lessons/bing-is-chatgpt/lesson.md

@@ -0,0 +1,15 @@
+# ChatGPT Search is (mostly) the Bing index — BWT is a prerequisite
+
+**Confidence: [H]** (multiple overlap studies)
+
+Seer (2026-04): **87% of ChatGPT citations match Bing top-10** (vs 56%
+Google top-10); earlier studies ~73%. ChatGPT Search = Bing index + its own
+OAI-SearchBot crawl + internal `web.run` fan-out queries.
+
+**How to apply:** for ChatGPT visibility, Bing indexing is table stakes —
+register Bing Webmaster Tools, submit sitemaps, fix Bing-side crawl issues,
+and check Bing rankings for priority queries. Bing Places matters for local
+([[local-ai-gap]]). Don't block Bingbot ([[bot-taxonomy-three-classes]]).
+
+**Evidence:** https://www.soci.ai/blog/how-to-rank-in-chatgpt-perplexity-and-google-ai-overview/ ·
+https://searchengineland.com/inside-chatgpt-search-web-run-fan-out-queries-ai-visibility-477339

package/packs/builtin/seo-aeo-expert/lessons/bot-taxonomy-three-classes/lesson.md

@@ -0,0 +1,21 @@
+# Three AI bot classes — know which one you are blocking
+
+**Confidence: [H]** (vendor primary docs)
+
+| Class           | Bots                                                                                                    | Blocking it means                                                                  |
+| --------------- | ------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| Training        | GPTBot, ClaudeBot, Google-Extended, Bytespider, Meta-ExternalAgent, CCBot                               | content not in future training sets — legitimate choice, NO search-visibility cost |
+| Search/citation | **OAI-SearchBot** (ChatGPT Search), **Claude-SearchBot**, **PerplexityBot**, **Bingbot**, **Googlebot** | removed from that engine's ANSWERS — total visibility loss there                   |
+| User-fetch      | ChatGPT-User, Perplexity-User                                                                           | live page fetches on user request fail                                             |
+
+Two traps: **Google-Extended does NOT control AI Overviews/AI Mode**
+(Googlebot does — blocking Google-Extended only affects Gemini Apps
+grounding). **GPTBot does not control ChatGPT Search** (OAI-SearchBot does);
+ChatGPT also dies with Bingbot because its index is Bing ([[bing-is-chatgpt]]).
+
+**How to apply:** never block a search/citation bot without an explicit
+business decision. Audit robots.txt AND the CDN layer
+([[cloudflare-default-block]]) — both can block independently.
+
+**Evidence:** https://developers.openai.com/api/docs/bots ·
+https://nohacks.co/blog/ai-user-agents-landscape-2026

package/packs/builtin/seo-aeo-expert/lessons/chunk-shape/lesson.md

@@ -0,0 +1,18 @@
+# Chunk shape: self-contained 200-400-word sections, answer-first
+
+**Confidence: [M]** (consistent practitioner consensus; no single gold-standard study)
+
+AI engines retrieve and cite at **passage level**. Working shape: one concept
+per heading-bounded section of ~200-400 words; **answer-first openings**
+(direct 1-3 sentence answer/definition before elaboration); minimal
+dependence on surrounding context; specific extractable facts (numbers,
+named entities, dates) inside the section. CMU-linked research: definition-
+first openings correlate with higher LLM "impression scores".
+
+**Google caveat:** Google's official guide says chunking is NOT needed for
+Google's systems ([[google-official-ai-guide]]) — this lesson is about
+ChatGPT/Perplexity/Claude retrieval, where it demonstrably helps. Write
+naturally for humans; structure so each section stands alone.
+
+**Evidence:** https://www.lumar.io/blog/best-practice/content-chunking-ai-extractability-geo-aeo-explainer/ ·
+https://www.kopp-online-marketing.com/ultimate-guide-for-llm-readability-optimization-and-better-chunk-relevance

package/packs/builtin/seo-aeo-expert/lessons/citation-over-rank/lesson.md

@@ -0,0 +1,19 @@
+# Get cited, not just ranked
+
+**Confidence: [H]** for CTR decline; **[M]** for the citation-compensation figure
+
+Every independent study finds CTR decline under AI answers: Pew (2025-07,
+real clickstream) — clicks fall 15%→8% of searches when an AI summary is
+present; Ahrefs — ~58% lower CTR for the #1 result under an AI Overview.
+But brands **cited inside** the AI answer earn ~35% more organic clicks
+(Seer Interactive, 53 brands / 5.47M queries). The strategic objective moved
+from "rank #1" to "be the cited source".
+
+**How to apply:** measure citation share on priority queries, not just rank.
+Content levers that earn citations: [[geo-content-levers]],
+[[mentions-beat-backlinks]]. Treat "93% zero-click" claims as vendor
+folklore — no independent panel backs that number.
+
+**Evidence:** https://www.pewresearch.org/short-reads/2025/07/22/google-users-are-less-likely-to-click-on-links-when-an-ai-summary-appears-in-the-results/ ·
+https://ahrefs.com/blog/ai-overviews-reduce-clicks-update/ ·
+https://www.seerinteractive.com/insights/aio-impact-on-google-ctr-september-2025-update