Создать первый проект

Проект — это папка, в которой работает ваш агент. Эта страница создаёт такую папку, добавляет в неё первый общий набор правил и показывает, что появилось на диске и почему агент теперь будет это читать. Десять минут, никаких предварительных знаний.

Создай проект VibeVM с именем hello-vibe в текущей папке, установи в него пакет org.vibevm.world/wal из реестра по умолчанию и покажи мне список чтения, который агент получает в начале сессии. навык vibevm, установленный у вашего агента; доступ по сети к github.com/vibespecs или пакет, уже лежащий в машинном хранилище папка `hello-vibe` с `vibe.toml`, `vibe.lock`, каталогом `vibevm/` и файлами `CLAUDE.md`, `AGENTS.md` и `GEMINI.md`, которые заканчиваются блоком `<vibevm>`; `vibe check` не находит ошибок test -f hello-vibe/vibe.toml test -f hello-vibe/vibe.lock grep -q "org.vibevm.world/wal" hello-vibe/vibe.lock vibe check --path hello-vibe --quiet

Агент выполняет `vibe init hello-vibe`: команда создаёт папку с [манифестом](../glossary/index.xml#manifest), пустым [лок-файлом](../glossary/index.xml#lock-file), двумя стартовыми файлами, которые вы будете править сами, и тремя файлами инструкций для агентов. Затем он выполняет `vibe install org.vibevm.world/wal --path hello-vibe`. vibe читает [реестры](../glossary/index.xml#registry) из манифеста, находит пакет, подбирает версию, скачивает его в машинное [хранилище](../glossary/index.xml#store) и показывает план. После подтверждения он копирует пакет в `hello-vibe/vibevm/vibedeps/`, записывает лок-файл и генерирует стартовые файлы, которые агент будет читать. Наконец агент запускает `vibe tree`, чтобы показать этот список чтения, и `vibe check`, чтобы убедиться, что проект согласован.

1. Создайте проект. Имя становится папкой:

2. Установите пакет. Установка показывает план и просит подтверждения; в скрипте вопрос снимает `--assume-yes`:

3. Посмотрите, что записано:

4. Посмотрите список чтения, который получает агент:

5. Проверьте проект:

Откройте `hello-vibe/vibe.toml`: он называет проект и после установки перечисляет `org.vibevm.world/wal` среди требований с диапазоном версий. Откройте `hello-vibe/vibe.lock`: он закрепляет точную версию и [отпечаток](../glossary/index.xml#fingerprint) содержимого. Под `hello-vibe/vibevm/vibedeps/` лежит опубликованное дерево пакета, без изменений. Под `hello-vibe/vibevm/vibespecs/boot/` лежат два ваших стартовых файла и сгенерированный `INDEX.md`; сгенерированный `STATIC.md` появится рядом, как только какой-нибудь пакет попросит читать себя первым и целиком, а `wal` этого не просит. А в конце `CLAUDE.md`, `AGENTS.md` и `GEMINI.md` стоит блок, который указывает на них агенту.

Откройте новую [сессию агента](../glossary/index.xml#agent-session) в `hello-vibe` и спросите, каким правилам он следует: он назовёт пакет, который вы только что поставили, потому что прочитал полосу, прежде чем отвечать.

Повторный `vibe install` без имён пакетов ставит всё, что требует манифест; это команда после клонирования существующего проекта.

Если в папке уже есть `CLAUDE.md`, vibe дописывает свой блок в конец и не трогает ваш текст. Если он находит два блока или сломанный, он останавливается с ошибкой и ничего не меняет, пока вы не почините файл.

Отказаться от плана установки — не ошибка: ничего не записывается, а хранилище сохраняет скачанное на следующий раз.