разбор находок doc-consistency: остатки модели типов и копии в ссылки

Первый прогон агента — по репозиторию, который его же и содержит. Два
прохода, 17 находок, все подтверждены по файлам.

Пять находок — остатки прежней модели типов в файлах, до которых я не
дошёл двумя коммитами раньше. adopt.md держал имена секций роадмапа
канона 2 («порядка», «темы») и «пустой goal законен только у идеи»;
from-review.md и TODO.md — упразднённый [idea]; task-batch в другом
плагине — «задачи-идеи». Правку модели я вёл от документов, которые
менял, а не от тех, что на них ссылаются: grep по упразднённому слову
дал бы все пять за минуту.

Самая дорогая находка оказалась моей и свежей. Таблица типов в canon.md
объявляла цель у fix запрещённой, а tasks/SKILL.md и task-fix.md —
необязательной; код на стороне вторых. Копия разошлась с домом за один
день, обе половины писал один проход. Поправлено не значение, а причина:
canon.md дважды объявлял, что фиксирует только словарь типов, — значит
колонкам «разделы» и «цель» в нём не место. Осталась таблица из двух
колонок и ссылка на дом схемы.

Перечень «чем держат проект» пересказывался втроём и разъехался:
«метрики и логи» против «мониторинга», «проверки» есть в двух из трёх.
При этом tasks/SKILL.md ссылался на дом рядом с собственным пересказом —
ссылка не мешает копии разойтись, если копия всё равно стоит. Перечень
остался в canon.md, два места ссылаются.

README пересказывал раскладку канона блоком кода, и копия была уже
неполна — не хватало путей, чьё отсутствие docs.py считает нарушением.
Заменено ссылкой. Там же измеренное число из DECISIONS III заменено
ссылкой на решение.

REMAINING дублировал два отмеченных сделанными пункта TODO и держал
счётчики, которые обязан двигать человек: «двенадцати тем и 16 коммитов»
(стало 28 и 52), «три неизмеренных изменения» (стало больше). Счётчики
отменены как класс, причина записана в шапку. Открытый вопрос про парный
статус ADR переформулирован: судья появился, открыт остался охват.

Три противоречия вне av-dev-pm: --roadmap-sections перечислен среди
флагов init прозой того же файла, объявляющей, что его нет; review-ops
берёт журнал docs/review.md и тут же объявляет историю инцидентов
принципиально недоступной; «честный предел» конвейера отменял целиком
документ docs/research/. Плюс битый якорь ссылки на раздел вычитки.

Находка про Co-Authored-By снята как неверная: агент прочитал
av-dev-git/skills/commit/SKILL.md как описание практики этого
репозитория, а это продукт, уезжающий в чужие проекты. Устав агента не
различает «документ про нас» и «документ про то, что мы производим» —
остаток записан в REMAINING, в устав пока не дописан.

DECISIONS тема 29 (ЧЧШШ–ЮЮЯЯ, следствия 109–113).

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

DECISIONS.md

@@ -1978,3 +1978,66 @@ ADR, запискам разведки и сообщениям коммитов
      показывал закрывающие маркеры как `<!-- /дом -->`, а требовал
      `<!-- /дом: <id> -->`; нашлось это первой же попыткой ими воспользоваться.
      Пример в докстроке — тот же образец, что плейсхолдер в схеме.
+
+## 29. Обкатка `doc-consistency` на самом dev-skills (2026-08-05)
+
+Первый прогон агента — по репозиторию, который его же и содержит. Два прохода
+(av-dev-pm; пайплайн плюс верхний уровень), 17 находок, все подтверждены по
+файлам.
+
+**ЧЧШШ. Агент нашёл ровно тот класс, ради которого заводился, и в свежей
+работе.** Пять находок — остатки прежней модели типов в файлах, которые я не
+дошёл поправить двумя коммитами раньше: `adopt.md` держал имена секций **канона
+2**, `from-review.md` и `TODO.md` — упразднённый `[idea]`, `task-batch` в другом
+плагине — «задачи-идеи». Правку модели я вёл от документов, которые менял, а не
+от документов, которые на них ссылаются, — и обратный обход не сделал ни разу.
+
+**ЩЩЪЪ. Самая дорогая находка была моей и свежей.** Таблица типов в `canon.md`
+объявляла цель у `fix` запрещённой, а `tasks/SKILL.md` и `task-fix.md` —
+необязательной; код на стороне вторых. Копия разошлась с домом **за один
+день** — я написал обе половины в одном коммите. Это и есть цена второго дома в
+чистом виде: не «когда-нибудь разойдётся», а «разошлось прежде, чем высохли
+чернила».
+
+Исход не «поправить значение», а **убрать причину**: `canon.md` дважды объявлял,
+что фиксирует только словарь типов, — значит колонкам «разделы» и «цель» в нём
+не место. Осталась таблица из двух колонок и ссылка на дом схемы.
+
+**ЫЫЬЬ. Копии перечня «чем держат проект» разъехались втроём.** `canon.md`,
+`tasks/SKILL.md` и `task-goal.md` пересказывали его своими словами: «метрики и
+логи» против «мониторинга», «проверки» есть в двух из трёх. При этом
+`tasks/SKILL.md` **ссылался на дом рядом с собственным пересказом** — ссылка не
+мешает копии разойтись, если копия всё равно стоит.
+
+**ЭЭЮЮ. Находка про коммиты снята как неверная, и это дефект самого агента.**
+Он прочитал `av-dev-git/skills/commit/SKILL.md` («без `Co-Authored-By`») как
+описание практики этого репозитория и предъявил 38 коммитов с трейлером. Но
+dev-skills — **маркетплейс плагинов**: скилл коммита здесь продукт, уезжающий в
+чужие проекты, а не правило, которому подчиняется сам репозиторий. Устав агента
+не различает «документ описывает этот репозиторий» и «документ описывает то, что
+репозиторий производит».
+
+**ЮЮЯЯ. Счётчики в документах отменены как класс.** `REMAINING.md` держал «после
+разбора двенадцати тем и 16 коммитов» (стало 28 и 52) и «три неизмеренных
+изменения подряд» (стало больше). Оба числа обязан двигать человек, и оба
+отстали молча. Заменены на формулировки, которые не надо поддерживать, и в шапку
+записана причина.
+
+### Что из этого следует
+
+109. **Правка модели идёт по обратным ссылкам, а не по изменённым файлам.**
+     Меняешь дом — обойди тех, кто на него ссылается: `grep` по упразднённому
+     слову дал бы все пять остатков за минуту. Это дешевле любого агента и
+     должно идти до него.
+110. **Ссылка на дом не отменяет копию, стоящую рядом.** Проверять надо не
+     «есть ли ссылка», а «есть ли пересказ»; `tasks/SKILL.md` имел и то и другое.
+111. **Копия расходится с домом в пределах одного коммита.** Прежняя оценка
+     («разойдётся на первой правке») занижена: расхождение возникает при
+     написании, если оба места пишет один проход.
+112. **Агент, читающий репозиторий-продукт, обязан различать «про нас» и «про
+     то, что мы производим».** Иначе он предъявляет продукту практику его
+     потребителя. Устав `doc-consistency` этого различения не содержит — остаток
+     записан в REMAINING.
+113. **Число в документе — обязанность, которую никто не берёт.** Счётчик тем,
+     коммитов, правок протухает молча; формулировка без числа дешевле его
+     сопровождения.