forgeplan discover start

forgeplan discover start создаёт новую сессию обнаружения в рабочем пространстве и выводит протокол, которому должен следовать AI-агент, чтобы отобразить существующую кодовую базу в артефакты Forgeplan. Сессия действует как контейнер для находок, которые агент добавляет (через MCP) по мере чтения кода, истории git, тестов и документации.

Само сканирование не происходит внутри этой команды - она настраивает состояние и инструкции; фактический обход выполняется агентом, который понимает выведенный протокол.

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

• Один раз при онбординге в brownfield-проект - сразу после forgeplan init -y в существующем репозитории.
• После длительного периода без инструментов - запустить сессию обновления, чтобы наверстать упущенное.
• Когда вы хотите, чтобы AI-помощник отобразил новую подсистему, которую вы ещё не задокументировали.

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

• Для рутинной работы над greenfield-проектами - используйте forgeplan route + forgeplan new.
• Когда ни один агент не будет следовать протоколу - сессия останется пустой.
• Для крошечных задач с одним файлом - накладные расходы не стоят того; просто создайте Note.

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

forgeplan discover start <NAME>

Аргументы

  <NAME>  Имя проекта для сессии обнаружения

Опции

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

Примеры

# Запустить именованную сессию в текущем рабочем пространстве
forgeplan discover start "Auth System Onboarding"

# Типичный brownfield-процесс
forgeplan init -y
forgeplan discover start "Legacy API Mapping"
# агент теперь выполняет выведенный протокол, вызывая discover_finding через MCP
forgeplan discover show <session-id>
forgeplan discover complete <session-id>

Что выведенный протокол сообщает агенту

1. Многоуровневый порядок чтения - код > git > тесты > документация. Нижние уровни только валидируют верхние, никогда не переопределяют их.
2. Категории находок - решения, инварианты, дрейф, долг, риски, сигналы владения.
3. Как сообщать - добавлять каждую находку с помощью инструмента discover_finding MCP (только MCP, по задумке - исключает участие людей во время проведения обследования).
4. Когда останавливаться - эвристики для охвата (например, все модули/крейты верхнего уровня затронуты, основные эпохи git проанализированы).
5. Передача - по завершении вызвать discover complete, чтобы запустить проход рекомендаций.

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

discover start - это точка входа brownfield-конвейера:

discover start  →  агент обходит источники  →  discover_finding (MCP) ×N
                     ↓
                  discover show (проверка)
                     ↓
                  discover complete  →  предложения артефактов  →  forgeplan new ...

Он был представлен в PRD-035 Sprint 13.3-13.4 для устранения пробела в онбординге, задокументированного в PROB-022.

См. также

• forgeplan discover - родительская команда и обзор протокола
• forgeplan discover show - проверка запущенной сессии
• forgeplan discover list - все сессии
• forgeplan discover complete - завершение + рекомендации
• forgeplan init - шаг начальной загрузки рабочего пространства перед обнаружением