Это руководство публикуется для машин так же, как для людей. Агент может получить любую страницу простым текстом, спросить, где живёт правило, и загрузить весь корпус одним файлом, подобранным под его бюджет.
| Адрес | Что это | Когда читать |
| `https://vibevm.org/doc/llms.txt` | индекс: по строке на страницу, первый абзац страницы | сначала, чтобы выбрать страницу |
| `https://vibevm.org/doc/<package>/<version>/<page>.md` | одна страница простым Markdown, с номерами блоков | чтобы ответить на один вопрос |
| `https://vibevm.org/doc/<package>/<version>/<page>.xml` | та же страница в исходной форме, со всеми адресами правил и примерами | чтобы процитировать правило или выполнить пример |
| `https://vibevm.org/doc/llms-small.txt`, `llms-medium.txt`, `llms-full.txt` | корпус в трёх размерах, стабильный текст первым | только когда задача охватывает много страниц |
| `https://vibevm.org/doc/manifest.json` | каждая страница с её языком, аудиториями, статусом и якорями | для программной навигации |
| `https://vibevm.org/doc/resolve/?uri=spec://…` | резолвер: адрес на входе, страница и блок на выходе | когда сообщение или страница цитирует адрес |
| `https://vibevm.org/doc/ru/…` | те же файлы для другого языка | когда пользователь читает на этом языке |
Сайт также отдаёт манифест: JSON-список всех страниц с их статусами, языками, аудиториями и якорями, по адресу `/doc/manifest.json` и разрешает адрес `spec://` по адресу `/doc/resolve/?uri=…`; `<package>` — это группа и имя руководства, `org.vibevm.core/vibevm-docs`, а `<version>` — номер или `latest`.
Те же страницы живут в машинном [хранилище](../glossary/index.xml#store), как только выполнен `vibe cache add org.vibevm.core/vibevm-docs`. `vibe explain "spec://org.vibevm.core/vibevm-docs-ru/<page>#<anchor>"` печатает страницу или блок; `vibe doc manifest --llms small` печатает список страниц из хранилища. Ничто на этом пути не обращается к сети, и потому проприетарную документацию читают именно так.
Каждый блок на странице несёт номер, `p12` и так далее; он присваивается при сборке страницы и одинаков в веб-странице, в Markdown и в XML. Ссылка — это адрес страницы плюс этот номер: `spec://org.vibevm.core/vibevm-docs-ru/model/boot-lane#p7`. Заголовки сохраняют и именованные [якоря](../glossary/index.xml#anchor), и именованный якорь после публикации не меняется никогда; [номер блока](../glossary/index.xml#block-number) называет текущий текст и после правки может сдвинуться, как номер строки.
Правила на странице цитируются из [спецификации](../glossary/index.xml#specification) по адресу и показываются на языке самой спецификации. Когда вы говорите пользователю, что гласит правило, предпочитайте адрес спецификации адресу руководства; когда объясняете почему, предпочитайте страницу руководства.
1. На ошибке прочитайте адрес, который называет сообщение, затем страницу, на которую его отображает страница диагностики.
2. На вопросе отвечайте с одной страницы: первый абзац — простой ответ, блоки правил несут точную формулировку.
3. На задаче возьмите блок просьбы со страницы как свою задачу и подставьте имена и пути пользователя. Выполните её, затем выполните строки assert. Задача сделана, когда каждая из них завершилась нулём.
4. Выбирая среди документаций одного пакета, предпочитайте помеченную как официальная и называйте издателя документации сообщества.
5. Никогда не загружайте весь корпус, когда отвечает одна страница.
`vibe mcp serve` предлагает те же операции как инструменты. `explain` смотрит на один узел карты по адресу; `query` находит узлы, и это два разных глагола намеренно. `select` принимает до семи предикатов, `uri:`, `symbol:`, `kind:`, `scope:`, `has:`, `lacks:` и `depth:`, через пробел, соединённых по И, без операторов. Неизвестный предикат, повторённый предикат или пустой запрос — ошибка, которая называет токен и перечисляет, что ожидалось.
`query_package` возвращает полную запись установленного пакета из лока. `read_subskill` возвращает содержимое активного [поднавыка](../glossary/index.xml#subskill), где бы он ни жил: в дереве проекта или в машинном хранилище. `materialise_subskill` копирует лениво подтянутый поднавык в дерево проекта и отказывается перезаписывать без `force`; это единственный инструмент, который пишет.
Языковые пакеты вида `mcp` приносят собственные серверы с четырьмя инструментами, `tcg_validate`, `tcg_scope`, `tcg_complete` и `tcg_type`: тонкими адаптерами над операциями с теми же именами. Каждый принимает обязательный `language`, `typescript` или `rust`, и собственные параметры операции без изменений. Каждый отвечает обогащённым результатом как структурированным содержимым плюс коротким текстом, в котором находки идут первыми.
Текст, написанный для агентов, никогда не входит в [стартовую полосу](../glossary/index.xml#boot-lane) проекта; это руководство берут, когда нужно, а не читают на каждом старте сессии.
Сама стартовая полоса — чистое чтение файлов: ничто в ней не выполняется, и руководства в ней нет.
Страница, которая есть на языке источника, но не на языке, который вы запросили, отдаётся на языке источника по запрошенному адресу, с пометкой; не считайте её отсутствующей.