Цикл проектного графа · интерактив

DAG Explorer · артефакты в 3D

Каждый артефакт в проекте - узел. Каждая связь между ними (parent / informs / triggers) - ребро. В сумме это направленный ациклический граф (DAG), который показывает, откуда взялось каждое решение. Когда артефактов 20+ и связей 50+, читать его текстом невозможно. Эта страница рендерит реальный пример проекта в 3D - крутите мышью, прячьте типы кнопками сверху, наводитесь на узлы для деталей.

01 · Разметка

Иерархия по Y-оси

Epic сверху · Evidence снизу · 5 слоёв

→

02 · Nodes

Узлы по типу

7 типов артефактов · 7 цветов

→

03 · Edges

Связи по семантике

parent · informs · triggers

Хранилище знаний MVP · реальный проектный граф

Сценарий: Vault - приложение для заметок. Один Epic, четыре PRD под ним, RFC-обсуждения для каждого, ADR-решения, Spec-контракты, Evidence-замеры, плюс Problem, который запустил одну из PRD. Всего 22 артефакта и 30 связей. Сцена крутится, узлы наведения показывают полный frontmatter, кнопки сверху прячут типы.

parent · структурная связь informs · evidence подкрепляет triggers · problem запускает PRD

Раскладка по слоям · что читается на Y-оси

Высота узла на сцене - это уровень в DAG. Чем выше, тем абстрактнее (намерение); чем ниже, тем конкретнее (доказательство).

y = 4

y = 3

y = 2.5

y = 2

y = 1

y = 0

Стратегическая цель проекта - что вообще делаем
EPIC

намерение

Продуктовые требования - что строим и для кого
PRD

намерение

Сигналы, которые запустили работу - баги, риски, наблюдения
PROB

сигнал

Архитектурные обсуждения - какие альтернативы рассматриваем
RFC

обсуждение

Принятые решения и контракты системы
ADR · SPEC

решение

Данные, подкрепляющие или опровергающие решения
EVID

доказательство

Стрелки идут снизу вверх для evidence

Структурная иерархия (parent) - Epic сверху, остальное под ним. Серые тонкие линии. Информационные связи (informs) идут снизу вверх - от Evidence к ADR/SPEC. Оранжевые линии. Триггер-связи (triggers) от Problem к PRD - пунктирные красные, событие запустило цепочку.

Что видно в графе · паттерны для чтения

Когда вы крутите сцену, обратите внимание на типичные конфигурации - они показывают здоровье решения сразу.

паттерн A · здоровая цепочка

PRD → RFC → ADR ← Evidence

Требование породило обсуждение, обсуждение - решение, решение подкреплено хотя бы одним evidence. R_eff > 0, активация легитимна.

EPIC
└─ PRD-001
└─ RFC-001
└─ ADR-001 ← EVID-001

паттерн B · blind spot

ADR без Evidence

Решение принято, но снизу к нему ничего не подходит. R_eff = 0. forgeplan blindspots подсветит, активация невозможна.

ADR-XXX
· нет входящих informs
· R_eff = 0
· status: draft (заблокирован)

паттерн C · orphan

RFC без PRD

Обсуждение существует, но не связано с продуктовым требованием. Сирота - либо забыли линкануть parent, либо RFC устарел.

RFC-XXX
· нет parent
· нет children
· кандидат на supersede/deprecate

паттерн D · разветвление

PRD с несколькими ADR

Одно требование породило несколько архитектурных решений по разным аспектам. Нормально для Critical-depth. Каждый ADR со своим evidence-набором.

PRD-002
├─ RFC-002a → ADR-002a
└─ RFC-002b → ADR-002b