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

Настройка копии проекта

Файл .vibeforge/workspace.json: миграции, команда запуска, лишние файлы и порты.

Копия проекта — чистый чекаут, поэтому иногда ей нужен один шаг настройки: миграции, генерация, docker. Всё это описывается файлом .vibeforge/workspace.json в корне проекта. Файл лежит в git — значит действует во всех копиях. Все поля необязательные.

{
  "setup": "npm run db:migrate && npm run seed",
  "run": "npm run dev -w @acme/web",
  "archive": "docker compose down -v",
  "copy": ["config/local.yml", "certs"],
  "copyEnv": true,
  "ports": 2
}

Поле	Когда нужно
setup	Один раз на новую копию: миграции, генерация, seed, docker
run	Чем поднимать превью, если автоопределения из package.json мало
archive	Уборка перед удалением копии
copy	Файлы и папки, которых нет в git
copyEnv	Копировать ли `.env*` автоматически (по умолчанию да)
ports	Сколько портов закрепить за сессией: фронт, api и так далее

Файл, который в копии уже есть, не перезаписывается — правка агента остаётся его правкой. Права файлов сохраняются: chmod 600 останется 600.