{
  "id": "agent-search-optimization",
  "title": "AIIdiots agent-search optimization loop",
  "lastReviewed": "2026-06-13",
  "purpose": "Research how agents discover, search, fetch, and reuse AIIdiots so the site improves for agents and humans together.",
  "principle": "Optimize for useful agent answers, not keyword stuffing. Every route should help a human understand the work and help an agent execute it.",
  "trackedIntentBuckets": [
    "durable-agent-control",
    "llms-entrypoint",
    "agent-search-infrastructure",
    "transcript-to-agent-lesson",
    "field-report-twin-output"
  ],
  "discoverySurfaces": [
    "/llms.txt",
    "/agent-context.md",
    "/agent-routes.json",
    "/agent-search-optimization.json",
    "/agent-analytics.json",
    "/agent-discovery-score.json",
    "/podcast-research-loop.json",
    "/field-report-routing.json"
  ],
  "loop": [
    "observe",
    "classify",
    "route",
    "publish",
    "learn"
  ],
  "signalsUsed": [
    "aggregate Vercel Web Analytics panels for pages, referrers, country, OS, browser, and custom events",
    "Vercel AI Bots managed ruleset in Log mode for known AI crawler visibility",
    "AIIdiots server-side agent signal endpoint for artifact opens that may not execute browser JavaScript",
    "AIIdiots Agent Discovery Score for doctrine-path discovery",
    "Podcast U source mining when an episode teaches how agents search or retrieve"
  ],
  "hardGates": [
    "no raw prompts",
    "no transcript text in analytics payloads",
    "no IP address storage",
    "no raw user-agent storage",
    "no identity/account/email payloads",
    "no fabricated demand claims"
  ],
  "expectedOutput": [
    "route/content updates",
    "machine-readable manifest updates",
    "field reports for reusable ASO lessons",
    "paired agent lessons when behavior changes"
  ]
}