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:
av
2026-08-03 20:32:17 +03:00
co-authored by Claude Opus 5
parent 57714c3549
commit dd69251d04
8 changed files with 190 additions and 3 deletions
@@ -23,6 +23,23 @@
| `retune` уже был дважды подряд | `drop` | удаляем проход |
| находит, но ложных больше трети от всех находок | `retune` | триаж съедает больше, чем экономит проход |
Вердикты образуют храповик со счётчиком — его-то таблица и не показывает:
```mermaid
stateDiagram-v2
state "проход в профиле" as live
state "retune №1 — правка charter'а" as r1
state "retune №2 — последняя попытка" as r2
state "проход удалён" as dead
[*] --> live: заведён и откалиброван ДО включения
live --> r1: 1/3, 0/3 или ложных больше трети
r1 --> live: замер keep — счётчик сброшен
r1 --> r2: снова не ловит
r2 --> live: замер keep — счётчик сброшен
r2 --> dead: снова не ловит — это театр
```
**`retune` не более двух раз подряд.** Проход, не находящий дефект своего класса
в 2 из 3 прогонов после двух правок промпта, — это театр. Удалять, а не
бесконечно править формулировки: каждая итерация правки промпта стоит дороже,
@@ -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. Находка → конвенция
Условия: находка **принята** при ревью (не отвергнута, не понижена в гипотезу) и