diff --git a/src/routes/(5)guides/(17)ai-tools.mdx b/src/routes/(5)guides/(17)ai-tools.mdx
index 97e97a850..070957889 100644
--- a/src/routes/(5)guides/(17)ai-tools.mdx
+++ b/src/routes/(5)guides/(17)ai-tools.mdx
@@ -138,10 +138,11 @@ export default defineConfig({
 This site serves its content in the forms an assistant can fetch:
 
 - [`/llms.txt`](/llms.txt) is an index of every page with its one-line description.
+- [`/llms-small.txt`](/llms-small.txt) is the short form for a small context budget: the rules that differ from Solid 1.x, the 1.x to 2.0 corrections, and one line per `solid-js` export.
 - [`/llms-full.txt`](/llms-full.txt) is the whole site in one Markdown file.
 - Every page is available as Markdown at its own URL with `.md` appended, for example `/concepts/reactivity.md`.
 
-Give an assistant the index and let it fetch the pages it needs; the full corpus is for tools that load everything once.
+Give an assistant the index and let it fetch the pages it needs; the small file is for a tool that can afford one short read, and the full corpus is for tools that load everything once.
 
 ## Rules to paste into an instructions file
 
@@ -204,7 +205,7 @@ Every name in the block is checked against the installed cheatsheet; when the ch
 - `captureArtifact` with `expectNoDiagnostics` and `expectRerunBudget` turns a reactive claim into evidence a test or an assistant can check.
 - With `diagnostics: true`, `POST /__solid/diagnostics` drives `begin`, `end`, `active`, `whyDidRun`, and `costs` against the running page.
 - `eslint-plugin-solid/configs/v2` catches destructured props and the other common generated mistakes before the code runs.
-- `/llms.txt`, `/llms-full.txt`, and every page's `.md` URL serve these docs as Markdown.
+- `/llms.txt`, `/llms-small.txt`, `/llms-full.txt`, and every page's `.md` URL serve these docs as Markdown.
 - Paste the rules block into the assistant's instructions file and keep the project's own conventions beside it.
 
 ## Next steps