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

@@ -50,11 +50,29 @@ description: Вести содержимое документов канона
 Синк документации:
 - architecture.md — добавлен воркер свёртки, ссылка на capability reindex
 - database.md — миграция 00006, таблица bucket
-- adr/ — заведён ADR-2026-08-03-ochered-tablicej: отказ от внешней очереди
+- adr/ — заведён ADR-2026-08-03-queue-as-table: отказ от внешней очереди
 - research/ — новое о формате не узнано
 - passport, security, conventions, review — не требуется: изменение внутреннее
+- сверка doc-consistency: находок нет, просмотрено 4 документа из 10
 ```
 
+## Сверка после синка
+
+Синк правит документы поодиночке, а расходятся они **между собой**: факт,
+дописанный в `architecture.md`, уже живёт в `CLAUDE.md`; периметр в
+`security.md` не знает про новый эндпоинт. Поймать это на своей же правке нельзя
+— поэтому последним шагом синка зовётся агент **`doc-consistency`** на те
+документы, которых синк касался.
+
+Он читает `docs/` и `openspec/`, кода не читает, ничего не правит и возвращает
+готовые формулировки. Строка его доклада входит в доклад синка — **включая
+пустую**: «находок нет, просмотрено N из M» это ответ, а молчание читается как
+«не звали».
+
+**Сверку с кодом синк не зовёт.** «Протухший факт, разошедшийся с кодом» смотрит
+`doc-code-drift`, он дорог (читает репозиторий) и зовётся раз в спринт на сессии
+— не на каждой сделанной задаче.
+
 ## ADR — промоут, а не второе сочинение
 
 Обоснование уже написано: `opsx:propose` кладёт `design.md` в каждый change, и