# Руководство VibeVM

> Руководство VibeVM по-русски: установить vibe, понять пакеты и стартовую полосу, работать с агентом, писать и публиковать пакеты.

A community documentation of org.vibevm.core/vibevm, published by org.vibevm.core, in ru.
An adaptation of org.vibevm.core/vibevm-docs (an official translation).
Read it at /doc/org.vibevm.core/vibevm-docs-ru/1.0.0/. Rendered 2026-09-14.

Что покрывает: что такое VibeVM и как он даёт агенту-кодеру нужный текст для чтения; установку vibe; создание проекта; пакеты, реестры, лок-файл и машинный store; установку, обновление, публикацию и работу без сети; навык vibevm для агента и работу через него; жизненный цикл от проверки до выкладки; полный справочник команд, манифеста, лок-файла и настроек; написание пакетов всех видов, включая документацию и её адаптации.
Для кого: для тех, кто запускает vibe в своих проектах, для тех, кто пишет пакеты, и для агентов, которые читают за них.
Что считает известным: как пользоваться терминалом и текстовым редактором, что такое агент-кодер и что делает менеджер пакетов для языка программирования.
Чего не покрывает: сами нормативные спецификации (руководство их цитирует, а не пересказывает), внутреннее устройство отдельных агентов и историю проектирования vibe.

## For agents

- [Как агент читает это руководство](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/agent/how-agents-read-this-manual/): Это руководство публикуется для машин так же, как для людей. Агент может получить любую страницу простым текстом, спросить, где живёт правило, и загрузить весь корпус одним файлом, подобранным под его бюджет. (4 min · agent)
- [Глоссарий](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/glossary/index/): Одно определение на термин, и это единственное место, где термин определён. Каждая другая страница ведёт сюда, когда впервые употребляет слово из этого списка; рядом с русским термином стоит английский, потому что команды, манифесты и спецификации говорят по-английски. (8 min · user, author, dev, agent)
- [Дерево зависимостей на экране](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/reference/tree/): `vibe tree` рисует пакеты, которые разрешил проект, деревом, говорит о каждом, как его текст доходит до агента, и объясняет почему. В терминале команда открывает интерактивный экран; в скрипте печатает простое дерево или JSON. Эта страница об этой команде, её экране и о том, как агент может посмотреть на экран без терминала. (4 min · user, author, agent)
- [Стартовая полоса: как агент читает проект](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/model/boot-lane/): Когда агент стартует, он читает короткий упорядоченный список файлов, который vibe вычислил из всего, от чего зависит проект. В списке есть фиксированный первый файл, читаемый целиком, и перечень остальных. Одни записи читаются всегда, другие — только когда выполняется условие, и ничего в списке не написано руками. (4 min · user, author, agent)
- [Пишите спецификации, которые агент может процитировать](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/authoring/specs-agents-can-cite/): Текст в пакете полезен агенту, только если у каждого правила в нём есть адрес. Эта страница показывает форму такого текста: именованные разделы, одна мысль на единицу, статус на каждой и адрес, который после публикации не меняется никогда. (4 min · author, agent)
- [Поручите работу агенту](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/agent/ask-your-agent/): Каждая страница этого руководства, которая описывает задачу, начинается с простой просьбы, которую вы печатаете своему агенту. Эта страница объясняет, что эти просьбы предполагают, как агент доказывает, что работа сделана, и что происходит, когда vibe возвращает задание агенту, вместо того чтобы выполнить его самому. (3 min · user, agent)
- [Машинные форматы и JSON-отчёты](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/reference/machine-formats/): Каждая команда умеет отвечать в JSON для скриптов и агентов. Эта страница перечисляет документы, их схемы и поля конверта, которые несёт каждый документ. (3 min · user, author, agent)
- [Справочник команд](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/reference/commands/): Каждая команда, которую принимает vibe, с её опциями, словами самой программы. Ничто на этой странице не написано руками. (1 min · user, author, agent)

## Pages

- [Как устроен vibe](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/architecture/how-vibe-is-built/): vibe — один бинарник, собранный из набора библиотек на Rust, каждая из которых владеет одной заботой: прочитать описание проекта, выбрать версии, скачать оттуда, где пакеты опубликованы, записать дерево на диск, поговорить с агентами. Эта страница — карта библиотек, швов между ними и пути, который проходит через них установка. (5 min · dev)
- [Что принёс эпик жизненного цикла](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/architecture/what-the-lifecycle-epic-delivered/): С июля по сентябрь 2026 года vibe вырос из установщика пакетов в систему сборки с машиной расширений, нативным ABI, записью каждой выкладки и экспортом терминала. Эта страница рассказывает этот маршрут как одну систему: что решили по дороге и что оставили на потом. (4 min · dev)
- [Перекиньте мост к чужому репозиторию](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/authoring/bridge-a-repository/): Иногда текст, который должен читать ваш агент, живёт в репозитории, чей автор никогда не слышал о vibe. Пакет-мост делает его устанавливаемым всё равно: вы сопровождаете чужой репозиторий и публикуете обычный пакет, который его оборачивает, с авторством и лицензией оригинала, отделёнными от ваших. (3 min · user, author)
- [Перевести документацию](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/authoring/translate-documentation/): Перевод — отдельный пакет той же формы, что оригинал: те же страницы, те же имена разделов, те же примеры по ссылке, на другом языке. Эта страница создаёт такой пакет и объясняет, что делает его официальным. (3 min · author)
- [Написать feat или stack](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/authoring/write-a-feat-or-stack/): Feat говорит, что построить, не говоря как; stack говорит, как это делает технология. Эта страница пишет по одному и соединяет их через умения, которые одному нужны, а другой предоставляет. (3 min · author)
- [Написать документацию для пакета](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/authoring/write-documentation/): Руководство для пакета — само по себе пакет: оно называет, что документирует, несёт заголовок и краткое описание, и его читают, а не устанавливают. Эта страница пишет такое руководство, с примерами, которые выполняются, и правилами, процитированными из источника, откуда они взяты. (5 min · author)
- [От сообщения об ошибке к правилу](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/diagnostics/errors/): Сообщения об ошибках vibe называют правило, которое они применяют. Эта страница перечисляет сообщения, которые вы, скорее всего, встретите, что каждое значит и самый короткий выход, в том порядке, в котором они обычно появляются. (5 min · user)
- [Вопросы](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/faq/index/): Настоящие вопросы, которые задавали люди; на каждый ответ в несколько предложений и ссылка на страницу, которая объясняет механизм. (4 min · user)
- [Package manifest](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/manifest/): What `org.vibevm.core/vibevm-docs-ru@1.0.0` declares about itself. Everything on this page is the package's own manifest, read and shown — nothing here is an opinion about the package. (3 min · user, dev)
- [Руководство VibeVM — README](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/readme/): The README of `org.vibevm.core/vibevm-docs-ru@1.0.0`, as the package ships it. (1 min · user, dev)
- [Лок-файл: vibe.lock](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/reference/lock-file/): `vibe.lock` — файл, который vibe пишет, а вы коммитите: точные версии, которые получил проект. Эта страница объясняет каждое поле, чтобы вы могли прочитать его диф в пул-реквесте и понять, что изменилось. (3 min · user)
- [Маршрут новичка](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/start/index/): У вас есть агент-кодер и проект. VibeVM даёт этому агенту правильный текст для чтения перед началом работы и держит этот текст в согласии с тем, что решила ваша команда. Эта страница проводит от пустой папки до проекта, который агент понимает, короткими шагами. (2 min · user)
- [Реестры и индекс](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/model/registries/): Пакеты публикуются в место, которое vibe умеет читать: по умолчанию это публичная организация на GitHub, по репозиторию на пакет. Проект перечисляет такие места в том порядке, в каком им доверяет. Каталог рядом с каждым из них отвечает на поиск, ничего не клонируя. (7 min · user)
- [Манифест: vibe.toml](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/reference/manifest/): `vibe.toml` — единственный файл, который вы пишете, чтобы описать проект или пакет: его имя, от чего он зависит, откуда берутся пакеты и что он доставляет. Эта страница перечисляет каждую таблицу и поле с их смыслом. (5 min · user, author)
- [Видимость зависимостей: public, private и друзья](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/model/dependency-visibility/): У пакета, от которого вы зависите, есть собственные зависимости, и они тоже могут дотянуться до вашего проекта. Дотянутся ли, решается там, где объявлена каждая зависимость, построчно: получают все, не получает никто или только проекты, которые назвали объявляющий пакет другом. Эта страница объясняет три метки, дружбу, которая открывает среднюю из них, что в результате оказывается в вашем дереве и как спросить vibe, почему пакет тут есть или почему его нет. (7 min · user, author)
- [Пакеты и их виды](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/model/packages-and-kinds/): Всё, что устанавливает vibe, — пакет: папка с небольшим файлом описания и тем текстом или инструментами, которые она приносит. Пакеты бывают восьми видов, и вид говорит, для чего пакет нужен, ещё до того, как вы его откроете: способ работать, фича, технология, инструмент, языковой гайд, сервер для агента, документация или приложение. (5 min · user, author)
- [Как сопровождается это руководство](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/architecture/how-this-manual-is-maintained/): Это руководство — пакет, и оно расходится с продуктом, как любой код на следующий день после выпуска: продукт добавляет флаг, читатель задаёт вопрос, на который не отвечает ни одна страница, абзац, залатанный пять раз, перестаёт читаться. Само по себе это не останавливается, поэтому руководство держится на небольшом наборе петель с именованными триггерами, очереди, которая измеряет пробелы, и журнале, куда записывается, что нашла каждая петля. Эта страница говорит, что это за петли, что их запускает и что вы должны, когда меняете продукт. (5 min · author, dev)
- [Поставляйте инструменты и MCP-серверы](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/authoring/ship-tools-and-mcp-servers/): Пакет может доставлять программы: инструменты командной строки, которые собираются при установке, или сервер, с которым говорит ваш агент. Эта страница объявляет и то и другое, собирает их в собственной папке пакета и объясняет, почему сервер закрепляет точную версию инструментов, которые обслуживает. (4 min · author)
- [Настройки, пути и окружение](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/reference/settings-and-environment/): vibe держит собственные файлы в одной папке в вашей домашней директории и читает несколько переменных окружения. Эта страница перечисляет содержимое папки, каждую переменную и то, что побеждает, когда они расходятся. (3 min · user)
- [Факты и маркеры статуса](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/authoring/facts-and-status-markers/): Любой нормативный документ — список обещаний, и у каждого обещания есть состояние: предложено, строится, сделано, отброшено. vibe читает это состояние из маленького маркера, написанного рядом с обещанием, в Markdown или в форме XML, и одна команда говорит вам, когда маркер испорчен или стоит не на месте. Эта страница — грамматика этих маркеров. (3 min · author)
- [Версии и обновления](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/model/versions/): Версия — это обещание о поведении, а не снимок файлов. Ваш проект просит диапазон, vibe записывает тот один номер, который выбрал, а обновление сдвигает этот номер намеренно. Сам vibe следует тому же правилу: один номер означает один контракт, сколько бы раз ни пересобирали бинарник за ним. (3 min · user)
- [Лок-файл и машинное хранилище](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/model/lock-and-store/): Один файл в вашем проекте записывает, какие именно версии пакетов он получил, вплоть до контрольной суммы их содержимого, чтобы коллега поставил те же байты. Одна папка на вашей машине держит эти байты по разу на компьютер, чтобы второй проект или день без сети не стоили ничего сверх. (3 min · user)
- [Использовать приватный реестр](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/howto/use-a-private-registry/): Компания может держать пакеты у себя и пользоваться vibe без изменений. Эта страница нацеливает проект или целую машину на это место, с поисковым каталогом рядом или без него, а публичный оставляет запасным. (3 min · user)
- [Что лежит в проекте](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/start/what-a-project-contains/): После первой установки в проекте лежит горстка файлов, которые написали вы, и набор побольше, который vibe написал за вас. Эта страница называет каждый из них и говорит, кому можно его менять, чтобы ничего из вашего не было перезаписано и ничего из сгенерированного не правили руками. (4 min · user)
- [Жизненный цикл: от validate до deploy](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/lifecycle/phases/): У сборки программ есть фиксированный порядок шагов, и vibe называет их: проверить дерево, произвести сгенерированные исходники, собрать, протестировать, дать агенту создать то, что может только агент, проверить результат, упаковать, выложить. Каждый шаг выполняется, только когда изменилось что-то, от чего он зависит. (3 min · user, author)
- [Написать пакет lang](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/authoring/write-a-lang-package/): Пакет lang учит агента писать на языке или в нотации: идиомы, ограничения, форма хорошего файла. Эта страница пишет такой пакет и объясняет, как vibe распознаёт в нём языковую дисциплину. (3 min · author)
- [Расширения и провайдеры](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/lifecycle/extensions-and-providers/): Пакет может встроиться в сборку: выполнить шаг, преобразовать этап или передать задачу агенту. Эта страница объясняет, как такие встраивания объявляются, как проект их включает и как увидеть, какие из них выполнились и почему. (4 min · user, author)
- [Два дерева: что пишете вы и что пишет vibe](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/model/two-trees/): Проект держит порознь два рода текста: правила, которые написала ваша команда, и копии общих правил, которые пришли с установленными пакетами. Установка пакета никогда не правит ваш текст. Удаление никогда не оставляет в нём следа. (3 min · user)
- [Опубликовать пакет](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/howto/publish-a-package/): Вы написали пакет и хотите, чтобы его ставили другие. Эта страница публикует его туда, откуда ставят ваши проекты, отдельным репозиторием, помечает версию тегом и проверяет, что свежий проект может его установить. (4 min · user, author)
- [Установить vibe](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/start/install-vibe/): vibe — одна программа без рантайма, который надо ставить. На Windows вы скачиваете архив и распаковываете его; на любой платформе с тулчейном Rust — собираете из исходников. Когда всё готово, одна команда печатает версию. (3 min · user)
- [Что такое VibeVM](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/start/what-vibevm-is/): Агент-кодер начинает каждую сессию, ничего не зная о вашем проекте. VibeVM лечит это так же, как менеджер пакетов лечит недостающие библиотеки: вы называете, чему следует проект, и агент получает точный текст для чтения в начале каждой сессии. Текст приходит из пакетов, поэтому команда, компания или сообщество могут делить его и улучшать в одном месте. (3 min · user)
- [Написать пакет flow](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/authoring/write-a-flow/): Flow говорит агенту, как работает команда: как коммитить, что проверить перед пушем, как вести заметки между сессиями. Эта страница пишет такой пакет с нуля, включая короткий текст, который агент читает на каждом старте сессии. (4 min · author)
- [Убрать VibeVM из проекта](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/lifecycle/scrape/): Когда проект закончен и должен уйти без следа инструмента, который помогал его строить, одна операция удаляет каждый файл и каждое упоминание vibe, сохраняя продукт и его сборку нетронутыми. (4 min · user)
- [Читать документацию локально](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/howto/read-documentation-locally/): Документацию пакетов, которыми вы пользуетесь, включая приватные, можно читать на собственной машине, ничего никуда не отправляя. Эта страница скачивает руководство на вашу машину и открывает читалку в браузере. (3 min · user)
- [Дайте агенту навык vibevm](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/agent/give-your-agent-the-skill/): Ваш агент работает лучше, когда знает, что такое vibe и как его вызывать. Эта страница кладёт короткий файл с инструкцией туда, где агент его читает, а для агентов, которые это поддерживают, запускает сервер, к которому агент обращается напрямую. (4 min · user)
- [Прослеживаемость: спецификации, код и карта](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/architecture/traceability/): Каждый публичный кусок кода в vibe указывает на правило, которое он воплощает, а сгенерированная карта отвечает в обе стороны: какой код стоит за этим правилом, какому правилу отвечает этот код. (3 min · dev)
- [Настроить рабочее пространство](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/howto/set-up-a-workspace/): Несколько пакетов, которые разрабатывают вместе, могут жить в одном репозитории и делить одну запись о версиях, которыми пользуются. Эта страница превращает папку в такое рабочее пространство и показывает, как участники ссылаются друг на друга по пути. (3 min · user, author)
- [Установить пакет](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/howto/install-a-package/): Вы нашли пакет, которому должен следовать ваш проект. Эта страница добавляет его в проект, записывает точную версию и показывает, как проверить, что агент теперь будет его читать. (3 min · user)
- [Обновить пакеты](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/howto/update-packages/): Пакеты меняются. Эта страница показывает, у каких из ваших есть версия новее, двигает вперёд один из них или все и объясняет, что vibe записывает по дороге. (3 min · user)
- [Удалить пакет](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/howto/remove-a-package/): Удаление пакета убирает его текст из проекта и из списка чтения агента, а всё написанное вами оставляет нетронутым. (2 min · user)
- [Собрать, упаковать и выложить проект](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/lifecycle/build-package-deploy/): Эта страница проводит проект от исходников до работающей выкладки тремя командами, показывает, что каждая оставляет на диске, и как снять выкладку, не гадая, чем она владела. (4 min · user, author)
- [Работать без сети](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/howto/work-offline/): В самолёте или за файрволом vibe продолжает работать из того, что уже есть на машине. Эта страница скачивает нужное до отъезда и ставит из него без сети. (3 min · user)
- [Создать первый проект](/doc/org.vibevm.core/vibevm-docs-ru/1.0.0/start/first-project/): Проект — это папка, в которой работает ваш агент. Эта страница создаёт такую папку, добавляет в неё первый общий набор правил и показывает, что появилось на диске и почему агент теперь будет это читать. Десять минут, никаких предварительных знаний. (3 min · user)