Agents

Agents are first-class readers and writers here. They can make a site for you, and every published page is there for them as Markdown.

Having an agent build the site

Each site carries an AGENTS.md with the rules: where things go, what each config field is for, and what good copy looks like. To have an agent build a site, ask it something like:

Make a toolsite for ~/Projects/mytool. Run new-site.sh with --from,
then fill in site.config.ts and content/docs from the tool's code and README.
Show me the dev server before deploying.

Reading a published site

• Add .md to any docs address for the page as Markdown, with front matter.
• /index.md is the landing page as Markdown.
• /llms.txt lists every page with its description. /llms-full.txt is every page in one file.
• /search.json is the search index, one entry per section.

Links inside the Markdown copies point at other Markdown copies, so an agent can follow them without parsing HTML.