av
de12a4d8a3
Каталоги, агенты и общие дома переехали в av-dev/; скиллы названы по прежнему плагину — doc-*, task-*, code-*, с двумя смысловыми именами вместо тавтологии: doc-sync вместо docs, task-track вместо tasks. Манифесты сведены к двум плагинам. Пространства имён вызовов и пути внутри дерева переписаны машинно; проза, которая называет прежние плагины отдельными, идёт следующим шагом.
5.2 KiB
Журнал версий формата задач
Одна запись на версию. Проект знает свою версию из ключа tasks в <каталог задач>/.tasks.json; повышение (upgrade в SKILL.md, раздел
«Версия формата») идёт по записям снизу вверх от версии проекта до текущей и
делает то, что в них названо.
Правило записи: что добавилось, что переехало, что удалено, что сделать проекту. Без последнего пункта запись бесполезна — по ней и работает повышение.
Версия — целое число. Обратной совместимости у формата нет: есть «приведён» и «не приведён».
Это журнал формата задач, а не канона документов. Числа у них разные и
двигаются порознь: плагин av-dev-tasks ставится в одиночку, и у проекта без
av-dev-docs версии канона нет вовсе. Журнал канона —
references/changelog.md скилла av-dev-docs:canon.
Версия 1 — 2026-08-11
Первая объявленная версия формата. До неё каталог задач версии не имел вовсе:
формат менялся, а сказать, к какому его состоянию приведён конкретный проект,
было нечем — tasks.py о расхождении молчал, и отставший каталог выглядел
здоровым ровно до первой команды, которая об него спотыкалась.
Что появилось. Ключ tasks в <каталог задач>/.tasks.json — целое число,
версия формата. Сам файл стал обязательным: до сих пор он заводился только
ради имён, отличных от умолчания, и проект с умолчаниями жил без него. Версия —
не настройка, от которой можно отказаться, поэтому init и adopt apply теперь
пишут файл всегда, а check требует числа и сверяет его со своим.
Что версия значит, а что нет. Она отвечает на один вопрос — «по какой записи
журнала повышать каталог». Что записи применены по существу, из числа не
следует: двигают его руками, и соврать им так же легко, как любой другой
строкой. check --fix недостающее число не приписывает намеренно — это было бы
объявлением каталога приведённым к формату, шагов которого никто не делал.
Чего в этой записи нет. Переезды, случившиеся до появления числа, — каталог
из docs/ в корень (канон 11) и отмена спринтов (канон 12) — задним числом сюда
не переписаны. Они уже названы журналом канона, и второй перечень тех же шагов
разошёлся бы с первым. Версия 1 — это формат на день её появления, что бы
проекту ни пришлось пройти до неё.
Что сделать проекту.
- Догнать формат по журналу канона, если каталог отстал. Признаки известны
поимённо: каталог лежит в
docs/tasks/(канон 11 велитgit mv docs/tasks tasksи починку относительных ссылок внутри записей), в нём естьSPRINT.mdили тегиsprint:<слаг>(канон 12 велит снести файл, вернуть строки в беклог черезcheck --fixи расставить порядок грумингом). Ничего из этого нет — каталог уже в сегодняшнем формате, и шаг пропускается. - Завести
<каталог задач>/.tasks.json, если его нет. Имена частей в него не переписываются: там только то, что отличается от умолчания. - Записать версию:
"tasks": 1первым ключом. tasks.py check --dir <каталог задач>— до отсутствия расхождений.
Что при этом не трогается. Записи в items/, индексы и REJECTED.md не
меняются ни строкой: версия 1 объявляет то, что уже есть, а не переделывает его.