doc-consistency и doc-code-drift звались шагом сессии между спринтами. Сессия стала грумингом, груминг судит задачи, а не документы, и звать чужих агентов не вправе — они в av-dev-docs. На живом проекте их не звал бы никто, кроме разовых adopt и upgrade. Момент назван у владельца. Разрез с canon check проверяемый: машина сверяет форму, healthcheck — утверждения. Почему скилл, а не просто описания агентов: двоим нужна оркестровка — позвать обоих на весь канон разом, передать doc-code-drift раздел запретов, разобрать урожай порциями, назвать границы покрытия и кого именно позвал. Этого агент о себе не знает. doc-wording внутрь не взят: ему оркестровка не нужна, и ритм другой — он нужен там, где текст только что писали. Заодно из shared/plugin-boundary.md и README убран счётчик скиллов: он протух дважды за день.
7.7 KiB
Что осталось сделать
Здесь только работы и их порядок. Чего здесь нет намеренно:
- риски, открытые вопросы и принятые пределы — REMAINING.md;
- почему решено так — DECISIONS.md, записи датированы;
- шаги повышения проекта с версии канона на версию — журнал версий (changelog.md). Пересказ их сюда был бы вторым домом, и прежний план на этом уже разъезжался: он повторял записи версий 3, 4 и 5 построчно, и половина повторов протухла молча.
Сделанное отсюда удаляется, а не помечается галочкой. След остаётся в
коммитах и в DECISIONS.md; список из двух сотен [x] перестают читать целиком,
и живые пункты в нём теряются — прежний план умер именно так.
Где мы сейчас
Плагинов четыре, и каждый ставится отдельно: av-dev-docs (канон документов и
их содержимое), av-dev-tasks (задачи и цели), av-dev-code (код по задачам:
цикл SDD, конвейер ревью, OpenSpec), av-dev-git. Общее, что нужно нескольким
дословно, живёт домом в shared/ и уезжает копиями.
Канон документов — версия 12. Живые проекты стоят на 2–3 и на плагине
av-dev-pm, которого больше нет.
1. Живые проекты — вернуть в рабочее состояние
Блокирует всё остальное: под текущим каноном не стоит ни один проект, и ни один
скилл, кроме docs.py check, не исполнялся на живом коде ни разу
(см. REMAINING, «Что ещё не сделано»).
healthlog — первым
- переустановить плагины: снять
av-dev-pmиav-dev-pipeline, поставитьav-dev-docs,av-dev-tasks,av-dev-code,av-dev-git. Оба прежних имени мертвы, иplugin updateих не переименует — только снять и поставить.marketplace update, затемplugin update— одного шага мало (README, «Обновление») - удалить проектные копии:
.claude/skills/healthlog-{task,review}-pipelineи девять.claude/agents/healthlog-review-*.md. Они прошлого поколения и после переезда указывают на документы, которых уже не будет av-dev-docs:canonв режимеadopt— он приведёт проект к канону 12 сразу, картой и с подтверждением. Файл-в-файл здесь не расписан: раскладку знает скилл, и второй перечень разошёлся бы с ним- каталог задач — в
tasks/корня (канон 11), не вdocs/tasks/, и безSPRINT.md(канон 12). Скилл задач зовётся изadoptсам - гейт проекта: три шага вместо одного —
docs.py check,tasks.py check --dir tasks,openspec.py check. Второй и третий раньше не были нужны: согласованность задач тянул за собойdocs.py, формуconfig.yamlон же. Теперь оба молчат, и без своих шагов дрейф перестанет ловиться - разобрать урожай
doc-consistencyиdoc-code-driftпорциями — правило единственного дома на живом проекте не проверял никто
jellybit — после калибровки
Порядок не произволен: замер (раздел 3) блокирует переезд jellybit, и только его.
- то же, что у healthlog: плагины, проектные копии,
adopt, каталог задач, гейт - проектные копии здесь опаснее: скиллы названы
task-pipeline,review-pipeline— ровно как в плагине, и короткое имя может увести в устаревшую копию молча (REMAINING)
2. Учёт работ без спринтов — что осталось
Сделано: спринт снят со скрипта и текстов, приоритет стал порядком строк в
беклоге, гейт готовности переехал в tasks.py ready, session стал скиллом
groom, запись 12 в журнал версий канона написана.
- прогнать груминг на живом беклоге — на фикстуре проверялись команды, а не сам разбор. Наблюдение к первому прогону: не выродился ли шаг 4 в «оставить как есть» — признак тот, что доклад не называет ни одного движения с доводом
3. Калибровка — блокирует переезд jellybit
- замер на четырёх находках healthlog: скелет из
null, откат бинаря, канонизация в транзакции,-1 >= -1. Цена и ожидаемый исход — REMAINING, «Главный незакрытый риск»
4. Пайплайн: что осталось после resolve
Сам скилл написан (av-dev-code:resolve, два чекпоинта, ветка разведки),
task-batch удалён. Осталось то, что на бумаге не проверяется:
- перемерить скилл
reviewтем же вопросом, что и проект целиком: сколько из его стадий реально смотрятся глазами. Тысяча строк, и весь автоматический участок между чекпоинтами держится на них - чекпоинт «объяснение» собирается из
proposal.mdиdesign.md, а требования к их форме уехали вopenspec/config.yaml(rules.proposal,rules.design). На живом проекте это ни разу не работало: неизвестно, хватает ли двух артефактов, чтобы объяснение не пришлось дописывать руками
5. Обкатка
- один-два цикла healthlog на новом процессе. Наблюдения к первой обкатке два: не выродились ли «границы покрытия» в шаблон (REMAINING, «Открытые вопросы») и не превратился ли чекпоинт в ритуал одобрения — признак тот же, дословно повторяющийся текст и согласие без единой правки