Перейти к содержимому
F●RGEPLAN

forgeplan discover complete

forgeplan discover complete <SESSION_ID> закрывает сессию обнаружения в brownfield-проекте. Она помечает запись сессии как завершённую, запускает проход рекомендаций по всем накопленным результатам и выводит список предлагаемых артефактов - обычно ProblemCard, PRD, Note, а иногда и ADR - для создания пользователем с помощью forgeplan new.

Здесь конвейер brownfield-проекта превращает необработанные результаты в реальное состояние методологии.

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

Заголовок раздела «Когда использовать»
  • После того как агент завершил обход исходных уровней и discover show сообщает о достаточном покрытии.
  • В конце спринта по онбордингу - кристаллизуйте всё изученное в артефакты.
  • Когда вы хотите остановить сессию и зафиксировать всё, что было найдено до сих пор - частичные сессии всё равно выдают рекомендации.

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

Заголовок раздела «Когда НЕ использовать»
  • Пока агент всё ещё активно отправляет результаты - дождитесь, пока он завершит работу.
  • Для отмены без сохранения - отката нет; после завершения предложения выдаются.
  • Для уже завершённой сессии - идемпотентно, но бессмысленно.

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

Заголовок раздела «Использование»
forgeplan discover complete <SESSION_ID> [OPTIONS]

Аргументы

Заголовок раздела «Аргументы»
  <SESSION_ID>   Идентификатор сессии обнаружения (из discover list / start)

Опции

Заголовок раздела «Опции»
  -h, --help     Вывести справку
  -V, --version  Вывести версию

Примеры

Заголовок раздела «Примеры»
Окно терминала
forgeplan discover complete disc-001


# Полный цикл онбординга
forgeplan init -y
forgeplan discover start
# ... агент работает ...
forgeplan discover show disc-001
forgeplan discover complete disc-001
# → предложения выведены; создайте те, которые вы принимаете
forgeplan new prob "Несоответствие аутентификации между документацией и кодом"
forgeplan new prd  "Унифицированный загрузчик конфигурации"

Что делает проход рекомендаций

Заголовок раздела «Что делает проход рекомендаций»

По завершении движок:

  1. Группирует результаты по категориям (решения, инварианты, расхождения, технический долг, риски, владение).
  2. Удаляет дубликаты - объединяет результаты, ссылающиеся на один и тот же модуль/концепцию.
  3. Сопоставляет категории с типами артефактов - расхождения → ProblemCard, важные решения → ADR, пробелы → PRD, наблюдения → Note.
  4. Предлагает глубину - тактическая / стандартная / глубокая на основе радиуса поражения и эвристики обратимости.
  5. Выдаёт предложения в виде списка команд forgeplan new, которые пользователь может принять, отредактировать или пропустить.

Пользователь сохраняет контроль: предложения выводятся, а не создаются автоматически.

Как это вписывается

Заголовок раздела «Как это вписывается»

discover complete - это точка передачи от обнаружения к обычному жизненному циклу Forgeplan:

discover start → (findings) → discover complete → proposals
                                                    ↓
                          forgeplan new prob/prd/adr/note ...
                                                    ↓
                          validate → reason → activate

Отсюда проект проходит через стандартный цикл Shape → Validate → ADI → Code → Evidence → Activate, как и любая greenfield-работа.

См. также

Заголовок раздела «См. также»