У вас уже есть репозиторий

Как начать не с пустого проекта: собрать спеку по коду, разметить систему компонентами и подключить накопленную работу.

Продукт не требует начинать с нуля. Если код уже написан, а документации нет или она устарела, порядок другой: сначала описать то, что есть, потом планировать новое.

Шаг 1. Подключитесь и заведите проект

в сессии агента, из корня репозитория

/flownix-init

На вопрос про сборку спеки ответьте «да» — это следующий шаг.

Шаг 2. Соберите спеку по коду

в сессии агента

/bootstrap-spec

Агент обойдёт репозиторий и документацию, поймёт, что за система, и запишет это в проект: спеку продукта и документы по подсистемам. Это не автогенерация из комментариев — он читает код и формулирует, что тот делает.

Зачем это до планирования: без спеки агент, планирующий новую фичу, не знает принятых решений и предложит то, что вы уже отвергли год назад.

Шаг 3. Разметьте систему компонентами

в сессии агента

/map-components

Компонент — часть системы: сервис, приложение, библиотека, инфраструктура. Агент обойдёт репозиторий, сверит каталоги с манифестами сборки и заведёт по компоненту на реальную часть.

Дальше работа привязывается к компонентам, и вопрос «как дела у шлюза» получает ответ одним запросом, а не пересчётом задач руками.

Шаг 4. Дальше как обычно

С этого места работа не отличается от нового проекта: планирование и выполнение. Разница в том, что агент теперь ищет по накопленному контексту и знает, что уже решено.

Чего ожидать

Спека будет неполной. Это нормально: она база, а не итог. Дополняется по мере работы — скилл update-knowledge держит её в актуальном состоянии.

Часть исторических задач останется без компонентов. Разметка задним числом надёжна только там, где есть за что зацепиться: путь в тексте задачи, коммит, ветка ревью. Остальное лучше оставить неразмеченным, чем привязать наугад.