Files

T

граница: правило стало про раскладку проекта, а не про соседний плагин

Дом shared/plugin-boundary.md переехал в shared/absence.md: отсутствовала всё
это время не установка плагина, а часть раскладки проекта, и узнавалась она
следом на диске. Перечень внешнего сократился до двух — opsx и av-dev-git.
Ветки «плагина нет» переписаны на «этой части в проекте нет»; там, где ветка
существовала только ради неразрешимого пути в чужое дерево, она снята вовсе.

Внутриплагинные копии языка и словаря сопровождения сняты: два справочника по
213 строк и один по 34 заменены ссылкой на общий дом. Копии остались там, где
текст обязан лежать внутри промпта, — в уставах вычитки. Заодно починены пути
$CLAUDE_PLUGIN_ROOT и относительные ссылки, разъехавшиеся с новыми именами
каталогов.

2026-08-13 10:18:04 +03:00

6.3 KiB

Raw Blame History

🧹 `chore` — обслуживание, наблюдаемое поведение не меняется

Зависимости, сборка, перенос, чистка, оснастка. Отвечает на «что нужно сделать», глаголом в неопределённой форме.

Общая форма записи (мета, слаг, строка индекса) — task-format.md. Здесь только то, что у этого типа своё.

Схема


Заголовок отвечает на	что нужно сделать
Обязательные разделы	`Затрагивает`, `Критерии приёмки`
Допустимые сверх того	`Рамки`, `Вопросы`
Поле места	Категория — полка домена беклога
Цель (`goal:<слаг>`)	нет: цель — это возможность, а здесь её не появляется
Индекс	`BACKLOG.md`
Берётся в работу	да

Адресат — разработчик, и это законно

Тест готовности спрашивает «что станет наблюдаемо иначе». У chore ответ адресован разработчику, а не пользователю: «перестанет собираться два раза», «уедет последний вызов устаревшего API», «проверки гоняются одной командой». Это ответ, а не отговорка.

У chore тест готовности слабее честно, а не молча. Пока типа не было, такие задачи либо не заводились вовсе, либо формулировались как выдуманная пользовательская польза — и то и другое хуже, чем сказать прямо, для кого работа.

Отсюда же граница: если после задачи меняется то, что видит пользователь, — это не chore. Тип, оставшийся от первой формулировки, врёт ровно там, где по нему отбирают.

Обнаружилось это уже в работе — запись переформулируется, а не дорешивается. Исполнитель останавливается, называет тип, которым задача оказалась (fix — поведение расходится с заявленным, feature — снаружи появляется то, чего не было), и человек решает: сменить тип и решать процессом того типа — либо прекратить. Тип меняет этот скилл, а не исполнитель по ходу: у нового типа своя схема разделов, и ready проверит её заново.

Алгоритм

Проверить, что поведение не меняется. Меняется — это feature или fix, и у неё другие требования (цель, воспроизведение).
Назвать, что перестанет мешать — одной фразой, адресуясь разработчику. «Прибраться в модуле X» — не ответ: непонятно, что изменится.
Назвать границы в Затрагивает. У обслуживания они часто не в коде: конфиг и его образцы, версия зависимости, команда сборки, файл CI. Границей считается то, у чего есть внешняя сторона и цена изменения.
Написать критерии приёмки — 2–5 утверждений с оракулами. У chore оракул обычно самый дешёвый из всех типов: команда, которая раньше падала или требовала трёх шагов, теперь отрабатывает одним.
Проверить, что это не «заодно». Обслуживание любит склеиваться в пачку («обновить зависимости и переписать сборку и убрать мёртвый код»). Не мерджится порознь — это несколько задач (split.md).
Цель не проставлять. chore служит работоспособности, а не направлению. Работа по сопровождению проекта при этом видна в роадмапе — секцией Сопровождение, но целью не становится.

Кто такую задачу решает

Решает её конвейер проекта — скилл av-dev:code-resolve, сценарий обслуживания: он не заводит change и не пишет требований, потому что у работы, не меняющей поведения, дельта-спек нет по построению. Тип записи там только предлагает сценарий, а подтверждает его отсутствие дельт: разошлись — работа останавливается, и это тот самый случай, когда тип, оставшийся от первой формулировки, врёт. Плагина нет — задача решается как проект привык, а этот скилл её только заводит и закрывает.

Что видит машина, а что человек

ready смотрит на наличие непустого Затрагивает и на число критериев — ровно то же, что у feature. Разница между типами здесь не в строгости проверки, а в том, кому адресован ответ на «что станет наблюдаемо иначе», — и это судит человек.

6.3 KiB Raw Blame History Unescape Escape

🧹 chore — обслуживание, наблюдаемое поведение не меняется