av
bf6a173115
- DECISIONS.md (4040 строк, 65 тем) → decisions/, файл на тему плюс указатель; - буквенные метки решений заменены сквозными Р1–Р234, следствия получили префикс С при прежних номерах: схема букв выродилась до пятибуквенных и сломалась — `АЕАКЛ` была занята и темой 53, и темой 65; - 42 перекрёстные ссылки переписаны под новые номера и стали живыми; где номер означал тему, а слово стояло «решение», формулировка исправлена.
5.8 KiB
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. Число в документе — обязанность, которую никто не берёт. Счётчик тем, коммитов, правок протухает молча; формулировка без числа дешевле его сопровождения.