канон 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/canon.md

@@ -58,10 +58,10 @@ docs/
   security.md                  периметр; недоверенный вход; что вне модели
   conventions/
     README.md                  индекс, правило промоута, что механизировано
-    <тема>.md
+    <slug>.md
   research/
     README.md                  как снималось, индекс
-    <тема>.md                  наблюдения и числа с провенансом
+    <slug>.md                  наблюдения и числа с провенансом
   adr/
     README.md                  индекс записей, статусы, правило замены
     template.md
@@ -75,8 +75,29 @@ openspec/
   changes/archive/             архив изменений с design.md — сырьё для ADR
 ```
 
-Текст документов — русский; слаги файлов, capability и задач — английские,
-kebab-case.
+### Имена файлов английские, текст русский
+
+**Текст документов русский; имена файлов, capability и задач — английские,
+kebab-case.** Причина не эстетическая: имя файла стоит в ссылках из других
+документов, в коммитах и в путях, которые набирают руками, — а кириллица в пути
+ломается по-разному в разных местах и не набирается на английской раскладке.
+
+**Транслита не заводим.** Слаг именуется английским словом **по сути**, а не
+записью русского латиницей: `queue-as-table`, а не `ochered-tablicej`. Транслит
+нечитаем тому, кто ищет по смыслу, и не сокращается.
+
+У ADR имя вдобавок несёт форму — `ADR-ГГГГ-ММ-ДД-slug.md`: по ней записи
+сортируются, и по ней же ищется дата решения.
+
+`docs.py check` проверяет кириллицу и kebab-case **жёстко**, форму имени ADR —
+тоже, а транслит **эвристикой**, то есть замечанием: английское слово от
+транслита машина не отличает. Слаги каталога задач ведёт `tasks.py` — там та же
+проверка и тот же разрез.
+
+**Переименование — не правка, а перенос ссылок**: делается одним проходом по
+всем местам, где имя упомянуто, иначе останутся битые ссылки. Для задач это
+умеет `tasks.py adopt`; для документов канона правит человек, а `docs.py` потом
+показывает, что ссылки целы.
 
 ## Роли документов
 
@@ -297,6 +318,7 @@ kebab-case.
 
 Факт живёт ровно в одном файле; остальные ссылаются. Карта на случай спора:
 
+<!-- дом: карта-домов -->
 | Факт | Дом |
 | --- | --- |
 | поведение системы | `openspec/specs/<capability>/spec.md` |
@@ -311,6 +333,7 @@ kebab-case.
 | единые точки проекта | `architecture.md` |
 | имя основной ветки, `testdata`, временный каталог | `CLAUDE.md` |
 | что уже механизировано правилом | `conventions/README.md` |
+<!-- /дом: карта-домов -->
 
 ## Пустое называется пустым
 
@@ -347,16 +370,31 @@ kebab-case.
 Граница объявляется вслух в каждом отчёте: `check`, отчитавшийся «канон
 соблюдён» на проекте, где из шести файлов три лишние, хуже отсутствующего.
 
-| Проверяет `docs.py` | Судит агент |
-| --- | --- |
-| отсутствующие пути канона | смысловой дубль документа и capability |
-| файлы в `docs/` вне канона | поведение, оставшееся в `architecture.md` |
-| битые относительные ссылки | протухший факт, разошедшийся с кодом |
-| версия канона и её отставание | достаточность честной строки в пустом слоте |
-| нетронутый плейсхолдер шаблона | связность и читаемость |
-| маркеры долга — числом | |
-| миграция изменена, а `database.md` нет | |
-| capability без упоминания в `architecture.md` | |
+| Проверяет `docs.py` | Судит агент | Какой |
+| --- | --- | --- |
+| отсутствующие пути канона | смысловой дубль документа и capability | `doc-consistency` |
+| файлы в `docs/` вне канона | поведение, оставшееся в `architecture.md` | `doc-consistency` |
+| имя файла не kebab-case латиницей; форма имени ADR | транслит в имени — сверх эвристики | `doc-wording` |
+| битые относительные ссылки | прямое противоречие между документами | `doc-consistency` |
+| версия канона и её отставание | достаточность честной строки в пустом слоте | `doc-consistency` |
+| нетронутый плейсхолдер шаблона | ADR без ссылки на `design.md`, замена без парного статуса | `doc-consistency` |
+| маркеры долга — числом | **протухший факт, разошедшийся с кодом** | `doc-code-drift` |
+| миграция изменена, а `database.md` нет | зависимость в манифесте, не названная в обзоре | `doc-code-drift` |
+| capability без упоминания в `architecture.md` | второй способ там, где обзор обещал единственный | `doc-code-drift` |
+| | связность и читаемость | `doc-wording` |
+
+**Агентов двое, и разведены они по глубине, а не по охвату.** `doc-consistency`
+читает только `docs/` и `openspec/` — сверка текста с текстом дёшева и зовётся на
+каждом синке документации. `doc-code-drift` читает репозиторий и гоняет читающие
+команды: дорого, и зовётся раз в спринт и перед приведением проекта к канону.
+Слитый агент делал бы дешёвую половину редкой, а дорогую — поверхностной; тот же
+разрез, что между `task-form` и `doc-wording`.
+
+**Перечень фактов, которые `doc-code-drift` сверяет с кодом, закрыт** — имя
+основной ветки, команды, пути, зависимости поимённо, настройки с числовым
+значением, единые точки проекта, capability, проверяемые инварианты. «Сверить
+архитектуру с кодом» задача без дна, и агент, которому её поставили, выдаёт
+правдоподобную труху вместо находок.
 
 ## `docs/.pm.json`