forgeplan init

forgeplan init инициализирует новое рабочее пространство Forgeplan в текущем каталоге. Она создаёт папку .forgeplan/ со всеми подкаталогами для артефактов (adrs, prds, rfcs, epics, specs, evidence, problems, solutions, notes, refresh, memory), инициализирует индекс LanceDB и записывает config.yaml по умолчанию. После этого вы можете начать создавать артефакты с помощью forgeplan new.

Когда использовать

Первичная инициализация Forgeplan в совершенно новом проекте.
Свежее клонирование существующего репозитория Forgeplan - markdown отслеживается, но .forgeplan/lance/ игнорируется Git, поэтому индекс должен быть перестроен локально.
Восстановление после катастрофического повреждения рабочего пространства или потери каталога .forgeplan/lance/ (в сочетании со свежей резервной копией экспорта).

Когда НЕ использовать

.forgeplan/ уже существует и находится в рабочем состоянии - используйте forgeplan migrate для обновления схемы вместо повторной инициализации.
Перестройка только индекса LanceDB из неповреждённого markdown - используйте forgeplan scan-import (деструктивная повторная инициализация не требуется).

Использование

forgeplan init [OPTIONS]

Опции

      --force    Принудительная повторная инициализация, даже если .forgeplan/ существует
  -y, --yes      Неинтерактивный режим (пропускает запросы, использует значения по умолчанию)
      --scan     Сканировать существующие документы и импортировать их
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Примеры

Пример 1: Первичная настройка (AI агент)

forgeplan init -y

Создаёт .forgeplan/ со значениями по умолчанию и без интерактивных запросов. AI агенты всегда должны использовать -y - в противном случае интерактивный мастер заблокирует их.

Пример 2: Свежее клонирование репозитория Forgeplan

git clone <repo> && cd <repo>
forgeplan init -y
forgeplan scan-import
forgeplan list

Markdown в .forgeplan/{adrs,prds,...} отслеживается, но lance/, .fastembed_cache/ и config.yaml игнорируются Git. init -y воссоздаёт пустую оболочку, затем scan-import перестраивает индекс LanceDB из отслеживаемого markdown.

Пример 3: Внедрение в существующий проект (Brownfield onboarding)

forgeplan init -y --scan

Сканирует стандартные каталоги документов (docs/, rfcs/ и т. д.) и импортирует любой markdown, который выглядит как артефакт, классифицируя его по типу.

Пример 4: Повторная инициализация после резервного копирования

forgeplan export --output backup.json
cp -r .forgeplan .forgeplan-backup-$(date +%Y%m%d)
rm -rf .forgeplan
forgeplan init -y --force
forgeplan import backup.json

Единственный безопасный путь повторной инициализации - экспорт + копирование файловой системы + повторная инициализация + импорт.

Как это вписывается в рабочий процесс

Эта команда является частью полного жизненного цикла артефакта - см. руководство для сквозного потока. init - это нулевой шаг; следующая команда почти всегда forgeplan health или forgeplan scan-import.

Примечания по безопасности

AI агенты всегда должны передавать -y. Интерактивный мастер зависнет на стандартном вводе и будет выглядеть как застрявший процесс.
Никогда не используйте rm -rf .forgeplan без предварительного экспорта. См. forgeplan export - это единственный путь резервного копирования, который сохраняет ссылки, доказательства и состояние оценки.
config.yaml игнорируется Git. Если вы выполните повторную инициализацию, вы потеряете настройки провайдера LLM. Сделайте резервную копию отдельно: cp .forgeplan/config.yaml ~/fp-config-backup.yaml.
Markdown сохраняется при повторной инициализации только в том случае, если вы сначала скопируете его. --force очищает папку. Всегда используйте cp -r .forgeplan .forgeplan-backup-$(date +%Y%m%d) в качестве дополнительной меры безопасности.
Различия в схеме между версиями (например, v0.17 → v0.18 добавлены столбцы) - по возможности предпочитайте forgeplan migrate повторной инициализации.

См. также

forgeplan export - обязательное резервное копирование перед любой деструктивной операцией
forgeplan import - восстановление артефактов после повторной инициализации
forgeplan scan-import - перестройка LanceDB из отслеживаемого markdown
forgeplan migrate - недеструктивные обновления схемы
forgeplan health - проверка начала сессии
Конфигурация - настройка провайдера LLM