канон 13: файл версии зовётся по владельцу, у задач появилась своя версия формата

Имя `.pm.json` пережило плагин `av-dev-pm` на два месяца и указывало в пустоту.
Правило, которое из этого вынуто: имя служебного файла — имя плагина, который
его завёл, и по нему же владельца узнают.

- `docs/.pm.json` → `docs/.docs.json`, запись 13 журнала. Прежнее имя docs.py
  не читает намеренно: по этому числу upgrade решает, какие записи применять,
  и два дома разъехались бы молча ровно там, где это дороже всего. Вместо
  совместимости — узнавание: check видит старый файл и печатает готовую git mv
- у каталога задач появилась своя версия формата — ключ `tasks` в
  `.tasks.json`, свой журнал версий и своё повышение. До сих пор её не было
  вовсе, хотя docs.py в комментарии уверенно на неё ссылался: описание
  опережало механику ровно так, как сказано в решении 195
- число своё, а не копия канонического: плагин ставится в одиночку, и у
  проекта без docs/ версии канона нет — сверять было бы не с чем
- конфиг задач стал обязательным (init и adopt apply пишут его всегда), check
  сверяет число, `check --fix` его не приписывает: приписанное объявляло бы
  каталог приведённым к формату, шагов которого никто не делал
- переезды 11 и 12 в новый журнал задним числом не переписаны — версия 1
  велит догнать формат по журналу канона, называя признаки отставания
  поимённо (каталог в docs/tasks/, живой SPRINT.md)
- запись 60 в DECISIONS со следствиями 200–203; отдельно разведено с решением
  F, где `.docs.json` отвергался как указатель путей: отвергнут был указатель,
  а не имя

av-dev-tasks/skills/tasks/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: tasks
-description: Ведение задач и целей как каталога markdown-файлов (одна запись = один файл в items/ + строка в одном из индексов). У каждой записи есть тип (goal, feature, fix, chore, research), и тип решает, каких разделов она требует и что с ней можно делать. Заведение записи из диалога, разбор находок аудита/ревью, декомпозиция на независимо полезные части, штурм сырья, гигиена полей и проверка согласованности индексов. Использовать, когда просят добавить задачу/идею/цель, превратить находки ревью в задачи, разбить задачу, проработать идею, поправить формат или проверить беклог. Расстановка приоритетов и разбор накопившегося — скилл groom. Не реализует задачи — этим занимается скилл решения задачи.
+description: Ведение задач и целей как каталога markdown-файлов (одна запись = один файл в items/ + строка в одном из индексов). У каждой записи есть тип (goal, feature, fix, chore, research), и тип решает, каких разделов она требует и что с ней можно делать. Заведение записи из диалога, разбор находок аудита/ревью, декомпозиция на независимо полезные части, штурм сырья, гигиена полей и проверка согласованности индексов. Использовать, когда просят добавить задачу/идею/цель, превратить находки ревью в задачи, разбить задачу, проработать идею, поправить формат или проверить беклог. Он же повышает каталог до текущей версии формата по своему журналу версий, когда tasks.py check говорит, что каталог отстал. Расстановка приоритетов и разбор накопившегося — скилл groom. Не реализует задачи — этим занимается скилл решения задачи.
 ---
 
 # Задачи
@@ -399,7 +399,7 @@ python3 $tk adopt scan --from … | apply --plan …   # разовая адап
 | 0 | сошлось / сделано | дальше по сценарию |
 | 1 | **только `check`:** найден дрейф индексов и файлов | `check --fix`, остаток разобрать |
 | 2 | ошибка употребления: аргументы или нарушенное правило | читать сообщение, это отказ по существу |
-| 3 | окружение: каталог не найден, конфиг битый или мимо диска | чинится путём или `docs/.pm.json`, повтор не поможет |
+| 3 | окружение: каталог не найден, конфиг битый или мимо диска | чинится путём или `<каталог задач>/.tasks.json`, повтор не поможет |
 | 4 | внутренний сбой | дефект скрипта, доложить |
 
 Различать 1 и 3 обязательно: «дрейф в беклоге» — рабочая ситуация, «каталога
@@ -486,6 +486,39 @@ python3 $tk adopt scan --from … | apply --plan …   # разовая адап
 [fix](references/task-fix.md) · [chore](references/task-chore.md) ·
 [research](references/task-research.md).
 
+## Версия формата
+
+Формат каталога задач меняется, и проект должен знать, к какой его версии
+приведён. Число живёт ключом `tasks` в `<каталог задач>/.tasks.json`, журнал
+версий — [references/changelog.md](references/changelog.md), сверяет их
+`tasks.py check`: отстало — строка расхождения, ушло вперёд — устарел плагин.
+
+**Версия своя, а не канона документов.** Плагин ставится в одиночку: проект,
+взявший учёт работ без `av-dev-docs`, каталога `docs/` не имеет вовсе, а значит
+не имеет и версии канона — сверять было бы не с чем. Обратной совместимости у
+формата нет: есть «приведён» и «не приведён».
+
+**`upgrade` — повысить каталог до текущего формата:**
+
+1. `python3 $tk check --dir D` — первая же строка расхождений называет версию
+   проекта и версию скрипта. Проект новее скрипта — **обнови маркетплейс**, а не
+   проект: это отстал плагин.
+2. Иди по [журналу](references/changelog.md) снизу вверх от версии проекта до
+   текущей и делай названное в каждой записи. Записи независимы и применяются по
+   порядку.
+3. Подними `tasks` в `.tasks.json` до текущей — руками, последним шагом. Раньше
+   времени поднятое число объявляет каталог приведённым к формату, шагов
+   которого никто не делал; `check --fix` этого не пишет намеренно.
+4. `check --dir D` ещё раз — до отсутствия расхождений.
+
+Записи журнала описывают **что сделать проекту**. Если запись этого не говорит —
+это дефект журнала, и о нём надо сказать, а не догадываться.
+
+**Канон документов сюда не вмешивается.** Его журнал двигает своё число в
+`docs/.docs.json` и вправе сказать «позови этот скилл», но не двигать версию
+формата задач: две версии, ходящие по одному журналу, разъедутся на первом же
+проекте, где стоит один плагин без другого.
+
 ## Сценарии
 
 ### Завести запись из диалога
@@ -647,17 +680,19 @@ python3 $tk adopt scan --from … | apply --plan …   # разовая адап
   действительно новый, а перевод чужой раскладки делает `av-dev-docs:canon`.
   У скрипта поиск вверх по дереву ещё жив — он для непереведённых проектов, и
   полагаться на него скилл не должен: молча найденный чужой каталог это дрейф.
-- **Настройки живут в `<каталог задач>/.tasks.json`** — свой файл у своего
-  плагина: **имена** файлов и заголовков, и только если они отличаются от
-  умолчания. Неизвестный ключ — код 3 на любой команде, так что лишнее слово в
-  этом объекте останавливает работу с задачами целиком.
+- **Версия формата и настройки живут в `<каталог задач>/.tasks.json`** — свой
+  файл у своего плагина: ключ `tasks` с версией формата плюс **имена** файлов и
+  заголовков, и последние — только если отличаются от умолчания. Неизвестный
+  ключ — код 3 на любой команде, так что лишнее слово в этом объекте
+  останавливает работу с задачами целиком.
 
-  Дом именно свой, а не `docs/.pm.json`, потому что `docs/` принадлежит плагину
-  канона: проект, поставивший учёт работ без него, каталога `docs/` не имеет
-  вовсе. Прежний ключ `tasks` в `docs/.pm.json` читается, **только когда своего
-  файла нет** — для проектов, заведённых до раскола плагинов; скрипт при этом
-  говорит замечанием, куда его перенести. Есть оба — побеждает свой, и об этом
-  тоже говорится вслух: молча выбранный из двух конфиг это дрейф.
+  Дом именно свой, а не `docs/.docs.json`, потому что `docs/` принадлежит
+  плагину канона: проект, поставивший учёт работ без него, каталога `docs/` не
+  имеет вовсе. Прежний ключ `tasks` в `docs/.pm.json` читается, **только когда
+  своего файла нет** — для проектов, заведённых до раскола плагинов; скрипт при
+  этом говорит замечанием, куда его перенести. Есть оба — побеждает свой, и об
+  этом тоже говорится вслух: молча выбранный из двух конфиг это дрейф. Версию
+  прежний дом не знает и знать не может — она читается только из своего файла.
 - **Секции беклога** берутся из заголовков `##` индекса как есть; их количество
   и названия — дело проекта (умолчание `Ядро` / `Инфра`). **В конфиге их нет** —
   второй список разошёлся бы с заголовками молча.