{ "id": "aiidiots.operating-map.v1", "lastReviewed": "2026-06-25", "humanTwin": "/map", "source": "src/data/routeTaxonomy.ts", "note": "Machine-readable projection of the same route taxonomy used by the human operating map. Read this when choosing a route by job, use-when, action, and proof.", "machineRouteMap": [ { "lane": "start-here", "label": "Start Here", "mentalModel": "The onboarding runway: choose your fighter, build your rig, run a first mission that proves the setup works.", "rooms": [ { "route": "/", "useWhen": "You have no context yet and need the three-way split before anything else.", "primaryAction": "Pick the job that matches your problem and take that door.", "proof": "You leave with a chosen lane, not a tour.", "status": "live" }, { "route": "/about", "useWhen": "A human lands cold and wants the shape before the depth.", "primaryAction": "Read the orientation, then jump to the lane you need.", "proof": "You can name the six lanes and where you sit.", "status": "live" }, { "route": "/install", "useWhen": "You have no agent running yet, or no durable place for it to live.", "primaryAction": "Run the install, then the handoff prompt that makes the agent finish its own setup.", "proof": "An agent that answers where you already are — phone and chat, not a babysat terminal.", "status": "live" }, { "route": "/firstbrain", "useWhen": "The agent did the job once and woke up with amnesia.", "primaryAction": "Hand it the boot sequence and starter files — memory as a few files, not a database.", "proof": "It wakes up as someone and remembers the world.", "status": "live" }, { "route": "/path", "useWhen": "You want the ordered route through the map, not the map itself.", "primaryAction": "Walk the stations; take the express doors if you already know where you are.", "proof": "Every station is a real room on this site, walked to — not asserted.", "status": "live" } ] }, { "lane": "doctrine", "label": "Doctrine", "mentalModel": "The constitution of the loop: command, contracts, gates, receipts, and the failure modes each one prevents.", "rooms": [ { "route": "/informed-command", "useWhen": "An agent runs long and unattended and you cannot tell if it is alive or lying.", "primaryAction": "Adopt the three states, the filter, and the ten acceptance tests split into gates and judgment.", "proof": "You read status; you never haunt a transcript.", "status": "live" }, { "route": "/loop-contract", "useWhen": "You are about to hand an agent a long task with only a vibe to guide it.", "primaryAction": "Copy the nine-part loop harness and fill it in before the agent starts.", "proof": "A durable contract the next session can resume from cold.", "status": "live" }, { "route": "/playbooks", "useWhen": "One agent works and you want repeatable, durable runs you can trust unattended.", "primaryAction": "Lift a playbook and run it with its invariants intact.", "proof": "Each spec ships provenance and the invariants it enforces.", "status": "live" }, { "route": "/architecture", "useWhen": "You want to map your real setup onto the pillars and find the next durable-execution gap.", "primaryAction": "Trace a request through the system map; expand any pillar to see what it prevents.", "proof": "Every P-number and I-number cited anywhere resolves to the canonical index.", "status": "live" }, { "route": "/control-plane", "useWhen": "You have agents working across the day and ten transcripts instead of one console.", "primaryAction": "Adopt the control-plane surface; read fleet status instead of per-agent logs.", "proof": "An honest split of what is real versus on the horizon.", "status": "live" }, { "route": "/full-yolo", "useWhen": "You have a spicy autonomous idea and need it bounded before it touches anything real.", "primaryAction": "Wrap the idea in state, risk brakes, receipts, and a human gate before production.", "proof": "A loop that is high-agency on the inside and braked at every external edge.", "status": "live" }, { "route": "/build", "useWhen": "Your pieces came together by accident and you want to choose them deliberately.", "primaryAction": "Score your real stack against the sixteen pillars and see what rides on hope.", "proof": "A scorecard of which invariants your stack covers and which it does not.", "status": "live" }, { "route": "/gbrain", "useWhen": "Files stopped scaling and the agent needs memory that compounds, not a junk drawer.", "primaryAction": "Adopt the schema: what gets written, what gets promoted, what stays out of the brain.", "proof": "Memory that survives the window and gets smarter on a schedule.", "status": "live" }, { "route": "/solutions", "useWhen": "An agent is failing in a known way and you want the first safe move plus the durable fix.", "primaryAction": "Find your symptom, apply the fix pattern, demand the receipt the agent must produce.", "proof": "Symptoms, root cause, first safe move, fix, and the required receipt — per failure mode.", "status": "live" } ] }, { "lane": "tested-skills", "label": "Tested Skills", "mentalModel": "Not a catalog of shiny things. A test bench: what a skill claims, how it was tested, where it helped, where it lied, and the verdict.", "rooms": [ { "route": "/skills", "useWhen": "You are deciding whether a skill is worth installing and want the receipt, not the pitch.", "primaryAction": "Read the trial, copy the agent handoff, adopt or skip on the verdict.", "proof": "Each trial carries how-tested, before/after, failure modes, and adopt/trial/avoid/watch.", "status": "live" }, { "route": "/tools", "useWhen": "You are not sure which tool or model fits a job and keep forcing a favorite.", "primaryAction": "Read the card, including the one thing the tool is admittedly bad at.", "proof": "Every card is posture-labeled, affiliate-free, and names a real weakness.", "status": "live" } ] }, { "lane": "field-reports", "label": "Field Reports", "mentalModel": "The site's memory engine: scan history, cluster pain, convert raw agent and human frustration into public-safe reports, then promote durable rules.", "rooms": [ { "route": "/field-reports", "useWhen": "You want to see how this site turns scars into reusable rules, or where the next lesson sits.", "primaryAction": "Read the backlog clusters; follow one from raw pain to promoted doctrine.", "proof": "A labeled seed backlog of agent-work pain clusters, public-safe by construction.", "status": "live" }, { "route": "/notes", "useWhen": "You want the published, edited lessons rather than the raw backlog.", "primaryAction": "Read a note; lift the lesson up front and the rule it became.", "proof": "Each note carries the incident, the fix, and the operating rule.", "status": "live" }, { "route": "/diagrams", "useWhen": "You learn a failure faster by seeing it drawn than by reading it.", "primaryAction": "Read the diagram for the failure mode you keep hitting.", "proof": "One diagram per pillar question, drawn from real incidents.", "status": "live" }, { "route": "/workbench", "useWhen": "You want to see what is actively cooking, not the finished doctrine.", "primaryAction": "Scan the latest bench entries for what is in flight.", "proof": "A dated, append-only log — no retroactive tidying.", "status": "live" } ] }, { "lane": "labs", "label": "Labs / Machines", "mentalModel": "Each lab is a machine with inputs, outputs, receipts, and a verdict — an intelligence intake, a money attempt, a shipping loop — not a junk drawer of business-ish pages.", "rooms": [ { "route": "/labs", "useWhen": "You want to understand the applied experiments as machines, not browse them blind.", "primaryAction": "Pick the machine whose input matches what you have and read its loop.", "proof": "Each machine declares input, output, receipt, and verdict.", "status": "live" }, { "route": "/podcastu", "useWhen": "You want distilled, agent-usable wisdom mined from podcasts and essays.", "primaryAction": "Filter the feed, raise the signal floor, export an agent study pack.", "proof": "Paraphrased distillations with public sources — never quotes or transcripts.", "status": "live" }, { "route": "/profit", "useWhen": "You want the public money ledger and the teardown of each attempt.", "primaryAction": "Read the current attempt, its probability to clear the bar, and the next lift.", "proof": "A public ledger that must improve probability or payout over the prior pass.", "status": "live" }, { "route": "/product-loop", "useWhen": "You shipped once but cannot make shipping a repeatable motion.", "primaryAction": "Run the loop; each step leaves its receipt and names how it goes wrong.", "proof": "Shipping as a cycle with a receipt per step, not a one-off.", "status": "live" }, { "route": "/ecosystem", "useWhen": "You are choosing a platform to build on and need to rate it before you ship.", "primaryAction": "Rate the tool agent-friendly, agent-tolerant, or agent-hostile before committing.", "proof": "A rubric and the lived map of where agents move well and where they hit walls.", "status": "live" } ] }, { "lane": "for-agents", "label": "For Agents", "mentalModel": "A persistent utility surface, not another content section. A fresh agent fetches it and knows where to go next.", "rooms": [ { "route": "/for-agents", "useWhen": "You are an agent about to touch files, tools, money, accounts, or production.", "primaryAction": "Apply AII first, route by state, then open the room your job needs.", "proof": "A state router, route briefs with gates and receipts, and the field-report router.", "status": "live" }, { "route": "/map", "useWhen": "You need the full map sorted by job, with a use-when and a proof per room.", "primaryAction": "Find the lane that matches the problem; each room states its one move and its receipt.", "proof": "One taxonomy object serves the human map and the machine route map — no drift.", "status": "live" } ] } ] }