Flownix
Начать
Разделы
На этой странице

Существующий репозиторий

Код есть, документации нет. Как описать то, что уже написано, и начать вести работу дальше.

Ситуация

Продукт разрабатывается год или три. Код есть, документация устарела или её нет, а знание системы живёт в головах. Новый разработчик — и тем более агент — тратит первые дни на то, чтобы понять, что здесь вообще происходит.

Планировать новое в такой ситуации опасно: агент, не знающий принятых решений, предложит то, что уже отвергли.

Что делаете вы

Читаете собранную спеку. Агент опишет систему такой, какой она выглядит из кода, — включая то, что вы считаете временным решением и собирались переделать. Расхождение между «как есть» и «как задумано» стоит поправить сразу, иначе оно закрепится.

Подтверждаете разметку компонентов. Скилл предлагает связи и называет основание каждой; вы соглашаетесь или нет. Молча он не привязывает, и не зря: пропущенная связь видна, а неверная не видна никому и портит прогресс компонента навсегда.

Что делает агент

Три вызова, по одному на шаг. Между ними стоит читать результат, а не гнать подряд:

в сессии агента, из корня репозитория
/flownix-init
/bootstrap-spec
/map-components

Что за этим стоит:

  1. /flownix-init — организация, проект, файл .flownix. На вопрос про строгий режим отвечайте «нет»: включать его до того, как появилась спека, значит упереться в гейт на первой же задаче.
  2. /bootstrap-spec — агент обходит репозиторий и документацию, формулирует, что за система, и записывает результат: спеку проекта и документы по подсистемам (create_doc_node). Это не выжимка из комментариев — он читает код.
  3. /map-components — create_component на каждую реальную часть системы, сверенную с манифестами сборки, а затем set_node_components на накопленную работу. Каждую связь он предлагает с основанием и ждёт вашего «да».

Что получится

Проект, который знает свою систему: спека, документы по подсистемам, дерево компонентов с прогрессом по каждому. Семантический поиск наполнен — агент, планирующий новую фичу, найдёт принятые решения и не предложит отвергнутое.

Границы

Спека будет неполной. Она база, а не итог: агент опишет то, что видно из кода, и не угадает намерений, которых в коде нет. Дополняется по мере работы.

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

Разметка требует вашего времени. Подтверждать связи придётся вам — это не тот шаг, который можно пропустить, не потеряв смысл всей затеи.

На большом репозитории сборка спеки не мгновенная. Агент читает код, а не индекс.

Дальше