Документация

Первая сессия

Выбрать проект, поставить задачу словами или из GitHub, выбрать режим и место работы — и получить результат в отдельной ветке на проверку.

1Нажмите «Создать» в левой колонке.
2Выберите каталог проекта: недавний чипом, любой через диалог или «Клонировать с GitHub». Если это не git-репозиторий, VibeForge предложит инициализировать его — без git не будет ни диффа, ни отката.
3Опишите задачу словами. Голосом — иконка микрофона; скриншот или файл можно перетащить в поле или вставить из буфера. Если задача уже написана в GitHub или трекере — «Начать из задачи».
4Выберите режим команды: для первой задачи это «Соло». В подписке есть «Авто» — он подберёт режим, движок и состав сам.
5Запустите. Дальше следите за лентой: агент читает файлы, правит код, запускает тесты. Что можно делать в это время — в «Пока агент работает».

Как писать задачу

Агент — сильный, но буквальный исполнитель: конкретика на входе даёт качество на выходе. Полезно указать четыре вещи:

Что сделать — одна ясная цель.
Где — файлы или каталоги, если знаете: наберите «@» и выберите их из списка, чтобы в задачу попал точный путь.
Критерии приёмки — «npm test проходит», «кнопка видна только администратору».
Ограничения — чего не трогать, каких зависимостей не добавлять.

Плохо: «сделай красивее», «почини баги». Хорошо: «Добавь на страницу настроек переключатель тёмной темы. Состояние — в localStorage, ключ theme. Существующие стили не менять. Проверь, что npx tsc --noEmit чистый».

Где работать

Вариант	Что происходит
В своей копии	По умолчанию. Сессия работает в отдельной копии проекта на ветке вида `vf/<имя-задачи>`. Каталог, открытый у вас в редакторе, не меняется; работа переносится кнопкой «Merge → main».
Прямо в проекте	Агент правит файлы в самом каталоге, на той ветке, что там выписана (обычно main). Правки видны в редакторе сразу, переносить ничего не нужно, откат — только через git. Каталог занят целиком: вторую сессию в него не пустят.
В этой ветке	Продолжить в копии и ветке уже существующей сессии — когда новая задача логически продолжает старую.

Что происходит с проектом

Если в проекте были незакоммиченные правки, перед стартом приложение спросит, убрать ли их в отдельный коммит-точку возврата или оставить как есть, — само оно чужую работу не коммитит. Профиль проекта запоминает режим, движок и модели: в следующий раз для той же папки они подставятся сами.

Ничего не применяется молча: результат остаётся в ветке сессии, пока вы не нажмёте «Merge → main». В подписке у оркестратора есть ещё одна остановка — план с эпиками ждёт вашего «Утвердить» до того, как будет создана хоть одна копия.