После первой установки в проекте лежит горстка файлов, которые написали вы, и набор побольше, который vibe написал за вас. Эта страница называет каждый из них и говорит, кому можно его менять, чтобы ничего из вашего не было перезаписано и ничего из сгенерированного не правили руками.
Начните с двух файлов в корне, потому что всё остальное выводится из них.
`vibe.toml` — это *[манифест](../glossary/index.xml#manifest)*. Его пишете вы, или `vibe init` пишет первую версию за вас. Он называет проект, перечисляет нужные пакеты с диапазоном версий для каждого и перечисляет [реестры](../glossary/index.xml#registry), откуда их брать. Это единственный файл, который нужен коллеге, чтобы воспроизвести вашу настройку, вместе с [лок-файлом](../glossary/index.xml#lock-file) рядом.
`vibe.lock` — это *лок-файл*. Его пишет vibe, вы его коммитите и никогда не правите. Он записывает точную версию каждого установленного пакета, включая те, что притянули ваши пакеты, и [отпечаток](../glossary/index.xml#fingerprint) содержимого каждого. С ним свежий клон ставит те же байты на любой машине.
Ниже лежит один каталог, `vibevm/`, с тремя детьми. Эта раскладка одинакова в каждом проекте и каждом пакете, и она не настраивается.
`vibevm/vibespecs/` — *ваше* дерево: [спецификации](../glossary/index.xml#specification) и правила, которые пишет сам этот проект, в Markdown или в XML-диалекте проекта. vibe читает его и никогда в него не пишет, с одним исключением, описанным ниже.
`vibevm/vibedeps/` — дерево *vibe*: по папке на установленный пакет и версию, с опубликованными файлами этого пакета как есть. Вы его коммитите, чтобы свежий клон читался без запуска чего бы то ни было, но никогда не правите. Правка там исчезает при следующей установке.
В `vibevm/vibepacks/` лежат пакеты, которые этот репозиторий разрабатывает на месте: проект, который и сам публикует пакеты, держит их исходники здесь, и vibe считает этот каталог маленьким локальным реестром. У большинства проектов его нет.
Исключение в вашем дереве — `vibevm/vibespecs/boot/`. Два файла там ваши: `00-core` держит основы проекта, `90-user` — ваши личные переопределения, и vibe не трогает ни тот, ни другой. Два файла там сгенерированы: `INDEX.md`, манифест того, что читает агент, есть всегда, а `STATIC.md`, текст, который он читает первым и целиком, есть только когда какой-то пакет попросил читать себя именно так. Оба несут заголовок о том, что они сгенерированы; этот заголовок не украшение.
Агент находит стартовые файлы через короткий [управляемый блок](../glossary/index.xml#managed-block) в конце `CLAUDE.md`, `AGENTS.md` и `GEMINI.md`, между строками `<vibevm>` и `</vibevm>`. vibe переписывает то, что между двумя маркерами, и ничего больше в этих файлах; остальной файл ваш, и место блока, раз он появился, — тоже ваше.
| Файл или каталог | Кто пишет | Коммитится | Правится руками |
| `vibe.toml` | вы (первую версию — `vibe init`) | да | да |
| `vibe.lock` | vibe | да | никогда |
| `vibevm/vibespecs/` | вы | да | да |
| `vibevm/vibespecs/boot/00-core`, `90-user` | вы | да | да |
| `vibevm/vibespecs/boot/INDEX.md`, `STATIC.md` | vibe | да | никогда |
| `vibevm/vibedeps/` | vibe | да | никогда |
| `vibevm/vibepacks/` | вы, когда репозиторий разрабатывает пакеты | да | да |
| блок `<vibevm>` в файлах инструкций для агентов | vibe | да | только его место |
| `.vibe/` | vibe | нет | никогда |
Последняя строка — черновая область проекта: кэши и внутреннее состояние, которые git игнорирует и которые можно спокойно удалить. Машинное [хранилище](../glossary/index.xml#store) скачанных пакетов лежит в другом месте, в вашем домашнем каталоге, и его делят все проекты на машине.
Ещё одна папка появляется, когда проект начинает вести учёт, какие правила своих пакетов он принял: `vibefacts/`, коммитится, по маленькому TOML-файлу на пакет. Установка пакета не копирует туда ни одного статуса автора; принять их — осознанное действие, `vibe facts adopt`, а `vibe facts` — рычаг для всего остального: перечислить, задать статус по адресу, синхронизировать и отчитаться. Удаление пакета спрашивает, оставить ли его файл принятия или убрать; `vibe facts clean` удаляет файлы исчезнувших пакетов, а после обновления `vibe facts sync` сообщает о [якорях](../glossary/index.xml#anchor), которые пропали или переехали.
Если вы удалите `vibevm/vibedeps/` или сгенерированные стартовые файлы, `vibe reinstall` восстановит их из лок-файла и хранилища, не трогая сеть.
Если проект из времён до нынешней раскладки несёт корневую папку `spec/`, vibe останавливается с рецептом миграции, а не гадает. Старые раскладки молча не читаются.
Если вы случайно напишете в `vibevm/vibedeps/`, сразу ничего не сломается; следующая установка перезапишет правку, потому что папка пакета там — дословная копия опубликованного.