Всё, что устанавливает vibe, — пакет: папка с небольшим файлом описания и тем текстом или инструментами, которые она приносит. Пакеты бывают восьми видов, и вид говорит, для чего пакет нужен, ещё до того, как вы его откроете: способ работать, фича, технология, инструмент, языковой гайд, сервер для агента, документация или приложение.
Пакет — это проект, который сделали устанавливаемым. У него та же раскладка, что у проекта: собственный `vibe.toml` и собственный `vibevm/vibespecs/`, и рядом может лежать код. Когда проект его ставит, опубликованное дерево пакета копируется в дерево зависимостей проекта дословно; ничего не извлекается, не переписывается и не сливается.
Пакет называется *[координатой](../glossary/index.xml#coordinate)*: группа, косая черта и имя, как в `org.vibevm.world/wal`. Группа похожа на перевёрнутое доменное имя и говорит, кто публикует; имя уникально внутри группы. Версия дополняет адрес, когда она нужна: `org.vibevm.world/wal@1.0.0`. Вид в имя не входит. Его можно написать префиксом в командной строке, `flow:org.vibevm.world/wal`, и тогда vibe проверит, что пакет действительно этого вида.
Группа — заявление, а не удостоверение: никто не проверяет, владеет ли издатель `com.google/x` этим доменом, и никогда не проверит, потому что у vibe нет центрального проверяющего, которого можно спросить. Имя уникально внутри своей группы, так что координата сама по себе и есть идентичность. В командной строке префикс вида и группа необязательны; в [манифесте](../glossary/index.xml#manifest) координата всегда пишется полностью. В [реестре](../glossary/index.xml#registry) репозиторий называется группой и именем через точку, `org.vibevm.world.wal`, что само по себе корректное перевёрнутое доменное имя.
Где бы пакет ни назывался в проекте, стоит полная координата: `group/name` в требовании, `group.name` как имя репозитория, `group/name` как первый сегмент адреса `spec://`. Короткие имена живут только там, где человек один раз набирает их в командной строке.
| Вид | Что приносит | Пример |
| `flow` | способ работать: правила коммитов, заметки сессий, соглашения о ревью; обычно [стартовый фрагмент](../glossary/index.xml#boot-snippet), который агент читает каждую сессию | `org.vibevm.world/wal` |
| `feat` | описание того, что построить, без слова о том, как | страница приветствия, вход по электронной почте |
| `stack` | технологический контекст, который говорит, как с ним строится фича, или бандл членов семейства одной версии | `org.vibevm.ai-native/rust-ai-native` |
| `tool` | скрипт или утилита, которую может вызвать шаг сборки | обёртка над форматтером |
| `lang` | руководство о том, как писать на языке или в нотации | `org.vibevm.ai-native/rust-ai-native-lang` |
| `mcp` | сервер, с которым разговаривает агент, собранный из кода самого пакета | `org.vibevm.ai-native/rust-ai-native-mcp` |
| `doc` | документация других пакетов: читается, не устанавливается | `org.vibevm.core/vibevm-docs` |
| `app` | самостоятельный продукт со своей выкладкой | `org.vibevm.doc/web` |
Набор закрыт и растёт только поправкой к [спецификации](../glossary/index.xml#specification); [манифест](../glossary/index.xml#manifest) с неизвестным видом отвергается, а не угадывается.
Вид — метаданные пакета, а не часть его идентичности: он решает, куда кладётся содержимое, что показывает фильтр `--kind` у `vibe list` и `vibe search` и принимается ли имя с префиксом вида. Два пакета разных видов не могут делить координату, потому что координата сама по себе и есть идентичность.
`app` отличается от `tool` механически: инструмент живёт в проекте и запускается через `vibe bin exec` по [лок-файлу](../glossary/index.xml#lock-file), а приложение не живёт ни в каком проекте-потребителе и собирается и выкладывается само по себе.
Некоторые [возможности](../glossary/index.xml#capability) приходят несколькими пакетами с общей основой имени: языковой гайд, сервер, который отдаёт его инструменты, и маленький бандл, который закрепляет оба на одной версии. Это *семейство*. Потребовать бандл — значит поставить семейство, а изменение любого члена поднимает всех до одной общей версии, так что части никогда не разъедутся.
Сам бандл — самый маленький пакет из возможных: манифест и README, ни кода, ни [стартового фрагмента](../glossary/index.xml#boot-snippet). Его единственная работа — назвать членов семейства одной версии.
Документация — исключение. Руководство пакета — его *[компаньон](../glossary/index.xml#companion)* с суффиксом `-docs` в той же группе, и оно держит собственную линию версий. Исправленная опечатка в руководстве не выпускает инструменты, а новая версия инструмента не требует нового руководства. Руководство говорит, какие версии своего [предмета](../glossary/index.xml#subject) оно описывает, а сайт берёт самое новое руководство, которое подходит.
`[package].materialization` говорит, как пакет попадает в дерево потребителя. `copy` — умолчание и всё, что нужно обычному пакету; `hardlink` — то же содержимое, делящее байты с [хранилищем](../glossary/index.xml#store). Оба вендорятся: папка коммитится вместе с проектом и восстанавливается из него без сети. `in-place` держит живой git-чекаут с собственным `.git`, который git игнорирует и который свежий клон восстанавливает на закреплённом коммите, поэтому ему нужны сеть и [git-источник](../glossary/index.xml#git-source). Всё разрушительное над таким слотом — удаление, принудительная переустановка, смена версии — сначала спрашивает, а когда ответить некому, требует `--force`.
Смена группы или имени пакета создаёт новый пакет, а не переименовывает старый: версии не переносятся, а старые координаты никогда не используются повторно для другого содержимого.
Пакет документации нельзя установить в проект. `vibe install` отказывает и называет команду, которая вместо этого скачивает его для чтения.
Короткое имя без группы, например `wal`, принимается в командной строке и разрешается через [индекс](../glossary/index.xml#index-registry) [реестра](../glossary/index.xml#registry); это удобство, а манифест всегда записывает полную координату.
Разрешить короткое имя можно только через индекс, по одному запросу на реестр; реестр без индекса коротких имён не предлагает, и нужна полная координата. Если лок-файл уже закрепил пакет с таким именем, короткое имя означает закреплённый. Когда два реестра предлагают под одним именем разные пакеты, vibe останавливается с кодом выхода 7 и перечисляет кандидатов, а вы повторяете команду с группой. Префикс вида проверяет результат и никогда не снимает неоднозначность, потому что два пакета разных видов не могут делить координату.