Example design review: serve recipes to agents by URL

What the Design review page recipe produced for an open question: how an agent that isn't connected yet can fetch a recipe. Three options, one recommendation.

The problem

Recipes live in a onecell cell. A person can open them, and a connected agent can read them over MCP. But the moment that matters most is before an agent is connected: onboarding, a link in a chat, or a new teammate's first session. Agent setup already solves this for its own instructions: /agent-setup/prompt.md is plain Markdown any agent can fetch. Recipes have no equivalent.

Goals

Not a goal: serving private documents by URL. Only what is deliberately published as public.

Options

OptionHowForAgainst
A. Public pages onlyPublish each recipe; link /p/<slug>No code; works todayHTML pages are heavy for agents to read, and the copyable prompt is buried in markup
B. Markdown files in the reporecipes/*.md served like agent-setup/prompt.mdVersioned in git; same pattern as agent setupTwo copies of every recipe, the cell and the repo, which will drift
C. Markdown for any public page (recommended)A route serves /p/<slug>.md from the published document through documentToMarkdownOne source; every public document gains an agent-readable form; embeds become linksDepends on publishing; the route must check visibility exactly as /p/<slug> does
flowchart LR
  C["Recipe written in the recipes cell"] -->|"publish as public"| P["Published document"]
  P --> H["/p/slug for people"]
  P --> M["/p/slug.md for agents"]
  S["agent-setup/prompt.md"] -->|"links the recipes index"| M
  A["Agent with no connection"] -->|"fetches"| M
Option C: one published document, two forms. Agent setup links the recipes index, so a new agent can find a recipe before it is connected.

Risks

Effort

Small: one route handler, a test for visibility, and a line in agent-setup/prompt.md. The Markdown export and the public resolver already exist.