Files
dev-skills/decisions/58-doc-judges-healthcheck.md
T
av bf6a173115 журнал решений: разложен по теме на файл, метки решений стали номерами
- DECISIONS.md (4040 строк, 65 тем) → decisions/, файл на тему плюс указатель;
- буквенные метки решений заменены сквозными Р1–Р234, следствия получили
  префикс С при прежних номерах: схема букв выродилась до пятибуквенных и
  сломалась — `АЕАКЛ` была занята и темой 53, и темой 65;
- 42 перекрёстные ссылки переписаны под новые номера и стали живыми; где номер
  означал тему, а слово стояло «решение», формулировка исправлена.
2026-08-13 12:40:56 +03:00

3.6 KiB
Raw Blame History

58. Судьи документов получили свой скилл — healthcheck (2026-08-09)

Р206. Момент вызова был свойством чужого ритуала и исчез вместе с ним. doc-consistency и doc-code-drift звались шагом сессии между спринтами. Сессия стала грумингом, груминг судит задачи, а не документы, и звать чужих агентов он не вправе — они живут в av-dev-docs. На живом проекте их не звал бы никто, кроме разовых adopt и upgrade.

Чинить это возвратом вызова в груминг было нельзя: это ровно то нарушение границы, которое там и обнаружилось (вызов агента чужого плагина по имени, без ветки «плагина нет»). Момент нужно было назвать у владельца — и оказалось, что владельца-то у них и нет: canon их звал, но владел раскладкой, а не суждением.

Скилл av-dev-docs:healthcheck. Предмет — то, чего машина не видит: разошлись ли документы между собой и с кодом. Разрез с canon check проверяемый: машина сверяет форму, healthcheck — утверждения. «Раздел есть» проверит скрипт; «написано, что зависимость одна, а в манифесте их три» — суждение.

Почему скилл, а не просто описание агентов. Триггер у агента и так есть — его description. Но двоим нужна оркестровка: позвать обоих на весь канон разом, передать doc-code-drift раздел запретов, разобрать урожай порциями, назвать границы покрытия и то, кого именно позвал. Этого агент о себе не знает.

doc-wording внутрь не взят, и это разрез, а не забывчивость. Ему оркестровка не нужна: он один и работает по названному списку документов. И ритм другой — он нужен там, где текст только что писали, а не там, где он год лежал. Скилл, собравший всех троих «потому что все про документы», склеил бы разные вопросы под одним вызовом.

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

С193. Момент вызова — такая же собственность, как сам инструмент. Агент, чей момент назначен чужим ритуалом, теряет его вместе с ритуалом и замолкает беззвучно: он исправен, его просто никто не зовёт.

С194. Оркестровка — вот что отличает скилл от агента. Одному исполнителю с ясным входом скилл не нужен, его находит описание. Скилл заводят там, где надо решить, кого звать, что передать, в каком объёме и что делать с результатом.