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

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

Иерархия нод

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

◇project— Корень дерева — продукт или инициатива.

▣epic— Крупный блок работы.

◆feature— Поставляемая возможность — то, что можно выпустить.

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

●task— Лист дерева — конкретная исполняемая единица.

Типы нод

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

◇project

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

▣epic

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

◆feature

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

▤plan

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

●task

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

▦doc

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

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

У каждой ноды есть статус. Агент двигает его явно через 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.