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

@@ -67,23 +67,29 @@ python3 $ds version --dir <корень>                # версия кано
 capability: незаполненный канон это переходное состояние, а не отказ. Маркеры
 долга просто считает числом.
 
-**Ты** судишь о том, чего она не умеет:
+Того, чего она не умеет, **ты не судишь сам** — для этого есть два агента, и
+разведены они по глубине:
 
-- **смысловой дубль** — `docs/specs/recognition.md` описывает то же, что
-  capability `recognition`. Файлы разные, содержание одно;
-- **поведение, оставшееся в `architecture.md`** — раздел на 900 строк с
-  требованиями вместо обзора;
-- **достаточность честной строки** — «внешних зависимостей нет» это факт,
-  «TBD» — пробел;
-- **протухший факт** — документ ссылается на то, чего в коде уже нет.
+| Агент | Что смотрит | Читает |
+| --- | --- | --- |
+| `doc-consistency` | смысловой дубль, прямое противоречие между документами, поведение в `architecture.md` вместо спек, ADR без ссылки и парного статуса, число без провенанса, заглушка вместо честной строки | `docs/`, `openspec/` |
+| `doc-code-drift` | протухший факт: имя ветки, команды, пути, зависимости поимённо, настройки с числом, единые точки проекта, capability | весь репозиторий |
+
+Судит **не тот, кто писал**: самопроверка документа слабее всего ровно там, где
+формулировка казалась удачной при написании. Ни один из них ничего не правит —
+оба возвращают готовые формулировки, подставляешь ты.
 
 ## `check`
 
 1. `docs.py check`, при наличии базы диффа — с `--base`.
-2. Прочитай то, что скрипт проверить не может (список выше), по документам,
-   которых касалась работа. Не «заодно по всему `docs/`».
-3. Доклад: вывод скрипта строкой исхода, твои находки поимённо, **граница
-   покрытия** — что смотрел и чего не смотрел.
+2. **Позови `doc-consistency`** на документы, которых касалась работа. Не «заодно
+   по всему `docs/`»: агент зовётся пачкой, но пачка отбирается работой.
+3. **`doc-code-drift`** — не на каждом `check`, а перед приведением проекта к
+   канону и раз в спринт (шаг сессии). Он дорог: читает репозиторий и гоняет
+   команды. Позвал — передай ему раздел запретов `CLAUDE.md`.
+4. Доклад: вывод скрипта строкой исхода, находки агентов поимённо, **граница
+   покрытия** — что смотрели и чего не смотрели, и **был ли позван
+   `doc-code-drift`**: доклад, умолчавший об этом, читается как «с кодом сверено».
 
 Дрейф раскладки чинится переносом; смысловые находки — это либо правка
 документа, либо задача, если работы больше чем на абзац.