mermaid там, где структура — граф или автомат
Критерий: диаграмма заводится, если структура граф или автомат, а проза вынуждена его пересказывать. Где структура таблица соответствий — чек-лист синка, профили ревью, коды выхода — не заводится: дублировала бы таблицу и разошлась с ней. tasks: жизненный цикл записи по индексам — состояния это где числится строка, файл items/ не двигается ни на одном переходе. session: четыре шага сессии; текст говорил «это зависимость, а не список», но зависимости не показывал — теперь на рёбрах написано, что ломается. sprint.md: исходы задачи в спринте плюс два ребра, где порядок нарушается молча — урожай до sprint close и блокер в обход исходов. task-pipeline: одиннадцать шагов с развилкой «тривиальная» и досрочным исходом «крупнее задачи». promote.md: храповик находка → конвенция → правило → удаление, с обратным ребром; обязательность третьего шага теперь видна как ребро. calibration.md: счётчик retune до drop — таблица вердиктов его выразить не может, автомат может. README: граф вызовов между плагинами; односторонность зависимости pipeline → pm видна сразу. Все девять блоков прогнаны через mermaid-cli. README-схема и автомат калибровки переверстаны после просмотра: subgraph'ы ломали раскладку, self-loop наезжал подписями. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -32,6 +32,36 @@
|
||||
Соглашение об именах: имя **плагина** длинное с префиксом `av-dev-`, имена
|
||||
**скилов** внутри — короткие. Вызов выходит вида `/av-dev-<плагин>:<скилл>`.
|
||||
|
||||
Кто кого зовёт (стрелка — вызов через пространство имён, не импорт):
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph pipe["av-dev-pipeline — исполнение, требует OpenSpec"]
|
||||
direction LR
|
||||
batch["task-batch"] --> tp["task-pipeline"]
|
||||
tp --> rp["review-pipeline<br/>9 агентов-проходов"]
|
||||
batch --> rp
|
||||
end
|
||||
subgraph pm["av-dev-pm — управление продуктом, владеет docs/"]
|
||||
direction LR
|
||||
init["init"] --> tasks["tasks"]
|
||||
canon["canon"] --> tasks
|
||||
session["session"] --> tasks
|
||||
docs["docs"]
|
||||
end
|
||||
opsx["opsx:* — внешний плагин:<br/>explore, propose, apply, archive"]
|
||||
git["av-dev-git: commit"]
|
||||
|
||||
tp --> opsx
|
||||
tp --> git
|
||||
tp --> docs
|
||||
tp --> tasks
|
||||
```
|
||||
|
||||
Зависимость **односторонняя: `av-dev-pipeline` знает про `av-dev-pm`, обратно —
|
||||
нет.** Управление продуктом работает в проекте без конвейера; конвейер без
|
||||
канона деградирует поразрядно и говорит об этом строкой.
|
||||
|
||||
## Канон документов проекта
|
||||
|
||||
Все проекты приводятся к одной раскладке — так проще ориентироваться, когда
|
||||
|
||||
Reference in New Issue
Block a user