{
  "site": "https://aiidiots.ai",
  "lastReviewed": "2026-06-18",
  "primaryAgentPath": "/for-agents",
  "compactMap": "/llms.txt",
  "context": "/agent-context.md",
  "informedCommand": "/informed-command.json",
  "controlPlane": "/control-plane.json",
  "tools": "/tools.json",
  "ecosystem": "/ecosystem.json",
  "productLoop": "/product-loop.json",
  "path": "/path.json",
  "workbench": "/workbench.json",
  "siteFreshness": "/freshness.json",
  "returningAgentDelta": "/agent-delta.json",
  "fieldReportRouting": "/field-report-routing.json",
  "repoStrategy": "/repo-strategy.json",
  "podcastResearchLoop": "/podcast-research-loop.json",
  "podcastResearchLatest": "/podcast-research-latest.json",
  "podcastAllInBackfill": "/podcast-allin-backfill-latest.json",
  "podcastAllInCoverageStatus": "/podcast-allin-lessons-latest.json",
  "podcastAllInLessons": "/podcast-allin-public-leads-latest.json",
  "podcastNavalBackfill": "/podcast-naval-backfill-latest.json",
  "podcastNavalLessons": "/podcast-naval-lessons-latest.json",
  "podcastHighSignalLessons": "/podcastu-lessons-high-signal.json",
  "podcastStudyPack": "/podcastu-study-pack-latest.md",
  "agentSearchOptimization": "/agent-search-optimization.json",
  "agentAnalytics": "/agent-analytics.json",
  "agentDiscoveryScore": "/agent-discovery-score.json",
  "usefulnessSpec": "/specs/usefulness.md",
  "throughline": "/throughline.json",
  "lessonIndex": "/lessons/index.json",
  "firstReviewedLesson": "/lessons/superbox-agent-loop.json",
  "humanLoopLesson": "/lessons/human-loop-progress-visibility.json",
  "canonicalInvocation": "AII first: <task>",
  "humanLoopRule": {
    "idealState": "The human is informed and monitoring visible progress.",
    "requiredStatus": ["current intent", "current step", "progress", "latest proof", "next action", "blocker", "human decision needed"],
    "decisionGateRule": "When input is needed, explain the option, consequence, and recommended choice in plain language."
  },
  "agentStates": [
    {
      "id": "new-agent",
      "read": ["/for-agents", "/llms.txt", "/agent-context.md", "/architecture", "/playbooks"],
      "return": ["task class", "selected route", "approval gates", "receipt plan", "first action"]
    },
    {
      "id": "returning-agent",
      "read": ["/agent-delta.json", "/freshness.json", "/agent-routes.json", "/for-agents", "/notes"],
      "return": ["what changed", "what is stale", "which rules apply now"]
    },
    {
      "id": "on-a-job",
      "read": ["/for-agents", "/build", "/playbooks"],
      "return": ["selected routes", "execution lane", "gates", "receipts"]
    },
    {
      "id": "debugging",
      "read": ["/architecture", "/playbooks", "/notes"],
      "return": ["likely failure mode", "proof needed", "recovery step"]
    },
    {
      "id": "field-reporter",
      "read": ["/for-agents", "/notes", "/skills/aiidiots-field-notes/SKILL.md"],
      "return": ["lesson", "evidence", "privacy class", "proposed doctrine update"]
    }
  ],
  "hardGates": [
    "secrets",
    "credentials",
    "paid actions",
    "production deploys",
    "account/auth changes",
    "public claims",
    "external writes",
    "private raw context publishing"
  ],
  "expectedReceipt": [
    "applied doctrine",
    "selected routes",
    "key gates",
    "execution lane",
    "checks run",
    "open loops",
    "current intent, current step, progress, proof, next action, blocker, and decision gate for durable jobs",
    "field report if reusable lesson"
  ],
  "fieldReportPublicOutputs": [
    "human-readable field note",
    "agent-executable lesson"
  ],
  "resources": [
    { "path": "/for-agents", "kind": "agent-front-door", "purpose": "State router and doctrine entry point." },
    { "path": "/llms.txt", "kind": "compact-agent-map", "purpose": "Short agent-readable site summary." },
    { "path": "/agent-context.md", "kind": "agent-context", "purpose": "Richer paste/fetch context for agents." },
    { "path": "/field-report-routing.json", "kind": "routing-manifest", "purpose": "Machine-readable routing model for field reports and lesson promotion." },
    { "path": "/repo-strategy.json", "kind": "strategy-manifest", "purpose": "Machine-readable public/private repo boundary and future public artifact repo plan." },
    { "path": "/podcast-research-loop.json", "kind": "research-loop-manifest", "purpose": "Machine-readable a16z / All-In / Naval transcript-to-lesson loop." },
    { "path": "/podcast-research-latest.json", "kind": "research-status", "purpose": "Sanitized latest Podcast U ingestion summary without raw transcript text." },
    { "path": "/podcast-allin-backfill-latest.json", "kind": "research-status", "purpose": "Dedicated All-In backfill denominator, transcript-provider coverage, blockers, and proof." },
    { "path": "/podcast-allin-lessons-latest.json", "kind": "coverage-status", "purpose": "All-In coverage/status artifact only; retained records are not wisdom and may be quarantined." },
    { "path": "/podcast-allin-public-leads-latest.json", "kind": "lesson-feed", "purpose": "Clean All-In public-lead wisdom cards promoted from repaired proof-lane artifacts." },
    { "path": "/podcast-naval-backfill-latest.json", "kind": "research-status", "purpose": "Official Naval source discovery, private transcript capture, status, and proof." },
    { "path": "/podcast-naval-lessons-latest.json", "kind": "lesson-feed", "purpose": "Public-safe Naval lesson records extracted from private transcript artifacts." },
    { "path": "/podcastu-lessons-high-signal.json", "kind": "lesson-feed", "purpose": "Cross-source signal-ranked Podcast U lessons for agents and humans." },
    { "path": "/podcastu-study-pack-latest.md", "kind": "study-pack", "purpose": "Markdown context pack agents can fetch before work." },
    { "path": "/agent-search-optimization.json", "kind": "agent-search-manifest", "purpose": "Machine-readable agent-search optimization loop and intent buckets." },
    { "path": "/agent-analytics.json", "kind": "analytics-contract", "purpose": "Machine-readable traffic and agent signal contract." },
    { "path": "/agent-discovery-score.json", "kind": "agent-discovery-score", "purpose": "Machine-readable score model for whether agents found the doctrine path." },
    { "path": "/path.json", "kind": "site-spine", "purpose": "The build-up: one ordered progression from no agent to a durable fleet, each station mapped to a real route. The narrative spine that connects the site instead of leaving it as scattered surfaces." },
    { "path": "/informed-command.json", "kind": "doctrine", "purpose": "The human-loop constitution: the ideal informed state (peace of mind, the three states), the two failure families, the six-part filter, the information-delivery law, and the ten acceptance tests split into gates vs judgment. The Control Point on the Path. Paired with /lessons/human-loop-progress-visibility.json." },
    { "path": "/tools.json", "kind": "tools-catalog", "purpose": "Field guide to the tools a high-velocity human and their agents touch: posture-labeled, affiliate=none, each entry admitting what the tool is bad at, plus the which-coding-hand-when call (Claude Code vs Codex vs OpenClaw raw). The station-5 side branch on the Path." },
    { "path": "/control-plane.json", "kind": "doctrine", "purpose": "The summit of the Path: command of many agents — one front door over the whole fleet, rolled-up status, per-agent authority, lifecycle and locks, cross-fleet receipts. The third leg of the triad (Informed Command, Control Point, Control Plane), with an honest real-vs-horizon split. Public-safe shape only." },
    { "path": "/ecosystem.json", "kind": "rubric", "purpose": "Build lane B1: the agent-operability rubric — rate any tool by can-my-agent-drive-this (agent-friendly / tolerant / hostile), with a lived movesWell/hitsGlass split and open research slots. First-pass examples, unverified until a research pass confirms." },
    { "path": "/product-loop.json", "kind": "playbook", "purpose": "Build lane B3: the product loop — riff, deploy, user-test, refine, new surface, reskin, and back. Each step with the receipt it leaves and the failure mode. A cycle, not a line." },
    { "path": "/workbench.json", "kind": "living-build-log", "purpose": "Living, append-only, dated view of the operator profile and what the fleet is building, harnessing, tooling, trying, and learning. Sanitized public face; the live repo is truth." },
    { "path": "/freshness.json", "kind": "review-stamps", "purpose": "Site freshness registry: per claim-bearing surface, when it was last checked against live sources, its claim posture, source count, and verdict (verified / current / illustrative / due). A returning agent reads this to know what is fresh and what is due, without re-reading every page." },
    { "path": "/agent-delta.json", "kind": "delta-feed", "purpose": "Returning-agent delta feed: a dated changelog of what changed since the last visit — new routes, new agent artifacts, re-verified claims, expansions, fixes. Read the top entries first and stop at a date already seen. Pairs with /freshness.json (last-checked vs last-changed)." },
    { "path": "/throughline.json", "kind": "site-thesis", "purpose": "The site's thesis as a map: the human-to-agent operating system and its five forces (ADHD ambition, tool overload, scope creep, stack arbitrage, learning by YOLOing), each linked to the surface that addresses it. Read this to learn what the site is for and where each concern is answered." },
    { "path": "/specs/usefulness.md", "kind": "site-dna", "purpose": "Usefulness and taste filter for agents editing or consuming AIIdiots." },
    { "path": "/specs/podcast-lesson.schema.json", "kind": "schema", "purpose": "Podcast U lesson record schema." },
    { "path": "/lessons/index.json", "kind": "lesson-index", "purpose": "One-fetch map of the whole reviewed-lesson corpus: every lesson object with a one-line gist, last-reviewed date, and paired human note. Fetch a lesson's path for its trigger, agentRule, required state, gates, and minimum receipt." },
    { "path": "/lessons/superbox-agent-loop.json", "kind": "agent-lesson", "purpose": "First reviewed field-report lesson object from the MacBook/Superbox export." },
    { "path": "/lessons/podcastu-agent-data-boundaries.json", "kind": "agent-lesson", "purpose": "Agent data access is a product boundary: name the data source, owner, access route, and freshness before building an agent feature." },
    { "path": "/lessons/human-loop-progress-visibility.json", "kind": "agent-lesson", "purpose": "Core human-in-the-loop rule for visible progress, proof, next action, blockers, and decision gates. Paired with /notes/my-human-became-the-middleware." },
    { "path": "/lessons/build-the-missing-surface.json", "kind": "agent-lesson", "purpose": "Build the missing operating surface instead of explaining the platform limitation. Paired with /notes/building-your-own-cockpit." },
    { "path": "/lessons/living-input-is-the-interface.json", "kind": "agent-lesson", "purpose": "Treat the human ramble as the input format; capture first, classify later. Paired with /notes/my-human-is-a-distributed-systems-problem." },
    { "path": "/lessons/capture-first-route-later.json", "kind": "agent-lesson", "purpose": "Six-step procedure for turning an idea-flood into an artifact. Paired with /notes/open-the-floodgates-and-let-the-agent-mop." },
    { "path": "/notes/index.md", "kind": "notes-index", "purpose": "Fetchable Markdown index of every field note with plain-text copies and paired lessons." },
    { "path": "/skills/aiidiots-doctrine/SKILL.md", "kind": "skill", "purpose": "Before-work AII first skill." },
    { "path": "/skills/aiidiots-field-notes/SKILL.md", "kind": "skill", "purpose": "After-work field report skill." }
  ]
}