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>
2026-08-03 20:32:17 +03:00
parent 57714c3549
commit dd69251d04
8 changed files with 190 additions and 3 deletions
@@ -11,6 +11,27 @@
 - **правила линтера** — то же с детерминированным оракулом и нулевой ценой
  внимания.

+```mermaid
+flowchart TD
+    f["находка ревью"]
+    cond{"принята и не специфична<br/>для одного места?"}
+    no["промоуту не подлежит:<br/>место одно — комментарий в коде;<br/>вкусовщина — вон на триаже;<br/>нужен рантайм — в журнал ревью"]
+    conv["конвенция:<br/>проверяемое свойство + какой проход нашёл"]
+    rule["правило линтера, запретитель,<br/>тест-сканер или анализатор"]
+    clean["шаг 3: формулировка удалена из конвенций,<br/>строка — в conventions/README.md"]
+
+    f --> cond
+    cond -->|нет| no
+    cond -->|да| conv
+    conv --> rule
+    rule --> clean
+    rule -->|"ложных чаще, чем ловит (~треть)"| conv
+```
+
+Ребро назад — обратное движение (внизу): правило, дающее ложные срабатывания
+чаще, чем ловит, снимается в прозу. Ребро `rule → clean` **обязательное**: без
+него первые два шага не окупаются, а именно его и пропускают.
+
 ## Шаг 1. Находка → конвенция

 Условия: находка **принята** при ревью (не отвергнута, не понижена в гипотезу) и