Give every repo an llms.txt in one pass
Most teams discover their site is illegible to agents only when an agent gets it wrong — a summary that misses the point, a citation to a page that doesn’t say what the agent claims. The fix is small, and it’s the kind of thing worth doing once, deliberately.
An llms.txt is a plain-language index: here is what this site is, and here are
the pages worth reading first. It doesn’t replace your sitemap. It tells an agent
where to look.
You don’t have to write it by hand. Describe what you want, let an agent read the repo and draft it, then read the draft critically — the judgment is yours, the typing isn’t.
Generate an llms.txt for this repo
- A git repository with a README
Read the repository structure and the README.
Produce a concise llms.txt at /public that lists the site's key pages as a
short markdown table of contents, each with a one-line description. Keep it
under 80 lines. Do not invent pages that don't exist — only list what you
can verify in the repo.
Run it, read what comes back, and commit the version you’d be happy for an agent to trust. That’s the whole practice: not a best practice — just a thing you now do.