Skip to content

docs(guides): link llms-small.txt from the AI tools page #1657

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We鈥檒l occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ryansolid wants to merge 2 commits into
base: v2-rebuild
Choose a base branch
from
Open

docs(guides): link llms-small.txt from the AI tools page #1657

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
497f43f
docs(guides): link llms-small.txt from the AI tools page
claude Oct 15, 2026
127198c
docs(guides): keep the llms-small line within the tone rules
claude Oct 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions src/routes/(5)guides/(17)ai-tools.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down Expand Up @@ -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
Expand Down
Loading