# 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**

```
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.