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