канон 4: слаг подкреплён проверкой, обещанный судья заведён

Оба пункта заметок оказались одним классом: правило записано и никем не
исполняется.

Слаги. canon.md говорил «слаги файлов, capability и задач — английские,
kebab-case» одной строкой в хвосте раскладки, а docs.py имён файлов не
смотрел вовсе. Итог нашёлся в самом плагине: единственный пример ADR в
скилле docs назывался ADR-2026-08-03-ochered-tablicej. Раскладка канона
при этом приглашала к нарушению — в схеме стояли плейсхолдеры <тема>.md,
то есть слово «тема» по-русски там, где надо писать <slug>.

docs.py check теперь смотрит имена: кириллица и не-kebab-case жёстко,
форма ADR-ГГГГ-ММ-ДД-slug.md жёстко, транслит эвристикой, то есть
замечанием. Проверяются docs/conventions, docs/research, docs/adr и имена
capability; каталог задач не трогается — его слаги ведёт tasks.py.

Набор маркеров транслита подобран так, чтобы ложных срабатываний не было
вовсе: выброшены ost (ловит post, cost), sch (schema), ya (yaml), nost
(nostalgia), хвост ii (radii). Цена названа в комментарии —
sostoyanie-partii проходит мимо. Правило, краснеющее на правде, приучает
пролистывать весь блок, и это дороже пропуска.

Агенты. В canon.md есть таблица «Что проверяет машина, а что человек», и
её правая колонка — смысловой дубль, поведение в architecture.md,
протухший факт, достаточность честной строки — три версии описывала
работу, которую никто не делал: скилл canon предлагал агенту судить об
этом самому, то есть проверять то, что он же и писал.

Заведены двое, разрез по глубине — тот же довод, что развёл task-form и
doc-wording. doc-consistency читает docs/ и openspec/, сверяет документы
между собой (факт в двух домах, прямое противоречие, поведение в обзоре
вместо спек, ADR без ссылки на design.md и без парного статуса, число без
провенанса, заглушка вместо честной строки) и зовётся на шаге синка
документации. doc-code-drift читает репозиторий, отвечает на «этот факт
ещё верен» и зовётся раз в спринт на сессии.

Перечень фактов, сверяемых с кодом, закрыт: имя ветки, команды, пути,
зависимости поимённо, настройки с числом, единые точки проекта,
capability, проверяемые инварианты. «Сверить архитектуру с кодом» —
задача без дна, и агент, которому её поставили, выдаёт правдоподобную
труху. Отсюда форма его доклада: начинается таблицей проверенного, а не
находками, — по ней видно, чего он не смотрел.

Карта домов уехала в устав doc-consistency помеченной копией: устав
ссылался на файл плагина, а агент работает в репозитории проекта, где
плагина может не быть. copies.py её сторожит.

Попутно: докстрока copies.py показывала закрывающие маркеры как
<!-- /дом -->, а код требует <!-- /дом: <id> -->. Нашлось первой же
попыткой ими воспользоваться.

DECISIONS тема 28 (ННОО–ХХЦЦ, следствия 105–108).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

DECISIONS.md

@@ -1915,3 +1915,66 @@ ADR, запискам разведки и сообщениям коммитов
      правящих мету, стало пять, и второй, перечитавший файл, стёр бы правку
      первого. Общий `stage()` поверх `files` снял целый класс отказов, который до
      этого держался на том, что шагов было мало.
+
+## 28. Слаг подкреплён проверкой, обещанный судья заведён (2026-08-05)
+
+Два пункта заметок, оба про одно: правило было записано и никем не исполнялось.
+
+**ННОО. Правило про английские слаги существовало и не проверялось ничем.**
+`canon.md` говорил «слаги файлов, capability и задач — английские, kebab-case»
+одной строкой в хвосте раскладки; `docs.py` имён файлов не смотрел вовсе. Итог
+предсказуем и нашёлся в самом плагине: единственный пример ADR в скилле `docs`
+назывался `ADR-2026-08-03-ochered-tablicej`. Раскладка канона при этом
+приглашала к нарушению — в схеме стояли плейсхолдеры `<тема>.md`, то есть слово
+«тема» по-русски там, где надо было писать `<slug>`.
+
+Разрез проверки — по тому, что машина знает точно: кириллица в имени и не-kebab-case
+**жёстко**, форма `ADR-ГГГГ-ММ-ДД-slug.md` жёстко, транслит **эвристикой**, то есть
+замечанием. Набор маркеров транслита подобран так, чтобы **ложных срабатываний не
+было вовсе**: выброшены `ost` (ловит `post`, `cost`), `sch` (`schema`), `ya`
+(`yaml`), `nost` (`nostalgia`), хвост `ii` (`radii`). Цена названа: `sostoyanie-partii`
+проходит мимо. Правило, краснеющее на правде, приучает пролистывать весь блок —
+это дороже пропуска.
+
+**ППРР. Канон три версии обещал судью, которого не было.** В `canon.md` есть
+таблица «Что проверяет машина, а что человек», и её правая колонка — смысловой
+дубль, поведение в `architecture.md`, протухший факт, достаточность честной
+строки — описывала работу, которую никто не делал: скилл `canon` предлагал
+агенту судить об этом самому, то есть проверять то, что он же и писал. Заведены
+`doc-consistency` и `doc-code-drift`, а колонка получила третий столбец с именем
+судьи: обещание без адресата и есть тот способ, которым правило перестаёт
+исполняться.
+
+**ССТТ. Агентов двое, разрез по глубине, а не по охвату.** Тот же довод, что
+развёл `task-form` и `doc-wording`: сверка текста с текстом дёшева и зовётся на
+каждом синке документации, сверка с кодом требует читать репозиторий и зовётся
+раз в спринт. Слитый агент делает дешёвую половину редкой либо дорогую —
+поверхностной.
+
+**УУФФ. Перечень фактов, сверяемых с кодом, закрыт.** Имя основной ветки,
+команды, пути, зависимости поимённо, настройки с числовым значением, единые точки
+проекта, capability, проверяемые инварианты. «Сверить архитектуру с кодом» —
+задача без дна, и агент, которому её поставили, выдаёт правдоподобную труху
+вместо находок. Отсюда и форма доклада `doc-code-drift`: он начинается **таблицей
+проверенного**, а не находками, — по ней видно, чего он не смотрел.
+
+**ХХЦЦ. Карта домов уехала в устав агента помеченной копией.** Устав ссылался на
+файл плагина, а агент работает в репозитории проекта, где плагина может не быть.
+Копия дословная, под маркерами `дом`/`копия`, и `copies.py` теперь её сторожит —
+механизм для этого в репозитории уже был.
+
+### Что из этого следует
+
+105. **Записанное правило без проверки не исполняется даже автором.** Слаг ADR
+     нарушен в единственном примере, который плагин показывает как образец. Тот
+     же класс, что «прозаический триггер ADR дал 6 записей на 43 изменения»:
+     умолчание становится отличимым только когда его проверяют.
+106. **Плейсхолдер — часть правила.** `<тема>.md` в схеме раскладки перевешивал
+     строку правила, стоявшую двумя абзацами ниже: образец читают вместо текста.
+107. **Эвристика настраивается по ложным срабатываниям, а не по полноте.** Ноль
+     ложных при одном пропуске лучше, чем наоборот: пропуск стоит одной ненайденной
+     находки, ложное срабатывание — доверия ко всему блоку.
+108. **Докстрока разошлась с кодом ровно там, где её читают.** `copies.py`
+     показывал закрывающие маркеры как `<!-- /дом -->`, а требовал
+     `<!-- /дом: <id> -->`; нашлось это первой же попыткой ими воспользоваться.
+     Пример в докстроке — тот же образец, что плейсхолдер в схеме.