forgeplan discover

forgeplan discover - это родительская команда для механизма обнаружения для brownfield-проектов Forgeplan (PRD-035, NOTE-041, PROB-022). Она организует сессии, управляемые протоколом, в ходе которых ИИ-агент считывает существующую кодовую базу, историю Git, тесты и документацию - именно в таком порядке приоритета - и сообщает о находках через MCP. В конце Forgeplan предлагает конкретные артефакты (ProblemCard, PRD, ADR, Note) для создания, чтобы проект мог начать использовать методологию без ручного создания бэклога.

Короче говоря: discover берёт проект, созданный до Forgeplan, и создаёт для него первый черновик артефактов.

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

Внедрение Forgeplan в существующий репозиторий - запустите discover start как один из первых шагов после forgeplan init -y.
После долгого спринта без инструментов - наверстайте упущенное по недокументированным решениям, пока они не стёрлись из памяти.
При присоединении к проекту новой команды - позвольте агенту построить структурированную карту существующего, затем используйте её для планирования.
Перед аудитом или рефакторингом - создайте начальные артефакты, чтобы рефакторинг имел базовую линию для замещения.

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

Для текущей работы над greenfield-проектами - предпочтительнее использовать forgeplan route + forgeplan new напрямую.
Для одной задачи - сессии discover создают общие обзоры, а не планы на уровне задач.
Без ИИ-агента, способного следовать протоколу MCP - discover start выводит инструкции, но кто-то должен их выполнить.

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

forgeplan discover <COMMAND>

Опции

  -h, --help     Вывести справку
  -V, --version  Вывести версию

Подкоманды

  start     Начать новую сессию обнаружения - выводит протокол для ИИ-агента
  list      Перечислить все сессии обнаружения в рабочем пространстве
  show      Показать статус сессии обнаружения
  complete  Пометить сессию обнаружения как завершённую
  help      Вывести это сообщение или справку по указанным подкомандам

Примеры

# Типичный процесс внедрения для brownfield-проектов
forgeplan init -y
forgeplan discover start
# → агент читает код/git/тесты/документацию, добавляет находки через MCP
forgeplan discover show <session-id>
forgeplan discover complete <session-id>
# → Forgeplan предлагает создать ProblemCard / PRD / Note
forgeplan discover list

Протокол в одном абзаце

discover start создаёт запись сессии и выводит протокол, которому должен следовать агент. Агент проходит по многоуровневым источникам - код > история Git > тесты > документация - и для каждой значимой находки вызывает инструмент discover_finding MCP (только MCP; эквивалента в CLI нет, чтобы цикл оставался управляемым агентом). discover show отображает накопленные находки; discover complete завершает сессию и выдаёт рекомендации для команд forgeplan new.

Приоритет многоуровневых источников (важно)

Код - это основная истина; всё остальное может лгать. Протокол обеспечивает следующий порядок:

Код - фактическое поведение, текущие инварианты.
История Git - кто что изменил, когда и почему (сообщения коммитов, ссылки на PR).
Тесты - объявленное поведение и граничные случаи, которые волновали команду.
Документация - желаемая или просроченная; использовать только для перекрёстной проверки пунктов 1-3, никогда как основной источник.

Находки из менее приоритетных уровней, которые противоречат более высоким уровням, помечаются как дрейф, часто становясь ProblemCard в рекомендациях.

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

discover закрывает пробел, выявленный в PROB-022 (пробел во внедрении brownfield-проектов). Он интегрируется с:

forgeplan new - рекомендации при discover complete соответствуют вызовам создания артефактов 1:1.
forgeplan health - состояние после discover должно показывать меньше сирот (артефактов без связей) и слепых пятен.
forgeplan fpf check - как только артефакты существуют, правила FPF могут их оценивать.

См. также

forgeplan discover start - начать сессию + вывести протокол
forgeplan discover list - все сессии в рабочем пространстве
forgeplan discover show - проверить находки сессии
forgeplan discover complete - завершить + выдать рекомендации
Руководство по методологии
forgeplan health - сравнение до/после