# 29. Обкатка `doc-consistency` на самом dev-skills (2026-08-05)

Первый прогон агента — по репозиторию, который его же и содержит. Два прохода
(av-dev-pm; пайплайн плюс верхний уровень), 17 находок, все подтверждены по
файлам.

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

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

Исход не «поправить значение», а **убрать причину**: `canon.md` дважды объявлял,
что фиксирует только словарь типов, — значит колонкам «разделы» и «цель» в нём
не место. Осталась таблица из двух колонок и ссылка на дом схемы.

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

**Р121. Находка про коммиты снята как неверная, и это дефект самого агента.** Он
прочитал `av-dev-git/skills/commit/SKILL.md` («без `Co-Authored-By`») как
описание практики этого репозитория и предъявил 38 коммитов с трейлером. Но
dev-skills — **маркетплейс плагинов**: скилл коммита здесь продукт, уезжающий в
чужие проекты, а не правило, которому подчиняется сам репозиторий. Устав агента
не различает «документ описывает этот репозиторий» и «документ описывает то, что
репозиторий производит».

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

## Что из этого следует

**С109. Правка модели идёт по обратным ссылкам, а не по изменённым файлам.**
Меняешь дом — обойди тех, кто на него ссылается: `grep` по упразднённому слову
дал бы все пять остатков за минуту. Это дешевле любого агента и должно идти до
него.

**С110. Ссылка на дом не отменяет копию, стоящую рядом.** Проверять надо не
«есть ли ссылка», а «есть ли пересказ»; `tasks/SKILL.md` имел и то и другое.

**С111. Копия расходится с домом в пределах одного коммита.** Прежняя оценка
(«разойдётся на первой правке») занижена: расхождение возникает при написании,
если оба места пишет один проход.

**С112. Агент, читающий репозиторий-продукт, обязан различать «про нас» и «про
то, что мы производим».** Иначе он предъявляет продукту практику его
потребителя. Устав `doc-consistency` этого различения не содержит — остаток
записан в REMAINING.

**С113. Число в документе — обязанность, которую никто не берёт.** Счётчик тем,
коммитов, правок протухает молча; формулировка без числа дешевле его
сопровождения.