слияние: три плагина стали одним av-dev, скиллы получили префиксы

Каталоги, агенты и общие дома переехали в av-dev/; скиллы названы по прежнему
плагину — doc-*, task-*, code-*, с двумя смысловыми именами вместо тавтологии:
doc-sync вместо docs, task-track вместо tasks. Манифесты сведены к двум
плагинам. Пространства имён вызовов и пути внутри дерева переписаны машинно;
проза, которая называет прежние плагины отдельными, идёт следующим шагом.

av-dev/skills/task-track/SKILL.md

@@ -0,0 +1,763 @@
+---
+name: task-track
+description: Ведение задач и целей как каталога markdown-файлов (одна запись = один файл в items/ + строка в одном из индексов). У каждой записи есть тип (goal, feature, fix, chore, research), и тип решает, каких разделов она требует и что с ней можно делать. Заведение записи из диалога, разбор находок аудита/ревью, декомпозиция на независимо полезные части, штурм сырья, гигиена полей и проверка согласованности индексов. Использовать, когда просят добавить задачу/идею/цель, превратить находки ревью в задачи, разбить задачу, проработать идею, поправить формат или проверить беклог. Он же повышает каталог до текущей версии формата по своему журналу версий, когда tasks.py check говорит, что каталог отстал. Расстановка приоритетов и разбор накопившегося — скилл groom. Не реализует задачи — этим занимается скилл решения задачи.
+---
+
+# Задачи
+
+Задачи — каталог markdown-файлов. Одна запись = один файл `items/<slug>.md` плюс
+строка **ровно в одном** индексе. Скилл владеет **форматом и содержимым**:
+заводит, редактирует, закрывает, разбирает находки ревью, дробит, штурмует сырьё.
+
+Чем он **не** владеет: **очередью** — что делать следующим и что перестало быть
+важным, решает скилл `groom`, а этот скилл лишь даёт ему операции; и выполнением
+задачи — это конвейер проекта.
+
+## Шесть правил, из которых всё следует
+
+Ситуация не покрыта инструкцией — решай по ним.
+
+0. **Цель — возможность приложения, задача — шаг к ней.** Цель отвечает на «что
+   приложение будет уметь», её «Завершение» — наблюдаемый признак того, что уже
+   умеет; задача отвечает на «что для этого нужно сделать». Оценивается проект
+   по **поведению**, а не по внутреннему устройству, поэтому и роадмап отвечает
+   не «сколько работ осталось», а «что уже умеет и чего ещё не умеет».
+   Свойство поведения — тоже возможность: «сообщает о своём состоянии»,
+   «исход слияния не зависит от порядка доставки» — законные цели.
+1. **Беклог гниёт с той стороны, где его пополняют.** Заведение — самая частая
+   операция и с худшим отказом: из одного разговора рождается пять файлов, а
+   переоценка потом разгребает то, чего не надо было заводить. Дедупликация и
+   фильтр на входе дешевле любой чистки. Заводим только то, что **не делаем
+   сейчас** и о потере чего пожалеем.
+2. **Файл — источник истины, индексы производны.** Разошлись — неправы индексы.
+   Согласованность механизируема и проверяется командой, а не вниманием: всё,
+   что ловит `tasks.py check`, не должно попадать ни в чек-лист, ни в промпт.
+   Поэтому **«зачем» живёт в мете файла**, а строка индекса его лишь
+   повторяет: пока поле лежало только в индексе, восстановление пропавшей
+   строки теряло его молча и навсегда. Единственное исключение намеренное: **в каком
+   индексе лежит запись, знают индексы** — поля-состояния в файле нет. И
+   **порядок строк в беклоге**: приоритет это свойство очереди, а не задачи, и в
+   файле ему места нет (правило 4).
+3. **Причина переживает запись.** Выкинутая без причины задача вернётся через
+   квартал тем же текстом. Реализованная оставляет след в коммите — выкинутая не
+   оставляет ничего, поэтому у неё есть `REJECTED.md`.
+4. **Приоритет — это порядок строк, а цель есть не у всякой задачи.** Очередь
+   внутри секции беклога значима: **первая строка — то, что делают следующим**.
+   Приоритет назначает человек на груминге, машина его не выводит и не угадывает.
+
+   Прежде здесь стояло «порядка нет, есть цель», и обосновано это было тем, что
+   на «что делать дальше» отвечает **набор спринта**. Набора больше нет, а
+   вопрос остался — и без порядка отвечать на него стало нечем.
+
+   **Дом приоритета — индекс, а не файл.** Это то же исключение из правила 2,
+   что и «в каком индексе лежит запись»: приоритет — свойство очереди. Положи он
+   в файл числом, и два соседних файла смогли бы утверждать одно и то же место,
+   а строка индекса — противоречить обоим.
+
+   Цель обязательна там, где она и есть содержание работы, — у **новой
+   возможности** (`feature`). Починка, техдолг и разведка служат
+   работоспособности, а не направлению, и живут без цели законно. Придуманная им
+   цель — то же враньё, от которого спасает тип. **Цель и приоритет —
+   независимые оси:** очередь может идти поперёк целей, и это законно.
+
+   Одно место в очереди назначено **не человеком, а типом**: **сырьё**
+   (`research` без раздела «Вопрос») стоит в конце своей категории. Его не берут,
+   и между берущимся оно каждый раз требует открыть файл, чтобы это понять. Раз
+   это выводится, проверяет и чинит это машина.
+5. **Тип решает, что с записью можно делать.** Тип — единственная ось и первое
+   поле меты: от него зависит, какие разделы обязательны в теле, нужна ли цель,
+   берётся ли запись в работу и в каком индексе живёт её строка. Словарь закрыт;
+   ни один тип не подошёл — значит, в записи их два, и её надо разделить.
+
+## Раскладка
+
+Каталог задач — **`tasks/` в корне репозитория, жёстко.** Он принадлежит этому
+плагину, а не канону документов: `docs/` ведёт другой плагин (`av-dev-docs`), и
+проект, поставивший учёт работ без него, каталога `docs/` не имеет вовсе. Внутри
+`docs/` задачи лежали до версии канона 11; непереехавший проект скрипт
+по-прежнему находит, но новый заводит только в корне.
+
+```
+tasks/
+  items/            задачи и цели файлами, <slug>.md, слаги английские
+  ROADMAP.md        состояние проекта: что уже умеет и чего ещё не умеет
+  BACKLOG.md        что можно взять — только задачи, целей здесь нет.
+                    Порядок строк в секции значим: это очередь
+  REJECTED.md       ушедшее БЕЗ реализации, с причиной и датой
+```
+
+Правило, снимающее путаницу: **`BACKLOG.md` — то, что берут; `ROADMAP.md` — то,
+подо что берут.** Цель в работу взять нельзя — берут её задачи, — поэтому в
+списке берущихся ей не место.
+
+**Четыре секции роадмапа, и последняя отвечает на половину вопроса:**
+
+| Секция | Англ. | Что в ней |
+| --- | --- | --- |
+| `Запланировано` | `Planned` | очередь значима и обосновывается прозой рядом |
+| `Направления` | `Directions` | очереди нет, тянутся долго |
+| `Сопровождение` | `Operations` | чем держат проект: инструмент, процесс, эксплуатация — не возможности приложения, и потому отдельно |
+| `Готово` | `Done` | достигнутые цели — строкой с датой, **без ссылки на файл**: файл удалён, поведение живёт в спеках |
+
+**Порядок тоже канонический, и `Готово` стоит последним не из скромности.**
+Достигнутое **копится**: через год этой секции больше, чем всех остальных
+вместе. Стоя первой, она отодвигает за экран ровно то, ради чего роадмап
+открывают чаще всего, — что делается сейчас и что дальше. Порядок проверяет
+`check`, переставляет `check --fix`.
+
+**Секции роадмапа канонические, категории беклога — нет**, и разница не в любви к
+единообразию. У каждой секции роадмапа свой смысл, в достигнутое пишет сам `close`, и
+роадмап, названный по-своему, читался бы только своим автором. Категории беклога
+(`Ядро`, `Инфра`) смысла не несут — это полки домена, и остаются делом проекта.
+Отсюда и разные имена поля меты: у цели **Секция** (часть роадмапа — состояние
+очереди), у задачи **Категория** (полка домена, на которой она лежит).
+
+Отсюда четыре правила, которые проверяет `tasks.py check`: **состав закреплён**
+(чужая секция — ошибка, а не вольность), **все четыре обязаны быть** (нет
+секции — нет ответа на её часть вопроса), **язык один на весь индекс**, **порядок
+канонический**. `--roadmap-sections` у `init` нет: выбирать нечего.
+
+**Заголовок секции отбит пустой строкой с обеих сторон и написан с прописной.**
+Во всех индексах одинаково, включая категории беклога, которые проект называет сам.
+Написание канонических секций правит `check --fix` (заодно и ссылку на секцию в
+мете файлов: имя секции принадлежит заголовку индекса, файл на неё только
+ссылается); отбивку и порядок он правит везде.
+
+Оговорка про `Сопровождение`: слово `окружение` сюда не годится — в
+`architecture.md` оно уже значит боевое окружение приложения, и одно слово в двух
+смыслах развело бы документы канона. А `Разработка`, стоявшая тут раньше,
+называла слишком много: роадмап **весь** про разработку, и секция с таким именем
+не отличалась от остальных ничем.
+
+**Секции «блокеры» в беклоге нет.** Блокер — это *состояние* (работа не может
+продолжаться ни одной задачей), а не полка: он живёт ровно до ответа человека, и
+записи в такой секции не успевают жить. Следы блокера остаются вопросами в
+файлах задач. Постоянно пустая секция со старой семантикой
+«разбираются пачками» противоречила бы правилу «блокер эскалируется немедленно»,
+поэтому `init` её заводить отказывается, а `check` о ней говорит. **Проекту,
+который переезжает с такой секцией, её надо удалить** — это единственное место,
+где это сказано.
+
+**Запись живёт в одном индексе за раз.** Индексов два, и выбирает между ними
+тип: цель в роадмапе, задача в беклоге. Сменился тип — строка переезжает
+(`edit --type`). Файл в `items/` при этом **не двигается**: он и есть запись,
+индексы лишь показывают, где она числится и в каком порядке стоит.
+
+**Порядок строк в беклоге — приоритет**, и он единственное, чего в файле нет
+(правило 4). Отсюда следствие для всякой машинной правки индекса:
+восстановленная или перенесённая строка встаёт **в конец своей секции**, и
+скрипт об этом говорит. Молчаливая вставка выдала бы машинную позицию за
+решение человека — а решение это его.
+
+**У сделанной задачи записи не остаётся** — файл и строка удаляются (`close
+--implemented`). Ей хватает коммита и документации проекта; вторая запись была
+бы вторым домом для того же факта. Вопрос «что было сделано и когда» отвечается
+даром: индексы лежат под git, а закрытие коммитится отдельным коммитом учёта —
+`git log -p tasks/BACKLOG.md` отдаёт историю без отдельного журнала.
+
+**У достигнутой цели запись остаётся, и это единственное исключение.** Файл
+удаляется так же, а строка переезжает в секцию `Готово` с датой. Причина в том,
+что цель — не работа, а **возможность**: «что приложение умеет» это половина
+вопроса, ради которого роадмап и открывают, и стирать её вместе с файлом значит
+оставить инструмент, отвечающий только «что осталось». Вторым домом это не
+становится: поведение живёт в `openspec/specs/`, а роадмап отвечает **когда и в
+каком порядке оно появилось** — другой вопрос. Ссылки на файл в строке нет
+намеренно: файл удалён, а битая ссылка — законная ошибка `check`.
+
+Куда запись может переехать и какой командой — весь набор переходов:
+
+```mermaid
+stateDiagram-v2
+    state "BACKLOG.md — что берут" as B
+    state "ROADMAP.md — подо что берут" as P
+    state "REJECTED.md — ушла без реализации" as R
+    state "записи нет — реализована" as D
+    state "ROADMAP.md, «умеет» — цель достигнута" as A
+
+    [*] --> B: add --type feature|fix|chore|research
+    [*] --> P: add --type goal
+    B --> P: edit --type goal --section
+    P --> B: edit --type feature|fix|chore|research --section
+    B --> D: close --implemented
+    P --> A: close --implemented
+    B --> R: close --reason
+    P --> R: close --reason
+    D --> B: reopen --reason
+    R --> B: reopen --reason
+    A --> P: reopen --reason
+```
+
+Состояния здесь — **где числится строка**, а не где лежит файл: файл
+`items/<slug>.md` не двигается ни на одном переходе. Стрелок «руками» на схеме
+нет намеренно — каждый переход это команда, и другого способа его совершить не
+существует.
+
+Схема — **сводка**: условия и оговорки живут в тексте разделов, и при
+расхождении прав текст.
+
+## Цели
+
+**Цель — возможность приложения.** Такой же файл в `items/`, тип `goal` (🎯),
+перечисленный в `ROADMAP.md`. Формулируется ответом на вопрос **«что приложение
+будет уметь»**, а не названием области работ: не «Работа с чтением», а «Чтение
+данных клиентами»; не «Рефакторинг слияния», а «Исход слияния не зависит от
+порядка доставки».
+
+**Свойство поведения — тоже возможность.** «Наблюдаемость» это «приложение
+сообщает о своём состоянии»; «прочность слияния» это «исход не зависит от
+порядка». Такие цели законны и переформулировки в функцию не требуют — требуют
+только, чтобы формулировка отвечала на «что приложение делает», а не на «какую
+часть кода мы трогаем».
+
+**Целью не становится работа, которой держат проект.** Состав перечислен
+[в словаре сопровождения](references/operations.md);
+на вопрос «что приложение будет уметь» ничто из него не отвечает. Им отведена отдельная секция роадмапа,
+чтобы они были видны в том же экране и при этом не читались как возможности
+продукта.
+
+**Граница проходит по тому, кто наблюдает, а не по теме.** «Приложение сообщает
+о своём состоянии» — возможность: наблюдает пользователь сервиса, и цели место
+среди прочих. «Дежурный видит состояние на одном экране» — сопровождение:
+наблюдаем мы. Одна и та же наблюдаемость попадает в разные секции, и это верно —
+секции отвечают на разные вопросы.
+
+**Сопровождение и эксплуатация — целое и часть**, а не синонимы, и та же тема
+живёт ещё в двух местах: разделе «Эксплуатация» в `architecture.md` и теме ревью
+`operations`. Словарь у всех трёх общий, дом у него один — `shared/operations.md`
+в репозитории плагинов, — а здесь лежит дословная копия:
+[references/operations.md](references/operations.md). Пересказывать его своими
+словами нельзя: три перечня «чем держат проект» уже разъезжались на «метриках и
+логах» против «мониторинга».
+
+Секция выбирается так: очередь значима и обоснована прозой — `Запланировано`;
+тянется долго и очереди не имеет — `Направления`; не про приложение, а про то,
+чем его держат, — `Сопровождение`; в `Готово` кладёт сам `close`.
+
+- **Список задач цели выводится, а не хранится.** В теле цели — зачем она и что
+  считается её завершением; перечня задач там нет. Он был бы третьим индексом и
+  поехал бы на первой же закрытой задаче, а `check` про него не знает. Связь
+  однонаправленна: задача несёт тег `goal:<слаг>`, перечень даёт
+  `tasks.py list --goal <слаг>`.
+- **Статус цели выводится.** Цель достигнута, когда у неё не осталось открытых
+  задач; `[x]`/`[~]` руками не ведутся, а `close` цели с живыми задачами
+  скрипт запретит. Достижение — `close <цель> --implemented`: файл удаляется,
+  строка с датой переезжает в `Готово`. Ошиблись — `reopen` вернёт файл и
+  **снимет строку достигнутого**, чтобы роадмап не утверждал того, чего нет. Единственная оговорка: цель без задач неотличима — «ещё не
+  разобрана» или «всё закрыто». Различает **тег `decomposed`** в мете
+  цели: он ставится, когда цель разложена на задачи. Тег, а не строка в теле —
+  потому что проверяется механически: `check` **напоминает** о нём у пустой цели
+  (замечанием, не ошибкой — неразобранная цель это законное состояние), а `check
+  --fix` сам проставляет его цели, у которой задачи есть.
+- **Тип `[epic]` упразднён.** Он был зонтиком между целью и задачами — «задача,
+  которая не мерджится целиком». Зонтик теперь цель, а слишком крупный шаг просто
+  дробится на шаги помельче под той же целью, и промежуточному типу места не
+  осталось. Замер подтвердил: ноль употреблений на 97 записей двух живых
+  проектов. Встретился в чужом беклоге — это цель либо набор задач, и `check`
+  назовёт его неизвестным типом.
+
+## Тип записи
+
+**Тип — единственная ось, и он решает, что с записью можно делать.** Дом типа —
+**поле меты `Тип` первой строкой**; эмодзи в заголовке H1 от него производна, её
+ставит `add` и чинит `check --fix`.
+
+| Тип | Обязательные разделы | Цель | В работу | Устав |
+| --- | --- | --- | --- | --- |
+| 🎯 `goal` | `Завершение` | — | нет | [task-goal.md](references/task-goal.md) |
+| ✨ `feature` | `Затрагивает`, `Критерии приёмки` | **обязательна** | да | [task-feature.md](references/task-feature.md) |
+| 🐞 `fix` | `Воспроизведение`, `Затрагивает`, `Критерии приёмки` | необязательна | да | [task-fix.md](references/task-fix.md) |
+| 🧹 `chore` | `Затрагивает`, `Критерии приёмки` | нет | да | [task-chore.md](references/task-chore.md) |
+| 🔬 `research` | `Вопрос`, `Куда ляжет ответ` | нет | да | [task-research.md](references/task-research.md) |
+
+Сверх обязательных у любой задачи допустимы `Рамки` и `Вопросы`. Раздел не из
+схемы своего типа — **замечание, а не ошибка**: свой раздел законная вольность
+проекта, но `Воспроизведение` у `chore` почти всегда значит, что тип проставлен
+не тот, и сказать об этом стоит, не запрещая.
+
+**Осей было две, и ортогональность у них была фальшивой.** Тип записи
+(`goal`/`idea`/`task`) и род работы (`kind:<род>` тегом) давали двенадцать клеток
+произведения, из которых законны были шесть: у цели род запрещён, у задачи
+обязателен, у идеи пуст. Плюс алгоритм работы крепится не к `task`, а к `fix` и
+`research` — то есть к роду. Оси схлопнуты, тег `kind:` упразднён.
+
+**Тип `idea` упразднён вместе с ними.** Он значил не род работы, а **состояние
+незаполненности** — «первый, второй или третий вопрос теста готовности не
+отвечается», — а состояние типом быть не может: оно меняется по мере того, как
+запись дописывают, а тип меняют командой. Теперь это состояние называется честно:
+`research` без раздела «Вопрос» — **сырьё**. В работу не берётся ровно как
+прежняя идея, лежит в конце своей категории и отбирается `list --raw`.
+
+Словарь **закрыт**. Открытый разъедется на синонимах — `bug`, `bugfix`, `fix`,
+`defect`, — и отбор по типу перестанет отвечать на свой единственный вопрос. Ни
+один тип не подходит — это сигнал, что в задаче их два и её надо разделить.
+
+**Требуется тип там, где по нему принимают решение:** `ready` без типа
+откажет, потому что не знает, каких разделов требовать. `check` о пропаже только
+**напоминает** — беклог, заведённый до появления типа, законен, и переоформлять
+его «заодно» здесь не просят.
+
+**Тип не выбирает метку ревью и глубину проверки.** Профиль выбирается по факту
+изменения, а не по типу задачи: `chore` бывает миграцией схемы, `fix` — правкой
+публичного контракта. Правило «предписание процесса в теле задачи снимается»
+типом не отменяется, а подтверждается: он описывает работу, а не то, как её
+проверять.
+
+**Одно исполнителю тип всё же говорит — каким сценарием работу вести, и то не
+один.** В плагине `av-dev-code` скилл `resolve` выбирает сценарий связкой из двух
+признаков: тип **предлагает** (`chore` — обслуживание, `research` — разведка),
+а подтверждает его предмет работы — есть ли что менять в спеках. Признаки
+разошлись — работа останавливается, и тип меняется здесь, командой `edit --type`,
+а не переклеивается исполнителем по ходу. Метку и глубину это по-прежнему не
+задаёт: их называет разметка изменения, а на прогоне без change — сам сценарий.
+
+## Как написана задача
+
+Три требования к тексту. Первое — про заголовок, два остальных про то, чтобы
+задачу можно было **оценить, не открывая код**.
+
+**Заголовок отвечает на вопрос своего типа.** Вопросов три, поэтому и форм три:
+
+| Тип | Отвечает на | Пример |
+| --- | --- | --- |
+| 🎯 `goal` | что приложение будет уметь | Соперником может быть компьютер |
+| ✨ `feature`, 🐞 `fix`, 🧹 `chore` | что нужно сделать | Печатать поле одним куском кода |
+| 🔬 `research` | о чём разведка | Подсказка следующего хода |
+
+Задача — **глаголом в неопределённой форме**, перед ним допускается «не»: «Не
+отбрасывать молча лишние символы в ходе», а не «Лишние символы молча
+отбрасываются». Описательный заголовок называет **состояние**, а из состояния не
+видно, чего от работы ждут: «Ничья объявляется, пока клетки есть» одинаково
+читается и как жалоба, и как задание, — и в списке, где решают «брать или не
+брать», это разные вещи. `research` формы действия не несёт **намеренно**: её
+исход знание, а что делать — ещё неизвестно, и заголовок-действие обещал бы
+решённость, которой нет.
+
+Из этого же правила растёт разница индексов: роадмап — список возможностей,
+беклог — список работ, и если заголовки перепутать формами, каждый из них
+начинает читаться как другой.
+
+`check` считает заголовки не в форме действия и печатает **число** в блоке
+здоровья, не замечанием на файл: проверка эвристическая (первое слово на
+`-ть`/`-ти`/`-чь`), а беклог, заведённый до правила, не переоформляют «заодно».
+Годность формулировки — не машине: её смотрит
+[агент вычитки](#вычитка-два-прохода-а-не-один).
+
+**Функции и границы, а не намерения.** Задача называет, что система начнёт
+делать, и какие границы это трогает: эндпоинт или команду, таблицу и миграцию,
+формат на диске, публичный тип пакета, внешний сервис. Перечень живёт разделом
+«Затрагивает» (форма — [references/task-format.md](references/task-format.md)) и
+требуется к взятию в работу. Без него задача оценивается по объёму текста, а не
+по объёму поверхности, — и оценка систематически занижена ровно там, где текст
+короткий, а границ много. Названы **границы**, а не то, как они изменятся: план
+реализации живёт в предложении об изменении, а не в задаче.
+
+**Предметно, но без усложнения.** Текст задачи читает человек, который решает,
+брать её или нет, и делает это по строке индекса и одному экрану тела.
+
+Язык — общий для всех проектных текстов, и дом у него один,
+`shared/language.md` в репозитории плагинов; здесь лежит дословная копия:
+[references/language.md](references/language.md) (информационный стиль,
+применённый к задачам и документам канона; там же таблицы англицизмов и жаргона
+и то, что из стиля отброшено намеренно). Задаче он даёт четыре требования,
+которые нарушаются чаще прочих:
+
+- **глагол вместо отглагольного существительного**: «обработчик не проверяет
+  владельца», а не «проверка владельца не осуществляется»;
+- **факт вместо оценки**: «время ответа доходит до 800 мс», а не «работает
+  медленно». Оценка без факта рядом — настроение, а не сведение;
+- **англицизм с живым русским аналогом заменяется**: не «зафиксить флоу», а
+  «починить порядок доставки». Имя вещи не переводится: слаг, команда, тип в
+  коде, `API`;
+- **термин не из документов проекта вводится одной строкой** или не
+  употребляется. Свой словарь у задачи — самый дешёвый способ сделать беклог
+  нечитаемым для того, кто вернётся к нему через квартал.
+
+И одно требование, которое есть только у задачи: **сложность формулировки — не
+признак сложности работы.** Задачу, которую не удаётся сказать просто, чаще
+всего не удаётся и оценить: это либо две задачи, либо сырьё.
+
+Эти правила — про **язык**, а не про объём: короткая задача без границ хуже
+длинной с ними.
+
+## Инструмент (`tasks.py`)
+
+Пусть `tk="$CLAUDE_PLUGIN_ROOT/skills/tasks/scripts/tasks.py"`, а `D` —
+`tasks` от корня проекта. `--dir` стоит в примерах намеренно: вызов из
+подкаталога — обычное дело.
+
+```
+python3 $tk check --dir D                # согласованность индексов + здоровье
+python3 $tk check --dir D --fix          # + починить дрейф (тип, эмодзи, место, заголовок, дубли, «зачем», форма меты)
+python3 $tk list --dir D [--stale] [--section S] [--type T] [--tag a,b] [--goal S] [--raw] [--index …] [--questions]
+python3 $tk add --dir D --slug S --title T --type goal|feature|fix|chore|research [--section S] [--goal G] [--why «зачем»] [--tag a,b]
+python3 $tk edit S --dir D [--title T] [--why «зачем»] [--type T] [--goal G] [--add-tag a,b] [--rm-tag c]
+python3 $tk move S --dir D [--section S] [--reason R] [--after S | --first]   # без --section — текущая секция
+python3 $tk close S --dir D --reason R      # в REJECTED.md + удалить (ушла без реализации)
+python3 $tk close S --dir D --implemented   # просто удалить (реализована и закоммичена)
+python3 $tk reopen S --dir D --reason R     # вернуть закрытую: приёмка не сошлась
+python3 $tk ready S… --dir D                # схема типа выполнена — можно брать в работу
+python3 $tk init --dir D [--sections …] [--items …] [--backlog …] …
+python3 $tk adopt scan --from … | apply --plan …   # разовая адаптация, references/adopt.md
+```
+
+**Коды выхода — единый словарь; на нём ветвятся скиллы, а не на тексте вывода:**
+
+| Код | Что случилось | Что делать |
+| --- | --- | --- |
+| 0 | сошлось / сделано | дальше по сценарию |
+| 1 | **только `check`:** найден дрейф индексов и файлов | `check --fix`, остаток разобрать |
+| 2 | ошибка употребления: аргументы или нарушенное правило | читать сообщение, это отказ по существу |
+| 3 | окружение: каталог не найден, конфиг битый или мимо диска | чинится путём или `<каталог задач>/.tasks.json`, повтор не поможет |
+| 4 | внутренний сбой | дефект скрипта, доложить |
+
+Различать 1 и 3 обязательно: «дрейф в беклоге» — рабочая ситуация, «каталога
+нет» — нерабочая, и одинаковая реакция на них была бы неверна в обоих случаях.
+
+Тип — английское ключевое слово `goal` / `feature` / `fix` / `chore` /
+`research` (как и прочие токены команд), у `add` **обязательное**: без него
+неизвестно, какой шаблон тела класть. Текст задачи при этом русский, а эмодзи в
+заголовке ставит скрипт.
+
+**Мутации правят файл и индексы заодно** — руками строку индекса или мету
+не пиши, зови `add`/`edit`/`move`/`close`/`reopen`. Смена заголовка, «зачем», типа,
+цели и **тегов** — это `edit`: он держит H1 (вместе с эмодзи), мету и индекс
+согласованными. Снятие тега — `--rm-tag` (после ответа на вопрос снимается
+`question`), смена цели — `--goal`, типа — `--type`; оба заменяют прежнее
+значение, а не добавляют второе.
+
+**Переезд между индексами — следствие смены типа, а не отдельная команда.**
+`edit <slug> --type goal --section <часть роадмапа>` переносит строку из
+`BACKLOG.md` в `ROADMAP.md` (и обратно — задачным типом плюс
+`--section <категория беклога>`);
+`move` двигает только внутри одного индекса и пишет причину. `--section` у
+`edit` работает **только** при таком переезде — иначе он отсылает к `move`,
+потому что смена секции без причины и есть тот дрейф, который потом никто не
+объяснит.
+
+**`move --after <слаг>` и `move --first` — это и есть расстановка приоритета.**
+Порядок строк в секции значим (правило 4), и двигают его только этой командой:
+руками поправленная строка не оставляет причины, а причина здесь и есть половина
+решения.
+
+Тело задачи скрипт не трогает:
+`add` кладёт заголовок, мета-блок и шаблон с подсказками, тело дописываешь
+редактором (пока плейсхолдер на месте, `check` напоминает).
+
+`check` — единственный судья согласованности; что именно он ловит, скажет его
+вывод, здесь не пересказываем. Гоняй его **в начале сессии** и **после каждой
+правки**, даже если правил мутациями: дрейф мог накопиться раньше. Накопившееся
+чини `check --fix` — он детерминированно правит то, где истина однозначна (тип в
+своё поле, эмодзи заголовка, имя поля места, секция, заголовок, дубли, «зачем» из
+индекса в файл, старая форма меты, пометка `decomposed` у цели с задачами, сырьё
+в конец категории), а неоднозначное (задача сразу в двух индексах, нечего
+восстанавливать, **тип, которого неоткуда взять**) печатает отдельной пометкой
+`НЕОДНОЗНАЧНО` — это тебе, и это идёт строкой доклада. **Ссылка на исчезнувший
+файл в пометку не попадает:** `--fix` её просто не трогает, и она остаётся
+`ОШИБКА` обычного `check` — то есть видна, но в докладе её надо назвать отдельно.
+
+`--fix` правит **и файлы** — там, где источник ровно один и выбирать не из чего:
+тип переезжает из прежнего дома (тег `kind:`, префикс `[goal]`/`[idea]`) в поле
+меты, заголовок получает эмодзи, поле места — имя по типу, «зачем», оставшееся
+только в индексе, переезжает в мету, цель с задачами получает `decomposed`.
+Каждый случай печатается поимённо.
+
+**Тип, который не выводится ниоткуда, `--fix` не угадывает.** `feature` от
+`chore` машина не отличает, и подставленное наугад значение врало бы ровно там,
+где по нему принимают решение. Такие записи идут в `НЕОДНОЗНАЧНО`, и тип им
+проставляет человек — `edit <слаг> --type …`.
+
+**Что механизировано, а что нет.** Схему типа проверяет `ready` на входе в
+работу — там, где по ней принимают решение; `check` поимённо о ней не говорит, а
+считает: строка здоровья **«схема типа не выполнена: N из M»** называет число и
+первые слаги, строка **«готово к взятию»** — сколько задач беклога пройдут
+`ready` целиком (схема плюс цель плюс отсутствие открытого вопроса). Это две
+разные строки, и совпадение их чисел — совпадение. У каждой части своя глубина:
+
+- **тип** — жёстко: назван и из закрытого словаря;
+- **критерии приёмки** (`feature`, `fix`, `chore`) — число пунктов жёстко
+  (меньше двух отказ, больше пяти замечание), наличие оракула **эвристикой** по
+  слову «оракул» в пункте;
+- **прочие разделы схемы** (`Затрагивает`, `Воспроизведение`, `Вопрос`,
+  `Куда ляжет ответ`, `Завершение`) — только **наличие непустого**. Содержимое
+  машине не видно: границу, которую забыли назвать, она от отсутствующей не
+  отличает, а шаги, по которым ничего не воспроизводится, — от годных.
+
+Настоящий оракул от слова «оракул» машина тоже не отличает, поэтому эвристика
+даёт только замечание, и в докладе это называется как есть: «проверено наличие
+разделов своего типа и число критериев, годность оракулов и полнота границ —
+глазами».
+
+Формат записи, меты, слага, индексов и `REJECTED.md` —
+[references/task-format.md](references/task-format.md); там же тест «готова к
+взятию». Схема и алгоритм каждого типа — по файлу на тип:
+[goal](references/task-goal.md) · [feature](references/task-feature.md) ·
+[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` и вправе сказать «позови этот скилл», но не двигать версию
+формата задач: две версии, ходящие по одному журналу, разъедутся на первом же
+проекте, где стоит один плагин без другого.
+
+## Сценарии
+
+### Завести запись из диалога
+
+1. **Фильтр.** Делаем прямо сейчас — не заводим. Не пожалеем о потере — не
+   заводим. Родилось три кандидата — покажи их и спроси, какие заводить: молча
+   заведённая пачка и есть тот самый отказ из правила 1.
+2. **Дедуп.** `list` плюс поиск по слагам, полю «зачем» и телам (`grep -ril`),
+   **включая `REJECTED.md`**. Нашлось среди живых — **дописываем в существующий
+   файл**, а не заводим соседний. Нашлось в `REJECTED.md` — покажи пользователю
+   ту строку и что изменилось с момента отказа (`add` предупредит и сам, но
+   молча заводить нельзя). Две задачи об одном — самая дорогая находка
+   переоценки.
+3. **Тип** — `--type` обязателен, и он же первое содержательное решение:
+
+   - возможность приложения, а не шаг к ней → `goal`;
+   - снаружи появляется то, чего не было → `feature`;
+   - поведение расходится с заявленным и **воспроизводится** → `fix`
+     (не воспроизводится → `research`);
+   - обслуживание, наблюдаемое поведение не меняется → `chore`;
+   - исход — знание, а не изменение системы → `research`.
+
+   Не подходит ни один — в записи их два, разбирай. Не проходит тест готовности
+   (см. task-format) — это **сырьё**: `--type research`, раздел «Вопрос» пока
+   пуст, место в конце категории. Не делается одним заходом — это не эпик, а
+   несколько задач под одной целью: дроби сразу.
+4. **Цель — если тип её требует.** У `feature` должен быть `--goal <слаг>`:
+   новая возможность и есть содержание цели. Подходящей нет — либо она
+   заводится (`--type goal`), либо перед тобой не `feature`. У `fix`, `chore` и
+   `research` цели может не быть вовсе, и придумывать её не надо.
+5. `add …`, затем допиши тело редактором **по схеме своего типа** — шаблон её
+   уже разложил, устав типа объясняет каждый раздел. «Зачем» отвечает «зачем
+   нужна эта задача» — состояние, остаток, боль, — а не пересказывает первый
+   абзац, и пишется **для человека**: не «канонизация внутри транзакции», а
+   «тело 40 МиБ держит блокировку 5 секунд, соседние доставки уходят в отказ».
+6. `check`.
+
+### Разобрать находки аудита или ревью
+
+Ревью и аудиты — тоже источник задач, но с опасностью, зеркальной диалогу: не
+пять файлов из одной мысли, а сорок файлов из сорока сырых находок. Защита та
+же, что в самом ревью: кластеризация по причине, дедуп против живых и
+`REJECTED.md`, находка без свидетельства → сырьё (`research`), а не задача, и карта кластеров
+пользователю до создания файлов. Порядок, отображение серьёзности и привязка к
+целям — [references/from-review.md](references/from-review.md).
+
+### Прийти в репозиторий, где задачи уже как-то ведутся
+
+Разовая операция: вывести каталог задач из старой раскладки беклога, `TODO.md`,
+заметок или списка шагов роадмапа — [references/adopt.md](references/adopt.md).
+Сюда же относится переименование транслитных слагов в английские: оно делается
+**одним проходом вместе с починкой перекрёстных ссылок**, а не по одному слагу.
+
+Если переводить надо не только задачи, а весь `docs/` — это скилл
+`av-dev:doc-canon`, и он зовёт этот сценарий сам на своём шаге.
+
+### Декомпозиция и штурм сырья
+
+[references/split.md](references/split.md). Обе операции превращают одну запись в
+несколько, и у обеих есть проверяемый тест: части должны **мерджиться порознь** и
+**каждая давать видимую пользу**, а у штурма исход «выкинуть» — полноправный.
+
+Там же **шов**: где резать, когда допустимых мест несколько. Коротко — по
+границе, которая одна поднимает метку ревью выше остальных; и не резать, когда
+обе половины остаются в одной метке, потому что несокращаемый костяк проверок
+платится за каждую задачу отдельно.
+
+### Вычитка: два прохода, а не один
+
+Записи судит **не тот агент, который их написал**: самопроверка текста слабее
+всего ровно там, где формулировка казалась удачной при написании. Проходов два,
+и они разные по природе:
+
+| Проход | Что смотрит | Над чем работает |
+| --- | --- | --- |
+| `task-form` | заголовок по типу, «зачем» вместо пересказа, границы вместо замысла, годность оракулов, предписание процесса, связь со строкой «Завершения» цели | только `items/`, **открывает файл цели** |
+| `task-wording` | залог и отглагольные, оценка без факта, стоп-слова, англицизмы, жаргон, неизвестный термин, транслит в слаге | `items/` и строки индексов; документы проекта — только как словарь |
+
+Разделены они не по охвату, а **по глубине**. Язык проверяется по словам и
+фразам, поштучно; форма записи требует понять, что задача делает, и открыть
+цель, на которую она ссылается. Слитый проход одну половину делает дорогой, а
+вторую — поверхностной.
+
+Модель у обоих одна, `sonnet`, и это не отменяет разреза. Оба судят по
+**записанному правилу** — семь пунктов формы против правил языка, — а их находка
+приходит готовой формулировкой, которую читает и отклоняет человек, а не молча
+реализует оркестратор. Ошибка здесь стоит строки чтения, и платить за неё верхней
+моделью не за что.
+
+Каждый устав отказывается от чужой половины прямо: увиденное не по своей части
+идёт **строкой в границах покрытия**, а не находкой. Две проверки одного места
+расходятся и начинают спорить, и разнимать их потом дороже, чем не сводить.
+
+**Порядок — сперва `task-form`.** Его находки меняют решение «брать или не
+брать», а язык — только цену чтения; и переписанный заголовок бессмысленно
+вычитывать до того, как он переписан.
+
+Зовутся они **пачкой, а не на каждую запись**: после заведения нескольких задач,
+после разбора находок ревью, после того как чужая работа уточнила записи (так
+делает разведка в `av-dev:code-resolve`), и на переоценке. Передаётся список файлов и — если
+есть — паспорт, архитектура и конвенции проекта: по ним отличается неизвестный
+термин от известного.
+
+Ни один из них ничего не правит. Оба возвращают готовые формулировки, и их
+подставляет скилл: заголовок — `edit <слаг> --title …`, «зачем» —
+`edit <слаг> --why …`, остальное редактором. **Заголовок и «зачем» — это то, по
+чему задачу выбирают, поэтому менять их молча нельзя**: покажи предложенное
+пользователю вместе с тем, что было. Правки в теле (границы, критерии, язык)
+применяются сразу.
+
+Всё, что ловит `tasks.py check`, оба не трогают намеренно.
+
+### Гигиена полей
+
+Правится по ходу любой операции, которая задачи касается (но не «заодно» по
+всему беклогу):
+
+- **протухшее «зачем»** — задача изменилась, а поле отвечает на старый вопрос;
+  особенно после ответа на вопрос задачи: «Решено: …» на «почему это лежит в
+  беклоге» уже не отвечает. Переписывается `edit <slug> --why …` — он правит
+  мету файла и строку индекса заодно;
+- **вопрос, застрявший в прозе** — вынимается в раздел «Вопросы» плюс тег
+  `question` (`edit --add-tag question`), иначе он не виден ни `list
+  --questions`, ни правилу «задача с открытым вопросом в работу не берётся»;
+- **тег, который некому снять** — `question` после ответа снимается `edit
+  --rm-tag question` вместе с записью ответа в тело **и опустошением раздела
+  «Вопросы»**: судит раздел, а не тег (`references/task-format.md`);
+- **свойство репозитория в рамках** — номер миграции, хеш, версия зависимости:
+  в лежалой задаче протухает молча и становится ложной рамкой. Снимается;
+  снимок берётся при постановке, а не при заведении;
+- **предписание процесса в теле** — «делать с такой-то меткой ревью», «взять
+  такой-то агент»: это второй дом для правила выбора и путь понизить требования
+  решением, принятым до проектирования. Снимается;
+- **тип, разошедшийся с задачей** — задача заводилась починкой, а после разбора
+  оказалось, что поведение никогда и не было заявлено: это `feature`, а не `fix`.
+  Правится `edit <slug> --type …`; тип, оставшийся от прошлой формулировки, врёт
+  ровно там, где по нему отбирают, **и требует не тех разделов**: у брошенного
+  `fix` останется «Воспроизведение», которого нечем заполнить;
+- **сырьё, у которого появился вопрос** — разведка обросла формулировкой, но
+  раздел «Вопрос» так и пуст: она числится сырьём и в работу не берётся.
+  Записывается вопрос, и `check --fix` поднимает строку из конца категории;
+- **границы, названные вместо реализации** — «переписать хранилище на новый
+  драйвер» в разделе «Затрагивает» это не граница, а замысел. Границы —
+  `таблица points и её миграция`, `эндпоинт POST /ingest`, `формат отпечатка на
+  диске`. Переписывается перечнем;
+- **англицизм и термин из ниоткуда** — правится по ходу той же операции, что
+  касается задачи (см. «Как написана задача»). Именно по ходу: беклог не
+  переписывают ради языка.
+
+## Переносимость
+
+Скилл независим от **языка программирования, сборки, CI и трекера**: он ничего
+не знает ни про Go, ни про npm, ни про конкретный багтрекер — задачи для него
+просто каталог markdown. Текст задач — русский (язык документации проекта);
+зашита только латиница слага. OpenSpec ему тоже не нужен.
+
+- **Каталог задач — `tasks/` в корне, жёстко**, и `--dir` передаётся явно всегда:
+  раскладка канона одинакова во всех проектах, и искать больше нечего. Каталога
+  нет — код 3 и вопрос человеку; `init` заводит его **только** когда проект
+  действительно новый, а перевод чужой раскладки делает `av-dev:doc-canon`.
+  У скрипта поиск вверх по дереву ещё жив — он для непереведённых проектов, и
+  полагаться на него скилл не должен: молча найденный чужой каталог это дрейф.
+- **Версия формата и настройки живут в `<каталог задач>/.tasks.json`** — свой
+  файл у своего плагина: ключ `tasks` с версией формата плюс **имена** файлов и
+  заголовков, и последние — только если отличаются от умолчания. Неизвестный
+  ключ — код 3 на любой команде, так что лишнее слово в этом объекте
+  останавливает работу с задачами целиком.
+
+  Дом именно свой, а не `docs/.docs.json`, потому что `docs/` принадлежит
+  плагину канона: проект, поставивший учёт работ без него, каталога `docs/` не
+  имеет вовсе. Прежний ключ `tasks` в `docs/.pm.json` читается, **только когда
+  своего файла нет** — для проектов, заведённых до раскола плагинов; скрипт при
+  этом говорит замечанием, куда его перенести. Есть оба — побеждает свой, и об
+  этом тоже говорится вслух: молча выбранный из двух конфиг это дрейф. Версию
+  прежний дом не знает и знать не может — она читается только из своего файла.
+- **Секции беклога** берутся из заголовков `##` индекса как есть; их количество
+  и названия — дело проекта (умолчание `Ядро` / `Инфра`). **В конфиге их нет** —
+  второй список разошёлся бы с заголовками молча.
+
+### Вызов из другого плагина
+
+`$CLAUDE_PLUGIN_ROOT` раскрывается **только внутри своего плагина**: конвейер
+задачи, конвейер ревью и любой другой чужой контекст до `tasks.py` по этой
+переменной не дотянутся. Мост — **вызов скилла через пространство имён**, а не
+путь:
+
+> Чужой контекст зовёт `Skill av-dev:task-track` и называет, что нужно сделать
+> («закрой задачу `<слаг>`, реализована»). Скилл разрешает свой
+> `$CLAUDE_PLUGIN_ROOT` сам. Путь наружу не выносится вовсе.
+
+Плагина в проекте нет — вызов не разрешится, и вызывающий **не выдумывает путь и
+не правит индекс руками**, а сообщает в докладе, что учёт задач остаётся за
+владельцем.
+
+## Слоты проекта
+
+Почти всё, что скиллу нужно знать о проекте, отвечает канон структурой: куда
+переезжает суть реализованной задачи — `openspec/specs`, `adr/`, архив change;
+какие в проекте оракулы — семантика гейта в `CLAUDE.md`. Отдельными слотами
+остаётся то, чего из раскладки не вывести. **Проект дописывает в `CLAUDE.md`**:
+
+1. **Что такое «сделана»** — чем задача выполняется (конвейер проекта) и что
+   входит в его определение сделанного. Скилл требует лишь **форму**: конвейер
+   проекта пройден + критерии приёмки проверены поимённо.
+2. **Что считается необратимым** и потому спрашивается у человека всегда
+   (деплой, выкладка наружу, удаление или перезапись данных).
+
+Ни того ни другого скилл не угадывает: не нашёл — спрашивает пользователя, а не
+подставляет умолчание.
+
+## Общее для всех сценариев
+
+- **Развилки — пользователю.** Через `AskUserQuestion`, с уже сформулированным
+  предварительным суждением (**рекомендация — первым вариантом**). Что выкинуть,
+  под какую цель отнести, какая рамка разведки верна — решение пользователя. Слаг,
+  формулировка, порядок строк в индексе — механика, делаем сами.
+- **Не больше трёх вопросов за раз.** Пачка длиннее трёх тяжела для ответа;
+  решений больше — веди **несколько итераций** диалога по ≤3, а не один
+  перегруженный запрос. Между итерациями применяй уже решённое.
+- **Границы покрытия в отчёте.** Любая сессия разбора, штурма или интейка
+  заканчивается строкой «просмотрено N из M, не трогали — …». Отчёт без неё
+  сообщает «беклог разобран», не сообщая, какая его часть осталась нетронутой.
+- **Ничего не удаляем молча.** Файл исчезает только через `close` — `--reason`
+  (ушла без реализации) или `--implemented` (реализована). Прямого `rm` нет.
+- **Слаги английские**, kebab-case, не транслит: `tie-break-equal-completeness`,
+  а не `taj-brejk-pri-ravnoj-polnote`. Заголовки, тела и «зачем» — русские.
+
+## Чего этот скилл не делает
+
+Не пишет код, не заводит спеки и предложения об изменении, не берёт задачу в
+работу — этим занимается конвейер проекта. **Не ведёт очередь:** что делать
+следующим и что перестало быть важным — скилл `groom`, а этот даёт ему операции.
+Не решает за пользователя, что важно. Не
+переоформляет существующие задачи «заодно»: правится то, чего касается операция.

av-dev/skills/task-track/references/adopt.md

@@ -0,0 +1,130 @@
+# Адаптация каталога задач
+
+Проект, где задачи уже как-то ведутся, и из имеющегося материала **выводится**
+заполненный каталог задач: цели, задачи, кладбище, индексы. Операция разовая —
+после неё проект живёт скиллами `tasks` и `groom`.
+
+**Это часть приведения проекта к канону.** Раскладку `docs/` целиком ведёт скилл
+`av-dev:doc-canon`; он же зовёт этот сценарий на шаге «каталог задач», потому что
+форматом задач владеет `tasks`, а не `canon`. Отдельно сценарий вызывается,
+когда переводить надо **только** задачи.
+
+Вход какой угодно: старая раскладка `av-dev-backlog` (индекс `README.md`,
+кладбище `CLOSED.md`, приоритеты секциями, транслитные слаги, файлы рядом с
+индексом), `TODO.md`, россыпь заметок, раздел «планы» в `README.md`, список
+шагов роадмапа проекта.
+
+## Три правила, из которых всё следует
+
+1. **Сперва карта, потом файлы.** Человеку показывается, что найдено, как
+   разложилось по целям и **что не разложилось**, — и только после подтверждения
+   пишется хоть один файл. Это то же правило, что у интейка находок ревью:
+   массовое заведение записей без подтверждения — самый дорогой отказ, потому
+   что разгребает его потом переоценка.
+2. **Ничего не терять.** Исходный текст переезжает в тело, «зачем» и причина
+   сохраняются, кладбище переносится строка в строку. Переименование слага —
+   не правка, а **перенос ссылок**: он делается одним проходом вместе с
+   переименованием, иначе останутся битые ссылки, которых никто не проверяет.
+3. **Что не классифицировалось — назвать поимённо.** Проглоченный пункт
+   выглядит как «всё перенеслось». Список «не разложилось» идёт в доклад
+   целиком, с причиной по каждому пункту.
+
+## Форма: карта — суждение — запись
+
+Механику несёт `tasks.py adopt`, суждение — ты. Разделено ровно по границе
+«машина умеет / не умеет»:
+
+```
+tk="$CLAUDE_PLUGIN_ROOT/skills/tasks/scripts/tasks.py"
+
+python3 $tk adopt scan --from docs/backlog docs/plan.md TODO.md \
+        --target tasks --out tasks-adopt-plan.json           # только чтение
+python3 $tk adopt apply --plan tasks-adopt-plan.json \
+        --refs docs openspec CLAUDE.md README.md             # запись
+```
+
+`scan` ничего не пишет, кроме карты: он распознаёт раскладку, собирает записи,
+поля «зачем», причины, кладбище, помечает похожее на транслит и на открытый вопрос в
+прозе, и **называет поимённо** то, что не разложилось. `apply` пишет каталог
+целиком одним проходом и чинит перекрёстные ссылки.
+
+Между ними — твоя работа, которую машина не сделает:
+
+- **английские слаги.** Перевести `taj-brejk-pri-ravnoj-polnote` в
+  `tie-break-equal-completeness` может только тот, кто понимает смысл. `scan`
+  честно говорит: проверить надо **все** слаги, признаки транслита — эвристика;
+- **цели.** Шаги роадмапа — готовые цели в **`Запланировано`** (очередь и
+  обоснование у них уже есть); тематические скопления задач — цели в
+  **`Направления`** («прочность слияния»,
+  «журнал и пересборка»). Предлагаешь ты, назначает человек;
+- **что вообще не задача.** Обоснование порядка шагов, абзац прозой, заголовок
+  раздела — это не пункты беклога, и они уходят в «не разложилось» с причиной.
+
+## Порядок
+
+1. **Осмотрись.** Где лежат задачи, роадмап, заметки. Каталог задач по канону —
+   всегда `tasks`. Секции беклога (`--sections`) — по умолчанию
+   `Ядро,Инфра`; если у проекта деление другое по существу, оно называется
+   здесь, а не подгоняется под умолчание, и становится **заголовками `##`
+   индекса** — их единственным домом. В `.tasks.json` секции не пишутся: там
+   версия формата и имена частей, а второй список секций разошёлся бы с
+   заголовками молча.
+2. **`adopt scan`** по всем источникам разом. Один прогон, одна карта: два
+   прохода дадут два несогласованных состояния.
+3. **Заполни карту**: `slug` (английский), `section`, `goal` у каждой записи;
+   список `goals` — из шагов роадмапа и из тем. Закрытый шаг целью не
+   заводится. Пустой `goal` законен у `fix`, `chore` и `research` — они служат
+   работоспособности, а не направлению; у `feature` цель обязательна.
+4. **Покажи человеку карту** через `AskUserQuestion`, ≤3 вопроса за итерацию,
+   рекомендация первым вариантом. Показывается: сколько записей, предлагаемые
+   цели (порядок и темы) с обоснованием, спорные отнесения, список «не
+   разложилось». Массовые механические решения (слаги, порядок строк) не
+   выносятся — это механика.
+5. **`adopt apply`.** `--refs` перечисляет **всё**, где могут стоять ссылки на
+   слаги: документация, архив изменений, `CLAUDE.md`, `README.md`. Скрипт
+   посчитает и покажет, сколько ссылок поправлено и по каким слагам.
+6. **`tasks.py check`** и доклад.
+
+`apply` отказывается писать поверх живого каталога и проверяет карту целиком
+**до** первой записи: неверная секция, дубль слага, цель, которой нет в карте —
+всё это отказ до того, как на диске появился хотя бы один файл.
+
+## Переходное состояние — объявляется, а не заминается
+
+Сразу после адаптации задачи в большинстве своём **не готовы к взятию**: у них
+нет критериев приёмки, а у части может не быть цели. Это нормально, но обязано
+быть названо, иначе следующий агент примет пустой беклог за поломку.
+
+`apply` печатает состояние по факту: сколько задач без цели (это **ошибки**
+`check`) и сколько не собрало разделы своего типа (для `check` это не ошибка, а
+строка здоровья, но `ready` такую задачу не пропустит). Закрывается это
+**порциями груминга** — скилл
+`groom`, 5–8 задач за порцию: проставить цели, превратить «готово, когда» в
+критерии с оракулами, вынуть вопросы из прозы в раздел «Вопросы». Там же
+беклогу впервые назначается **порядок**: после адаптации его нет вовсе, а
+очередь и есть то, ради чего каталог заводят.
+
+Готовность к первой задаче — не «`check` зелёный», а «`ready` пропускает хотя бы
+верхние строки очереди».
+
+## Чего адаптация не делает
+
+- **Не удаляет источники.** Старый каталог остаётся на месте: сверить и убрать —
+  дело человека, удалять чужое молча нельзя. В доклад идёт готовая команда.
+- **Не переписывает подписи ссылок.** `[docs/backlog](tasks/BACKLOG.md)` —
+  цель поправлена, текст остался; это правится глазами, и таких мест немного.
+- **Не сочиняет критерии приёмки и не придумывает цели**, которых в материале
+  нет. Придуманная цель хуже отсутствующей: под неё заведут задачи.
+- **Не трогает историю.** В коммитах старые слаги остаются, и это нормально.
+
+## Доклад
+
+- Источники и что в каждом распознано (раскладка, индекс, кладбище, секции).
+- Сколько записей перенесено, сколько целей заведено (порядок / темы) и откуда
+  каждая выведена.
+- **Переименования**: сколько слагов, сколько ссылок поправлено и в скольких
+  файлах — числом, а не «поправлены ссылки».
+- **Не разложилось**: поимённо, с причиной.
+- Переходное состояние: сколько задач без цели, сколько без критериев, чем и за
+  сколько порций закрывается.
+- `tasks.py check` — результат строкой.

av-dev/skills/task-track/references/changelog.md

@@ -0,0 +1,61 @@
+# Журнал версий формата задач
+
+Одна запись на версию. Проект знает свою версию из ключа `tasks` в `<каталог
+задач>/.tasks.json`; повышение (`upgrade` в [SKILL.md](../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 — это формат на день её появления, что бы
+проекту ни пришлось пройти до неё.
+
+**Что сделать проекту.**
+
+1. **Догнать формат по журналу канона, если каталог отстал.** Признаки известны
+   поимённо: каталог лежит в `docs/tasks/` (канон 11 велит `git mv docs/tasks
+   tasks` и починку относительных ссылок внутри записей), в нём есть `SPRINT.md`
+   или теги `sprint:<слаг>` (канон 12 велит снести файл, вернуть строки в беклог
+   через `check --fix` и расставить порядок грумингом). Ничего из этого нет —
+   каталог уже в сегодняшнем формате, и шаг пропускается.
+2. **Завести `<каталог задач>/.tasks.json`**, если его нет. Имена частей в него
+   не переписываются: там только то, что отличается от умолчания.
+3. **Записать версию**: `"tasks": 1` первым ключом.
+4. `tasks.py check --dir <каталог задач>` — до отсутствия расхождений.
+
+**Что при этом не трогается.** Записи в `items/`, индексы и `REJECTED.md` не
+меняются ни строкой: версия 1 объявляет то, что уже есть, а не переделывает его.

av-dev/skills/task-track/references/from-review.md

@@ -0,0 +1,131 @@
+# Задачи из аудита и ревью
+
+Ревью и аудиты — код-ревью, архитектурный проход, аудит безопасности, любой
+разбор другим агентом — порождают находки, часть которых становится задачами.
+Это отдельный интейк со своей опасностью, **зеркальной** интейку из диалога.
+
+- Интейк из диалога грешит переполнением: из одной мысли рождается пять файлов.
+- Интейк из ревью грешит сваливанием: сорок сырых находок превращаются в сорок
+  файлов. Беклог раздувается, а следующая переоценка склеивает их обратно.
+
+Защита от сваливания — та же, что в самом ревью: **кластеризация по причине, а
+не файл-на-находку.** Если у ревью был триаж — половина работы уже сделана, бери
+его выход. Если нет — триажируй сам, прежде чем заводить.
+
+**Штатный отправитель — `av-dev:code-review`** (и `av-dev:code-resolve`, который
+его вызывает): задач он не заводит сам, а отдаёт отложенные находки **списком
+урожая** — формулировка, оракул, провенанс — и хранит отчёт триажа вместе с
+изменением. Приходит и любой другой разбор, вплоть до пересказа человеком; тогда
+триажа нет и шаг 1 порядка делается руками.
+
+## Находка агента — не задача
+
+Мнение агента — **гипотеза, пока у неё нет свидетельства** (падающий тест,
+воспроизводимый шаг, положение руководства). Согласие нескольких находок само по себе
+достоверность не повышает: это один источник, высказавшийся несколько раз.
+
+Отсюда фильтр входа, поверх обычного «не делаем сейчас + пожалеем о потере»:
+
+- **Находка со свидетельством**, отложенная к исполнению → **задача**.
+  Свидетельство и последствие переносим в тело — это её «почему», то самое, что
+  переживает запись.
+- **Находка без свидетельства / низкой уверенности** → **сырьё**: `research`, у
+  которого раздел «Вопрос» и есть недостающее свидетельство («при каких условиях
+  это воспроизводится»). Не `fix`: без `Воспроизведения` его в работу не
+  возьмут, и правильно — чинить нечего, пока непонятно, что ломается. Судьба
+  сырья — штурм, где либо найдётся подтверждение, либо оно уедет в
+  `REJECTED.md`.
+- **Уже починено по ходу ревью** → **ничего**. Починенное не заводим.
+- **Развилка, решённая при ревью** → ничего; решённая «потом» → задача с
+  вопросом в разделе «Вопросы» и тегом `question`.
+
+## Порядок
+
+1. **Возьми выход триажа, а не сырые находки.** Сырой отчёт — это симптомы до
+   дедупликации; в нём одна причина размазана по нескольким строкам.
+2. **Кластеризуй по причине.** Пять находок об одном отсутствующем инварианте —
+   одна задача, а не пять. Класс мелочи (nits, косметика) — **один пакетный
+   файл** со списком пунктов, а не файл на каждую запятую.
+3. **Дедуп против живых задач и `REJECTED.md`.** Аудит переоткрывает уже
+   заведённое и уже выкинутое. Нашлось среди живых — дописываем находку в
+   существующий файл. Нашлось в `REJECTED.md` — это сигнал: причина отказа могла
+   устареть, выноси пользователю, а не заводи молча заново.
+4. **Разложи по целям — там, где цель нужна.** Большинство находок ревью это
+   `fix` и `chore`, и **цель им не требуется**: они служат работоспособности, а
+   не направлению. Придуманная им цель —
+   ровно то враньё, от которого спасает тип.
+
+   Цель обязательна у находки, которая оказалась **новой возможностью**
+   (`feature`): нашлось поведение, которого никто не заказывал, и его надо
+   либо заказать целью, либо убрать. Подходящей цели нет — заведи её
+   (`add --type goal --section Направления`) в том же проходе.
+5. **Покажи карту до создания файлов.** Кластер → задача / сырьё / строка в
+   пакетный файл / уже заведено / отброшено, и под какую цель — пачкой через
+   `AskUserQuestion`. Это тот же барьер, что и «три кандидата» в интейке из
+   диалога: массовое заведение файлов без подтверждения — ровно тот отказ, ради
+   которого интейк из ревью и выделен. Дешёвая мелочь по явному согласию может
+   заводиться и без поштучного вопроса — но карта пользователю предъявляется
+   всё равно.
+6. **Заводи утверждённое** через `tasks.py add`, с тремя добавками:
+   - **тег партии** — `--tag review-ГГГГ-ММ-ДД` (или `audit-<slug>`), чтобы весь
+     заход разбора поднимался одной командой `list --tag …`;
+   - **тип** — `--type`, и он **не по умолчанию `fix`**: починкой считается
+     расхождение с заявленным поведением, а находка «этого свойства никто не
+     заказывал» — это `feature`, находка «не знаем, как поведёт себя драйвер» —
+     `research`. Тип, розданный оптом, врёт ровно там, где по нему потом
+     отбирают, **и требует не тех разделов**: каждому `fix` придётся заполнить
+     `Воспроизведение`, а у находки без свидетельства его нет;
+   - **провенанс в теле** — кто нашёл, каким проходом, с каким свидетельством.
+     Без него через месяц не отличить проверенную находку от догадки.
+7. `tasks.py check`.
+
+## Куда девается серьёзность находки
+
+Уровня серьёзности в записи нет — но **выкидывать её нельзя**: серьёзность
+отображается **в позицию в очереди**, потому что приоритет и есть порядок строк
+в беклоге (правило 4 [SKILL.md](../SKILL.md)). Отображается через довод, а не
+напрямую: своей шкалы у интейка нет, доводы расстановки перечислены в
+[скилле груминга](../../groom/SKILL.md#приоритет-как-его-расставляют), и
+серьёзность попадает ровно в один из них.
+
+- **тяжёлая находка со свидетельством о сломанном сейчас** → задача под ту цель,
+  которой она угрожает, и **первой строкой секции**: `move <слаг> --first
+  --reason «сломано сейчас: …»`. Это довод «что сломано сейчас» из перечня
+  груминга — единственный, который не требует сравнения с соседями по очереди,
+  потому что сломанное дорожает само. Позицию всё равно назначает человек, и
+  здесь он её уже назначил: верх очереди для такой находки предъявляется картой
+  шага 5, а не проставляется молча;
+- **тяжёлая находка о риске, а не о поломке** (дорожает от ожидания,
+  разблокирует остальное) → в конец секции, а довод — причиной в мете
+  (`--reason`). Позицию назначит человек на ближайшем груминге, сравнив её с
+  верхом очереди; без записанного довода сравнивать он будет с нуля;
+- **находка, которая не ждёт груминга вовсе** (необратимый ущерб, покраснела
+  проверка, которую проект назвал сломанным), — не интейк: это работа прямо
+  сейчас, а в беклог она падает, только если ждать всё-таки можно;
+- **низкая уверенность или нет свидетельства** → сырьё (`research` с пустым
+  разделом «Вопрос»): его место в очереди производно от типа — конец секции;
+- **мелочь** → строка в пакетный файл;
+- **уже починено / развилка решена сейчас** → ничего.
+
+Словарей серьёзности много, и отображать их механически не на что: при сомнении
+— вопрос пользователю, а не догадка.
+
+## Поимённая сверка
+
+Интейк считается выполненным, только если **каждая** находка триажа получила
+исход: слаг заведённой задачи, ссылку на существующую, строку пакетного файла
+или запись «не заведена: причина». Нулевой урожай при непустом отчёте триажа
+виден сразу — и это единственный способ отличить «находок не было» от «не стал
+заводить». Список составляет не тот, кто отчитывается о заведении.
+
+Границы покрытия отчёта — то, что ревью проверить **не смогло**, — не находки и
+в задачи не идут: у них нет предмета. Их место в докладе, не в беклоге.
+
+## Доклад
+
+- Источник (какое ревью/аудит, сколько находок на входе).
+- Свёрнуто в задачи: N кластеров из M находок, со слагами, целями и тегом партии.
+- Что не заведено и почему: починено инлайн, уже заведено, стало сырьём, ушло в
+  `REJECTED.md`.
+- Поимённая сверка: находок на входе N, исход есть у N.
+- `tasks.py check`.

av-dev/skills/task-track/references/language.md

@@ -0,0 +1,213 @@
+# Язык проектных текстов
+
+**Копия.** Дом — `shared/language.md` в репозитории плагинов; язык общий для
+документов канона и для задач, и потому не принадлежит ни одному плагину.
+Правится дом, а не этот файл: расхождение ловит `copies.py` на гейте коммита.
+
+<!-- копия: язык-доктрина из av-dev/shared/language.md -->
+
+Правила — для всего, что пишется словами: задачи и цели, документы канона,
+решения ADR, записки разведки, сообщения коммитов. Не для кода и не для
+сообщений программы пользователю — там свои конвенции проекта.
+
+Основа — **информационный стиль** Максима Ильяхова ([учебник
+бюро](https://bureau.ru/projects/book-text/), книга «Пиши, сокращай»). Он
+написан для рекламы, статей и писем, поэтому взят не целиком.
+
+## Зачем он здесь
+
+Проектный текст читают в двух положениях, и оба неудобные: **выбирают, брать ли
+задачу**, глядя в строку индекса и один экран тела; и **возвращаются через
+квартал**, не помня контекста. Оба положения наказывают одно и то же — слова, не
+несущие сведений. Информационный стиль ровно про это, и его польза здесь не
+эстетическая: текст, из которого нельзя достать факт, заставляет открывать код,
+а это и есть цена, которой мы избегаем.
+
+## Что взято сверх правил вычитки
+
+Эти три требования судит человек, а не проход вычитки: находка по ним требует
+увидеть текст целиком, а не фразу.
+
+**Полезное действие.** У каждого текста есть вопрос, на который он отвечает, и
+читатель, который этот вопрос задаёт. Не отвечает — не пишется. У задачи это
+«зачем она нужна» и «что станет наблюдаемо иначе»; у документа канона — его
+собственный вопрос («что это за система», «как сложено», «почему так решили»).
+Текст, который не отвечает ни на чей вопрос, сокращается до нуля — это законный
+исход правки.
+
+**Параллельность.** Однородное пишется одинаково: пункты списка — одной
+грамматической формой, разделы одного вида — одним порядком, заголовки одного
+уровня — одним типом фразы. Разнобой читатель принимает за разницу по существу и
+ищет её.
+
+**Заголовок работает.** Заголовок называет содержание раздела, а не тему
+вообще: «Что проверяет `check`», а не «О проверках». Заголовков ставится
+столько, чтобы длинный текст можно было просматривать, а не только читать
+подряд.
+
+## Что отброшено намеренно
+
+Инфостиль написан для текстов, где читателя надо удержать. Проектный текст
+читают потому, что надо, и держать его нечем. Отсюда три расхождения:
+
+- **Парцелляция и рубленые фразы — нет.** Приём «Коротко. Ещё короче. Вот так»
+  ломает причинную связь, а в решении и в задаче ценность именно в ней:
+  «поэтому», «иначе», «раз так» несут смысл и остаются.
+- **Не всякое вводное — мусор.** «Если», «иначе», «при таком-то условии»,
+  «в отличие от» — это условия и противопоставления, то есть сведения. Режутся
+  вводные, которые не меняют смысл предложения.
+- **Скобки и точка с запятой остаются.** В технической записи скобки несут
+  уточнение — имя команды, единицы, слаг, — и запрет на них удлинил бы текст, а
+  не сократил. Запрет на многоточие принимаем: в проектном тексте оно значит
+  «дописать позже», и такой текст лучше не публиковать.
+
+И общее: инфостиль призывает «снять корону с себя и надеть на читателя». Здесь
+читатель — **ты сам через квартал** и тот, кто возьмёт задачу. Писать для них
+значит называть состояние и остаток, а не пересказывать, как было интересно
+разбираться.
+
+<!-- /копия: язык-доктрина -->
+
+## Правила
+
+<!-- копия: язык-правила из av-dev/shared/language.md -->
+
+У каждого правила названа причина: она же говорит, где правило **не**
+применяется.
+
+1. **Глагол вместо отглагольного существительного, активный залог.** «Обработчик
+   не проверяет владельца», а не «проверка владельца не осуществляется»;
+   «скрипт переписывает индекс», а не «индекс переписывается скриптом».
+   Отглагольное существительное прячет того, кто действует, — а в техническом
+   тексте важен именно он. Страдательный залог **остаётся**, когда деятель
+   неизвестен или неважен: «файл удаляется» верно, если удаляет любая из трёх
+   команд.
+
+2. **Факт вместо оценки.** «Время ответа доходит до 800 мс», а не «работает
+   медленно»; «тело 40 МиБ держит блокировку 5 секунд», а не «большие тела
+   тормозят». Оценка допустима, когда факт стоит рядом, в той же фразе. Без
+   факта это настроение, а не сведение, — и находка тем ценнее, что оценку
+   потом не проверить.
+
+3. **Стоп-слова.** Канцелярит (является, осуществляется, в целях, в рамках,
+   данный, вышеуказанный), вводные-паразиты (в общем, как известно, стоит
+   отметить), усилители (очень, крайне, достаточно, абсолютно, максимально),
+   синонимы одного качества («понятный и простой»), неопределённое
+   (соответствующий, определённый, некоторый).
+
+   Проверка одна: **вычеркни слово — смысл изменился, оставляй.** И осторожно с
+   вводными: «если», «иначе», «при таком-то условии», «в отличие от» несут
+   условие и противопоставление, то есть сведения, — их не трогают.
+
+4. **Одна мысль — одно предложение.** Предложение с двумя независимыми
+   утверждениями делится. **Причинную связь не режут**: «поэтому», «иначе», «раз
+   так» — смысл, а не длина; рубленые фразы ради краткости тут вредят.
+
+   **Поля меты не делятся.** «Зачем» в мете задачи по формату — одно
+   предложение: оно повторяется строкой индекса, и второму там не поместиться.
+   Тесно — сокращают, но не делят. То же с любым полем вида `- **Имя:** …`.
+
+5. **Англицизм, у которого есть живое русское слово, заменяется.**
+
+   | Калька | Русский аналог |
+   | --- | --- |
+   | флоу | поток, процесс, сценарий |
+   | фикс, зафиксить | исправление, исправить, починить |
+   | чекать | проверять |
+   | апрув, заапрувить | согласование, согласовать |
+   | best-effort | по возможности |
+   | кейс | случай, сценарий |
+   | перформанс | производительность |
+   | матчинг, смэтчить | сопоставление, сопоставить |
+   | зарелизить | выпустить, выложить |
+   | отрефакторить | переписать, разделить, убрать второй путь |
+
+   Насильно не переводится то, что является **именем вещи**: термины технологий
+   и протоколов (`SQL`, `API`, `CSV`, `N+1`, `IDOR`), имена классов, методов,
+   полей, таблиц и команд, слаг, а также термин, у которого нет точного русского
+   эквивалента и который в команде уже прижился.
+
+   Цель — простой и точный текст, а не пуризм. Русский аналог звучит коряво или
+   искажает смысл — остаётся термин.
+
+6. **Слово из своего словаря не трогается — список закрыт.** Оговорка «термин
+   прижился» без списка проверяема на глаз и потому не проверяема: прижившимся
+   выглядит любое слово, встреченное трижды.
+
+   | Термин | Что называет |
+   | --- | --- |
+   | интейк | заведение записи с фильтром и дедупом: «заведение» называет создание файла, слить их — смешать две операции |
+   | триаж | стадия конвейера, сводящая находки в решение |
+   | провенанс | обязательное свойство числа: чем и при каких условиях получено. «Источник» рядом называет саму запись, а не свойство |
+   | дедуп, дедупликация | сверка нового против уже лежащего |
+   | чек-лист | перечень, по которому идут сверху вниз, называя исход каждой строки |
+   | дифф, `--base` | разница между состояниями в git |
+   | промпт | текст, которым зовут модель |
+   | change, capability, spec | сущности OpenSpec, имена вещей чужого инструмента |
+   | generative, applicative | роды проходов ревью, вводятся определением по месту |
+   | чекпоинт | плановый стоп работы, на котором ждут ответа человека. «Остановка» называет любой перерыв, «согласование» — обряд одобрения, а здесь место в процессе, назначенное заранее |
+   | синк | сверка каждого документа канона с только что сделанной работой, с обязательным отрицанием по нетронутым. «Обновление документации» называет исход, а не работу, и молчит о принуждённом отрицании |
+
+   **Список закрыт.** Слово не отсюда и не из таблицы имён вещей выше — находка,
+   а не «принятый стиль»: у него либо есть живой русский аналог, либо оно
+   требует ввода одной строкой при первом употреблении.
+
+   Отсюда же читается снятое. Эти слова из текстов убраны, и возвращать их не
+   надо: **конфляция** (смешение), **декорреляция** (разведённость, разведён с
+   кем-то), **непоймание** (почему не поймали), **эвал-сет** (проверочный
+   набор), **гайд** (руководство), **опиниативный** (проход с мнением). Каждое
+   было латинизмом или калькой при живом русском слове, и каждое к моменту снятия
+   жило в трёх-шести файлах разом — то есть выглядело словарём, не будучи им.
+
+7. **Жаргон и метафоры заменяются прямым называнием.** Автору образ понятен,
+   читателю — нет.
+
+   | Метафора-жаргон | Прямо |
+   | --- | --- |
+   | рычаг (кэша, отбора) | условие отбора, параметр |
+   | навешен не на тот счётчик | завязан не на тот счётчик |
+   | переширокий матчинг по имени | слишком грубое сопоставление по имени, слишком много слабых совпадений |
+   | костыль | временное решение, обходной путь — и в чём именно |
+   | просело, отвалилось | стало медленнее на столько-то, перестало отвечать |
+
+   Проверка: **фраза требует, чтобы читатель додумал образ, — заменяется
+   буквальным описанием того, что происходит.**
+
+8. **Термин, которого нет в документах проекта, вводится одной строкой или не
+   употребляется.** Термин, не встречающийся ни в паспорте, ни в архитектуре, ни
+   в конвенциях, — свой словарь у отдельной записи, а это самый дешёвый способ
+   сделать беклог нечитаемым для того, кто вернётся к нему через квартал.
+   Заменять незнакомый термин догадкой нельзя: догадка о предметной области
+   дороже непонятного слова, потому что выглядит понятной.
+
+   **Слово, занятое в другом смысле, — то же нарушение.** Термин, который в
+   одном документе проекта значит одно, а здесь другое, ломает оба.
+
+9. **Имя файла — английское слово по сути, а не транслит.** `queue-as-table`, а
+   не `ochered-tablicej`; `move-parse-strict`, а не `razbor-hoda`. Транслит
+   нечитаем тому, кто ищет по смыслу, и не сокращается, а имя стоит в ссылках,
+   коммитах и путях, которые набирают руками. Переименование — **перенос ссылок
+   одним проходом**, а не правка одного файла.
+
+<!-- /копия: язык-правила -->
+
+## Порог правки
+
+<!-- копия: порог-правки из av-dev/shared/language.md -->
+
+**Правка без нарушенного правила не делается.** Текст, переписанный «чтобы
+звучало лучше», обесценивает список замечаний: когда половина из них вкусовая,
+перестают читать весь список, и вместе с ним пропадают настоящие находки.
+Сомневаешься — не правь. Формулировка, которая просто **не твоя**, — не находка.
+
+**Систематичность нарушения — не довод в его пользу.** Одна и та же ошибка в
+пяти файлах не становится «принятым стилем»: чаще это значит, что правило не
+применялось вовсе, — и находка тем важнее. «Так сделано везде» годится как
+основание для **одной находки на весь набор** («правило N нарушено в пяти
+записях, перечень: …»), но не как основание промолчать. Принятым считается
+только то, что назвал зовущий или что записано в конвенциях проекта.
+
+<!-- /копия: порог-правки -->
+
+И обратное: язык правится **по ходу той операции, которая записи касается**.
+Беклог не переписывают ради языка.

av-dev/skills/task-track/references/operations.md

@@ -0,0 +1,34 @@
+# Сопровождение и эксплуатация
+
+**Копия.** Дом — `shared/operations.md` в репозитории плагинов. Словарь общий для
+роадмапа, архитектуры и темы ревью `operations`, и не принадлежит ни одному из
+трёх — правится дом, а не этот файл.
+
+Скиллу задач он нужен для секции `Сопровождение` в `ROADMAP.md`: она отвечает не
+на «что приложение будет уметь», а на «чем его держат», и путать эти два вопроса
+нельзя.
+
+<!-- копия: сопровождение-словарь из av-dev/shared/operations.md -->
+
+Одна тема живёт в трёх местах, и путать их слова нельзя.
+
+**Сопровождение** — всё, чем держат проект: инструмент и сборка, процесс,
+выкладка, метрики и логи, инфраструктура, дежурство. **Эксплуатация** — его
+часть: работа системы на проде. Целое и часть, и никогда наоборот.
+
+| Место | Уровень | Что там |
+| --- | --- | --- |
+| `ROADMAP.md`, секция `Сопровождение` | план | **работы**, которые собираемся делать: цели и их задачи |
+| `architecture.md`, раздел «Эксплуатация» | состояние | **как устроено сейчас**: где работает, что рядом, кто перезапускает |
+| тема ревью `operations` | оптика | **чем проверяем**: «это упало через неделю на проде» |
+
+Слово **«поддержка» не употребляется вовсе** — в нём слышится помощь
+пользователю, а это другая работа.
+
+**Граница с возможностями проходит по тому, кто наблюдает.** «Приложение
+сообщает о своём состоянии» — возможность приложения, её место среди прочих
+целей: наблюдает пользователь сервиса. «Дежурный видит состояние на одном
+экране» — сопровождение: наблюдаем мы. Одни и те же метрики попадают в разные
+секции роадмапа, и это верно — секции отвечают на разные вопросы.
+
+<!-- /копия: сопровождение-словарь -->

av-dev/skills/task-track/references/split.md

@@ -0,0 +1,116 @@
+# Декомпозиция и мозговой штурм
+
+Обе операции превращают одну запись в несколько (или в ноль). Разница во входе:
+декомпозиция дробит **слишком крупную задачу**, штурм прорабатывает **идею**,
+которая ещё не задача.
+
+## Тест декомпозиции
+
+Задачу можно дробить, только если части удовлетворяют **обоим** условиям:
+
+1. **Мерджатся независимо.** Часть Б не требует, чтобы часть А была уже влита.
+   Есть порядок «сперва А, потом Б, иначе не собрать» → это не декомпозиция, а
+   план реализации: шаги остаются **внутри одного файла**.
+2. **Каждая — самостоятельный шаг.** Часть, осмысленная только в комплекте с
+   другой, — не задача. Проверяй тестом «готова к взятию» (task-format): какую
+   строку «Завершения» цели двигает **именно эта часть** и какие у неё
+   собственные критерии приёмки. У операционных частей (`fix`, `chore`,
+   `research`) цели может не быть — тогда достаточно собственных критериев.
+
+Не проходит хотя бы одно — **не дроби**. Ложная декомпозиция плодит файлы,
+которые нельзя взять поодиночке, и переоценка потом склеивает их обратно.
+
+## Где резать, если резать можно
+
+Тест выше говорит, **допустим** ли разрез. Где его провести из нескольких
+допустимых мест — отвечает шов.
+
+**Шов — там, где падает метка ревью.** Раздел «Затрагивает» перечисляет
+границы; если одна строка перечня поднимает метку выше остальных, эта часть и
+режется отдельно. Пример: задача перекладывает несколько узлов разом и заодно
+добавляет два поля в существующий ответ. Целиком это `large` — семь проходов по
+всему диффу, включая два, что держат машину и идут цепочкой. Разрезанная по шву,
+она даёт `large` на маленькой переложенной части и `medium` на остатке.
+
+**Считай костяк, а не файлы.** У каждой задачи есть несокращаемые четыре прохода
+(гейт, спеки, код, триаж), и они платятся за каждую. Разрез, после которого обе
+половины остаются в одной метке, делает ревью **дороже**: тот же объём
+проверяется тем же составом, но костяк оплачен дважды. Отсюда правило: **резать,
+когда разрез снимает дорогой проход с большей части диффа**, и не резать, когда
+он просто делает файлы мельче.
+
+**Это планирование, а не предписание процесса.** Метка ревью выбирается по
+факту изменения — тем, кто его видит, — и в тело задачи не пишется: строка
+«делать с меткой medium» это ровно тот второй дом правила выбора, который
+гигиена полей снимает. Шов пользуется меткой как **признаком**, что в задаче
+две разнородные работы; решение о метке остаётся за конвейером.
+
+**Цель наследуется.** Все части несут `goal:` родителя: декомпозиция не меняет
+того, чему работа служит. Если у части цель другая — это признак, что дробили не
+по той границе, либо что часть вообще из другой работы.
+
+## Что делать с родителем
+
+После разделения родитель **не остаётся** третьей висящей строкой:
+
+- части полностью замещают его → `close <slug> --reason "разложена на a, b"`.
+  `REJECTED.md` здесь — не «выкинули», а именно тот след, что переживает запись:
+  через квартал вопрос «куда делась задача X» отвечается строкой со ссылками на
+  наследников, а не археологией git;
+- родитель осмыслен как **возможность**, а не как шаг → это цель, и **строка
+  переезжает**: `edit <slug> --type goal --section <часть роадмапа>` снимает её с
+  `BACKLOG.md` и вставляет в `ROADMAP.md`. Файл в `items/` при этом не двигается —
+  он и есть запись. Части получают `--goal <слаг родителя>`, а закрывать родителя
+  нечем и незачем: он не выкинут, он стал целью.
+
+**Промежуточного зонтика между целью и задачей нет.** Тип `epic` упразднён:
+роль зонтика играет цель, а слишком крупный шаг дробится на шаги помельче под
+той же целью. Если частям нужен общий заголовок — значит у них общая
+возможность, и её надо назвать целью, а не заводить временный тип.
+
+## Когда декомпозиция случается посреди работы
+
+Задача, которая **оказалась крупнее задачи**, распознаётся до того, как под неё
+заведено предложение об изменении: иначе его придётся выбрасывать. Она выходит
+из работы на декомпозицию, а её строка возвращается в беклог с причиной
+(`move … --reason "крупнее задачи"`). Части заводятся сразу под той же целью, и
+**место в очереди им назначает человек**: машина поставит их в конец секции, а
+крупная задача редко распадается на что-то менее срочное, чем была сама.
+
+## Мозговой штурм сырья
+
+Сырьё — запись типа `research`, у которой раздел «Вопрос» пуст: она не проходит
+тест «готова к взятию», потому что неясно, что именно делаем. Штурм проясняет —
+и это **generative-операция, а не applicative**.
+
+Исход штурма и есть заполненный «Вопрос» (тогда разведку можно брать в работу)
+или набор задач с типами, которые из ответа следуют. Третий законный исход —
+`close --reason`.
+
+Applicative-штурм («перечисли задачи, следующие из идеи») выдаёт очевидное:
+перечисляется то, что уже видно в формулировке. Ценное — на уровень выше.
+
+1. **Сперва — формы, а не задачи.** Предложи **три разные постановки** идеи и
+   назови **компромисс каждой**: что она даёт, чем платит, что оставляет за
+   бортом. Если получилась одна постановка — штурм не состоялся, это
+   applicative.
+2. **Вынеси формы пользователю** через `AskUserQuestion` с компромиссами. Рамку
+   выбирает он: это продуктовое решение, не механика.
+3. **Назови цель.** Выбранная форма служит цели — существующей или новой. Идея,
+   для которой цель не находится, скорее всего уезжает в `REJECTED.md`, а не
+   заводится задачей.
+4. **Только выбранную форму** дроби по тесту декомпозиции выше и проставь
+   критерии приёмки: без них наследники останутся идеями под другим именем.
+
+**«Выкинуть» — полноправный исход штурма, а не его неудача.** Проработка, честно
+показавшая, что пользы нет или она несоразмерна цене, — это результат: идея
+уезжает с этой самой причиной, и та причина гасит её повторное появление.
+
+## Доклад
+
+- Идея/задача на входе, выбранная рамка (для штурма), задачи-наследники со
+  слагами, целями и секциями.
+- Судьба родителя: удалён / стал целью / выкинут с причиной.
+- `tasks.py check` после правок.
+- Границы покрытия: какие постановки рассмотрены и какие сознательно отброшены —
+  чтобы штурм не пришлось повторять с нуля.

av-dev/skills/task-track/references/task-chore.md

@@ -0,0 +1,77 @@
+# 🧹 `chore` — обслуживание, наблюдаемое поведение не меняется
+
+Зависимости, сборка, перенос, чистка, оснастка. Отвечает на **«что нужно
+сделать»**, глаголом в неопределённой форме.
+
+Общая форма записи (мета, слаг, строка индекса) — [task-format.md](task-format.md).
+Здесь только то, что у этого типа своё.
+
+## Схема
+
+| | |
+| --- | --- |
+| Заголовок отвечает на | что нужно сделать |
+| Обязательные разделы | `Затрагивает`, `Критерии приёмки` |
+| Допустимые сверх того | `Рамки`, `Вопросы` |
+| Поле места | **Категория** — полка домена беклога |
+| Цель (`goal:<слаг>`) | нет: цель — это возможность, а здесь её не появляется |
+| Индекс | `BACKLOG.md` |
+| Берётся в работу | да |
+
+## Адресат — разработчик, и это законно
+
+Тест готовности спрашивает «что станет наблюдаемо иначе». У `chore` ответ
+адресован **разработчику**, а не пользователю: «перестанет собираться два раза»,
+«уедет последний вызов устаревшего API», «проверки гоняются одной командой».
+Это ответ, а не отговорка.
+
+**У `chore` тест готовности слабее честно, а не молча.** Пока типа не было,
+такие задачи либо не заводились вовсе, либо формулировались как выдуманная
+пользовательская польза — и то и другое хуже, чем сказать прямо, для кого работа.
+
+Отсюда же граница: если после задачи меняется то, что видит пользователь, — это
+не `chore`. Тип, оставшийся от первой формулировки, врёт ровно там, где по нему
+отбирают.
+
+**Обнаружилось это уже в работе — запись переформулируется, а не дорешивается.**
+Исполнитель останавливается, называет тип, которым задача оказалась (`fix` —
+поведение расходится с заявленным, `feature` — снаружи появляется то, чего не
+было), и человек решает: сменить тип и решать процессом того типа — либо
+прекратить. Тип меняет этот скилл, а не исполнитель по ходу: у нового типа своя
+схема разделов, и `ready` проверит её заново.
+
+## Алгоритм
+
+1. **Проверить, что поведение не меняется.** Меняется — это `feature` или `fix`,
+   и у неё другие требования (цель, воспроизведение).
+2. **Назвать, что перестанет мешать** — одной фразой, адресуясь разработчику.
+   «Прибраться в модуле X» — не ответ: непонятно, что изменится.
+3. **Назвать границы** в `Затрагивает`. У обслуживания они часто не в коде:
+   конфиг и его образцы, версия зависимости, команда сборки, файл CI. Границей
+   считается то, у чего есть внешняя сторона и цена изменения.
+4. **Написать критерии приёмки** — 2–5 утверждений с оракулами. У `chore`
+   оракул обычно самый дешёвый из всех типов: команда, которая раньше падала
+   или требовала трёх шагов, теперь отрабатывает одним.
+5. **Проверить, что это не «заодно».** Обслуживание любит склеиваться в пачку
+   («обновить зависимости и переписать сборку и убрать мёртвый код»). Не
+   мерджится порознь — это несколько задач ([split.md](split.md)).
+6. **Цель не проставлять.** `chore` служит работоспособности, а не направлению.
+   Работа по сопровождению проекта при этом видна в роадмапе — секцией
+   `Сопровождение`, но целью не становится.
+
+## Кто такую задачу решает
+
+Решает её конвейер проекта — в плагине `av-dev-code` это скилл `resolve`,
+**сценарий обслуживания**: он не заводит change и не пишет требований, потому что
+у работы, не меняющей поведения, дельта-спек нет по построению. Тип записи там
+только **предлагает** сценарий, а подтверждает его отсутствие дельт: разошлись —
+работа останавливается, и это тот самый случай, когда тип, оставшийся от первой
+формулировки, врёт. Плагина нет — задача решается как проект привык, а этот скилл
+её только заводит и закрывает.
+
+## Что видит машина, а что человек
+
+`ready` смотрит на **наличие непустого** `Затрагивает` и на
+**число** критериев — ровно то же, что у `feature`. Разница между типами здесь не
+в строгости проверки, а в том, **кому адресован ответ** на «что станет
+наблюдаемо иначе», — и это судит человек.

av-dev/skills/task-track/references/task-feature.md

@@ -0,0 +1,65 @@
+# ✨ `feature` — снаружи появляется то, чего не было
+
+Задача, после которой наблюдаемое поведение меняется в сторону новой
+возможности. Отвечает на **«что нужно сделать»** и пишется глаголом в
+неопределённой форме.
+
+Общая форма записи (мета, слаг, строка индекса) — [task-format.md](task-format.md).
+Здесь только то, что у этого типа своё.
+
+## Схема
+
+| | |
+| --- | --- |
+| Заголовок отвечает на | что нужно сделать («Печатать поле одним куском кода») |
+| Обязательные разделы | `Затрагивает`, `Критерии приёмки` |
+| Допустимые сверх того | `Рамки`, `Вопросы` |
+| Поле места | **Категория** — полка домена беклога |
+| Цель (`goal:<слаг>`) | **обязательна** |
+| Индекс | `BACKLOG.md` |
+| Берётся в работу | да |
+
+**Цель обязательна, и это единственный тип, у которого так.** Новая возможность
+и есть содержание цели: подходящей нет — либо она заводится, либо перед тобой не
+`feature`. `ready` без цели откажет.
+
+## Алгоритм
+
+1. **Найти цель или завести её.** Задача без цели, названная функцией, — самый
+   частый способ пронести в беклог работу, которой никто не заказывал.
+2. **Назвать границы** в разделе `Затрагивает`: эндпоинт или команда, таблица и
+   миграция, формат на диске, публичный тип пакета, внешний сервис. Названы
+   **границы, а не замысел**: «переписать хранилище на новый драйвер» — замысел,
+   `таблица points и её миграция` — граница. Проверяется вопросом «это можно
+   назвать до того, как решено *как* делать?».
+3. **Написать критерии приёмки** — 2–5 проверяемых утверждений списком, у
+   каждого назван оракул. Не «работает корректно», а «повторный прогон даёт тот
+   же отпечаток — оракул: команда сверки».
+4. **Сказать, какую строку «Завершения» цели задача двигает.** Одной строкой в
+   теле. Это защита от задачи «отрефакторить X»: она проваливается не потому,
+   что невидима снаружи, а потому, что не находит строки, к которой относится.
+5. **Проверить, что задача одна.** Отвечается всё, но задача не делается одним
+   заходом и не мерджится целиком — это несколько задач под одной целью, дроби
+   сразу ([split.md](split.md)). Промежуточного зонтика между целью и задачей
+   нет.
+6. **Реализация** — дело конвейера проекта, не этого скилла. Закрывается
+   `close <слаг> --implemented`: файл и строка удаляются, суть переезжает в
+   `openspec/specs/` и документацию.
+
+## Что видит машина, а что человек
+
+Схему типа судит `ready` на входе в работу: **наличие непустого** раздела
+`Затрагивает`, **число** критериев (меньше двух — отказ, больше пяти —
+замечание) и цель. Наличие оракула проверяется **эвристикой** — словом «оракул»
+в пункте. `check` этого поимённо не говорит, а считает строкой здоровья
+(`SKILL.md`, «Что механизировано, а что нет»).
+
+Полнота перечня границ машине не видна: границу, которую забыли назвать, она от
+отсутствующей не отличает. Настоящий оракул от слова «оракул» тоже не отличает.
+Поэтому в докладе это называется как есть: «проверено число пунктов и наличие
+границ, годность оракулов и полнота границ — глазами».
+
+**Критерии — пол, но расхождение с ними есть дефект критериев.** Видишь, что
+критерии закрыты, а суть задачи не достигнута — **правь критерии и возвращай
+задачу**, а не держи невидимое сверх-требование: иначе исполнитель никогда не
+знает, закончил ли, и мотивирован занижать критерии заранее.

av-dev/skills/task-track/references/task-fix.md

@@ -0,0 +1,69 @@
+# 🐞 `fix` — поведение расходится с заявленным
+
+Задача о расхождении между тем, что система делает, и тем, что про неё заявлено
+— в спеке, в инварианте `CLAUDE.md`, в критериях закрытой задачи. Отвечает на
+**«что нужно сделать»**, глаголом в неопределённой форме, перед ним допускается
+«не»: «Не отбрасывать молча лишние символы в ходе».
+
+Общая форма записи (мета, слаг, строка индекса) — [task-format.md](task-format.md).
+Здесь только то, что у этого типа своё.
+
+## Схема
+
+| | |
+| --- | --- |
+| Заголовок отвечает на | что нужно сделать |
+| Обязательные разделы | **`Воспроизведение`**, `Затрагивает`, `Критерии приёмки` |
+| Допустимые сверх того | `Рамки`, `Вопросы` |
+| Поле места | **Категория** — полка домена беклога |
+| Цель (`goal:<слаг>`) | необязательна |
+| Индекс | `BACKLOG.md` |
+| Берётся в работу | да |
+
+## `Воспроизведение` — раздел, которого нет у других типов
+
+**Не воспроизводится — это `research`, а не `fix`.** Правило было записано и
+раньше, но проверять его было нечем, и «починки» без единого шага повторения
+уходили в работу наравне с остальными. Раздел делает правило проверяемым: он
+называет, **что сделать, чтобы расхождение проявилось, и что при этом видно
+вместо ожидаемого**.
+
+Пишется двумя частями, обе обязательны по смыслу:
+
+- **шаги или вход** — команда, запрос, файл, последовательность действий;
+- **что видно и что ожидалось** — «ввод `а1б2` ходит в `a1`, а должен быть
+  отвергнут с ошибкой».
+
+Это не критерии приёмки и не дублирует их: воспроизведение описывает **сегодня**,
+критерии — **завтра**. Пропущенное воспроизведение чаще всего означает одно из
+двух: расхождение приняли на слово, или его вообще нет, а есть недовольство
+поведением — и тогда это `feature`, а не `fix`.
+
+## Алгоритм
+
+1. **Воспроизвести.** Не удаётся — это `research`: заведи вопрос «при каких
+   условиях проявляется» и не притворяйся, что чинить есть что.
+2. **Найти, чему поведение противоречит.** Спека, инвариант, критерий закрытой
+   задачи. Не противоречит ничему — это `feature`: поведение никогда и не было
+   заявлено, а тип, оставшийся от первой формулировки, врёт ровно там, где по
+   нему отбирают.
+3. **Записать воспроизведение** — шаги и наблюдаемое против ожидаемого.
+4. **Назвать границы** в `Затрагивает`: починка часто трогает больше, чем
+   кажется по объёму текста, и оценка систематически занижена именно здесь.
+5. **Написать критерии приёмки** — 2–5 утверждений с оракулами. У починки
+   почти всегда есть парный критерий: **прежнее поведение не сломалось**
+   («ввод `а1` принимается по-прежнему»). Без него починка чинит одно и ломает
+   соседнее.
+6. **Цель не выдумывать.** `fix` служит работоспособности, а не направлению.
+   Придуманная цель — то же враньё, от которого спасает тип.
+7. **Записать дефект в журнал** `docs/review.md` с пометкой «проскочил / пойман
+   ревью». Проскочившие — проверочный набор для калибровки конвейера; пойманные с
+   оракулом — лучшая опора для прохода ревью: проектные, воспроизводимые,
+   однажды оказавшиеся правдой.
+
+## Что видит машина, а что человек
+
+`ready` смотрит на **наличие непустого** `Воспроизведения` и
+`Затрагивает` и на **число** критериев. Годность воспроизведения — человеку:
+шаги, по которым ничего не воспроизводится, машина от годных не отличает, и
+делать вид, что проверено больше проверенного, хуже, чем не проверять вовсе.

av-dev/skills/task-track/references/task-format.md

@@ -0,0 +1,405 @@
+# Формат записей и индексов
+
+Заголовок, мета-блок и строку индекса ставит `tasks.py add` — руками их не
+пишут. Этот файл описывает **общую форму** любой записи и то, что проверяет
+`check`; тело дописывает агент.
+
+Чем разделы тела отличаются от типа к типу, какой алгоритм у каждого типа и что
+у него обязательно — **отдельным файлом на тип**:
+
+| Тип | Файл | Одной строкой |
+| --- | --- | --- |
+| 🎯 `goal` | [task-goal.md](task-goal.md) | возможность приложения |
+| ✨ `feature` | [task-feature.md](task-feature.md) | снаружи появляется то, чего не было |
+| 🐞 `fix` | [task-fix.md](task-fix.md) | поведение расходится с заявленным |
+| 🧹 `chore` | [task-chore.md](task-chore.md) | обслуживание, поведение не меняется |
+| 🔬 `research` | [task-research.md](task-research.md) | исход — знание, а не изменение |
+
+## Файл записи
+
+`items/<slug>.md`:
+
+```markdown
+# 🐞 Не отбрасывать молча лишние символы в ходе
+
+- **Тип:** fix
+- **Категория:** Ядро — вернулась из работы: остаток писал нерешённое в журнал
+- **Зачем:** ввод «а1б2» ходит в a1 — игрок не видит, что ошибся, и винит игру
+- **Теги:** goal:merge-robustness
+
+Разбор хода читает первые два символа и молча выбрасывает остаток строки.
+
+## Воспроизведение
+
+Ввести `а1б2` в свой ход: программа ходит в `a1` и ничего не сообщает.
+Ожидалось — отказ с ошибкой разбора.
+
+## Затрагивает
+
+Разбор строки хода; текст ошибки в выводе партии. Формат сохранения партии
+не трогается.
+
+## Критерии приёмки
+
+- ввод «а1б2» отвергается с ошибкой — оракул: тест разбора
+- ввод «а1» принимается по-прежнему — оракул: тест разбора
+
+## Рамки
+
+Схема не трогается; данные только читаются; перезапуск допустим.
+
+Связано: решение о канонической форме содержимого.
+```
+
+- **Заголовок H1** — он же заголовок строки в индексе, дословно. Начинается
+  **эмодзи типа**, и она **производна**: её ставит `add` и чинит `check --fix`
+  по полю меты. Второго дома у типа нет — эмодзи это его отображение, как
+  строка индекса это отображение файла.
+- **Форма заголовка — по типу.** Цель отвечает на «что приложение будет уметь»;
+  `feature`, `fix` и `chore` — на «что нужно сделать», глаголом в неопределённой
+  форме, перед ним допускается «не»; `research` называет предмет разведки и
+  формы действия **не несёт намеренно**. Почему так — SKILL.md, «Как написана
+  задача». `check` считает заголовки не в форме действия и печатает число в
+  здоровье; годность формулировки смотрит агент `task-form`.
+- **Мета-блок** — список сразу после заголовка, **поле на строку**. Обязательны
+  **тип** и **место**, причина после тире желательна (именно она объясняет,
+  почему задача здесь оказалась — в том числе «вернулась из работы: …»), «зачем» и
+  теги необязательны. Нераспознанные поля сохраняются: скрипт правит свои и не
+  трогает чужие.
+- **Тип — первым полем.** Он решает, что у записи вообще может быть: какие
+  разделы обязательны, нужна ли цель, берётся ли она в работу, — и читается
+  раньше всего остального. Словарь **закрыт**: `goal` | `feature` | `fix` |
+  `chore` | `research`. Не подходит ни один — это сигнал, что в записи их два и
+  её надо разделить.
+- **«Зачем» отвечает на «зачем нужна эта задача»** — состояние, остаток, боль.
+  Не пересказ задачи: пересказ уже есть по ссылке. Живёт здесь, а не только в
+  индексе: строка индекса его повторяет и производна от него, `check` сверяет,
+  `check --fix` восстанавливает пропавшую строку **вместе с ним**. Пока поле
+  лежало только в индексе, штатная починка дрейфа теряла его молча и
+  навсегда — а это единственное, по чему задачу выбирают, не открывая.
+- **Тело** — одна фраза «что станет наблюдаемо иначе», дальше разделы по схеме
+  типа. Пишется на языке документации проекта: предметно, без англицизмов, у
+  которых есть русское слово, и без терминов, которых нет ни в паспорте, ни в
+  архитектуре, ни в конвенциях (правило и его причина — в SKILL.md, раздел «Как
+  написана задача»).
+
+Тело — не план реализации и не спецификация: принятое и реализованное переезжает
+в документацию проекта, а файл задачи удаляется.
+
+### Поле места: «Категория» и «Секция»
+
+Поле называет, **где числится строка**, и имя у него **зависит от типа**:
+
+| Тип | Поле | Значения | Что это |
+| --- | --- | --- | --- |
+| `goal` | **Секция** | `Запланировано`, `Направления`, `Сопровождение` | часть роадмапа: состояние очереди |
+| прочие | **Категория** | секции беклога проекта (`Ядро`, `Инфра`, …) | полка домена, на которой задача лежит |
+
+Разные имена потому, что это **разные вещи**. У задачи это полка: куда её
+положили и куда вернут, если она уйдёт в работу и вернётся. У цели оно называет
+не полку, а место в очереди работ. Одно имя на два смысла их и смешивало; `check` называет
+несовпадение дрейфом, `check --fix` переименовывает.
+
+Имя самого места принадлежит **заголовку индекса** — файл на него лишь
+ссылается, и принадлежность сверяется по нижнему регистру.
+
+### Прежние формы, которые читаются, но не пишутся
+
+Всё это `check` называет дрейфом, а `check --fix` переписывает:
+
+| Было | Стало |
+| --- | --- |
+| префикс `[goal]` / `[idea]` в H1 | поле **Тип** + эмодзи в H1; `[idea]` → `research` |
+| тег `kind:<род>` | поле **Тип** (род работы стал типом) |
+| поле **Секция** у задачи | поле **Категория** |
+| поле **Хук** | поле **Зачем** |
+| мета одной строкой через `·` | мета списком, поле на строку |
+
+Единственное, чего `--fix` не делает сам, — **проставить тип записи, у которой
+его неоткуда взять**: `feature` от `chore` машина не отличает, и подставленное
+наугад значение врало бы ровно там, где по нему принимают решение. Такие записи
+он называет поимённо пометкой `НЕОДНОЗНАЧНО`.
+
+### Затрагивает
+
+Перечень **границ**, которых изменение касается. Границей считается то, у чего
+есть внешняя сторона и цена изменения:
+
+- эндпоинт, команда, форма ответа, код ответа;
+- таблица, поле, миграция, формат на диске, формат сообщения в очереди;
+- публичный тип или функция пакета, конфиг и его образцы;
+- внешний сервис или библиотека, чьё поведение становится нужным.
+
+Ничего из этого не трогается — так и пишется: «границ не трогает, изменение
+внутри одного узла». Это ответ, а не пустой раздел.
+
+**Границы, а не замысел.** «Переписать хранилище на новый драйвер» — замысел;
+`таблица points и её миграция`, `эндпоинт POST /ingest` — границы. Разница
+проверяется вопросом «это можно назвать до того, как решено *как* делать?»: если
+нет, строка описывает реализацию, и её место в предложении об изменении.
+
+**Свойства репозитория сюда не пишутся** — по той же причине, что и в рамки:
+имя таблицы стабильно, номер последней миграции протухает молча. Пишется
+`таблица points и её миграция`, а не `миграция 0042`.
+
+**Что из этого механизировано.** `ready` смотрит только на
+**наличие непустого раздела**. Полнота перечня машине не видна: границу, которую
+забыли назвать, она от отсутствующей не отличает. Раздела нет — отказ во взятии:
+оценивать нечем.
+
+**У `goal` и `research` раздела нет** — у первой границы называют её задачи, у
+второй они становятся известны, когда из разведки родятся задачи.
+
+### Критерии приёмки
+
+2–5 проверяемых утверждений **списком** `- …`, **у каждого назван оракул**. Не
+«работает корректно», а «повторный прогон даёт тот же отпечаток — оракул:
+команда сверки». Это не второе определение сделанного, а проектная
+конкретизация вопроса «по чему видно, что закончено» из теста готовности ниже:
+там сказано «признак завершённости», здесь — «признак плюс чем проверяется».
+
+**Что из этого механизировано.** `ready` считает пункты: меньше
+двух — отказ («— работает» одной строкой больше не проходит), больше пяти —
+замечание, обычно это признак, что задача крупнее задачи. Наличие оракула
+проверяется **эвристикой** — словом «оракул» в пункте, — и потому даёт только
+замечание: настоящий оракул от слова «оракул» машина не отличает, и делать вид,
+что проверено больше проверенного, хуже, чем не проверять вовсе.
+
+**У `research` критериев нет** — её приёмка это записанный ответ, и описывается
+она разделами «Вопрос» и «Куда ляжет ответ». **У `goal` их заменяет
+«Завершение».**
+
+**Критерии — пол, но расхождение с ними есть дефект критериев.** Если приёмщик
+видит, что критерии закрыты, а суть задачи не достигнута, он **правит критерии и
+возвращает задачу исполнителю**, а не держит невидимое сверх-требование. Иначе
+исполнитель никогда не знает, закончил ли, и мотивирован занижать критерии
+заранее.
+
+### Рамки
+
+Одна строка: чего касаться нельзя, что перезапускается, что считается
+необратимым, трогается ли схема данных. Раздел **допустим у любого типа задачи и
+ни у одного не обязателен**. **Свойства репозитория сюда не пишутся** — номер
+последней миграции, версия зависимости, хеш: в лежалой задаче они протухают
+молча и становятся ложной рамкой. Снимок берётся при постановке, а не при
+заведении.
+
+### Вопросы
+
+Неразобранное решение человека живёт разделом `## Вопросы` **плюс тегом
+`question`**. Раздел без тега или тег без раздела — дрейф, `check` о нём скажет.
+
+Раздел `Вопросы` (о решении человека) и раздел `Вопрос` у `research` (предмет
+разведки) — **разные вещи и разные слова**: первый блокирует взятие, второй его
+разрешает.
+
+**Судит факт, а не метка.** Отказ во взятии даёт **непустой раздел «Вопросы»**,
+независимо от того, стоит ли тег: иначе забывший тег проходил бы, а поставивший
+спотыкался — стимул ровно обратный записанному правилу. Тег производен: он нужен
+отбору снаружи файла (`list --questions`, `list --tag question`), и его
+отсутствие при непустом разделе — замечание, а не лазейка. Тег без раздела тоже
+отказ, но с другим советом: либо вопрос записан не туда, либо тег пора снять.
+
+**Ответ на вопрос — три правки, и первая обязательна.** Раздел «Вопросы»
+опустошается: ответ переезжает в тело решением, а не остаётся вопросом рядом с
+ответом. Затем снимается тег (`edit <slug> --rm-tag question`) и переписывается
+«зачем»: «Решено: …» на вопрос «зачем нужна эта задача» уже не отвечает.
+
+**Порядок именно такой, потому что судит раздел, а не тег.** `ready`
+смотрит в непустой раздел и откажет даже при снятом теге, а `check`
+на снятый тег при непустом разделе посоветует тег вернуть. Снять тег, не
+опустошив раздел, — значит закольцевать себя между двумя советами.
+
+## Файл цели
+
+Форма та же, разделы и алгоритм — [task-goal.md](task-goal.md).
+
+```markdown
+# 🎯 Исход слияния не зависит от порядка доставки
+
+- **Тип:** goal
+- **Секция:** Направления
+- **Теги:** decomposed
+
+Ради чего: точки из разных доставок сходятся в один часовой объект, и сегодня
+исход столкновения зависит от порядка доставки, а не от содержания.
+
+## Завершение
+
+- повторная доставка тех же точек в другом порядке даёт то же состояние;
+- накопительная метрика за сутки не уменьшается после повторной доставки;
+- в логе видно, какая из двух точек выиграла и почему.
+```
+
+- **Задачи цели здесь не перечисляются.** Перечень даёт
+  `tasks.py list --goal <слаг>`; хранимый список стал бы третьим индексом и
+  поехал бы на первой же закрытой задаче.
+- **Тег `decomposed`** отличает «цель ещё не разобрана» от «все её задачи
+  закрыты» — два состояния, у которых снаружи один и тот же признак: задач нет.
+  Пометка именно **тегом**, а не строкой в теле: только так она проверяется.
+  `check` напоминает о нём у цели без задач замечанием — неразобранная цель
+  законна и зелёного прогона не ломает; `check --fix` сам ставит его цели, у
+  которой задачи есть, а цель с тегом и без задач — прямое приглашение закрыть.
+- Цель живёт в `ROADMAP.md` и **никогда** — в `BACKLOG.md`.
+- **Достигнутая цель не исчезает.** `close <слаг> --implemented` удаляет файл и
+  переносит строку в секцию `Готово` с датой:
+  `- 2026-08-04 \`merge-order\` — Исход слияния не зависит от порядка доставки. …`
+  Ссылки на файл в ней нет — файл удалён, а битая ссылка это ошибка `check`.
+  Поведение живёт в спеках проекта; роадмап отвечает, **когда и в каком порядке**
+  оно появилось.
+
+## Слаг
+
+Латиница и цифры, kebab-case, без ведущих, хвостовых и двойных дефисов
+(`foo-bar`, не `-foo`, `a--b`). Именуется **по сути, а не по текущей
+формулировке**: заголовок будет переписан при переоценке, а слаг стоит в ссылках
+из других задач, коммитов и черновиков. **Транслита не заводим** —
+`tie-break-equal-completeness`, а не `taj-brejk-pri-ravnoj-polnote`: транслит
+нечитаем для того, кто ищет по смыслу, и не сокращается.
+
+Переименование слага — не правка, а перенос ссылок: делается одним атомарным
+проходом по всем местам, где слаг упомянут, иначе останутся битые ссылки,
+которых никто не проверяет.
+
+## Индексы
+
+Строка везде одной формы:
+
+```markdown
+- [🐞 Заголовок дословно](items/slug.md) — зачем
+```
+
+«Зачем» отвечает на «зачем нужна эта задача» одним предложением: состояние,
+остаток, боль. Пересказ первого абзаца бесполезен — он уже есть по ссылке.
+Эмодзи внутри квадратных скобок не украшение: заголовок копируется **дословно**,
+и тип виден там, где решают «брать или не брать».
+
+| Файл | Что отвечает | Секции |
+| --- | --- | --- |
+| `ROADMAP.md` | что приложение уже умеет и чего ещё не умеет | канонические и в этом порядке: `Запланировано`, `Направления`, `Сопровождение`, `Готово` (англ. `Planned`, `Directions`, `Operations`, `Done`) |
+| `BACKLOG.md` | что **можно взять** — только задачи, **в порядке очереди** | категории проекта (по умолчанию Ядро/Инфра) |
+| `REJECTED.md` | что ушло без реализации и почему | — |
+
+Секции — **единственные заголовки `##` в индексе**: любой другой `##` в
+преамбуле проверка сочтёт секцией.
+
+**Порядок строк внутри секции беклога значим: это очередь.** Первая строка — то,
+что делают следующим; назначает порядок человек на груминге, и двигают его
+`move --after` и `move --first`. Одно место из очереди изъято и **производно от
+типа и заполненности**: **сырьё** (`research` без раздела «Вопрос») стоит в конце
+своей секции, потому что его не берут, и между берущимся оно каждый раз требует
+открыть файл, чтобы это понять. Проверяет `check`, переставляет `check --fix`,
+и человек этот порядок не назначает — иначе он был бы приоритетом, которого
+здесь нет.
+
+**Секции «блокеры» среди них нет.** Блокер — состояние, а не полка: он живёт до
+ответа человека, а следы остаются вопросами в файлах задач.
+Постоянно пустая секция со старой семантикой «разбираются пачками» противоречила
+бы правилу «эскалируем немедленно», поэтому `init` её не заводит, а `check`
+говорит о ней в чужом беклоге. Переезжаешь с такой секцией — удали её. В секции
+**`Запланировано`** очередь значима и обосновывается прозой; двигают строку
+`move <slug> --section Запланировано --after <другой>`. В секции **`Готово`**
+строки не той формы, что у прочих индексов: дата, слаг, заголовок — как в
+`REJECTED.md`, и по той же причине (файла уже нет, ссылаться некуда).
+
+**Секции роадмапа закреплены** — состав, полнота, единство языка и **порядок**
+проверяются `check`; категории беклога проект называет сам. Почему так —
+SKILL.md. Порядок закреплён потому, что `Готово` копится: стоя первым,
+достигнутое отодвигает за экран то, ради чего роадмап открывают чаще всего.
+
+**Заголовок секции пишется с прописной и отбивается пустой строкой с обеих
+сторон** — во всех индексах, включая категории беклога, имена которых выбирает
+проект. Написание канонических секций и отбивку правит `check --fix`; он же
+сводит написание места в мете файла с заголовком индекса.
+
+Индексы **производны**: расходятся с файлом — правим индексы (`check --fix`).
+Строку руками не пишут.
+
+Отсюда же ответ на «а если оборвётся посередине». Мутация сперва проверяет всё
+и складывает правки, и только потом пишет: сначала все временные файлы, потом
+переименования подряд. Полной транзакции на несколько файлов файловая система не
+даёт, но окно сжато до цепочки переименований, а **всё, что в нём может
+разъехаться, — производное**: файлы целы, индексы восстанавливает `check --fix`.
+Поэтому отказ на второй задаче из пяти не оставляет первую переписанной при
+нетронутых индексах.
+
+## `REJECTED.md`
+
+Туда уходит задача, покинувшая беклог **без реализации**. Строку пишет
+`tasks.py close --reason`, а `check` следит за форматом:
+
+```markdown
+- 2026-07-23 `versii-kachestvo-repaki` — Версии и качество одного тайтла.
+  Причина: калибровка болей — не боль, ни разу не возникло за полгода.
+  Была секция: Инфра.
+```
+
+Реализованные сюда не попадают: у них остаётся коммит и документация. У
+выкинутой не остаётся ничего — и через квартал она возвращается тем же текстом.
+Это первое место, куда смотрит дедупликация при заведении.
+
+Запись не запрещает завести задачу заново: изменился контекст — заводим и
+ссылаемся на строку, объясняя, что изменилось.
+
+## Теги
+
+Разметка сверх типа. Тип полем, потому что он один и обязателен; теги — потому
+что их много и `list --tag` уже умеет отбирать по ним порцию разбора.
+
+- `goal:<слаг>` — цель, которой служит задача. Обязателен **у `feature`**:
+  новая возможность и есть содержание цели. У `fix`, `chore` и `research` его
+  может не быть — они служат работоспособности, а не направлению.
+- `question` — в файле есть неразобранный раздел «Вопросы».
+- `decomposed` — на цели: разложена на задачи (см. «Файл цели»).
+
+Тега `kind:<род>` больше нет: род работы стал типом. Оставшийся в файле `check`
+называет дрейфом, а `check --fix` снимает, перенеся значение в поле «Тип».
+
+Отбор — `list --tag a,b`: перечисленные через запятую теги требуются **все
+сразу** (это И, не ИЛИ). Тег, которого нет ни у одной задачи, `list` называет
+вслух: молчаливый ноль читается как «таких задач нет», а чаще это опечатка.
+
+Свои теги проект заводит свободно (партия ревью `review-ГГГГ-ММ-ДД`, тема,
+источник) — словарь не фиксирован. В индексы теги не выносим: индексы
+производны, отбор делает `list --tag`, а не глаза.
+
+## Тест «готова к взятию»
+
+Задача готова, если из файла отвечаются четыре вопроса. Первый и четвёртый —
+общие, второй и третий у каждого типа свои и перечислены в его файле.
+
+1. **Что станет наблюдаемо иначе**, когда она сделана — снаружи: пользователю,
+   владельцу сервиса или разработчику. «Отрефакторить X» — не ответ; «перестанет
+   ломаться Y при Z» — ответ. **У `chore` адресат — разработчик, и это
+   законно**: «уедет последний вызов устаревшего API» — ответ, а не отговорка.
+   Тип объявлен как раз затем, чтобы такие задачи не выдумывали себе
+   пользовательскую пользу.
+2. **Что известно про сегодня** — то, что тип требует знать до работы:
+   у `fix` это `Воспроизведение`, у `research` — `Вопрос`, у `feature` и
+   `chore` — `Затрагивает`.
+3. **По чему видно, что закончено** — критерии приёмки с оракулами;
+   у `research` вместо них `Куда ляжет ответ`.
+4. **Какую часть «Завершения» своей цели она двигает** — у задачи с целью.
+   Строкой: «двигает пункт 2 «Завершения» — накопительная метрика перестаёт
+   уменьшаться». Это и есть защита от задачи «отрефакторить X»: она проваливает
+   тест не потому, что невидима снаружи, а потому, что не находит строки, к
+   которой относится. Заодно видно обратное — достаточен ли набор задач для
+   цели: строка «Завершения», к которой не относится ни одна задача, это
+   незакрытая часть возможности.
+
+   **У задачи без цели** (`fix`, `chore`, `research`) вопрос не задаётся: они
+   служат работоспособности, а не направлению.
+
+Не отвечается первый, второй или третий вопрос → это ещё не задача, а **сырьё**:
+тип `research` без раздела «Вопрос», место — конец секции, работа над ним —
+штурм. Не отвечается четвёртый у `feature` → либо цель есть и не проставлена,
+либо это не новая возможность.
+
+Отвечается всё, но задача не делается одним заходом и не мерджится целиком →
+это **несколько задач под одной целью**, дроби сразу. Промежуточного зонтика
+между целью и задачей нет: тип `[epic]` упразднён, потому что зонтиком стала
+сама цель.
+
+Тест применяется при заведении и при переоценке. К старым задачам, которых
+операция не касается, задним числом не применяется — беклог не переоформляют
+«заодно».

av-dev/skills/task-track/references/task-goal.md

@@ -0,0 +1,93 @@
+# 🎯 `goal` — возможность приложения
+
+Цель отвечает на **«что приложение будет уметь»**. Не область работ и не имя
+подсистемы: не «Работа со слиянием», а «Исход слияния не зависит от порядка
+доставки». Свойство поведения — тоже возможность.
+
+Общая форма записи (мета, слаг, строка индекса) — [task-format.md](task-format.md).
+Здесь только то, что у этого типа своё.
+
+## Схема
+
+| | |
+| --- | --- |
+| Заголовок отвечает на | что приложение будет уметь |
+| Обязательные разделы | `Завершение` |
+| Допустимые сверх того | — |
+| Поле места | **Секция** — часть роадмапа |
+| Цель (`goal:<слаг>`) | запрещена: цель и есть цель |
+| Индекс | `ROADMAP.md`, и никогда `BACKLOG.md` |
+| Берётся в работу | нет — берутся её задачи |
+
+Поле места у цели называется **«Секция»**, а не «Категория», и это не разнобой:
+у задачи оно называет полку домена, на которой она лежит, а у цели
+— часть роадмапа, то есть состояние очереди. Одно имя на два смысла их и
+смешивало.
+
+## «Завершение» — списком, а не абзацем
+
+Это признаки того, что приложение **уже умеет**, и на строки этого раздела
+ссылаются задачи цели: «двигает пункт 2 «Завершения» — накопительная метрика
+перестаёт уменьшаться». Абзацем такая ссылка не берётся, поэтому список.
+
+Отсюда же читается обратное и более полезное: **строка «Завершения», к которой
+не относится ни одна задача, — незакрытая часть возможности**. Достаточность
+набора задач видна из самой цели, а не из чьей-то памяти.
+
+## Алгоритм
+
+1. **Проверить, что это возможность, а не работа.** Работа, которой держат
+   проект, на вопрос «что приложение будет уметь» не отвечает; состав перечислен
+   [в словаре сопровождения](operations.md). Ей отведена секция
+   `Сопровождение` — там она видна в том же
+   экране и не читается как обещание продукта. Граница проходит по тому,
+   **кто наблюдает**:
+   «приложение сообщает о своём состоянии» — возможность, «дежурный видит
+   состояние на одном экране» — сопровождение.
+2. **Выбрать секцию.** Очередь значима и обоснована прозой — `Запланировано`;
+   тянется долго и очереди не имеет — `Направления`; про то, чем держат проект,
+   — `Сопровождение`. В `Готово` кладёт сам `close`.
+3. **Написать «Завершение»** — 2–5 наблюдаемых признаков списком. Пишутся до
+   декомпозиции: иначе задачи придумают себе цель задним числом.
+4. **Разложить на задачи** и проставить им `goal:<слаг>`. Перечень задач в теле
+   цели **не хранится** — он был бы третьим индексом и поехал бы на первой же
+   закрытой задаче; выводит `tasks.py list --goal <слаг>`.
+5. **Пометить `decomposed`.** Тег отличает «ещё не разобрана» от «все задачи
+   закрыты» — два состояния с одним внешним признаком. `check --fix` ставит его
+   сам цели, у которой задачи есть.
+6. **Закрыть достигнутой** — `close <слаг> --implemented`, когда не осталось
+   открытых задач. Файл удаляется, строка с датой переезжает в `Готово`. Скрипт
+   откажет, если задачи ещё живы.
+
+## Отменённая цель — сперва задачи, потом цель
+
+Замысел бывает неверен, и цель отменяют, не достигнув. Порядок обратный
+завершению и держится тем же запретом: цель, закрытая поверх живых задач,
+оставила бы их сиротами, и `close` этого не даст.
+
+1. **Разобрать её задачи поштучно.** Задача, теряющая смысл вместе с целью, —
+   `close <slug> --reason "<почему>"`; задача, переживающая цель, — `edit <slug>
+   --goal <другая>`. **Причина обязательна и пишется своя каждой:** «цель
+   отменена» это не причина, а пересказ команды, и в `REJECTED.md` от него нет
+   пользы через квартал.
+2. **Закрыть саму цель** — `close <слаг> --reason "<почему замысел отменён>"`.
+   Файл удаляется, строка с причиной и датой уходит в `REJECTED.md`. В `Готово`
+   не попадает: `Готово` отвечает «что приложение умеет», а отменённая цель не
+   умеет ничего.
+
+**Место этому — груминг, а не отдельный заход.** Отмена цели значит
+разбор всех её задач, а разбор задач и есть шаг 3 груминга
+(скилл `groom`, «что перестало быть важным»). Отменять на ходу,
+между делом, — верный способ закрыть скопом то, что стоило перевесить.
+
+## Что видит машина, а что человек
+
+`check` считает цели, различает разобранные и пустые, ставит `decomposed`,
+запрещает закрыть цель с живыми задачами и держит `Секцию` в согласии с
+заголовком роадмапа. **Годность формулировки — не машине**: «возможность это или
+область работ» решает [агент вычитки](../SKILL.md#вычитка-два-прохода-а-не-один).
+
+Достигнутая цель **не исчезает**: «что приложение умеет» — половина вопроса, ради
+которого роадмап открывают. Вторым домом поведения роадмап при этом не
+становится: нормативное поведение живёт в `openspec/specs/`, роадмап отвечает,
+**когда и в каком порядке** оно появилось.

av-dev/skills/task-track/references/task-research.md

@@ -0,0 +1,87 @@
+# 🔬 `research` — исход работы знание, а не изменение системы
+
+Ответ на вопрос, замер, разведка, проработка сырой мысли. Приёмка — **записанный
+ответ**, а не изменённый код.
+
+Общая форма записи (мета, слаг, строка индекса) — [task-format.md](task-format.md).
+Здесь только то, что у этого типа своё.
+
+## Схема
+
+| | |
+| --- | --- |
+| Заголовок отвечает на | о чём разведка (предмет, а не действие) |
+| Обязательные разделы | `Вопрос`, `Куда ляжет ответ` |
+| Допустимые сверх того | `Рамки`, `Вопросы` |
+| Поле места | **Категория** — полка домена беклога |
+| Цель (`goal:<слаг>`) | нет |
+| Индекс | `BACKLOG.md` |
+| Берётся в работу | да — **но только с заполненным «Вопросом»** |
+
+**Критериев приёмки у `research` нет, и это не поблажка.** Критерии в форме
+«оракул: тест» разведке натянуты: проверять нечего, пока ответа нет. Её приёмка
+описывается раздельно — вопрос, на который отвечаем, и место, куда ляжет ответ.
+
+**Заголовок формы действия не несёт намеренно.** Что делать, ещё неизвестно, и
+заголовок-действие обещал бы решённость, которой нет. «Подсказка следующего
+хода», а не «Сделать подсказку следующего хода».
+
+## Этот тип вобрал прежний `[idea]`
+
+Тип `idea` упразднён. Он значил не род работы, а **состояние незаполненности** —
+«первый, второй или третий вопрос теста готовности не отвечается», — а состояние
+типом быть не может: оно меняется по мере того, как запись дописывают, а тип
+меняют командой.
+
+Теперь это состояние называется честно: **`research` без раздела «Вопрос» — это
+сырьё**.
+
+| | сырьё | разведка |
+| --- | --- | --- |
+| Раздел `Вопрос` | пуст или отсутствует | заполнен |
+| `ready` | отказ | берёт |
+| Место в секции беклога | **конец**, `check --fix` сносит туда сам | среди прочих |
+| `tasks.py list --raw` | показывает | нет |
+
+Порядок строк в беклоге назначает человек — это приоритет (правило 4 скилла).
+Место сырья **из него изъято**: оно производно от типа и заполненности, а не от
+чьего-то решения, и потому его проверяет и чинит машина. Приоритетом оно не
+становится: сырьё не берут вовсе, и место в конце говорит именно это.
+
+Сырьём заводится и **сырая функция**: «Подсказка следующего хода» — ещё не
+`feature`, потому что неизвестно, что именно делать. Работа над ней — думание, и
+её исход — либо задачи, либо отказ.
+
+## Алгоритм
+
+1. **Записать вопрос одной фразой.** Не тему, а вопрос: не «Разобраться с
+   выводом в терминалах», а «Какими символами рамки печатаются одинаково в
+   Терминале, iTerm и `tmux`». Вопроса ещё нет — запись заводится сырьём и
+   лежит в конце секции, пока вопрос не появится.
+2. **Назвать, куда ляжет ответ**: `docs/research/<slug>.md`, ADR, тело этой
+   задачи. Место называется **заранее**, иначе ответ остаётся в переписке, а
+   через квартал разведку заказывают заново.
+3. **Ограничить рамками**, если разведка может утечь: сколько времени, какие
+   источники, что заведомо вне.
+4. **Провести разведку** и **записать ответ по названному адресу**. Числа — с
+   провенансом: с командой или условиями, которыми получены. Число без источника
+   проход ревью обязан читать как условие, а не как замер. Проводит её конвейер
+   проекта — в плагине `av-dev-code` это скилл `resolve`, сценарий разведки;
+   плагина нет — разведка ведётся как проект привык, а этот скилл её только
+   заводит и закрывает.
+5. **Разложить исход на задачи** — если он их родил. Разведка кончается одним из
+   трёх: заведены задачи, записано знание, отказ. **Отказ — полноправный исход**:
+   «проверили, не проблема» экономит работу.
+6. **Закрыть** — `close <слаг> --implemented`, когда ответ записан. Файл
+   удаляется: запись ответа и есть след, второго не нужно. Ушла без ответа —
+   `close --reason`, и строка уезжает в `REJECTED.md`.
+
+## Что видит машина, а что человек
+
+`ready` смотрит на **наличие непустых** разделов `Вопрос` и
+`Куда ляжет ответ`; `check` считает сырьё отдельной строкой здоровья и держит
+его в конце секции. Годность вопроса — человеку: «вопрос это или тема» машина не различает,
+и `check` о годности молчит намеренно.
+
+Штурм сырья, дробление исхода на задачи и тест «части мерджатся порознь» —
+[split.md](split.md).