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:
+15
-3
@@ -1033,9 +1033,21 @@ HTML-комментарии, невидимые в отрендеренном ma
|
||||
ровно эту ошибку. Исключение одно и оно же сток: триаж.
|
||||
|
||||
**BBB. Диаграммы в скиллах — `mermaid`.** Граф, описанный прозой, читается как
|
||||
инструкция и теряет форму; диаграмма показывает её целиком. Четыре штуки: общий
|
||||
граф прогона, граф профиля `design`, пример графа задач батча, веер финальной
|
||||
сверки.
|
||||
инструкция и теряет форму; диаграмма показывает её целиком. В конвейере четыре:
|
||||
общий граф прогона, граф профиля `design`, пример графа задач батча, веер
|
||||
финальной сверки.
|
||||
|
||||
**Критерий, где диаграмма уместна: структура — граф или автомат, и проза
|
||||
вынуждена его пересказывать.** По этому критерию диаграммы заведены ещё в шести
|
||||
местах: жизненный цикл записи по индексам (`tasks`), четыре шага сессии с
|
||||
причинами на рёбрах (`session`), исходы задачи в спринте (`sprint.md`), одиннадцать
|
||||
шагов пайплайна с развилкой «тривиальная» (`task-pipeline`), храповик промоута с
|
||||
обратным ребром (`promote.md`), счётчик `retune` до `drop` (`calibration.md`) и
|
||||
граф вызовов между плагинами (`README.md`). Где структура — таблица соответствий
|
||||
(чек-лист синка в `docs`, профили ревью, коды выхода), диаграмма не заводится:
|
||||
она бы дублировала таблицу и разошлась с ней. Все диаграммы прогоняются через
|
||||
`mermaid-cli` перед коммитом — синтаксическая ошибка в блоке не видна при чтении
|
||||
и молча ломает рендер.
|
||||
|
||||
### Что из этого следует
|
||||
|
||||
|
||||
Reference in New Issue
Block a user