журнал решений: разложен по теме на файл, метки решений стали номерами

- DECISIONS.md (4040 строк, 65 тем) → decisions/, файл на тему плюс указатель;
- буквенные метки решений заменены сквозными Р1–Р234, следствия получили
  префикс С при прежних номерах: схема букв выродилась до пятибуквенных и
  сломалась — `АЕАКЛ` была занята и темой 53, и темой 65;
- 42 перекрёстные ссылки переписаны под новые номера и стали живыми; где номер
  означал тему, а слово стояло «решение», формулировка исправлена.
This commit is contained in:
av
2026-08-13 12:40:56 +03:00
parent b411d4edb8
commit bf6a173115
72 changed files with 4253 additions and 4053 deletions
+65
View File
@@ -0,0 +1,65 @@
# 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. Число в документе — обязанность, которую никто не берёт.** Счётчик тем,
коммитов, правок протухает молча; формулировка без числа дешевле его
сопровождения.