EssaySimon Willison

Catch-up — Make Your Product Readable by Agents, Not Just People

A documented format that agents can construct is a product interface, even when it is just a URL.

Sources used2 references for this edition
  1. 01Simon Willison: LaTeX tool inspired by Tiny Little Officeindependent analysis · Oct 15, 2026
  2. 02Tiny Little Office llms.txtprimary · Oct 15, 2026
What actually happened
  • Simon Willison reports that Tiny Little Office stores document data in the URL fragment, making each document a bookmarkable, shareable link.
  • Willison reports that Tiny Little Office provides an llms.txt file explaining how agents can construct document-rendering URLs.
  • Tiny Little Office describes itself as an office suite whose documents live entirely in links and are made by writing a URL.
  • Tiny Little Office says links should remain under 2,000 characters and warns that hand-written links receive no checks.
The read

Catch-up written 24 October 2026 for 2026-10-15; covers a source published 2026-10-15.

So what

Products become easier to adopt in agent workflows when the machine-readable instructions and the shareable output use the same simple contract.

Use this

Choose one feature and document the exact input or URL shape an agent should create. Include examples, limits, and a check for malformed output.

Put it to work 30 minutes

An agent-readable feature contract with two worked examples

Write a one-page llms.txt for one feature: what it does, the exact URL or input format, two worked examples, and the length or validation limits.

See a worked example

Use a real, bounded workflow and record unknowns rather than estimating them. Keep the result small enough to review with a teammate.

Workflow or decision
A real workflow the team repeats each week.
Evidence to record
Quality, time, cost, failures, and reviewer notes.
Decision rule
Keep the current approach unless the agreed checks pass.

Your turn

Name the exact case you will test.

List the observations needed to make the decision.

Write what the evidence will make you do.

Check your work

Mark only what you have checked. You can save unfinished work.

Your draft stays in this browser. No account needed.

What could make this wrong

Fragment-stored documents are only as private as the link. The llms.txt says a hand-written link is checked by nothing, so agents can still produce broken documents.

Confidence · medium

Reported facts and quotations were checked against the named sources; the recommended exercise is editorial guidance to test in your own context.

Revisit · Nov 6, 2026

Can an agent create a valid, shareable result from the instructions alone?

Watch: Successful results from both worked examples · Malformed links or inputs produced by an agent

Keep Going

Product Builders newsletter

Get the Daily Brief by email.

One useful signal, practical exercises, and news from the builder community, when there is something worth sending.

Your email goes to Kit. Confirm the email Kit sends you to start receiving it. Unsubscribe whenever you like. Privacy.