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

Ключевые понятия

Иерархия нод, их типы, жизненный цикл статусов и связи между нодами.

Иерархия нод

Любая единица работы — это нода. Ноды образуют строгое дерево от продукта до конкретной задачи. Вложенность не ограничена, но рекомендуется выбирать минимальную глубину, которая остаётся читаемой.

◇project
▣epic
◆feature
▤plan
●task

Типы нод

У каждой ноды есть тип (kind). Он определяет её роль в дереве.

◇project

Корень дерева — продукт или инициатива. Создаётся через create_project, имеет короткий КЛЮЧ (префикс слагов, напр. AF).

▣epic

Крупный блок работы. Группирует несколько фич. Заводится только под действительно большой объём.

◆feature

Поставляемая возможность — то, что можно выпустить. Содержит планы реализации.

▤plan

План реализации фичи: цели, подход, риски и упорядоченный чек-лист задач в Markdown-контенте.

●task

Лист дерева — конкретная исполняемая единица. Здесь происходит реальная работа; содержит критерии приёмки.

▦doc

Документ. Markdown-страница с обратными ссылками и референсами. Живёт во вкладке «Документация».

◫group

Свободный контейнер для группировки чего угодно с чем угодно. Стоит под любой нодой на любом уровне дерева и держит любые ноды. Слаг — KEY-GRP-N. Не ступень иерархии и не управляет статусом или спекой.

Жизненный цикл статусов

У каждой ноды есть статус. Агент двигает его явно через update_node_status. Прогресс (0..100) задаётся отдельно для длинных задач через update_node_progress.

Очередь
backlog

Не начато.

Планирование
planning

Декомпозируется, пишется спецификация.

В работе
in_progress

Активно выполняется.

Тестирование
testing

Реализация готова, идёт проверка.

Регрессия
regression

Проверка нашла проблемы, идёт правка.

Выполнено
done

Завершено и проверено.

Заблокировано
blocked

Двигаться нельзя — причина всегда в комментарии.

Связи между нодами

Помимо иерархии «родитель → ребёнок», ноды связываются ещё тремя способами. Все связи видны в деталях ноды и на интерактивном графе.

Зависимости

Направленное ребро «A зависит от B»: B — блокер и должен быть завершён раньше A. Задаёт порядок выполнения задач (add_dependency, from_node зависит от to_node).

Референсы

Двусторонние перекрёстные ссылки между нодами: исходящие и обратные (backlinks). Задаются через set_references.

Типизированные связи

Семантические рёбра: blocks / blocked_by, depends_on / depended_by, related_to, duplicates / duplicated_by, parent_of / child_of. Двусторонние, задаются через add_relation.