<?xml version="1.0" encoding="UTF-8"?>
<spec xmlns="https://vibevm.org/spec/1">
  <title id="root">Маршрут новичка</title>
  <status stage="doc" state="work" audience="user"/>
  <p p="1">У вас есть агент-кодер и проект. VibeVM даёт этому агенту правильный текст для чтения перед началом работы и держит этот текст в согласии с тем, что решила ваша команда. Эта страница проводит от пустой папки до проекта, который агент понимает, короткими шагами.</p>
  <section id="step-1" title="Шаг 1: понять, что вы ставите">
    <p p="2">Сначала прочитайте [Что такое VibeVM](what-vibevm-is.xml). Это пять минут, и они дают одну мысль, на которой держится всё остальное: инструкция для агента — это зависимость, а зависимости устанавливают, версионируют и разделяют, как библиотеки. Правило, которое стоит запомнить: установка никогда не правит написанное вами.</p>
    <rule ref="spec://org.vibevm.core/vibevm/modules/vibe-workspace/PROP-009#INCLUDE-RULE" p="3"/>
  </section>
  <section id="step-2" title="Шаг 2: установить vibe">
    <p p="4">Следуйте странице [Установить vibe](install-vibe.xml). На Windows это архив и скрипт, на остальных платформах — клон репозитория и скрипт. Готово, когда новый терминал отвечает на `vibe --version`. Всё, чем владеет vibe, лежит в одной папке вашего домашнего каталога, и эту папку можно перенести одной переменной окружения.</p>
    <rule ref="spec://org.vibevm.core/vibevm/modules/vibe-registry/PROP-010#THE-SETTINGS-HOME-IS-DOT-VIBE-NOT-XDG" p="5"/>
  </section>
  <section id="step-3" title="Шаг 3: создать проект и установить один пакет">
    <p p="6">Следуйте странице [Создать первый проект](first-project.xml). Отдайте промпт агенту или выполните четыре команды руками. Пакет, который вы ставите, — это способ работать; с этого момента агент читает его в начале каждой сессии. Обратите внимание на план, который vibe показывает перед тем, как что-то записать: пока вы не сказали «да», ничего не установлено.</p>
    <rule ref="spec://org.vibevm.core/vibevm/modules/vibe-registry/PROP-002#IDENTITY-TUPLE" p="7"/>
  </section>
  <section id="step-4" title="Шаг 4: посмотреть, что появилось">
    <p p="8">Прочитайте [Что лежит в проекте](what-a-project-contains.xml), держа новую папку открытой рядом. Два файла ваши, одно дерево ваше, одно дерево принадлежит vibe, а сгенерированные файлы несут список чтения. Знать, кто что пишет, — это разница между проектом, который остаётся согласованным, и проектом, который воюет с собственным инструментом.</p>
    <rule ref="spec://org.vibevm.core/vibevm/modules/vibe-workspace/PROP-009#TWO-TREES" p="9"/>
  </section>
  <section id="step-5" title="Шаг 5: увидеть, как агент это читает">
    <p p="10">Прочитайте [Стартовую полосу](../model/boot-lane.xml). Агент открывает файл с инструкциями, читает один сгенерированный файл целиком, а дальше идёт по списку. Чтобы начать, он никогда не запускает vibe. Когда вы позже добавите, удалите или обновите пакеты, полоса будет собрана заново, и агент в следующей сессии прочитает новую.</p>
    <rule ref="spec://org.vibevm.core/vibevm/modules/vibe-workspace/PROP-009#SESSION-START-ORDER" p="11"/>
  </section>
  <section id="after" title="После маршрута">
    <p p="12">Дальше руководство ветвится. Для ежедневной работы страницы раздела *Как сделать* рассказывают об [установке](../howto/install-a-package.xml), [обновлении](../howto/update-packages.xml), [удалении](../howto/remove-a-package.xml), [работе без сети](../howto/work-offline.xml) и [публикации](../howto/publish-a-package.xml). Чтобы понять механику, страницы раздела *Модель* объясняют [пакеты и виды](../model/packages-and-kinds.xml), [реестры](../model/registries.xml), [лок-файл](../glossary/index.xml#lock-file) и машинное [хранилище](../glossary/index.xml#store) и [версии](../model/versions.xml). Чтобы работу делал агент, следующая страница — [Дайте агенту навык vibevm](../agent/give-your-agent-the-skill.xml). А когда какая-нибудь команда отказывает, страница [От сообщения об ошибке к правилу](../diagnostics/errors.xml) называет правило, которое она применила.</p>
  </section>
</spec>
