канон 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>

av-dev-pm/skills/canon/references/changelog.md

@@ -81,6 +81,20 @@ upgrade` идёт по записям снизу вверх от версии п
 9. **Алгоритм работы над каждым типом** — отдельным файлом,
    `skills/tasks/references/task-<тип>.md`: схема, что проверяет машина, что
    человек, и порядок шагов.
+10. **Имена файлов проверяются.** Правило «текст русский, имена английские»
+    стояло в каноне и не было подкреплено ничем: `docs.py` имён не смотрел вовсе.
+    Теперь смотрит — кириллица и не-kebab-case **жёстко**, форма имени
+    `ADR-ГГГГ-ММ-ДД-slug.md` жёстко, транслит **эвристикой**, то есть
+    замечанием. Заодно из раскладки канона убраны плейсхолдеры `<тема>.md`,
+    приглашавшие называть файлы по-русски.
+11. **Два агента вместо обещания.** В каноне была таблица «Что проверяет машина,
+    а что человек», и её правая колонка три версии описывала судью, которого не
+    существовало. Судьи заведены и разведены по глубине: **`doc-consistency`**
+    (документ ↔ документ ↔ openspec: факт в двух домах, прямое противоречие,
+    поведение в `architecture.md` вместо спек, ADR без ссылки и парного статуса,
+    число без провенанса, заглушка вместо честной строки) зовётся на шаге синка
+    документации; **`doc-code-drift`** (документ ↔ код по закрытому перечню
+    фактов) — раз в спринт на сессии и перед приведением проекта к канону.
 
 **Что сделать проекту:**
 
@@ -108,7 +122,15 @@ upgrade` идёт по записям снизу вверх от версии п
    `research`. Не «заодно по всему беклогу», а порциями переоценки: `check`
    ошибкой это не считает, отказывает только `sprint take`. Сколько задач готово
    к взятию, печатает блок здоровья `check`.
-7. `docs/.pm.json`: `"canon": 4`.
+7. Прогнать `python3 docs.py check`: он назовёт имена файлов не по правилу.
+   Кириллицу и не-kebab-case править обязательно, транслит — по решению
+   человека. **Переименование ADR это перенос ссылок**: слаг стоит в
+   `adr/README.md`, в `architecture.md` и в чужих документах, и делается одним
+   проходом, иначе останутся битые ссылки (их `docs.py` потом и покажет).
+8. Позвать `doc-consistency` на документы канона — первый прогон на живом
+   проекте обычно самый урожайный: правило единственного дома до сих пор никто
+   не проверял. Разбирать порциями, а не одним заходом.
+9. `docs/.pm.json`: `"canon": 4`.
 
 ## Версия 3 — 2026-08-04