av/dev-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

healthcheck: у судей документов появился свой скилл и свой момент

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

Момент назван у владельца. Разрез с canon check проверяемый: машина
сверяет форму, healthcheck — утверждения.

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

doc-wording внутрь не взят: ему оркестровка не нужна, и ритм другой —
он нужен там, где текст только что писали.

Заодно из shared/plugin-boundary.md и README убран счётчик скиллов: он
протух дважды за день.
This commit is contained in:
av
2026-08-09 16:58:51 +03:00
parent df5af47dc3
commit 4354cc4146
14 changed files with 218 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files
av-dev-docs/skills/docs/SKILL.md
+7 -6
View File
@@ -62,12 +62,13 @@ description: Вести содержимое документов канона
`security.md` не знает про новый эндпоинт. Поймать это на своей же правке нельзя,
и судит это агент `doc-consistency`.
**Но синк его не зовёт.** Оба судьи документов — `doc-consistency` и
`doc-code-drift` — зовутся раз в спринт, шагом сессии, на весь канон разом.
Причина в цене: `doc-consistency` на `opus` по каждой сделанной задаче — самая
дорогая церемония процесса, а `doc-code-drift` хоть и на `sonnet`, но читает
репозиторий целиком. К тому же расхождение между двумя документами по определению
требует двух документов, а на большинстве задач синк правит один.
**Но синк его не зовёт.** Обоими судьями документов владеет скилл
`av-dev-docs:healthcheck`, и зовут их на весь канон разом, а не на пачку,
отобранную работой. Причина в цене: `doc-consistency` на `opus` по каждой
сделанной задаче — самая дорогая церемония процесса, а `doc-code-drift` хоть и на
`sonnet`, но читает репозиторий целиком. К тому же расхождение между двумя
документами по определению требует двух документов, а на большинстве задач синк
правит один.
Что теряется: привязка находки к задаче, которая её породила. Что выигрывается,
кроме денег: синк перестаёт отбирать пачку, и в неё попадают документы,