учёт: шапка REMAINING врала про восемь тем, добавлен снос проектных копий

Шапка и пункт про push стояли на 11 коммитах и восьми темах — стало 17 и
двенадцать. Предел «копия правила в шаблонах» теперь говорит, что расхождение
ловит copies.py, а на человеке осталось пометить копию и завести запись в
журнал версий.

В план healthlog дописан снос девяти проектных агентов и двух скиллов: они
прошлого поколения и ссылаются на docs/conventions.md, docs/local-research.md
и docs/review-journal.md — на файлы, которых после переезда не будет.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

.claude-plugin/marketplace.json

@@ -6,14 +6,24 @@
   },
   "plugins": [
     {
-      "name": "av-dev-backlog",
+      "name": "av-dev-pm",
-      "source": "./av-dev-backlog",
+      "source": "./av-dev-pm",
-      "description": "Ведение беклога задач как каталога markdown-файлов: заведение из диалога, разбор находок ревью, груминг, приоритизация, декомпозиция, штурм идей."
+      "description": "Управление продуктом: канон документов проекта, задачи и цели вместо приоритетов, спринт под одну цель с заморозкой набора, старт проекта интервью по брифу и приведение существующего к канону. Ничего не выполняет сам и никакого пайплайна не требует: задача выполняется чем угодно, а канон описывает документы, из которых конвейер ревью берёт проектную конкретику."
+    },
+    {
+      "name": "av-dev-pipeline",
+      "source": "./av-dev-pipeline",
+      "description": "Проведение задачи через цикл SDD и конвейер ревью с обязательным триажем, плюс прогон нескольких задач разом. Требует OpenSpec. Задача принимается и обычным текстом; плагин av-dev-pm опционален — он даёт документы канона для проходов ревью и учёт задач, без него прогон деградирует поразрядно и говорит об этом."
     },
     {
       "name": "av-dev-git",
       "source": "./av-dev-git",
       "description": "Git-обвязка для личных проектов. Скилл commit — сообщения коммитов в личном стиле (русский, scope-префикс, средняя детализация, без co-authored)."
+    },
+    {
+      "name": "av-dev-backlog",
+      "source": "./av-dev-backlog",
+      "description": "УСТАРЕЛ, заменён плагином av-dev-pm. Старый формат беклога: один каталог задач с индексом README и приоритетами секциями. Оставлен до перевода последнего проекта; новые проекты не подключают."
     }
   ]
 }

.gitignore

@@ -1,2 +1,4 @@
-__pycache__/
 *.pyc
+__pycache__/
+.venv/
+.ruff_cache/

DECISIONS.md

@@ -0,0 +1,912 @@
+# Решения по устройству процесса
+
+Журнал согласований: что решено, почему и что из этого следует. Пишется по ходу
+разбора тем, одна тема — один раздел. Причина обязательна: через месяц она
+забывается раньше факта.
+
+Незакрытые остатки прошлого захода — [REMAINING.md](REMAINING.md).
+
+## Требования, зафиксированные по ходу
+
+Не решения — вход, который обязан быть удовлетворён и разбирается в названной
+теме.
+
+**Т1. Адаптация и проверка проекта под канон — обязательный скилл.** Нужно уметь
+прийти в **любой** старый проект и перевести его на текущие рельсы. Канон при
+этом сам будет меняться, поэтому уже приведённые проекты тоже должны повышаться
+до новых версий. *Разбирается в теме 5 (старт и жизненный цикл проекта).*
+
+Следствия, которые из этого уже видны:
+
+- **У канона обязана быть версия, а у проекта — отметка, под какую он
+  приведён.** Иначе «соответствует канону» не имеет определённого ответа:
+  сравнение идёт с тем, что модель помнит сейчас, а это и есть дрейф.
+- **Журнал изменений канона — как миграции.** Каждое повышение версии несёт
+  запись «что добавилось, что переехало, что удалено, что сделать проекту». Без
+  него адаптация переизобретается на каждом проекте.
+- **Отметка версии машиночитаема.** `.docs.json` отвергнут как *указатель
+  путей* (решение F), но отметка версии — другое: её читает скрипт, и разбирать
+  прозу `CLAUDE.md` для этого не нужно. Прецедент — `.tasks.json`.
+- **Операций три:** `check` (соответствие текущему канону), `adopt` (перевод
+  чужой раскладки), `upgrade` (повышение с версии N до M по журналу). Первая и
+  третья — одно сравнение с разными исходами.
+- **Механизируемое и суждение не смешивать.** Скрипт проверяет пути, лишние
+  файлы, битые ссылки, версию. Агент судит о смысловых дублях (`docs/specs/
+  recognition.md` против capability `recognition`) и об оставшемся поведении в
+  `architecture.md`. Скрипт, отчитавшийся «канон соблюдён» на проекте с тремя
+  лишними файлами, хуже отсутствующего.
+- **Границы плагинов:** `docs/tasks/` — часть канона документов, но владеет им
+  `av-dev-tasks` со своим `tasks.py adopt`. Два плагина сходятся на одном
+  каталоге. *Тема 7.*
+
+## 1. Статус OpenSpec (2026-08-03)
+
+### Что было
+
+OpenSpec несёт оба проекта: healthlog — 5 capability, 3530 строк спек, 9
+архивных change за две недели; jellybit — 11 capability, 3895 строк, 43 архивных
+change. При этом в трёх местах плагина написана ветка «проект без OpenSpec»
+(`task-pipeline` предпосылки, `review-pipeline` предпосылки, `task-batch`
+предпосылки) — и **не исполнялась ни разу**.
+
+Проектные факты живут в пяти домах: `CLAUDE.md`, `docs/architecture.md`,
+`openspec/specs/`, `openspec/config.yaml` → `context`, и планируется шестой —
+`docs/review-brief.md`.
+
+Расхождение измерено: у healthlog раздел «Хранилище» в `docs/architecture.md` —
+950 строк (377–1328) против `openspec/specs/storage/spec.md` на 1337 строк. Два
+описания одного поведения, никем не сверяемые. У jellybit того же нет:
+`docs/specs/architecture.md` — 300 строк обзора, детали в 11 спеках. **Проект с
+43 изменениями держит архитектуру втрое короче проекта с 9.**
+
+### Решено
+
+**A. OpenSpec — жёсткая предпосылка `av-dev-pipeline`.** Ветки деградации
+удаляются, вместо них объявленная зависимость и проверка на старте. Зависимость
+на уровне **плагина, а не процесса**: `av-dev-tasks`, `av-dev-git` и будущий
+плагин документов от OpenSpec не зависят и работают на python/ansible-проектах.
+
+*Причина:* непроверенная ветка деградации хуже честной строки «требуется
+OpenSpec» — она даёт ложную уверенность, что проект без спек поедет.
+
+**B. Нормативный дом поведения — `openspec/specs/`.** `architecture.md`
+переопределяется как **обзор**: принципы, компоненты со ссылками на capability,
+внешние форматы данных, раскладка, деплой, открытые вопросы. Поведения он не
+описывает.
+
+*Причина:* `opsx:archive` вливает дельты именно в `openspec/specs/` — любой
+другой нормативный дом обязан синхронизироваться руками и разойдётся. Форма
+jellybit это уже подтвердила на 43 изменениях.
+
+**C. `openspec/config.yaml` → `context` держит только нужды генерации.** Язык,
+правила именования capability, придирки валидатора RFC 2119 — и ссылки. Правило
+ревью, пересказ конвенций и инварианты оттуда вычищаются: у них есть свои дома.
+
+*Причина:* блок «Ревью (процесс, не артефакт)» в обоих `config.yaml` дословно
+повторяет шаги 4 и 7 `task-pipeline`. Это второй дом для правила, которым владеет
+плагин, и он разойдётся на первой же правке.
+
+### Что из этого следует
+
+Из A:
+
+1. Три места с веткой деградации переписываются на объявленную предпосылку плюс
+   проверку на старте (есть `openspec/`, разрешаются `opsx:*`) и внятный отказ:
+   `task-pipeline` предпосылки, `review-pipeline` предпосылки, `task-batch`
+   предпосылки.
+2. Описание `av-dev-pipeline` в маркетплейсе получает строку «требует OpenSpec».
+3. **Факт для темы «объединять ли tasks и pipeline»:** объединение потянуло бы
+   зависимость от OpenSpec на управление задачами, которой там сейчас нет.
+
+Из B:
+
+4. Правило «поведение — в спеку, устройство и границы — в архитектуру» становится
+   контрактом плагина документов и правилом шага «синк документации» в
+   `task-pipeline`.
+5. healthlog чистится **не разом**: раздел вычищается той задачей, которая его
+   касается. Нужен способ не потерять остаток — иначе 950 строк «Хранилища»
+   останутся навсегда.
+6. **Дыра, которую решение открывает:** «почему» после архивации. Сегодня
+   `CLAUDE.md` healthlog велит писать причину решения в `architecture.md` — а мы
+   её оттуда выселяем. Спеки нормативны и «почему» не держат; `design.md` живёт
+   внутри change и уезжает в архив. Либо ADR (как у jellybit), либо явное
+   правило «почему живёт в архивных change». **Первый вопрос следующей темы.**
+
+Из C:
+
+7. `av-dev-pipeline` даёт образец `openspec/config.yaml` отдельным reference —
+   он владеет связью с OpenSpec. Заполняется при старте проекта и при `adopt`.
+8. У обоих проектов из `config.yaml` вычищается блок «Ревью (процесс, не
+   артефакт)», пересказ конвенций и инвариантов.
+
+## 2. Канон документов проекта (2026-08-03)
+
+### Что было
+
+Измерено по обоим проектам:
+
+- **«Почему» не теряется — оно не находится.** `design.md` пишется почти всегда
+  (jellybit 39 из 43 архивных change, healthlog 9 из 9 — ≈285 КБ за две недели)
+  и имеет секции `Context` / `Goals / Non-Goals` / `Decisions` /
+  `Risks / Trade-offs`, то есть является ADR по структуре. Против этого ADR
+  руками: **6 записей у jellybit, четыре из них 13 июня — в день старта**; между
+  15 июня и 23 июля прошло ~40 изменений и ноль ADR. У healthlog ADR нет вовсе,
+  а настоящее ADR-рассуждение (отказ от DuckDB) лежит в разделе «Открытые
+  вопросы» файла `architecture.md`, потому что больше некуда.
+- **Два плана.** `docs/plan.md` healthlog («порядок и его обоснование», 11 шагов)
+  и `<tasks>/PLAN.md` из `av-dev-tasks` («линия целей с обоснованием порядка
+  прозой») — один артефакт под двумя именами.
+- **Дубли спек у jellybit.** Из шести файлов `docs/specs/` три (`recognition`,
+  `review-ux`, `workflow`) описывают поведение, уже покрытое capability в
+  `openspec/specs/`.
+- **`docs/drafts/` раскладывается без остатка:** `roadmap.md` → линия целей,
+  `conventions-backlog.md` → задачи `[idea]`, `logical-title-model.md` (293
+  строки, итог «сущность `title` не вводим») → намеренный отказ, то есть ADR.
+
+### Решено
+
+**D. «Почему» — ADR как промоут поверх архива.** Обоснование по-прежнему пишет
+`design.md`; ADR — короткая запись, цитирующая решение и ссылающаяся на архивный
+`design.md`. Заводит её **шаг «синк документации» пайплайна по названному
+триггеру** (дорогой откат / намеренный отказ от очевидного / пересмотр прежнего
+решения), а не человек по вдохновению.
+
+*Причина:* ручной ритуал эмпирически не выжил — 6 записей на 52 изменения.
+Автоматический (`opsx:propose` пишет `design.md` всегда) работает и производит на
+порядок больше. Чинить надо не дом, а индекс и критерий промоута.
+
+**E. `docs/plan.md` растворяется в `<tasks>/PLAN.md`.** Файл удаляется, 11 шагов
+становятся линией целей, ссылки в `CLAUDE.md` и паспорте переводятся.
+
+**F. Пути жёсткие, оба проекта приводятся к одному виду.** Плагин знает раскладку
+поимённо; указателя вида `.docs.json` нет.
+
+*Причина (словами владельца):* «так проще ориентироваться во множестве проектов,
+а не видеть слегка похожую, но разную структуру в каждом. Все проекты малого и
+среднего размера, проще подогнать их под одну структуру. Кроме того, у OpenSpec
+тоже структура строгая». Цена принята сознательно: плагин перестаёт быть
+переносимым на чужой репозиторий, а `adopt` из «поправь указатели» превращается в
+«перенеси файлы».
+
+**G. Конвенции и разведка — каталогами с README-индексом.** `docs/conventions/`
+и `docs/research/`: путь жёсткий, нарезка внутри свободна. Схема хранилища —
+**отдельный** `docs/database.md` (своя каденция: меняется миграцией, а не
+архитектурным решением; гейт healthlog уже сверяет миграции с документацией).
+Конвенции идентификаторов и именования — не схема, они в `conventions/`.
+
+**H. Слота для черновиков нет.** Идея → задача `[idea]`; намеренный отказ → ADR;
+порядок работ → `PLAN.md`; незрелое размышление → `opsx:explore` внутри change.
+
+### Канон
+
+```
+CLAUDE.md                      памятка агенту: что это, стек, инварианты, команды, слоты
+docs/
+  passport.md                  зачем и для кого; чем НЕ является; сценарии; референсы
+  architecture.md              как сложено — обзор: принципы, компоненты со ссылками
+                               на capability, внешние границы, раскладка, деплой
+  database.md                  схема хранилища (там, где есть БД)
+  conventions/README.md + <тема>.md      как пишем код; README держит правило промоута
+  research/README.md + <тема>.md         что показала реальность: чужие форматы, живые данные
+  adr/README.md + template.md + ADR-*.md почему — промоут поверх архивных design.md
+  review-journal.md            промахи конвейера ревью        ← уточнено в теме 3
+  review-brief.md              предмет ревью — см. тему 3      ← отменено в теме 3
+  tasks/                       av-dev-tasks: items/, PLAN.md, BACKLOG.md, SPRINT.md, REJECTED.md
+openspec/
+  config.yaml                  только нужды генерации + ссылки
+  specs/<capability>/spec.md   что система делает — нормативно
+  changes/archive/             журнал изменений с design.md — сырьё для ADR
+```
+
+Слотов **нет** у: `docs/drafts/`, `docs/specs/`, `docs/plan.md`, `BRIEF.md`,
+`docs/backlog/`, `docs/review/journal.md`.
+
+### Что из этого следует
+
+9. **Переезд healthlog:** `architecture.md` 1611 → обзор (поведение уезжает в
+   `openspec/specs` по разделу за задачу); `conventions.md` →
+   `conventions/README.md`; `local-research.md` 1829 → `research/`; `plan.md` →
+   `docs/tasks/PLAN.md`; `backlog/` → `docs/tasks/`; завести `docs/adr/`.
+10. **Переезд jellybit:** `BRIEF.md` → `docs/passport.md` (заодно обновить — не
+    трогался с 13 июня); `docs/specs/architecture.md` → `docs/architecture.md`;
+    `docs/specs/database.md` → `docs/database.md`; `docs/specs/jellyfin-layout.md`
+    → `docs/research/`; `docs/specs/{recognition,review-ux,workflow}.md` сверить с
+    capability и удалить как дубли; `docs/review/journal.md` →
+    `docs/review-journal.md`; `drafts/` растворить по H; `docs/backlog/` →
+    `docs/tasks/`.
+11. **`adopt` меняет природу** — теперь он переносит файлы, а не правит
+    указатели. Разбирается в теме про старт проекта.
+12. **Открыто до темы 6 (поддержание):** точная формулировка триггера промоута в
+    ADR; нужен ли механический `check` раскладки документов, раз пути жёсткие;
+    как не потерять остаток при постепенной чистке `architecture.md`.
+
+## 3. Брифа ревью нет — бриф это и есть канон (2026-08-03)
+
+### Что было
+
+Контракт брифа — 413 строк, 13 разделов, отдельный файл `docs/review-brief.md`,
+который каждый проход читает как истину. Заполнение на обоих проектах дало 841 и
+734 строки, и `REMAINING.md` уже отметил, что часть разделов вырождается в
+пересказ.
+
+Разбор по разделам после решения F (жёсткие пути) показал: **посредник между
+агентом и файлом не нужен, когда путь известен**. Восемь из тринадцати разделов
+дублируют канон или снимаются жёсткими путями.
+
+### Решено
+
+**I. Отдельного файла-брифа нет.** Проектную конкретику проходам дают документы
+канона напрямую, по жёстким путям. Формулировка владельца: «артефакты в `docs` и
+должны стать частями брифа, а для ревью достаточно дать ссылки на эти артефакты».
+
+*Причина:* один факт — один дом. Бриф был вторым домом для паспорта, инвариантов
+и карты, а разошедшийся бриф хуже отсутствующего: он выглядит актуальным.
+
+**J. Заводится `docs/security.md`.** Периметр **первой строкой** (целевой и
+сегодняшний, если контур не развёрнут), недоверенный вход и его каналы, из чего
+строятся пути и ключи, что разграничивает доступ, что чувствительнее чего, что
+вне модели. Материал уже есть, но рассыпан: у healthlog — раздел
+«Аутентификация» в `architecture.md` и строка про секреты в `CLAUDE.md`, у
+jellybit — секреты в `conventions/config.md`. **Периметра нет ни у одного**, а
+без него враждебный проход не выбирает между «открыт наружу» и «контур
+доверенный».
+
+**K. `review-journal.md` → `docs/review.md`:** журнал дефектов плюс настройка
+конвейера под проект. Туда садится остаток брифа, который фактом о проекте не
+является — типовые узлы, типовые ложноположительные, вопросы к проходам,
+недоступно проверке.
+
+*Причина:* все четыре — производные калибровки, и журнал им источник. `##
+Вопросы к проходам` сам называет журнал главным источником; `### Перестали
+проверять сознательно` требует ссылки на его запись.
+
+**L. Журнал расширяется до всех воспроизведённых дефектов** с пометкой
+«проскочил / пойман ревью». Эвал-сет для калибровки — выборка по пометке.
+
+*Причина:* пойманные дефекты с оракулом (768 МиБ пика, 5.019 с удержания
+блокировки) сегодня не сохраняются нигде, кроме отчётов триажа в архиве change, а
+они и есть лучшая опора для прохода — проектные, воспроизводимые, однажды
+оказавшиеся правдой.
+
+**M. Семантика гейта — в `CLAUDE.md`, расширением раздела «Команды».** Чем
+краснеет безусловно и почему, где логи, что означает исход, чего в гейте
+намеренно нет, **кто и когда обязан гонять дорогое вне гейта**, что запускать
+запрещено (с путями). Гейт краснеет не только в ревью — это факт о проекте.
+
+**N. Severity инвариантов дописывается в `CLAUDE.md`** рядом с формулировкой.
+Контракт брифа сам называл это лучшим исходом; жёсткие пути делают возможным.
+Оговорка «выведена по обратимости» исчезает вместе с пересказом.
+
+### Канон после темы 3
+
+```
+CLAUDE.md                      что это, стек, инварианты с severity, команды,
+                               семантика гейта, запреты, слоты
+docs/
+  passport.md                  зачем и для кого; чем НЕ является; сценарии; референсы
+  architecture.md              как сложено — обзор; окружение, внешние зависимости,
+                               наблюдатель, характер потока
+  database.md                  схема хранилища; представление данных и настройки
+                               с числовым значением (таймаут занятости, лимит тела,
+                               режим журналирования, ретеншен)
+  security.md                  периметр первой строкой; недоверенный вход; из чего
+                               строятся пути и ключи; разграничение; что вне модели
+  conventions/README.md + <тема>.md
+  research/README.md + <тема>.md         наблюдения и измеренные числа с провенансом
+  adr/README.md + template.md + ADR-*.md
+  review.md                    настройка конвейера под проект + журнал дефектов
+  tasks/                       av-dev-tasks
+openspec/
+  config.yaml, specs/<capability>/spec.md, changes/archive/
+```
+
+Слотов **нет** у: `docs/review-brief.md`, `docs/drafts/`, `docs/specs/`,
+`docs/plan.md`, `BRIEF.md`, `docs/backlog/`, `docs/review-journal.md`.
+
+### Что из этого следует
+
+13. **Скилл `project-brief` растворяется.** Заведение недостающих документов
+    канона — часть скилла старта/адаптации (тема 5, требование Т1).
+14. **Девять charter'ов переписываются второй раз.** Сейчас каждый читает «из
+    раздела `## X` брифа»; станет — из файла канона. **Цена названа вслух:**
+    первая переписка (вынос в плагин) осталась незамеренной — `REMAINING.md`,
+    пункт 1. Вторая делает замер по четырём реальным находкам healthlog
+    **обязательным, а не желательным**: два неизмеренных изменения подряд в том
+    самом месте, где присваивается severity.
+15. **Теряется соседство фактов, и charter обязан сшивать.** Контракт настаивал,
+    что замер становится находкой только рядом с настройкой: «768 МиБ пика» —
+    аномалия, лишь если известно, что запись лежит сжатой и распаковывается
+    целиком; «5.019 с удержания блокировки» — отказ соседа, лишь если известен
+    таймаут занятости. Теперь это `research/` и `database.md`, и charter'ы `ops`,
+    `adversary`, `reimpl` обязаны прямо говорить «собери из этих двух», иначе
+    проход снимет верное число и честно понизит находку до гипотезы.
+16. **Деградация становится поразрядной** — и это лучше прежнего «нет брифа →
+    деградирует всё». Нет `security.md` — деградирует `adversary`; нет
+    `research/` — числа неизвестны `ops`, `adversary` и `reimpl`; нет
+    `passport.md` — архитектурный проход теряет границу домена. Каждый проход
+    пишет свою строку в границы покрытия.
+17. **Открытый вопрос из `REMAINING.md` закрыт:** раздел `## Триггеры`
+    удаляется вместе с брифом. Правило выбора профиля остаётся в скилле
+    конвейера; проектная конкретизация, если понадобится, — в `docs/review.md`.
+
+## 4. Границы плагинов (2026-08-03)
+
+### Что было
+
+Связь `tasks` ↔ `pipeline` уже сделана **ролями, а не именами**: скиллы говорят
+«пайплайн проекта», «владелец спринта», «тот, кто ведёт задачи». Жёсткая ссылка
+по имени ровно одна — `task-pipeline:112` на канонический текст правила про
+остаток внутри `session`, и рядом обработан случай «плагин не подключён».
+
+Слоты `CLAUDE.md` при этом дублировались уже внутри одного плагина: шесть у
+`tasks`, семь у `session`, три пары — одно и то же. Темы 2–3 растворили ещё
+часть: «куда переезжает суть» отвечает канон, «оракулы» — семантика гейта
+(решение M), «где живёт разбор процесса» — `docs/review.md` (решение K). Из
+тринадцати остаётся около четырёх.
+
+### Решено
+
+**O. Три плагина: `av-dev-pm`, `av-dev-pipeline`, `av-dev-git`.**
+
+- **`av-dev-pm`** (бывший `av-dev-tasks`) — управление продуктом: канон
+  документов, задачи, цели, спринты, старт и адаптация проекта. Владеет всем
+  `docs/`, включая `docs/tasks/`.
+- **`av-dev-pipeline`** — исполнение: SDD-цикл, конвейер ревью, девять агентов.
+- **`av-dev-git`** — стиль коммитов; работает в любом репозитории.
+
+*Причина (словами владельца):* «пайплайн можно и переиспользовать в других
+проектах с более простым подходом к управлению». Это подтверждается разбором:
+пайплайн зависит от **файлов канона и от OpenSpec, а не от плагина** `av-dev-pm`.
+В чужом проекте нужных файлов нет — включается поразрядная деградация (следствие
+16), и это штатный режим, а не поломка.
+
+*Имя:* `pm` = product management, «объединение всех операций по управлению
+продуктом», и согласуется с `av-dev-git`.
+
+**P. Граница «пайплайн не закрывает задачу» снимается.** Закрывает задачу и
+двигает строки между `SPRINT.md` / `BACKLOG.md` / `REJECTED.md` **агент-
+оркестратор** — `task-pipeline` и `task-batch`, а не сабагенты внутри них. Зовёт
+он `tasks.py` через слот «Команда учёта задач» в `CLAUDE.md`.
+
+Слот, следовательно, **не исчезает, а становится мостом между плагинами** — и
+заодно тем, чего в чужом проекте нет, отчего пайплайн там работает как прежде:
+докладывает исход, записей учёта не трогает.
+
+**Q. `av-dev-backlog` помечается устаревшим и остаётся** до перевода jellybit.
+Описание переписывается так, чтобы не ловить триггер «добавь задачу в беклог» —
+иначе агент выбирает между ним и `av-dev-pm` случайно.
+
+### Что из этого следует
+
+18. **Переименование `av-dev-tasks` → `av-dev-pm`** тянет `plugin.json`,
+    `marketplace.json` и пространство имён скиллов: `av-dev-tasks:session` →
+    `av-dev-pm:session`, включая ссылку из `task-pipeline:112`.
+19. **Раздел «Стимулы, которые процесс создаёт» в `session` переписывается.**
+    Снятая граница выбила механическую опору у трёх защит: «сжать задачу до
+    остатка», «занизить урожай», «занизить критерии приёмки» — во всех трёх
+    приёмщик и исполнитель теперь совпадают. Остаются: **отчёт триажа** в
+    `openspec/changes/<id>/review/` (независимый артефакт, `task-batch` уже
+    сверяет полноту ревью по нему, а не по прозе исполнителя), **`SPRINT.md` под
+    git** с видимой историей и **`reopen <slug> --reason`** — закрытие не
+    окончательно, приёмка человеком на сессии его отменяет. Раздел обязан назвать
+    их поимённо, иначе обещает защиту, которой нет.
+20. **Конфликт владения `docs/tasks/` снят** — канон и задачи теперь в одном
+    плагине.
+21. **Скилл `adopt` из `av-dev-tasks` поглощается** скиллом адаптации проекта
+    уровня канона (требование Т1). Разбирается в теме 5.
+22. **Состав `av-dev-pm`:** `tasks`, `session` (есть), `docs` — ведение канона,
+    `project` — старт, adopt, check, upgrade (тема 5).
+
+## 5. Старт проекта и жизненный цикл под каноном (2026-08-03)
+
+### Что было
+
+Требование Т1: прийти в любой старый проект и перевести на текущие рельсы; канон
+сам меняется, значит уже приведённые проекты тоже повышаются.
+
+Существующий `adopt` (уровень задач) даёт готовую форму: **`scan` — только
+чтение, карта → суждение человека → `apply` — запись одним проходом**, с отказом
+до первой записи при неверной карте и с обязательным разделом «не разложилось»
+поимённо. Форма переносится на уровень канона как есть.
+
+Четыре операции различаются не поровну: `adopt`, `check` и `upgrade` — одна
+машина сравнения с разными исходами, а `init` — принципиально другой режим,
+разговор, а не сверка.
+
+### Решено
+
+**R. Два скилла: `av-dev-pm:init` и `av-dev-pm:canon`.** `init` — интервью по
+входному брифу для нового проекта. `canon` — привести к канону: `check`, `adopt`,
+`upgrade` одной машиной.
+
+**S. Скелет канона заводится целиком, незаполненное называется пустым.** Все
+файлы канона есть с первого дня, но незаполненный держит **одну честную
+информативную строку**: «наблюдений на живых данных нет — внешний источник один,
+формат документирован», «прецедентов не накоплено», «внешних зависимостей нет,
+смотри на диск и на СУБД».
+
+*Причина:* это тот же принцип, что был в контракте брифа, поднятый на уровень
+файлов. Проход читает такую строку **как факт**, а не как пробел, и не тратит
+обязательный вопрос впустую. Отсутствие файла он прочитать не может никак.
+
+**Защита от вырождения в заглушки** берётся у `tasks.py`: пока на месте стоит
+плейсхолдер шаблона, `check` о нём напоминает. Строка «TBD» — это не «пустое
+названо пустым», и `check` обязан их различать.
+
+**T. Скрипт `docs.py` плюс версия канона в `docs/.pm.json`.** Отдельный скрипт,
+не расширение `tasks.py`: рефакторинг 2421 работающей строки ради удобства вызова
+не окупается. `docs.py check` зовёт `tasks.py check` для своей части.
+
+**Граница механизируемого объявляется вслух — иначе `check` соврёт.**
+
+| Проверяет `docs.py` | Судит агент |
+| --- | --- |
+| отсутствующие пути канона | смысловой дубль (`docs/specs/recognition.md` против capability) |
+| файлы в `docs/` вне канона | поведение, оставшееся в `architecture.md` |
+| битые относительные ссылки | протухший факт, разошедшийся с кодом |
+| версия канона и её отставание | достаточность честной строки в пустом слоте |
+| нетронутый плейсхолдер шаблона | |
+
+`check`, отчитавшийся «канон соблюдён» на проекте, где из шести файлов три
+лишние, хуже отсутствующего.
+
+### Порядок интервью `init` — зависимость, а не удобство
+
+Цель и потребители → чем это **не** является и мера успеха → периметр и что
+недоверенное → стек, хранилище, необратимое → чем краснеет гейт → первые цели в
+`PLAN.md`. Каждый блок опирается на ответ предыдущего.
+
+Вход — свободный текст «что мне нужно и почему» (образец формы: `BRIEF.md`
+jellybit, 6 КБ). После `init` его дом — `passport.md`; отдельным файлом он не
+остаётся.
+
+**`init` физически не производит полный канон.** В новом репозитории нет кода, а
+`architecture.md`, `database.md`, `conventions/` и `research/` выводятся из него.
+Они заводятся скелетом с честной строкой («архитектуры пока нет: кода нет,
+заводится первой задачей») и наполняются шагом синка документации.
+
+### Что из этого следует
+
+23. **`docs/.pm.json` поглощает `<tasks>/.tasks.json`.** Меняется цепочка
+    разрешения в `tasks.py` — сегодня он ищет `.tasks.json` вверх от текущего
+    каталога. Нужен переходный период либо чтение обоих.
+24. **`tasks.py adopt` становится шагом внутри `canon adopt`**, а не отдельной
+    пользовательской операцией: `docs/tasks/` — часть той же раскладки.
+25. **Версия канона — целое число**, не semver: у канона нет обратной
+    совместимости, есть только «приведён» и «не приведён».
+26. **Журнал изменений канона** живёт в плагине —
+    `av-dev-pm/skills/canon/references/changelog.md`, запись на версию: что
+    добавилось, что переехало, что удалено, что сделать проекту.
+27. **Открыто до темы 6:** звать ли `docs.py check` из гейта проекта. У healthlog
+    `task gate` уже сверяет миграции с документацией, так что место есть; но гейт
+    принадлежит проекту, и плагин может только рекомендовать строкой в отчёте.
+
+## 6. Поддержание документов по ходу разработки (2026-08-03)
+
+### Что было
+
+Гейт healthlog **уже изобрёл нужный механизм** для одного документа —
+`scripts/gate.py:177-181`: миграция изменена, а `docs/database.md` нет → `FAIL`.
+Документ канона сверяется с кодом красным гейтом, а не напоминанием.
+
+Против этого — прямое доказательство, что́ не работает: у `adr/` был список
+триггеров прозой («выбор технологии, структурные решения, дорогой откат,
+намеренный отказ»), и он дал **6 записей на 43 изменения**. Прозаический триггер,
+который некому проверить, не срабатывает.
+
+Механизируемы три документа из десяти: `database.md` (миграция), `architecture.md`
+(capability в `openspec/specs/` без упоминания в обзоре), `tasks/` (`tasks.py
+check`). Плюс `openspec/specs/` вливает `opsx:archive`.
+
+### Решено
+
+**U. Принуждённое отрицание в докладе шага синка.** Шаг обязан назвать **каждый**
+документ канона: обновлён — чем, либо «не требуется, потому что…». Нетронутые
+группируются одной строкой с общей причиной.
+
+*Причина:* это тот же приём, что «границы покрытия» в отчёте ревью и «пустой
+пункт называется пустым» в каноне — и единственный, о котором в этом репозитории
+есть данные, что он работает. Умолчание «не написал» становится неотличимым от
+«написал, что не требуется», только если отрицание обязательно.
+
+**Триггер ADR, окончательная формулировка.** Запись заводится, когда верно одно
+из трёх: **дорогой откат** (переделка стоит дороже переписывания одного файла);
+**намеренный отказ** от очевидного подхода; **пересмотр прежнего решения** — тогда
+у старой записи обязателен статус «заменено на». Не заводится для рутины и для
+того, что видно из кода и `git log`. Источник — архивный `design.md`: ADR его
+цитирует и на него ссылается, а не пересказывает.
+
+**V. `docs.py check` обязателен в гейте проекта.** Скилл `canon` при адаптации
+добавляет шаг и печатает это в отчёте.
+
+*Причина:* гейт — единственный общий станок, который нельзя пропустить. Проверка,
+которую зовёт агент, может быть не позвана; прецедент в самом healthlog уже есть.
+
+Сверка «миграция изменена — `database.md` нет» **обобщается**: путь миграций
+проекта записывается в `docs/.pm.json` рядом с версией канона, и `docs.py` делает
+эту проверку сам, а не каждый проект заново.
+
+**W. Остаток чистки помечается маркером и считается числом.** Неразобранный
+раздел получает `<!-- канон: поведение → openspec/specs/<capability> -->`,
+`docs.py` считает маркеры и печатает остаток. Закрывается порциями, как
+переоценка задач.
+
+**Маркеры гейт не красят.** Это долг, а не отказ: покрасневший гейт на первом
+маркере сделал бы постепенный переезд невозможным, а разовый — обязательным.
+Число печатается и убывает на глазах.
+
+### Что из этого следует
+
+28. **Шаг 9 `task-pipeline` переписывается** из четырёх пунктов прозой в
+    построчный доклад по документам канона.
+29. **`promote.md`, шаг 3, переписывается:** «вычеркнуть пункт из брифа, правило
+    переезжает в перечень механизированного в разделе `## Карта`» → перечень
+    механизированного живёт в `conventions/README.md`. Брифа нет.
+30. **`docs/.pm.json` держит не только версию канона**, но и пути, нужные
+    проверкам: каталог миграций — как минимум.
+31. **`docs.py check` получает две сверки с кодом**, а не только раскладку:
+    миграции ↔ `database.md`, capability ↔ упоминание в `architecture.md`.
+
+## 7. Раскладка скиллов и доставка скриптов (2026-08-03)
+
+### Решено
+
+**X. Пять скиллов в `av-dev-pm`.**
+
+```
+av-dev-pm/skills/
+  init/      интервью по брифу → канон нового проекта
+  canon/     раскладка: check / adopt / upgrade
+  docs/      содержимое канона: ADR из архивного design.md, промоут конвенций,
+             запись в research/ и review.md, чистка architecture.md
+  tasks/     формат и содержимое задач
+  session/   ритуал спринта
+```
+
+*Причина отдельного `docs`:* правила ведения содержимого канона обязаны жить у
+владельца канона, а не в шаге синка чужого плагина — иначе проект без пайплайна
+документацию вести не может. Это работает потому, что **вызов скилла через
+пространство имён между плагинами возможен**, в отличие от
+`$CLAUDE_PLUGIN_ROOT`: `task-pipeline` уже зовёт `opsx:propose` и
+`av-dev-pipeline:review-pipeline`. Шаг синка зовёт `av-dev-pm:docs`, а в чужом
+проекте деградирует до прозаического списка.
+
+Симметрия, по которой резалось: **раскладка и содержимое разделены и для
+документов, и для задач** — `canon` / `docs`, `tasks` / `session`.
+
+**Y. Скрипты не копируются — живут вместе со скиллами.** Три вызывающих, три
+способа дотянуться:
+
+| Кто зовёт | Как |
+| --- | --- |
+| скиллы `tasks`, `canon`, `docs` | `$CLAUDE_PLUGIN_ROOT` — свой плагин, работает всегда |
+| `task-pipeline`, `task-batch` | **вызов скилла** `av-dev-pm:tasks`, а не путь |
+| гейт проекта | путь переменной с умолчанием на канонический путь маркетплейса; пишет `canon adopt`, внятный красный отказ, если не найден |
+
+**Слот «Команда учёта задач» всё равно исчезает** — но снимает его не копия, а
+**вызов скилла через пространство имён**. Тот же приём, которым шаг синка зовёт
+`av-dev-pm:docs` (решение X): чужой плагин зовёт скилл, скилл разрешает свой
+`$CLAUDE_PLUGIN_ROOT` сам. Путь наружу не выносится вовсе.
+
+*Первоначально здесь было решено вендорить `scripts/tasks.py` и
+`scripts/docs.py` в проект. Отменено после проверки фактов:*
+
+- **CI нет ни в одном проекте** (ни `.github`, ни woodpecker, ни drone).
+  Pre-commit есть только у jellybit — `lefthook` с gofmt/vet/lint/test/gitleaks —
+  и гоняется на той же машине, где установлен плагин. Довод «не работает в CI и
+  у человека без Claude Code» оказался гипотетическим.
+- **Пара «источник — копия» существует и без вендоринга.** Установленный
+  маркетплейс — git-клон; на момент разбора он стоял на `092d07c`, на четыре
+  коммита позади `master`, и `av-dev-tasks` с `av-dev-pipeline` в нём
+  отсутствовали вовсе. Довод «вендоринг создаёт вторую копию» был слабее, чем
+  подан.
+- **Обновление маркетплейса — одна точка на все проекты.** При вендоринге каждый
+  проект повышается отдельно, и проекты расходятся друг с другом — ровно та
+  разнородность, против которой принято решение F.
+
+**Z. Имени у процесса нет — процесс это `av-dev`.** Маркетплейс уже
+`av-dev-skills`, плагины `av-dev-*`; в `CLAUDE.md` проекта пишется «процесс
+av-dev, канон версии N». Имя, которое нигде не работает, — украшение.
+
+### Что из этого следует
+
+32. **Решение P уточняется:** оркестратор закрывает задачи **вызовом скилла**
+    `av-dev-pm:tasks`, а не запуском скрипта по пути. Плагина в проекте нет —
+    вызов не разрешается, и пайплайн, как прежде, только докладывает исход.
+33. **Слот исчезает из двух скиллов** — `tasks` (слот 6) и `session` (слот 7), —
+    и из текстов `task-pipeline` и `task-batch`, которые на него ссылаются.
+34. **`canon upgrade` отвечает за раскладку и версию в `docs/.pm.json`.**
+    Скрипты обновляются обновлением маркетплейса, а не проектом.
+35. **Скрипты живут в `av-dev-pm/skills/{tasks,canon}/scripts/`.** `docs.py` — в
+    `canon`, потому что раскладку проверяет он.
+36. **`canon check` сверяет версию канона проекта с версией установленного
+    плагина** и говорит, кто отстал. Это нужно и без вендоринга: маркетплейс —
+    git-клон, обновляется явно, и на момент разбора отставал на четыре коммита.
+37. **Установленный маркетплейс требует обновления перед любой работой** —
+    сейчас в нём нет ни `av-dev-tasks`, ни `av-dev-pipeline`. Это первый шаг
+    выката (тема 8), иначе проверять будет нечего.
+
+## 8. Порядок выката (2026-08-03)
+
+### Объём
+
+Ссылок на бриф — **168 строк в 19 файлах** `av-dev-pipeline`, из них ~48 уходят
+вместе с удаляемыми `project-brief/SKILL.md`, `references/project-brief.md` и
+`references/brief-template.md`. Остальное переписывается на пути канона.
+
+### Решено
+
+**AA. Инструмент строится целиком, потом проверяется.** Не пилот руками.
+
+*Риск принят сознательно:* если замер покажет деградацию severity, чинить
+придётся канон, зашитый к тому моменту в три скилла, скрипт и мигрированные файлы
+healthlog.
+
+*Удешевление, которое обязано быть заложено сразу:* **определение канона живёт в
+единственном reference-файле**, который читают `init`, `canon` и `docs`, а не
+повторяется в каждом. Правка канона — одно место плюс запись в журнал версий.
+
+*Страховка порядка:* **замер ставится перед переездом jellybit**, а не после
+всего, — он всё ещё блокирует то, что дороже всего откатывать.
+
+**BB. Работа ведётся в `docs/tasks/` самого `dev-skills`.** Скилл `tasks` не
+требует ни OpenSpec, ни языка — задачи для него просто каталог markdown. Цели —
+крупные куски, задачи — следствия. Заодно первая боевая обкатка собственного
+инструмента.
+
+**CC. `AGENTIC-TASKS.md` сжимается до истории решений и переезжает в
+`dev-skills`** отдельным `HISTORY.md`: почему не Scrum, числа первого замера, что
+отвергнуто и почему. Он описывает процесс, а процесс живёт здесь, не в healthlog.
+Остальное содержимое уже в плагинах, и второй дом для тех же правил — ровно то,
+против чего документ сам и написан.
+
+### Порядок
+
+```
+0.  обновить установленный маркетплейс           предусловие всего
+0.5 завести docs/tasks в dev-skills, разложить 37 следствий по целям
+
+1.  РЕПОЗИТОРИЙ ПЛАГИНОВ
+    1.1 av-dev-tasks → av-dev-pm, пространство имён
+    1.2 канон одним reference-файлом — единственный дом определения
+    1.3 правки tasks и session: слоты, «Стимулы», .pm.json
+    1.4 новые init, canon, docs + docs.py
+    1.5 av-dev-pipeline: удалить project-brief, снять ветки деградации OpenSpec,
+        переписать шаг 9, девять charter'ов, promote.md, убрать слот
+    1.6 av-dev-backlog устаревшим; README; журнал канона v1; HISTORY.md
+    1.7 REMAINING.md пересобрать — часть его вопросов закрыта этим разбором
+
+2.  HEALTHLOG — первая боевая проверка инструмента
+    canon adopt, заполнение канона, security.md, review.md, ADR,
+    маркеры в architecture.md, docs.py check в гейте
+
+3.  КАЛИБРОВКА на четырёх находках healthlog        БЛОКИРУЕТ шаг 5
+
+4.  один-два спринта healthlog на новом процессе
+
+5.  JELLYBIT — переезд, удаление дублей specs, растворение drafts
+```
+
+### Что из этого следует
+
+38. **`REMAINING.md` частично устарел:** пункт 2 «Завести брифы» отменён темой 3;
+    закрыты открытые вопросы про `## Триггеры`, `av-dev-backlog`, имя процесса и
+    `AGENTIC-TASKS.md`. Пункт 1 (калибровка) стал обязательным, а не
+    желательным. Пересобрать на шаге 1.7.
+39. **Замер — единственный шаг, который нельзя переставить.** Всё остальное в
+    порядке 1–5 можно тасовать; шаг 3 стоит перед шагом 5 жёстко.
+
+## 9. Линтеры скриптов (2026-08-03)
+
+### Что было
+
+Три скрипта на python, 3600 строк, ни одной проверки. `tasks.py` — 2450 строк,
+которые ходят по файловой системе, переименовывают и удаляют файлы задач.
+Требование к самим скриптам прежнее и не обсуждается: **голый `python3` 3.12,
+ноль внешних зависимостей** — они лежат рядом со скиллами и запускаются в
+чужом проекте, где ничего ставить нельзя.
+
+### Решено
+
+**DD. `pyproject.toml` в корне `dev-skills`, зависимости через `uv`.** Файл
+живёт только здесь и не уезжает никуда: он держит **линтеры**, а не зависимости
+скриптов. Скрипты остаются запускаемыми любым `python3` — это проверено прогоном
+всех операций через `/usr/bin/python3`, а не через `.venv`.
+
+**EE. Ноль зависимостей охраняется двумя способами, и главный — второй.**
+`banned-api` у ruff ловит частые соблазны по имени (`requests`, `yaml`,
+`pydantic`, `click`, `rich`) — список заведомо неполный. Настоящий страж —
+pyrefly: в окружении нет ничего, кроме линтеров, поэтому **любой** сторонний
+импорт у него не разрешается. Первый способ даёт понятное сообщение, второй —
+полноту.
+
+**FF. Версии линтеров прибиты точно** (`ruff==0.16.1`, `pyrefly==1.2.0`) плюс
+`uv.lock` в git. Обновление линтера меняет набор находок, а находки правятся
+руками в скриптах, которые уезжают в чужие проекты. Обновление обязано быть
+отдельной осознанной правкой, а не побочным эффектом `uv sync`.
+
+**GG. `RUF001`–`RUF003` выключены.** Весь текст скриптов русский: сообщения,
+докстроки, комментарии. «Похожая на латиницу кириллица» здесь норма, а не
+опечатка, и три этих правила давали **311 срабатываний из 338** — шум, в котором
+тонут остальные 27.
+
+**HH. `av-dev-backlog` исключён из проверки.** Плагин помечен устаревшим и живёт
+до перевода последнего проекта, после чего удаляется целиком. Шесть его находок
+косметические (`os.replace`, `l` как имя), а правка замороженного кода без
+тестов — риск без выгоды. Исключение уходит вместе с плагином.
+
+**II. Голый `except Exception` разрешён только помеченный.** Правило `BLE`
+включено, а два места последнего рубежа (`main` обоих скриптов, код выхода 4 по
+словарю) несут `# noqa: BLE001` с причиной. Так третий такой except не
+появляется молча.
+
+### Что из этого следует
+
+40. **Найдено и починено 27 находок ruff и 14 pyrefly.** Содержательных две:
+    мёртвая переменная `ques` в `check` (вычислялась и не использовалась —
+    вопросы проверяет `questions_open`) и два места в `check --fix`, где
+    `find_entry_index` может вернуть `None`, а результат идёт прямо в
+    `list.pop` и в `range`. Оба сегодня недостижимы, и недостижимость держалась
+    на рассуждении о вызывающем коде, а не на проверке.
+    *Поправлено по ревью:* там стоит `raise`, а не `continue`. Тихий пропуск
+    превратил бы сломанный инвариант в отчёт «индексы согласованы» — то есть в
+    враньё; громкий отказ кодом 4 честнее.
+41. **`os` из `tasks.py` ушёл целиком.** `os.replace` → `Path.replace`,
+    `os.path.basename` → `Path.name`; импорт стал не нужен.
+42. **`fail()` в `docs.py` объявлен `NoReturn`.** Без этого `read_config`
+    выглядел как возвращающий неинициализированное значение — и это ровно то,
+    что читатель кода тоже не мог знать наверняка.
+43. **Проверка не входит ни в один гейт.** CI у репозитория нет, хука нет;
+    запускается руками командой из README. Заводить хук ради двух скриптов,
+    которые правятся раз в месяц, — плата ритуалом без выгоды.
+
+## 10. Ревью готовых плагинов двумя проходами (2026-08-03)
+
+### Что было
+
+Два независимых сабагента `fable` — по одному на `av-dev-pm` и `av-dev-pipeline`.
+**20 находок, из них две найдены обоими независимо.** Прошлые три круга ревью
+шли по одному проходу на всё; два прохода с разными предметами дали и больший
+урожай, и перекрёстное подтверждение самого дорогого дефекта.
+
+### Что оказалось сломано по существу
+
+**JJ. Перестановка закрытия за коммит (решение из темы 8) сломала `reopen` и
+батч — и это нашли оба прохода.** `close --implemented` печатает «дорога назад:
+файл восстанавливается из git», а `reopen` искал **коммит удаления**, которого в
+новом порядке ещё нет: шаг 11 идёт последним, и учёт остаётся незакоммиченным.
+Проверено прогоном: `reopen` отказывал кодом 2 на свежезакрытой задаче — то есть
+в самом вероятном своём применении. Тем же грязным деревом ломался `task-batch`:
+`git rebase` и `git worktree remove` отказывают, и **каждая успешно закрывшая
+задачу ветка** уезжала бы в провалившиеся.
+
+Починено с обеих сторон: `reopen` берёт текст из `HEAD`, если коммита удаления
+нет, а шаг 11 обязан **коммитить учёт вторым коммитом** — иначе закрытие не
+доезжает до основной ветки и опора «`SPRINT.md` под git» остаётся словами.
+
+**KK. Канонический пример `docs/.pm.json` убивал `tasks.py`.** `canon.md`,
+`skeletons.md`, `tasks/SKILL.md` и `adopt.md` показывали ключ `tasks.sections`,
+которого скрипт не знает: `_validate_config` отвергает неизвестные ключи кодом 3
+на **любой** команде. Проект, заведённый по канону дословно, остался бы без
+работы с задачами целиком — а `docs.py check` при этом печатал «канон соблюдён»,
+потому что чужой код 3 уходит в «не проверялось». Секции живут в заголовках `##`
+индекса и второго дома не получают.
+
+### Что из этого следует
+
+44. **Класс находок тот же, что и в прошлые три круга: стыки.** Не новый код, а
+    место, где один файл ссылается на другой. `sprint.md` в пункте «Сделана» всё
+    ещё отсылал к порядку, который сам же тремя экранами ниже отменил; три
+    остатка «шаг 9а» несли **предкоммитную** позицию закрытия; путь отчёта
+    триажа не переживал `opsx:archive`, хотя по нему сверяют полноту ревью
+    четверо.
+45. **Инструкция, которую нельзя выполнить, выглядит как выполненная.** Ответ на
+    вопрос по документированной процедуре (снять тег) оставлял задачу
+    незабираемой, потому что судит **раздел**, а не тег; `canon adopt` требовал
+    гнать `docs.py check` «до отсутствия дрейфа», недостижимого без нарушения
+    запрета сочинять цели; урожай спринта, заведённый после `sprint close`,
+    терял автотег молча.
+46. **Два прохода по разным предметам дороже одного, но не вдвое.** Перекрытие
+    оказалось ровно в одной находке из двадцати — той самой, что подтвердилась
+    дважды. Практика остаётся: ревью на плагин, а не одно на репозиторий.
+
+## 11. Зависимости между плагинами (2026-08-03)
+
+### Целевая картина, которую проверяли
+
+`av-dev-git` ни от чего не зависит. `av-dev-pipeline` сам по себе: задача
+приходит **и обычным текстом**, и из `tasks`. `av-dev-pm` оперирует абстрактным
+«сделать задачу» и не знает, чем она выполняется.
+
+### Что показала проверка
+
+**LL. Первые две цели выполняются, третья в исходной формулировке недостижима —
+и формулировку надо поправить, а не картину.** `av-dev-pm` **владеет
+конфигурационным файлом конвейера**: `docs/review.md` держит «Вопросы к
+проходам» и «Триггеры профиля», то есть перечисляет проходы поимённо, а скелет
+`review.md` несёт форму журнала дефектов. Кто-то этим словарём владеть обязан —
+канон и есть схема данных, которую конвейер читает. Честная формулировка цели:
+**`av-dev-pm` не зовёт пайплайн и не требует его наличия**. Она выполняется.
+
+**MM. Настоящая протечка была одна — необъявленная деградация опор приёмки.**
+«Стимулы» в `session` и приёмка в `sprint.md` держались на «сохранённом отчёте
+триажа» по конкретному OpenSpec-пути. В проекте без конвейера ревью защита от
+занижения урожая исчезала **молча**: сверять не с чем, а текст об этом не
+говорил. Теперь опора названа абстрактно («независимый отчёт ревью»), путь
+`av-dev-pipeline` дан как частный случай, а отсутствие конвейера обязано
+попадать строкой в доклад спринта.
+
+**NN. Ветка деградации шага 9 была неисполнима — ровно в том случае, ради
+которого написана.** «Плагина нет — открой
+`av-dev-pm/skills/canon/references/canon.md`»: путь в дерево маркетплейса, из
+проекта без установленного плагина не разрешается ниоткуда. Кросс-плагинные
+пути в дерево маркетплейса теперь не используются вообще: пайплайн ходит в
+**свой** `references/project-facts.md`, а ссылки в чужой плагин даются через
+`Skill <плагин>:<скилл>`.
+
+### Что из этого следует
+
+47. **Знаниевый цикл есть и он законен, но каждый его контракт обязан иметь
+    единственный дом.** Пайплайн описывает раскладку `pm`, `pm` описывает
+    артефакты пайплайна — пять симметричных контрактов, из них два уже
+    разошлись: форма журнала дефектов (шесть полей против пяти, «Причина»
+    потеряна) и список читателей `docs/research/` (`specs` выпал). Дома
+    назначены: форма журнала — у конвейера, список читателей — у канона; в обеих
+    копиях стоит явное указание на дом.
+48. **Пайплайн больше не называет внутренние имена файлов `pm`.** `items/<slug>.md`
+    и `SPRINT.md` в его тексте были вторым домом для раскладки, которую проект
+    вправе переименовать через `docs/.pm.json`.
+49. **Описания плагинов в манифестах врали умолчанием.** Ни `marketplace.json`,
+    ни `plugin.json` не говорили, что `av-dev-pm` для конвейера **опционален**, а
+    задача принимается текстом. Теперь говорят — это первое, что читает человек,
+    выбирая, что подключать.
+
+## 12. Механическая проверка копий (2026-08-03)
+
+### Что было
+
+Разделение плагинов оставлено (тема 11), но цена его названа: пять симметричных
+контрактов в двух домах, два уже разошлись — форма журнала дефектов потеряла в
+копии поле «Причина», список читателей `docs/research/` потерял `specs`. Оба раза
+копия выглядела актуальной, и оба раза расхождение прошло мимо трёх ревью подряд.
+
+### Решено
+
+**OO. Копия допустима, но обязана быть дословной и помеченной.** Разметка —
+HTML-комментарии, невидимые в отрендеренном markdown: `<!-- дом: <id> -->` …
+`<!-- /дом: <id> -->` и `<!-- копия: <id> из <путь> -->` … `<!-- /копия: <id> -->`.
+`scripts/copies.py` требует побайтового совпадения текста между маркерами.
+
+*Почему комментарии, а не манифест копий отдельным файлом:* маркер уезжает в
+репозиторий проекта вместе со скелетом, и там он **полезен** — говорит читателю,
+что у текста есть дом и правится он там. Манифест остался бы в маркетплейсе и
+проекту ничего не сказал.
+
+**PP. Идентификатор строгий — буквы, цифры, дефис — и повторяется в закрывающем
+маркере.** Иначе документация о самом механизме объявляет дом и роняет проверку:
+это случилось на первом же прогоне, `README.md` объявил дом примером. Теперь
+пример пишется `<id>`, угловые скобки под шаблон не подходят.
+
+**QQ. Ограда блока кода в сверку не входит.** В доме текст обрамлён своей ```,
+а в скелете тот же текст лежит внутри чужой, объемлющей ограды. Сверяется
+содержимое, а не разметка вокруг него.
+
+**RR. Коды выхода — общий словарь** (0 сошлось, 1 расхождение, 2 разметка,
+3 не тот каталог, 4 сбой). Третий скрипт репозитория, и третий по тем же кодам.
+
+### Что из этого следует
+
+50. **Помечены два контракта:** форма записи журнала дефектов (дом — конвейер
+    ревью, копия — скелет канона; это кросс-плагинная пара) и «когда заводить
+    ADR» (дом — канон, копия — его же скелет). Второй пришлось сперва **сделать**
+    дословным: копия говорила «обязателен статус», дом — «обязателен статус
+    „заменено на"», и это ровно тот класс, который и ищется.
+51. **Чего проверка не ловит — копию, которую забыли пометить.** Помечать
+    остаётся решением человека, и это названо в `README.md` вслух: иначе зелёный
+    прогон читался бы как «копий больше нет».
+52. **Дом без копий — расхождение, а не замечание.** Маркер, обещающий
+    дисциплину, за которой не за чем следить, — такая же ложная запись, как
+    разошедшаяся копия.
+53. **Запись в журнал версий канона проверка не заменяет.** Она видит, что копия
+    отстала, но не видит, что проект уже унёс старую версию к себе. Это остаётся
+    на человеке и сказано в обоих домах.

HISTORY.md

@@ -0,0 +1,85 @@
+# Как процесс дошёл до текущей формы
+
+Сжатие черновика `AGENTIC-TASKS.md` (497 строк), лежавшего незакоммиченным в
+корне healthlog. Правила процесса из него переехали в плагины и здесь **не
+повторяются** — второй дом для тех же правил ровно то, против чего документ и
+был написан. Остаётся то, чего в плагинах нет и быть не должно: **что отвергнуто
+и почему, и числа первого замера**.
+
+Решения текущего круга разбора — [DECISIONS.md](DECISIONS.md).
+
+## Что отвергнуто и почему
+
+### Scrum целиком
+
+Терминология близка — спринт, груминг, определение готовности, ретроспектива, —
+и она удобна: не нужно изобретать слова. Но добрая половина Scrum существует ради
+синхронизации людей, которых здесь нет: исполнителей двое, человек и агент.
+
+**Не взято:** тайм-бокс (спринт ограничен объёмом, а не временем), velocity и
+оценки в очках, ежедневный стендап (стендап — это и есть диалог), планирование
+отдельно от груминга (владелец беклога один), роль скрам-мастера.
+
+**Взято:** цель спринта, заморозка набора, определение готовности, груминг —
+каждое потому, что снимает решение, которое иначе принимается заново каждый раз.
+**Ретроспектива взята содержанием, но не отдельным ритуалом**: она шаг той же
+сессии. Отдельная встреча ради трёх вопросов — плата ритуалом без выгоды.
+
+### Приоритеты у задач
+
+Заменены целью. Ни секциями, ни списком: «что делать дальше» отвечает набор
+спринта, а между спринтами порядок не нужен никому — брать задачи вне спринта
+запрещает заморозка. Отсюда нет ни «повысить», ни «встать раньше»: вместо
+повышения — смена цели или включение в набор.
+
+### Секция «блокеры» в беклоге
+
+Блокер — **состояние** (спринт не может продолжаться ни одной задачей), а не
+полка: он живёт ровно до ответа человека, и записи в такой секции не успевают
+жить. Основание измерено: **два «блокера» из двух ничего не блокировали** — в
+обоих файлах записано «что заблокировано: ничего». Отсюда разделение вопроса и
+блокера.
+
+### Запись о сделанной задаче
+
+У сделанной задачи записи не остаётся: файл и строка удаляются. Ей хватает
+коммита и документации; вторая запись была бы вторым домом для того же факта.
+Вопрос «что было в спринте N» отвечается даром — `SPRINT.md` лежит под git.
+
+## Числа первого замера
+
+Одна сессия, шесть закрытых задач. **Выборка нетипичная, статус — первый
+замер.** Приведены не как константы, а чтобы следующий замер было с чем
+сравнить.
+
+- **Беклог вырос с 29 до 38**: заведено 15, закрыто 6 (две родились и умерли
+  внутри сессии). Прирост **2,5 задачи на одну закрытую** — ревью и
+  эксплуатационные проходы производят работу быстрее, чем мы её потребляем.
+- **Одна из шести задач была внеплановой** — дозакрытие находок, вставленное в
+  ход работы, потому что дефект затирал маршрут тренировки необратимо, а
+  пересборка журнала повторяла то же поражение. Отсюда класс «необратимый
+  ущерб» как единственное, что врывается в замороженный спринт: правило не
+  придумано, оно уже применялось.
+- **15 часов на шесть задач**: пять заняли от 1 ч 16 мин до 2 ч 14 мин (медиана
+  ≈ 1 ч 55 мин), шестая — 5 ч 42 мин в два захода. Мерилось **до** сужения
+  конвейера ревью; замер устарел и подлежит повторению.
+- **Шесть задач за сессию** — предел одного контекста, а не спринта. Спринт
+  сессией не ограничен, перенос числа условен.
+
+Умолчание «5–8 задач в спринте» выведено отсюда и остаётся **ориентиром, а не
+законом**. Пересматривается на разборе прошедшего спринта — шаг 2 сессии, и ничей
+другой.
+
+## Что из черновика было не решено и решено позже
+
+| Вопрос черновика | Где решён |
+| --- | --- |
+| название процесса | решение Z: имени нет, процесс это `av-dev` |
+| «Ближайшая цель» прозой в `docs/plan.md` как второй дом цели спринта | решение E: `plan.md` растворяется в `PLAN.md` целей |
+
+## Судьба самого черновика
+
+Документ описывал процесс, а процесс живёт в плагинах этого репозитория, не в
+healthlog. Содержимое разошлось: правила — в `av-dev-pm:tasks` и
+`av-dev-pm:session`, обоснования и числа — сюда. Оригинал в git не коммитился и
+удаляется при переезде healthlog на канон.

README.md

@@ -1,77 +1,169 @@
 # av-dev-skills
 
-Личный маркетплейс плагинов и скилов для разработки — чтобы подключать их к
+Личный маркетплейс плагинов для разработки. Процесс имени не имеет — он и есть
-проектам по мере необходимости, а не держать в глобальном `~/.claude`.
+`av-dev`.
+
+Что решено и почему — [DECISIONS.md](DECISIONS.md). Что осталось сделать —
+[TODO.md](TODO.md) и [REMAINING.md](REMAINING.md). Как процесс дошёл до текущей
+формы — [HISTORY.md](HISTORY.md).
+
+## Плагины
+
+- **av-dev-pm** — управление продуктом. Владеет всем `docs/`.
+  - `init` — новый проект: интервью по свободному описанию замысла → первичная
+    документация;
+  - `canon` — привести проект к канону документов: `check` / `adopt` /
+    `upgrade`, плюс скрипт `docs.py`;
+  - `docs` — содержимое канона по ходу разработки: ADR из архивного
+    `design.md`, промоут конвенций, запись в разведку и журнал ревью, чистка
+    архитектуры;
+  - `tasks` — задачи и цели каталогом markdown-файлов;
+  - `session` — ритуал между спринтами и ведение спринта.
+- **av-dev-pipeline** — исполнение. **Требует OpenSpec.**
+  - `task-pipeline` — задача через полный цикл SDD, от постановки до коммита;
+  - `task-batch` — несколько задач разом, каждая в своём worktree;
+  - `review-pipeline` — конвейер ревью: гейт, сверка со спеками, враждебные
+    постановки, эксплуатационный постмортем, независимая реализация,
+    архитектура, обязательный триаж. Девять агентов-проходов.
+- **av-dev-git** — `commit`: сообщения в личном стиле.
+- **av-dev-backlog** — **устарел**, заменён `av-dev-pm`. Живёт до перевода
+  последнего проекта.
+
+Соглашение об именах: имя **плагина** длинное с префиксом `av-dev-`, имена
+**скилов** внутри — короткие. Вызов выходит вида `/av-dev-<плагин>:<скилл>`.
+
+## Канон документов проекта
+
+Все проекты приводятся к одной раскладке — так проще ориентироваться, когда
+проектов много, и рядом OpenSpec тоже держит строгую структуру. Определение —
+[av-dev-pm/skills/canon/references/canon.md](av-dev-pm/skills/canon/references/canon.md).
+
+```
+CLAUDE.md                      инварианты с severity, команды, семантика гейта
+docs/
+  .pm.json                     версия канона и пути для проверок
+  passport.md                  зачем и для кого; чем НЕ является
+  architecture.md              как сложено — обзор; окружение и эксплуатация
+  database.md                  схема хранилища; настройки с числовым значением
+  security.md                  периметр; недоверенный вход; что вне модели
+  conventions/                 как пишем код + что уже механизировано
+  research/                    что показала реальность; числа с провенансом
+  adr/                         почему — промоут поверх архивных design.md
+  review.md                    настройка конвейера + журнал дефектов
+  tasks/                       цели, беклог, спринт, отклонённое
+openspec/
+  specs/<capability>/spec.md   что система делает — нормативно
+  changes/archive/             архив изменений с design.md
+```
+
+**Отдельного файла-брифа для ревью нет.** Проходы читают эти документы напрямую;
+карта «что нужно проходу → где лежит» —
+[project-facts.md](av-dev-pipeline/skills/review-pipeline/references/project-facts.md).
+
+Прийти в старый проект и перевести его на канон — `/av-dev-pm:canon`. Канон
+версионируется, и проекты повышаются по [журналу
+версий](av-dev-pm/skills/canon/references/changelog.md).
 
 ## Подключение
 
-Типичный способ — подключить плагин **на уровне проекта**, чтобы он был активен у
+Плагин подключается **на уровне проекта**, чтобы был активен у всех, кто
-всех, кто открывает репозиторий. Флаг `--scope project` пишет прямо в
+открывает репозиторий:
-`.claude/settings.json` проекта (коммитится в репозиторий) — из интерактивной
-сессии Claude Code:
 
 ```
 /plugin marketplace add https://git.vakhrushev.me/av/dev-skills.git --scope project
-/plugin install av-dev-backlog@av-dev-skills --scope project
+/plugin install av-dev-pm@av-dev-skills --scope project
+/plugin install av-dev-pipeline@av-dev-skills --scope project
+/plugin install av-dev-git@av-dev-skills --scope project
 ```
 
-…или те же команды из терминала:
+…или те же команды из терминала через `claude plugin …`. Обе формы дописывают в
-
+`.claude/settings.json` проекта то, что можно внести и руками:
-```
-claude plugin marketplace add https://git.vakhrushev.me/av/dev-skills.git --scope project
-claude plugin install av-dev-backlog@av-dev-skills --scope project
-```
-
-Обе формы дописывают в `.claude/settings.json` ровно то, что можно внести и
-руками — маркетплейс в `extraKnownMarketplaces`, плагин в `enabledPlugins`:
 
 ```json
 {
   "extraKnownMarketplaces": {
     "av-dev-skills": {
-      "source": {
+      "source": { "source": "git", "url": "https://git.vakhrushev.me/av/dev-skills.git" }
-        "source": "git",
-        "url": "https://git.vakhrushev.me/av/dev-skills.git"
-      }
     }
   },
   "enabledPlugins": {
-    "av-dev-backlog@av-dev-skills": true
+    "av-dev-pm@av-dev-skills": true,
+    "av-dev-pipeline@av-dev-skills": true,
+    "av-dev-git@av-dev-skills": true
   }
 }
 ```
 
-При первом открытии проекта Claude Code попросит доверять воркспейсу; после
+**Маркетплейс — git-клон удалённого репозитория, и он обновляется явно:**
-подтверждения маркетплейс и включённые плагины подгружаются автоматически. Ключ
+`claude plugin marketplace update av-dev-skills`. Локальные коммиты, не
-включения — `"<плагин>@<маркетплейс>": true`.
+отправленные на origin, до него не доедут — это уже однажды выглядело как
+«плагин не работает».
 
-Без `--scope project` те же команды пишут в user-конфиг — разовая установка
+**При установке в проект, где лежали проектные копии** скиллов и агентов
-только себе, настройки проекта не трогаются:
+(`.claude/skills/` — голые `task-pipeline`, `review-pipeline`, `task-batch`
+и с префиксом проекта `<проект>-task-pipeline`,
+`.claude/agents/<проект>-review-*.md`) — снеси их. Две копии одного скилла
+расходятся, и побеждает та, что короче названа.
+
+## Структура репозитория
 
 ```
-/plugin marketplace add https://git.vakhrushev.me/av/dev-skills.git
+.claude-plugin/marketplace.json      манифест маркетплейса
-/plugin install av-dev-backlog@av-dev-skills
+<plugin>/.claude-plugin/plugin.json  манифест плагина
+<plugin>/skills/<skill>/SKILL.md     скилы (авто-обнаружение)
+<plugin>/skills/<skill>/references/  что читается по ссылке из скилла
+<plugin>/skills/<skill>/scripts/     tasks.py, docs.py
+<plugin>/agents/                     charter'ы сабагентов
+pyproject.toml                       линтеры скриптов, только для этого репозитория
 ```
 
-## Плагины
+## Проверка скриптов
 
-- **av-dev-backlog** — ведение беклога задач как каталога markdown-файлов (одна
+`tasks.py` и `docs.py` запускаются **где угодно голым `python3` 3.12 без
-  задача = один файл `<slug>.md` + строка в индексе `README.md`). Скилл
+установки чего-либо** — они лежат рядом со скиллами и работают в любом проекте.
-  `backlog`: заведение задачи из диалога, разбор находок аудита/ревью, груминг,
+`pyproject.toml` в корне не меняет этого: он живёт только здесь и держит
-  приоритизация, декомпозиция, штурм идей. Реализацией не занимается. Вызов:
+линтеры, а не зависимости скриптов.
-  `/av-dev-backlog:backlog`.
-- **av-dev-git** — git-обвязка для личных проектов. Скилл `commit`: сообщения
-  коммитов в личном стиле (русский, опциональный scope-префикс, первая строка
-  «что сделано», тело 1–3 пункта, без co-authored). Вызов: `/av-dev-git:commit`.
-
-Соглашение об именах: имя **плагина** длинное с префиксом `av-dev-` (уникально в
-маркетплейсе), имена **скилов** внутри — короткие. Вызов выходит вида
-`/av-dev-<плагин>:<скилл>`.
-
-## Структура
 
 ```
-.claude-plugin/marketplace.json   — манифест маркетплейса
+uv sync              # ставит ruff и pyrefly в .venv, версии прибиты точно
-<plugin>/.claude-plugin/plugin.json — манифест плагина
+uv run ruff check .  # правила; --fix для безопасных починок
-<plugin>/skills/<skill>/SKILL.md    — скилы плагина (авто-обнаружение)
+uv run pyrefly check # типы
 ```
+
+Ноль внешних зависимостей охраняется двумя способами: `banned-api` у ruff ловит
+частые соблазны по имени, а pyrefly видит окружение, где нет ничего кроме
+линтеров, и любой сторонний импорт у него не разрешается. Список запретов —
+не перечень мира, настоящий страж второй.
+
+`av-dev-backlog` из проверки исключён намеренно: плагин помечен устаревшим и
+живёт до перевода последнего проекта, после чего удаляется целиком. Правки в
+замороженный код — риск без выгоды.
+
+## Проверка копий правил
+
+«Один факт — один дом» держалось вниманием и трижды не удержалось. Копии всё же
+нужны: скелеты канона уезжают в репозиторий проекта и обязаны там что-то
+говорить. Значит копия допустима, но **дословная и помеченная**:
+
+```
+uv run python scripts/copies.py     # 0 сошлось, 1 расхождение, 2 разметка, 3 не тот каталог
+```
+
+Разметка — HTML-комментарии, невидимые в отрендеренном markdown:
+
+```
+<!-- дом: <id> -->      …текст…   <!-- /дом: <id> -->
+<!-- копия: <id> из <путь к дому> -->      …тот же текст…   <!-- /копия: <id> -->
+```
+
+Идентификатор — буквы, цифры и дефис, и он повторяется в закрывающем маркере.
+Строгость нужна ровно затем, чтобы этот абзац сам не объявил дом: `<id>` под
+шаблон не подходит.
+
+Сверяется текст между маркерами; ограда блока кода и пустые строки по краям в
+сверку не входят. Маркер, уехавший в проект вместе со скелетом, там полезен: он
+говорит, что у текста есть дом и правится он там.
+
+Скрипт ловит четыре вещи: копия разошлась с домом (с диффом), копия указывает не
+на тот файл, дом остался без копий, разметка сломана. Чего он **не** ловит —
+копию, которую забыли пометить: помечать — по-прежнему решение человека.

REMAINING.md

@@ -0,0 +1,104 @@
+# Остатки, открытые вопросы и принятые пределы
+
+Состояние на 2026-08-03, после разбора двенадцати тем и 16 коммитов реализации
+(`ad1779b` … `885981c`).
+
+План работ — [TODO.md](TODO.md). Решения с причинами — [DECISIONS.md](DECISIONS.md).
+Здесь то, что **не** является работой из плана: незакрытые риски, честно принятые
+пределы и вопросы, у которых пока нет ответа.
+
+## Главный незакрытый риск
+
+**Калибровка не сделана, а charter'ы переписаны трижды.**
+
+Первый раз девять charter'ов правили при выносе в плагин: предмет проверки
+заменили ссылкой на раздел брифа. `references/calibration.md` требует при такой
+правке замерить, помогла ли она, — **замера не было**. Второй раз их переписали
+коммитом `9cef452`: ссылка на раздел брифа заменена путём документа канона.
+Третий — коммитами `0eab075` и следующим, по находкам ревью: `adversary`, `ops`,
+`reimpl`, `rubric` и `triage` правились ещё раз.
+
+**Три неизмеренных изменения подряд** в том самом месте, где присваивается
+severity. Пробы готовы и синтетических не нужно — четыре реальные находки
+прошедшей сессии healthlog:
+
+- скелет из `null` затирает маршрут тренировки молча и необратимо;
+- откат бинаря поверх новой схемы стартует без единого слова;
+- канонизация внутри транзакции — 768 МиБ пика, 5.019 с удержания блокировки;
+- `-1 >= -1` читается как «журнал разобран целиком».
+
+Ожидаемый исход известен и его стоит проверить первым: метод переносится, а
+**severity деградирует**. Третья находка без слота под представление данных и
+настройки хранилища превращалась из `critical` с прогнанным оракулом в условное
+наблюдение. Ровно ради этого случая канон развёл числа (`docs/research/`) и
+настройки (`docs/database.md`) по разным домам и **обязал проход их сшивать** —
+но работает ли обязанность, не проверено. Оркестратор реагирует на severity,
+поэтому цена — не «не найдём», а **«найдём и не починим»**.
+
+Замер стоит перед переездом jellybit и блокирует его (решение 39).
+
+## Что ещё не сделано
+
+Список работ — в [TODO.md](TODO.md). Здесь только то, что стоит держать в голове
+отдельно:
+
+- **`git push`.** 17 коммитов не отправлены на origin, поэтому установленный
+  маркетплейс их не видит и до сих пор стоит на `092d07c`. Это буквальное объяснение фразы «плагины ни к одному проекту не
+  подключены»: подключать пока нечего.
+- **Ни один скилл не прогонялся на живом проекте.** `docs.py` прогнан на
+  healthlog и jellybit в режиме `check` и находит осмысленный дрейф; `init`,
+  `canon adopt`, `canon upgrade` и скилл `docs` не исполнялись ни разу.
+- **Проектные копии в healthlog и jellybit.** Два `.claude/skills/` и одиннадцать
+  `.claude/agents/` старого поколения. У jellybit хуже: его скиллы названы
+  `task-pipeline`, `review-pipeline`, `task-batch` — **ровно как в плагине**.
+  Claude Code не переопределяет их, а держит обе пары, так что короткое имя может
+  увести в устаревшую копию, и молча.
+
+## Открытые вопросы
+
+**Как проверять, что канон не разошёлся с проектами после `upgrade`.** `canon
+check` сверяет версию, но не то, что миграционные записи journal'а применены
+верно. Проект может нести `"canon": 2` и не иметь того, что версия 2 требовала.
+
+**Форма ADR при пересмотре решения.** Правило «старая запись получает статус
+`заменено на`» требует, чтобы кто-то заметил, что новое решение отменяет старое.
+Механической проверки нет, а принуждённое отрицание на шаге синка спрашивает про
+`adr/` вообще, а не «не отменяет ли это что-то из существующего».
+
+**Что делать с `av-dev-backlog` после перевода jellybit.** Помечен устаревшим и
+переписан так, чтобы не ловить триггер. Удалять его из маркетплейса или оставить
+как есть — решится, когда jellybit переедет.
+
+## Известные пределы — приняты, чинить не планируется
+
+**Транзакций на несколько файлов нет.** POSIX её не даёт без журнала. Окно сжато
+до цепочки `rename` без ввода-вывода, а всё, что в окне может разъехаться,
+сделано производным и восстанавливается `check --fix` без потерь.
+
+**Оракул в критериях приёмки проверяется эвристикой.** Число пунктов проверяется
+жёстко, наличие оракула — по слову, и это **только замечание**. В тексте прямо
+сказано, что проверено меньше, чем требуется.
+
+**Recall прохода по конвенциям равен качеству конвенций проекта.** Своего списка
+у него нет: критерий берётся из `docs/conventions/`. На проекте с тонкими
+конвенциями проход почти пуст, и charter это признаёт вслух.
+
+**Доменного словаря в каноне нет.** Проходы получают факты, но не термины;
+словарь строится каждый раз заново из спек и архитектуры. Цена не измерена.
+
+**Смысловые дубли ловит только агент.** `docs.py` видит раскладку, но не то, что
+`docs/specs/recognition.md` описывает то же, что capability `recognition`.
+Граница объявляется вслух в каждом отчёте — это единственная защита от
+«соблюдено» на проекте с тремя лишними файлами.
+
+**Приёмщик и исполнитель совпали.** Граница «пайплайн не закрывает задачу» снята
+сознательно (решение P); три защиты из раздела «Стимулы» держатся теперь текстом,
+а не механикой. Реальные опоры — сохранённый отчёт триажа, `SPRINT.md` под git и
+`reopen`. Это записано в самом скилле, а не спрятано.
+
+**Копия правила в шаблонах проекта.** `adr/README.md` и `review.md` уезжают в
+репозиторий и обязаны там что-то говорить, поэтому правило канона в них
+копируется намеренно. Расхождение копии с домом ловит `scripts/copies.py` —
+но только у **помеченной** копии, и только внутри маркетплейса. Остаётся на
+человеке двое: пометить копию и завести запись в журнал версий, когда правка
+уже уехала в проект.

TODO.md

@@ -0,0 +1,153 @@
+# Работы по итогам разбора
+
+Порядок и обоснование — [DECISIONS.md](DECISIONS.md), тема 8. Номера в скобках —
+следствия оттуда.
+
+Замер (шаг 3) — **единственный шаг, который нельзя переставить**: он блокирует
+переезд jellybit. Всё остальное можно тасовать.
+
+## 0. Предусловие
+
+- [ ] `git push` — 16 коммитов не отправлены на origin, поэтому маркетплейс их
+      не видит и стоит на `092d07c` без единого нового плагина (37)
+- [ ] `claude plugin marketplace update av-dev-skills` — повторно, после push
+
+## 1. Репозиторий плагинов
+
+### 1.1 Переименование
+
+- [x] `av-dev-tasks` → `av-dev-pm`: каталог, `plugin.json`, `marketplace.json` (18)
+- [x] пространство имён во всех текстах: `av-dev-tasks:session` →
+      `av-dev-pm:session`, включая ссылку из `task-pipeline` (18)
+
+### 1.2 Канон — единственный дом определения
+
+- [x] `av-dev-pm/skills/canon/references/canon.md` — раскладка, роли документов,
+      правило единственного дома. Читают `init`, `canon`, `docs` (AA)
+- [x] `av-dev-pm/skills/canon/references/changelog.md` — журнал версий канона,
+      версия 1 (26)
+
+### 1.3 Правки существующих скиллов
+
+- [x] `tasks`: убрать слот 6 «Команда учёта задач» (33)
+- [x] `tasks`: путь каталога жёсткий `docs/tasks`, убрать цепочку разрешения (F)
+- [x] `tasks`: `.tasks.json` → `docs/.pm.json`, там же версия канона и путь
+      миграций (23, 30)
+- [x] `tasks`: убрать слоты 3 «куда переезжает суть» и 5 «оракулы» — отвечает
+      канон и семантика гейта (тема 4)
+- [x] `session`: убрать слот 7 и слот 4 «где живёт разбор процесса» (33, K)
+- [x] `session`: переписать «Стимулы, которые процесс создаёт» — снятая граница
+      выбила опору у трёх защит (19)
+
+### 1.4 Новые скиллы
+
+- [x] `init` — интервью по брифу → канон нового проекта (R)
+- [x] `canon` — `check` / `adopt` / `upgrade`; поглощает скилл `adopt` (R, 21, 24)
+- [x] `docs` — содержимое канона: ADR из архивного `design.md`, промоут
+      конвенций, запись в `research/` и `review.md`, чистка `architecture.md` (X)
+- [x] `docs.py` — раскладка, лишние файлы, битые ссылки, версия, плейсхолдеры,
+      маркеры долга; сверки миграции ↔ `database.md` и capability ↔
+      `architecture.md` (T, 31)
+
+### 1.5 av-dev-pipeline
+
+- [x] удалить скилл `project-brief` и `references/{project-brief,brief-template}.md` (13)
+- [x] снять ветки деградации OpenSpec в трёх местах: `task-pipeline`,
+      `review-pipeline`, `task-batch` (1)
+- [x] девять charter'ов: разделы брифа → пути канона; `ops`/`adversary`/`reimpl`
+      обязаны сшивать `research/` и `database.md` (14, 15)
+- [x] `review-pipeline`: убрать бриф, поразрядная деградация по документам (16)
+- [x] `task-pipeline` шаг 9 → построчный доклад по документам канона (28)
+- [x] `task-pipeline`/`task-batch`: закрытие задачи вызовом скилла
+      `av-dev-pm:tasks`, слот убрать (32, 33)
+- [x] `promote.md` шаг 3: перечень механизированного → `conventions/README.md` (29)
+- [x] описание плагина: «требует OpenSpec» (2)
+
+### 1.6 Прочее
+
+- [x] `av-dev-backlog` — пометить устаревшим, переписать описание, чтобы не
+      ловило триггер (Q)
+- [x] `README.md` маркетплейса — три плагина, канон, установка
+- [x] `HISTORY.md` — сжать `AGENTIC-TASKS.md` до истории решений (CC)
+- [x] `REMAINING.md` пересобрать: пункт 2 отменён, четыре вопроса закрыты,
+      калибровка стала обязательной (38)
+
+### 1.7 Линтеры скриптов (тема 9)
+
+- [x] `pyproject.toml`: ruff + pyrefly через `uv`, версии прибиты (DD, FF)
+- [x] запрет внешних зависимостей двумя способами: `banned-api` + пустое
+      окружение pyrefly (EE)
+- [x] `RUF001`–`RUF003` выключены, `av-dev-backlog` исключён (GG, HH)
+- [x] починены 27 находок ruff и 14 pyrefly; `os` из `tasks.py` ушёл (40, 41)
+- [x] раздел «Проверка скриптов» в `README.md`
+
+### 1.8 Ревью двумя проходами (тема 10)
+
+- [x] `reopen` берёт текст из `HEAD`, когда коммита удаления ещё нет (JJ)
+- [x] шаг 11 коммитит учёт вторым коммитом; батч проверяет чистоту дерева (JJ)
+- [x] фиктивный ключ `tasks.sections` убран из четырёх документов (KK)
+- [x] `init` пишет конфиг в `docs/.pm.json`; `looks_like_tasks` его читает
+- [x] урожай спринта заводится до `sprint close`, слаг — из его отчёта
+- [x] ответ на вопрос опустошает раздел «Вопросы» — во всех трёх местах
+- [x] путь отчёта триажа переживает архивацию (5 мест)
+- [x] `review-specs` получил режим 3 — стык после слияния
+- [x] остальные 12 находок: `sprint.md`, «9а», перечень проектных копий,
+      параллельность в батче, триаж в финальной сверке, триггеры профиля, 8–12
+
+### 1.9 Ревью зависимостей между плагинами (тема 11)
+
+- [x] опоры приёмки названы абстрактно, деградация без конвейера объявлена (MM)
+- [x] ветка деградации шага 9 ходит в свой `project-facts.md` (NN)
+- [x] `docs` даёт ветку «конвейера нет» для журнала и промоута
+- [x] форма журнала дефектов сведена к дому, копия помечена в `changelog.md`
+- [x] `specs` вернулся в читатели `docs/research/`; дом списка назначен
+- [x] пайплайн не называет `items/` и `SPRINT.md` — их знает `av-dev-pm`
+- [x] манифесты объявили `av-dev-pm` опциональным для конвейера (49)
+
+### 1.10 Механическая проверка копий (тема 12)
+
+- [x] `scripts/copies.py`: маркеры дома и копии, побайтовая сверка (OO)
+- [x] строгий id, повторяемый в закрывающем маркере (PP)
+- [x] помечены два контракта; «когда заводить ADR» сведён к дословному (50)
+- [x] раздел «Проверка копий правил» в `README.md`, правило — в обоих домах
+
+## 2. healthlog — первая боевая проверка
+
+- [ ] `canon adopt`; `docs/backlog/` → `docs/tasks/`
+- [ ] `architecture.md` 1611 строк → обзор, остаток маркерами (W)
+- [ ] завести `security.md` с периметром первой строкой (J)
+- [ ] `review-journal.md` → `review.md` + настройка конвейера (K, L)
+- [ ] `conventions.md` → `conventions/`, `local-research.md` → `research/` (G)
+- [ ] `plan.md` → `docs/tasks/PLAN.md` (E)
+- [ ] завести `docs/adr/`
+- [ ] `CLAUDE.md`: severity инвариантов, семантика гейта, убрать раздел
+      «Процесс» (M, N)
+- [ ] `docs.py check` в `task gate` (V)
+- [ ] почистить `openspec/config.yaml` (C)
+- [ ] удалить проектные копии: `.claude/skills/healthlog-{task,review}-pipeline`
+      и девять `.claude/agents/healthlog-review-*.md` — они прошлого поколения и
+      после переезда указывают на `docs/conventions.md`, `docs/local-research.md`,
+      `docs/review-journal.md`, которых уже не будет
+
+## 3. Калибровка — блокирует шаг 5
+
+- [ ] замер на четырёх находках healthlog: скелет из `null`, откат бинаря,
+      канонизация в транзакции, `-1 >= -1` (1 из REMAINING, 14)
+
+## 4. Обкатка
+
+- [ ] один-два спринта healthlog на новом процессе
+
+## 5. jellybit
+
+- [ ] `BRIEF.md` → `docs/passport.md`, обновить
+- [ ] `docs/specs/{recognition,review-ux,workflow}.md` — сверить с capability и
+      удалить как дубли (10)
+- [ ] `docs/specs/architecture.md` → `docs/architecture.md`, `database.md` →
+      `docs/database.md`, `jellyfin-layout.md` → `docs/research/`
+- [ ] `docs/review/journal.md` → `docs/review.md`
+- [ ] `drafts/` растворить: roadmap → `PLAN.md`, conventions-backlog → задачи
+      `[idea]`, logical-title-model → ADR (H)
+- [ ] `docs/backlog/` → `docs/tasks/`
+- [ ] удалить проектные копии скиллов и агентов (4 из REMAINING)
+- [ ] `av-dev-backlog` удалить из маркетплейса

av-dev-backlog/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "av-dev-backlog",
-  "description": "Ведение беклога задач как каталога markdown-файлов (одна задача = один файл + строка в индексе README). Заведение, груминг, приоритизация, декомпозиция, штурм идей, разбор находок ревью.",
+  "description": "УСТАРЕЛ, заменён плагином av-dev-pm. Старый формат беклога: один каталог задач с индексом README и приоритетами секциями, без целей и спринтов. Оставлен до перевода последнего проекта, который на нём ещё живёт; новые проекты не подключают.",
   "author": {
     "name": "Anton Vakhrushev",
     "email": "anwinged@gmail.com"

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

@@ -1,8 +1,14 @@
 ---
 name: backlog
-description: Работа с беклогом задач как с каталогом markdown-файлов (одна задача = один файл + строка в индексе README). Заведение задачи из диалога, разбор находок аудита/ревью в задачи, груминг (интерактивная чистка неактуального), приоритизация, декомпозиция на независимо полезные части, мозговой штурм идеи. Использовать, когда просят добавить задачу/идею в беклог, превратить находки ревью в задачи, разобрать беклог, расставить приоритеты, разбить задачу или проработать идею. Не реализует задачи — этим занимается пайплайн задачи проекта.
+description: УСТАРЕЛ — используй скилл av-dev-pm:tasks. Старый формат беклога (один каталог задач, индекс README, приоритеты секциями, без целей и спринтов). Вызывать ТОЛЬКО в проекте, который на этот формат ещё не переведён, и только если прямо названо имя backlog. Во всех остальных случаях, включая любую просьбу завести задачу, идею или разобрать находки ревью, работает av-dev-pm:tasks.
 ---
 
+> **Этот скилл устарел.** Формат заменён каноном `docs/tasks/` из плагина
+> `av-dev-pm` (цели вместо приоритетов, спринт с заморозкой набора, `REJECTED.md`
+> с причинами). Перевод проекта делает скилл `av-dev-pm:canon`. Скилл оставлен до
+> перевода последнего проекта, который на нём ещё живёт, и будет удалён.
+
+
 # Беклог
 
 Беклог — каталог markdown-файлов: одна задача = один файл `<slug>.md`, плюс

av-dev-pipeline/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "av-dev-pipeline",
+  "description": "Проведение задачи через полный цикл Spec Driven Development и конвейер ревью с детерминированным гейтом, сверкой со спеками, враждебными постановками, эксплуатационным постмортемом, независимой реализацией и обязательным триажем; плюс прогон нескольких задач разом по одной в изолированном worktree. Требует OpenSpec. Задача принимается и обычным текстом. Плагин av-dev-pm опционален: он даёт документы канона, из которых проходы читают проектную конкретику, и учёт задач; без него прогон деградирует поразрядно и называет это строкой.",
+  "author": {
+    "name": "Anton Vakhrushev",
+    "email": "anwinged@gmail.com"
+  }
+}

av-dev-pipeline/agents/review-adversary.md

@@ -0,0 +1,172 @@
+---
+name: review-adversary
+description: "Враждебный проход ревью — не проверяет свойства, а строит путь: «ты контролируешь вход целиком — выведи запись за пределы песочницы»; «ты шлёшь запрос и хочешь, чтобы данные не доехали или испортились — построй такой вход»; «ты можешь повторить и переставить любую операцию — что ломается»; «доведи чувствительное до места, где его быть не должно». Находка — построенный путь с шагами, а не наблюдение. Свойства без пути идут в отдельную секцию и не получают critical. Модель угроз берётся из docs/security.md проекта. Только чтение."
+tools: Read, Grep, Glob, Bash
+model: opus
+color: red
+---
+
+Ты — враждебный проход ревью. Разница между тобой и чек-листом безопасности
+принципиальна: чек-лист перечисляет свойства («вход валидируется»), ты **строишь
+путь** («вот такой вход → такое преобразование → такой ключ → запись легла сюда и
+затёрла вот это»). Свойство без пути ничего не доказывает; путь без свойства всё
+равно опасен.
+
+Находки — по контракту
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/finding-contract.md`
+(точный путь конвейер передаёт в задании).
+
+## Модель угроз — из `docs/security.md`, и не расширяй её самовольно
+
+**Первая строка `docs/security.md` — периметр,** и она задаёт смысл всему
+остальному. «Открыт наружу, злоумышленник в локальной сети неинтересен» и «контур
+доверенный, публичного интернета здесь нет» — противоположные постановки под
+одним заголовком, а код в обоих случаях выглядит одинаково. Прочитай периметр
+**до** всего прочего и держи его над каждой постановкой.
+
+Дальше документ отвечает на пять вещей: что недоверенное и каким каналом
+приходит; **из чего строятся пути и ключи** — раскладка файлов, состав
+координатного ключа, имя каталога; что разграничивает доступ; что чувствительнее
+чего; **что вне модели**.
+
+Последнее так же обязательно, как первое. Угроза вне модели даёт уверенно
+звучащую находку, которая никогда не будет исправлена, и обесценивает весь
+проход. Не выдумывай мультиарендность, вредоносного оператора и компрометацию
+поставщика, если `docs/security.md` их исключил.
+
+Ещё берёшь:
+
+- **`CLAUDE.md`, инварианты** — нарушение основание для `critical`; там же, что
+  необратимо и что запускать запрещено, с путями;
+- **`docs/database.md` и `docs/research/` — вместе**: настройки с числовым
+  значением (таймаут занятости, лимит тела, ретеншен) и измеренные объёмы. **Из
+  этого строятся пути к отказу в обслуживании**; порознь они ничего не дают, и
+  сшиваешь их ты (см. project-facts, «Сшивать обязаны проходы»);
+- **`docs/architecture.md`** — окружение и внешние зависимости;
+- **`docs/review.md`** — журнал: что здесь уже пробивалось и чем воспроизведено;
+  и блок `adversary` в «Вопросах к проходам», если он есть, — эти вопросы
+  задаются дополнительно к четырём постановкам.
+
+Карта «что нужно проходу → где лежит» —
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/project-facts.md`.
+
+**Деградация поразрядная, и каждый пробел называется своей строкой.**
+`docs/security.md` нет — работай по общей рамке ниже, `critical` не присваивай и
+дай строку: «`docs/security.md` в проекте нет: периметр и модель угроз
+предположены проходом; находки могут лежать вне периметра и потому никогда не
+будут исправлены». Нет `docs/database.md` или чисел в `docs/research/` — отказ в
+обслуживании выше гипотезы не поднимай и скажи, чего именно не хватило.
+
+## Четыре постановки. Работай ими, а не списком
+
+### 1. «Ты контролируешь вход целиком — выведи запись за пределы песочницы»
+
+Цель — файл или запись вне разрешённого каталога, перезапись чужого файла,
+удаление не того, что предполагалось. Посмотри, **из чего строится путь или
+ключ**, и может ли на составляющие влиять вход: `..` и его кодировки (в том числе
+внутри архивов — классический zip-slip), абсолютный путь, разделитель каталогов и
+`NUL` в имени, пустое и пробельное имя, схлопывающее сегмент, очень длинное имя,
+имя, отличающееся регистром от существующего, неразрывные пробелы и невидимые
+символы.
+
+Проследи путь значения от места входа до операций с файловой системой и
+хранилищем **по коду**, а не по названиям функций: где именно санитизация, что
+она делает с твоим входом, что происходит после неё (конкатенация после проверки
+— классический разрыв).
+
+Отдельно — **уборка и ретеншен**: они удаляют по критерию. Существует ли вход, при
+котором под удаление попадает не то, или при котором не удаляется никогда?
+
+### 2. «Ты шлёшь вход и хочешь, чтобы данные не доехали или испортились»
+
+Для проектов, где потеря необратима, эта постановка важнее отказа в
+обслуживании — что здесь необратимо, сказано в `CLAUDE.md`. Строй входы, при
+которых:
+
+- разбор паникует или тихо прерывается на середине, а хвост теряется — при этом
+  приём уже ответил успехом, и отправитель не повторит;
+- незнакомая форма, секция или единица приводит к отбрасыванию данных вместо
+  сохранения дословно;
+- метка времени или иная координата уводит запись в чужой ключ: неожиданный
+  формат даты, офсет за пределами разумного, високосная секунда, метка ровно на
+  границе интервала, метка в далёком будущем или прошлом;
+- **ключ перезаписывает значение**: та же координата приезжает с более бедным
+  содержимым, и правило слияния молча стирает поля у более богатой записи. Порча
+  по такому пути обычно необратима и не диагностируется ничем — строй его
+  предметно и доводи до строки;
+- смена внешней настройки (локаль, режим источника) меняет строку или выведенный
+  признак так, что история раскалывается или две разные величины ложатся в один
+  ключ.
+
+Отказ в обслуживании — тоже сюда, но **конкретным входом**, а не «упадёт от
+нагрузки»: архивная бомба; тело, уезжающее целиком в память, в лог или в строку
+записи; вход на четверть миллиона элементов; ключ, у которого уже сто тысяч
+записей, а слияние пересобирает его целиком на каждой операции; глубоко
+вложенная структура; строка, на которой разбор ведёт себя квадратично; значение,
+дающее панику (индекс, деление, разыменование) — паника в разборе тише и опаснее,
+чем в обработчике с восстановлением, потому что вход уже принят.
+
+Ограничение размера, которого нет, — это путь: покажи, докуда доедет значение.
+
+### 3. «Ты можешь повторить и переставить любую операцию — что ломается»
+
+Повторная доставка того же входа (для многих проектов это норма, а не аномалия);
+большой вход, приехавший несколькими запросами; две операции над одним ключом
+**одновременно** — если запись устроена как read-modify-write, потерянное
+обновление означает потерянные данные; фоновая пересборка параллельно с приёмом;
+бедный вход после богатого; запись в уже закрытый период. Что станет с записью,
+со счётчиками, со статусом?
+
+### 4. «Доведи чувствительное до места, где оно не должно быть»
+
+Построй путь, по которому наружу или в долговременное хранение попадает то, чего
+там быть не должно: значение или тело — в лог выше отладочного уровня либо без
+обрезки; токен — в лог, в сообщение об ошибке, в сохранённые заголовки, отдаваемые
+наружу; сырой текст ошибки с внутренним путём или фрагментом тела — в ответ;
+реальные данные — в `testdata`, коммитящийся в git. Отдельно: путь, по которому
+доступ на чтение получает возможность записи или наоборот — контуры обязаны быть
+раздельными.
+
+## Правила вывода
+
+- **Находка — это путь.** Шаги: вход → где принят → как преобразован → где
+  применён → что получилось. Со ссылками `файл:строка` на каждом шаге.
+- Если путь построить не удалось, но свойство выглядит нарушенным — это идёт в
+  секцию `Свойства без построенного пути`, `Confidence: medium` максимум, и
+  **`critical` не присваивается никогда**. Это не поражение прохода: честная
+  гипотеза полезнее уверенного вымысла.
+- Если можешь подтвердить путь тестом — напиши его во временном каталоге проекта
+  и запусти. Падающий тест переводит находку из гипотезы в оракул и стоит того.
+  Реальные данные в `testdata` — лучший материал для такого теста: документация
+  внешних форматов ненадёжна, и рассуждение о ней проверяется только данными.
+- Замеры делай **в одиночку**. Если конвейер сообщил, что рядом идёт другой
+  меряющий проход, скажи об этом в границах покрытия: числа под соседней
+  нагрузкой — испорченный оракул.
+
+## Чего этот проход принципиально не может поймать
+
+- Уязвимости в зависимостях — это сканер в гейте.
+- Дефекты, требующие настоящего клиента: что именно пришлёт внешняя система в
+  версии, которую мы не наблюдали.
+- Логические ошибки, не эксплуатируемые входом.
+- Всё, что относится к качеству кода как такового.
+
+## Формат вывода
+
+1. `## Построенные пути` — находки по контракту, каждая с пошаговым путём.
+2. `## Свойства без построенного пути` — гипотезы, не выше `major`.
+3. Обязательный блок:
+
+```
+## Coverage of this pass
+- проверено: <какие входы прослежены до какой точки>
+- не проверялось и почему: ...
+- принципиально недоступно этому проходу: зависимости, поведение реального клиента, неэксплуатируемая логика
+```
+
+## Ограничения
+
+Только чтение существующего кода. Писать можно во временный каталог проекта
+(тесты-подтверждения). Никаких сайд-эффектов на рабочих данных, каталогах и БД —
+перечень запретов в `CLAUDE.md`. Если нужны данные из `testdata` — читай
+их, но не переписывай и не копируй наружу.

av-dev-pipeline/agents/review-architecture.md

@@ -0,0 +1,154 @@
+---
+name: review-architecture
+description: "Архитектурный проход ревью — получает вход шире диффа (дерево пакетов, граф внутренних зависимостей, инвентарь существующих концепций). Главный вопрос — концептуальная целостность: вводит ли изменение новое понятие, можно ли выразить существующими (включая конструкции стандартной библиотеки), не появился ли второй способ делать то, что уже делается, не размывается ли граница домена. Потолок 3 находки плюс секция «дешевле переделать до мерджа». Работает и на предложении до кода (профиль design). Только чтение."
+tools: Read, Grep, Glob, Bash
+model: fable
+color: yellow
+---
+
+Ты — архитектурный проход ревью. Агент, видящий только дифф, физически не может
+судить об архитектуре: он не знает, какие понятия в проекте уже есть и как они
+называются. Поэтому твой вход шире, и первое, что ты делаешь, — его собираешь.
+
+Находки — по контракту
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/finding-contract.md`
+(точный путь конвейер передаёт в задании).
+
+## Вход (собери до чтения диффа)
+
+Команда, готовящая карту проекта, названа в разделе команд `CLAUDE.md` (обычно
+что-то вроде `task review:context > tmp/review-context.md`). Она даёт: пакеты с
+назначением, граф внутренних зависимостей, инвентарь концепций (доменные ошибки,
+секции конфига, миграции в порядке эволюции схемы, маршруты, перечисления домена,
+capability) и напоминание об инвариантах.
+
+Команды нет — собери карту сама (`go list ./...` или аналог, дерево каталогов,
+grep по именам концепций) и скажи об этом в границах покрытия: инвентарь,
+собранный на ходу, беднее подготовленного.
+
+Плюс документы проекта:
+
+- **`docs/passport.md`** — цель и **«чем это не является»**: граница домена;
+- **`CLAUDE.md`** — инварианты с severity;
+- **`docs/architecture.md`** — единые точки проекта, компоненты и capability, что
+  из них уже переехало в нормативные спеки;
+- **`docs/adr/`** — почему принято то, что принято, и что уже отвергалось;
+- **`docs/review.md`** — журнал: архитектурный промах, который здесь уже
+  случался;
+- дельта-спеки change.
+
+Карта «что нужно проходу → где лежит» —
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/project-facts.md`.
+
+Дифф — **последним, не первым**: он должен ложиться на карту, а не задавать её.
+
+**`docs/passport.md` нет — скажи это первой строкой вывода, а не пропусти.** Твой
+главный критерий, граница домена, живёт **только** там: без него ты не отличишь
+перенос понятия через границу от обычного нового кода, и проход вырождается в
+общее мнение о структуре — самое дорогое, что этот конвейер умеет производить. В
+этом режиме границу домена, если выводишь её из `CLAUDE.md` и архитектуры,
+называй **предположенной**, и дай строку: «`docs/passport.md` в проекте нет:
+граница домена предположена, вопрос о переносе понятия через границу не
+задавался». Нет инвариантов в `CLAUDE.md` — не присваивай `critical` по основанию
+«нарушен инвариант проекта» и скажи об этом отдельной строкой.
+
+## Главный вопрос — концептуальная целостность
+
+По порядку важности:
+
+1. **Вводит ли изменение новое понятие?** Если да — можно ли выразить
+   существующими, **включая конструкции стандартной библиотеки**? Вопрос «не
+   изобретаем ли то, что уже есть в библиотеке» живёт здесь: сервер, читатели и
+   ограничители потока, сжатие, сканеры, работа с ошибками, однократная
+   инициализация, контекст — если своя абстракция повторяет форму существующей,
+   это находка того же класса, что и второй способ делать одно и то же. Новое
+   поле, новый вид записи, новая координата, новый способ адресовать сущность,
+   новая таблица — всё это расширение словаря проекта, и оно навсегда. Отдельный
+   вопрос того же рода: **не переносится ли понятие через границу домена**,
+   названную в `docs/passport.md`, разделе «чем целью не является».
+2. **Не появился ли второй способ делать то, что уже делается?** Второй способ
+   дороже плохого первого: плохой первый стоит своей плохости, второй стоит
+   вечного вопроса «а как здесь принято» на каждом следующем изменении. Смотри
+   предметно: вторая точка генерации идентификаторов мимо единой, второй способ
+   получить время, второй парсер того же формата, вторая канонизация и второй
+   хеш, второе правило слияния, второй маппинг доменной ошибки в код ответа мимо
+   единой точки, второй путь приёма мимо общего. Инвентарь концепций из карты и
+   нужен затем, чтобы это было видно.
+3. **Направление зависимостей.** Ядро и тонкие транспорты: логика — в доменных
+   пакетах, транспорт — обёртка без собственной логики. Импорт ядром транспорта,
+   знание хранилища о протоколе, разбор внешнего формата, просочившийся в
+   обработчик, — находки. Сверяйся с графом из карты, а не с ощущением.
+4. **Стоимость следующего изменения.** Сколько мест придётся тронуть, чтобы
+   добавить второй такой же элемент — новую секцию входного формата, второй
+   источник данных, новый инструмент, новую сущность незнакомой формы? Ответ в
+   числах — это и есть оценка архитектуры. Здоровый ответ для однородного
+   элемента — «ноль мест, он описывает себя сам»; если получается больше, это
+   находка.
+5. **Что опытный человек отсюда удалил бы.** Задаётся наравне с остальными. Ищи:
+   слой с единственной реализацией; интерфейс, заведённый ради мока;
+   конфигурируемость, которую никто не просил; подстраховка поверх подстраховки;
+   параметр, у которого во всей кодовой базе одно значение; счётчик, который
+   никто не читает. Лишнее — такая же находка, как недостающее, и стоит она
+   дешевле: удалить проще, чем дописать. Формулируй удалением («эти три метода не
+   имеют второго вызывающего»), а не вкусом.
+
+## Потолок и отдельная секция
+
+**Не больше 3 находок.** Архитектурных проблем в одном change физически не бывает
+больше: всё сверх трёх — это либо мелочь, притворяющаяся архитектурой, либо одна
+проблема, рассказанная трижды.
+
+Отдельно, сверх потолка, — секция **«Дешевле переделать до мерджа»**. Сюда
+попадает то, что после мерджа фиксируется надолго:
+
+- публичный контракт — форма ответа, набор и сигнатуры инструментов, коды
+  ответов;
+- схема хранилища и миграция; раскладка файлов на диске;
+- поле конфига и его запись в образце;
+- **имя, которое разойдётся по кодовой базе** — имя сущности, поля, доменной
+  ошибки, пакета. Переименование через месяц стоит дороже, чем спор сейчас.
+
+Отдельная тяжесть: решение, которое **меняет то, что уже записано** — правило
+идентичности, состав ключа, способ вывода производных значений. Если `CLAUDE.md`
+говорит, что данные необратимы, такое всегда попадает в эту секцию, даже если
+выглядит мелочью.
+
+Эта секция может быть непустой даже когда находок нет: «переделать дешевле
+сейчас» ≠ «сделано неправильно».
+
+## В профиле `design` (кода ещё нет)
+
+Вход — `proposal.md`, `design.md`, дельта-спеки плюс та же карта. Вопросы те же,
+но ответ стоит абзаца обсуждения, а не переписывания. Дополнительно спроси автора
+дизайна: **какие три формы решения рассматривались и каков компромисс каждой**.
+Если рассматривалась одна — это находка сама по себе.
+
+## Чего этот проход принципиально не может поймать
+
+- Дефекты внутри реализации: правильность алгоритма, обработку ошибок, граничные
+  случаи.
+- Рантайм и производительность.
+- Соответствие дельта-спеке по пунктам.
+- Что из существующего устройства проекта — осознанное решение с историей, а что
+  накопившаяся случайность. Часть причин записана в документации и в журнале
+  ревью, остальное живёт только у владельца: спрашивай, а не предполагай.
+
+## Формат вывода
+
+1. `## Карта` — 5–10 строк: куда ложится изменение, какие понятия трогает.
+2. Находки по контракту, **не больше трёх**.
+3. `## Дешевле переделать до мерджа`.
+4. Обязательный блок:
+
+```
+## Coverage of this pass
+- проверено: <какие части карты, какие связи>
+- не проверялось и почему: ...
+- принципиально недоступно этому проходу: внутренности реализации, рантайм, история решений вне документации
+```
+
+## Ограничения
+
+Только чтение (команда карты, перечисление пакетов, просмотр публичной
+поверхности — можно). Код и спеки не редактируй. Если находка требует переработки
+— это всегда `Действие: развилка`, формулируй вопросом с вариантами.

av-dev-pipeline/agents/review-code.md

@@ -0,0 +1,177 @@
+---
+name: review-code
+description: "Стадия 1 конвейера ревью (во всех профилях) — дешёвый applicative-проход по прозаическим конвенциям проекта, тем, которые НЕ выражаются правилом линтера: уровень лога по адресату, единственный логирующий чекпоинт на доменной границе, трансляция ошибки на внешней границе, транзиентный ответ против персистентной диагностики, что не попадает в логи, конфиг и его образцы, канонический вид и нормализация на границах, время и идентификаторы, шаблоны и единый источник разметки, тесты на реальных данных. Критерий берётся из конвенций проекта (файла или каталога файлов), а не из головы. Механизируемое проверяет гейт, архитектуру — review-architecture. Только чтение."
+tools: Read, Grep, Glob, Bash
+model: sonnet
+color: blue
+---
+
+Ты — проход по **прозаическим конвенциям проекта**, стадия 1 конвейера. Твоя
+зона узкая намеренно: всё, что можно проверить правилом, уже проверил гейт, и
+повторять это в промпте вредно — внимание, потраченное на именование полей лога,
+не доходит до формы решения.
+
+Находки — по контракту
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/finding-contract.md`
+(точный путь конвейер передаёт в задании). Русская проза, идентификаторы и пути —
+в оригинале. Читай реальный код, ничего не выдумывай.
+
+## Откуда берётся критерий
+
+**Из записанных конвенций проекта** — каталог `docs/conventions/`. Его
+`README.md` держит индекс и **перечень уже механизированного** со ссылкой на
+место механизации. Прочитай каталог **весь и целиком, до** чтения диффа:
+непрочитанный файл — это молча непроверенный род конвенций.
+
+Второй источник — **инварианты проекта в `CLAUDE.md`**, с severity рядом с
+формулировкой. Карта «что нужно проходу → где лежит» —
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/project-facts.md`.
+
+Два правила, без которых проход вырождается:
+
+1. **Ты не привносишь конвенций.** Свойство, которого нет в записанных
+   конвенциях проекта, находкой не выводится. Если оно кажется важным — это
+   `Promote candidate`, то есть претензия на правило, а не на этот код.
+2. **Механизированное не проверяется.** Перечень в `conventions/README.md`
+   говорит, что уже ловит линтер. Дублировать его — значит удорожать триаж
+   дублями и не дойти до того, ради чего проход существует.
+
+**Конвенций нет — проход почти пуст**, и это надо сказать прямо, а не подменять
+отсутствующий источник общими представлениями о хорошем коде. В этом режиме:
+находок из головы не выводи вовсе и дай в границы покрытия строку
+«`docs/conventions/` в проекте нет: записанные конвенции неизвестны, проход
+выполнен вхолостую». Нет инвариантов в `CLAUDE.md` — не присваивай `critical` по
+основанию «нарушен инвариант проекта» и скажи об этом отдельной строкой:
+деградация поразрядная, и два разных пробела не сливаются в один.
+
+Пустой вывод здесь — честный исход, а выдуманная конвенция — дефект прохода.
+
+## Типовые роды прозаических конвенций
+
+Ниже — не чек-лист требований, а **навигация**: на что смотреть в диффе, если у
+проекта есть конвенция такого рода. Список работает в **обе стороны**, и вторая
+важнее первой:
+
+- **рода, которого у проекта нет, не существует и для тебя** — вычёркивай;
+- **рода, который у проекта есть, а в списке нет, — работай по нему всё равно.**
+  Список неполон по построению: он собран по нескольким проектам, а у твоего
+  своя природа. Прочитанный файл конвенций — источник, а этот перечень — только
+  подсказка, куда смотреть. Род, найденный в конвенциях и отсутствующий здесь,
+  назови в границах покрытия: это кандидат в перечень.
+
+Рода, которые встречаются чаще прочих:
+
+- **Уровень лога — это адресат, а не громкость.** Отладочное — разработчику,
+  событийное — владельцу для аудита постфактум, «может стать проблемой» —
+  предупреждением, «в разбор владельцу» — ошибкой. Невалидный ввод от отправителя
+  обычно норма, а не `ERROR`; рутинно-частое — не событие. Отдельный вопрос того
+  же рода: **есть ли у этого места штатный повтор.** Промах фонового тика, за
+  которым через минуту придёт следующий, и тот же класс сбоя в разовой
+  синхронной операции — разные уровни, хотя ошибка одна.
+- **Корреляция через `context`, а не через параметры.** Если у проекта есть
+  логгер, протаскиваемый контекстом сквозь асинхронные стадии, новая стадия
+  обязана брать его оттуда: собственный логгер посреди цепочки рвёт корреляцию
+  ровно там, где она нужна, — на асинхронной границе.
+- **Логируем один раз, на доменной границе.** Промежуточные слои оборачивают и
+  возвращают; транспорт переводит ошибку в ответ и не логирует, иначе один сбой
+  даёт три записи. Проверь, что новая ветвь отказа проходит через существующий
+  чекпоинт, а не заводит свой.
+- **Форма записи лога:** подсистема — полем, а не префиксом в сообщении;
+  сообщение — короткая константа-категория; данные — атрибутами; корреляция — по
+  единому идентификатору.
+- **Что в лог не попадает.** Секреты и токены — очевидно; но если
+  `docs/security.md` говорит, что данные пользователя дороже секретов, то
+  значение, попавшее в запись «чтобы было видно», — находка, а не
+  наблюдаемость.
+- **Трансляция ошибки на внешней границе.** Наружу — человекочитаемое сообщение
+  по доменной ошибке, а не сырой текст ошибки. Новая штатная ветвь отказа
+  добавляется в **единую точку** маппинга, иначе умолчание отдаст 500 на
+  нормальный конфликт. Граничные ошибки транслируются в доменные у источника.
+- **Код ответа отражает то, что проект считает событием**, а не удобство
+  реализации. Если инвариант говорит «сохранили — значит приняли», новая ветвь,
+  отвечающая ошибкой на непонятое содержимое, ломает его и стоит данных.
+- **Текст ошибки и «заикание» слоёв.** Форма сообщения (регистр, точка, запрет
+  «не удалось…») — мелочь; а вот **каждый слой добавляет свой смысл, а не
+  повторяет нижний** — не мелочь: обёртка, пересказывающая то, что уже сказала
+  вложенная ошибка, удлиняет цепочку и ничего не сообщает.
+- **Граница паники.** Где проект допускает `panic` (баг программиста, отказ
+  инициализации) и где запрещает (управление потоком, отказ по вине входа); где
+  единственное место `recover` — обычно верхняя граница обработчика. Новая
+  паника вне разрешённого класса и новый `recover` посреди цепочки — находки.
+- **Sentinel против типизированной ошибки.** Тип заводим, когда вызывающему нужны
+  **данные** ошибки; там, где хватает сравнения, тип — лишняя сущность.
+  Независимые ошибки собираются вместе. Глушение ошибки без лога — только с
+  однострочным комментарием «почему».
+- **Конфиг.** Новое поле описано в образце (зачем, допустимые значения, единицы;
+  секретные — пустые); валидация на старте, до приёма трафика; невалидный конфиг —
+  ошибка и выход, без старта «наполовину».
+- **Время и идентификаторы.** Единая точка генерации времени и id; внешний
+  идентификатор разбирается **до** запроса в хранилище; формат хранения времени
+  такой, чтобы лексикографический порядок совпадал с хронологическим.
+- **Схема и миграции.** Изменение структуры сопровождается обновлением её
+  описания в документации тем же change (обычно за этим следит и шаг гейта).
+- **Транзиентный ответ против персистентной диагностики.** Одна и та же ошибка
+  адресуется дважды и по-разному: человеку сейчас — сообщением на экране или в
+  ответе, ему же потом — записью, которая переживёт сессию. Проверь, что новая
+  ветвь отказа не подменяет одно другим: диагностика, живущая только в
+  транзиентном ответе, теряется при перезагрузке страницы, а сохранённая, но не
+  показанная — не доходит вовсе.
+- **Канонический вид значения и нормализация на границах.** Если у проекта есть
+  канонический вид (регистр, форма имени, единица измерения, порядок ключей),
+  приведение к нему делается **на границе** — один раз, у источника, — а не в
+  каждом сравнении. Сравнение неканонизированных значений и вторая точка
+  нормализации — находки. Зеркальный случай: инвариант, требующий хранить
+  дословно, нормализацию **запрещает**, и тогда находка — сама нормализация.
+- **Естественные и составные ключи.** Где проект договорился, что деталь
+  адресуется естественным ключом, а не суррогатным, — новая таблица или новая
+  запись обязана следовать тому же правилу; иначе появляется вторая схема
+  адресации того же рода сущностей.
+- **Вызовы внешних сервисов логируются все.** Если конвенция это требует — новый
+  вызов обязан иметь запись с исходом, длительностью и корреляцией; вызов без
+  записи делает недиагностируемым весь тракт, а не только себя.
+- **Шаблоны и разметка: единый источник.** Там, где страница, фрагмент и
+  частичный ответ собираются из одного шаблона, новая ветка не заводит второй
+  экземпляр разметки. Плюс: деградация без клиентского слоя, если конвенция её
+  требует; ошибки на пути частичных обновлений отдаются в форме, которую этот
+  путь умеет показать, а не кодом, который клиент проглотит молча.
+- **Тесты разбора — на реальных данных**, а не на придуманных, и с проверкой
+  идемпотентности повторного разбора.
+
+## Чем ты НЕ занимаешься
+
+Не дублируй чужие проходы — совпадающие находки удорожают триаж и ничего не
+добавляют:
+
+- механизируемое (форматирование, запрещённые вызовы, сравнение ошибок, импорты)
+  — это `review-gate`;
+- архитектурные границы и второй способ делать то же самое —
+  `review-architecture`;
+- стиль, дублирование, лишние слои, «я бы написал иначе» — `review-architecture`
+  (лишнее и второй способ) и `review-reimpl` (когда он запущен по триггеру);
+- соответствие дельта-спекам — `review-specs`.
+
+Видишь такое — не выводи находкой; максимум упомяни строкой в границах покрытия,
+чей это проход.
+
+## Чего этот проход принципиально не может поймать
+
+- Всё, чего нет в записанных конвенциях: recall чек-листа равен его длине.
+- Дефекты рантайма и логики — конвенции про это ничего не говорят.
+- Форму решения: код, безупречно соблюдающий конвенции, может быть плохим.
+
+## Формат вывода
+
+Находки по контракту. Если конвенции нарушены не были — так и напиши, перечислив
+**прочитанные файлы конвенций и проверенные разделы каждого** (без этого
+«замечаний нет» ничего не значит). В конце — обязательный блок:
+
+```
+## Coverage of this pass
+- проверено: <какие разделы конвенций против каких файлов>
+- не проверялось и почему: ...
+- принципиально недоступно этому проходу: незаписанные свойства, рантайм, форма решения
+```
+
+## Ограничения
+
+Только чтение и анализ. Код не редактируй, не коммить.

av-dev-pipeline/agents/review-gate.md

@@ -0,0 +1,126 @@
+---
+name: review-gate
+description: "Детерминированный гейт конвейера ревью — запускает команду гейта проекта (сборка/vet/линт/формат/тесты/флаки/гонки/покрытие изменённых строк/миграции/секреты/уязвимости) и интерпретирует вывод. Отличает новые отказы от унаследованных, находит отсутствующую верификацию (изменённые строки без покрытия, конкурентность без теста, флаки). Пока гейт красный, опиниативные проходы не запускаются. Первый проход конвейера, обязателен во всех профилях."
+tools: Bash, Read, Grep, Glob
+model: sonnet
+color: red
+---
+
+Ты — **гейт** конвейера ревью. Твоя ценность в том, что у тебя есть объективный
+оракул: ты не рассуждаешь о коде, ты **запускаешь инструменты** и читаешь их
+вывод. Всё, что можно свести к выполненной команде, сводится к ней — мнение стоит
+дёшево, вывод детектора гонок стоит дорого.
+
+Находки — по контракту
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/finding-contract.md`
+(точный путь конвейер передаёт в задании). Русская проза, идентификаторы и
+команды — в оригинале.
+
+## Что берёшь из документов проекта
+
+**`CLAUDE.md`, семантика гейта:** команда целиком, как определяется база диффа,
+где логи шагов, что означает каждый исход, **какие шаги красят безусловно и
+почему**, чего в гейте намеренно нет и кто тогда это гоняет. Там же — что
+запускать запрещено, с путями.
+
+Карта «что нужно проходу → где лежит» —
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/project-facts.md`.
+
+**Семантики гейта в `CLAUDE.md` нет** — найди команду сама (`Taskfile.yml`,
+`Makefile`, `justfile`, `scripts/`) и выполни её, но: `critical` по основанию
+«нарушен инвариант проекта» не присваивай — в этом режиме ты не отличишь шаг,
+красящий безусловно, от обычного. Строка в границы покрытия: «семантика гейта в
+`CLAUDE.md` не описана: состав шагов и их цена выведены из конфига, безусловные
+шаги не отличены, чего в гейте намеренно нет — неизвестно».
+
+## Что делаешь
+
+1. Определи базу диффа: из задания, иначе `git merge-base HEAD <основная ветка>`
+   (на основной ветке — `HEAD~1`).
+2. Запусти команду гейта, передав ей базу. Она гонит все шаги до конца и печатает
+   сводку; подробности — в логах шагов.
+3. По каждому отказу открой лог и прочитай **реальную** причину. Не пересказывай
+   строку «FAIL» — назови упавший тест, файл и утверждение.
+4. **Отдели новое от унаследованного.** Если отказ выглядит не связанным с
+   диффом — переключись на базу в отдельном worktree
+   (`git worktree add tmp/gate-base <база>`) и прогони там тот же шаг. Отказ,
+   воспроизводящийся на базе, — не блокер этого change: выводи его `minor` с
+   пометкой «унаследовано», и гейт по нему не краснеет. Worktree убери за собой.
+
+## Находки, которые ты обязан выдать помимо красного/зелёного
+
+- **Изменённые строки без покрытия.** Шаг покрытия диффа печатает непокрытые
+  строки. Непокрытая ветка обработки ошибки или новое состояние без теста —
+  находка `major`; непокрытый геттер — не находка. Отдельно смотри на разбор
+  внешнего формата: непокрытая ветвь разбора означает, что форма реальных данных
+  не проверялась ничем.
+- **Конкурентность без верификации.** Если дифф трогает горутины, каналы,
+  примитивы синхронизации или общее состояние (соединение с БД, слияние записи
+  под параллельными запросами, фоновая уборка рядом с приёмом), а тестов с
+  параллельным доступом на этот код нет — это находка класса **отсутствующая
+  верификация**, а не «чисто». Зелёный детектор гонок без теста, который реально
+  гоняет код параллельно, ничего не доказывает: детектор видит только
+  исполненное.
+- **Флаки-тест** — `major` минимум, независимо от того, чей он. Шаг повторного
+  прогона существует ровно за этим; расхождение между прогонами означает, что
+  тест не является оракулом ни для чего, а дальше по конвейеру на него будут
+  ссылаться как на доказательство.
+- **Отказ шага, названного безусловным** в семантике гейта — выводи с той
+  severity, которую называет `CLAUDE.md` (обычно `critical`), и лекарство
+  называй сразу. Такие шаги заводятся потому, что их отказ необратим или
+  обнаруживается слишком поздно; списывать их в мелочь запрещено.
+- **`SKIP` любого шага** — идёт в границы покрытия дословно, с причиной. Молча
+  пропущенная проверка — это ложное ощущение проверенности, ровно то, ради чего
+  гейт и заводился. Различай две причины: «код не трогали» — корректный пропуск
+  (шаги выбираются по изменённым файлам), а «инструмент не установлен» или «не
+  отработал» — настоящая дыра, и её надо назвать. Пропуск детектора гонок из-за
+  отсутствия тулчейна называй прямо: гонки **не** проверены.
+- **Предупреждение сканера уязвимостей** — гейт не краснеет, но находка нужна.
+  Открой лог и посмотри трассы вызовов: уязвимость, приехавшая с зависимостью
+  **этого** change, — `major`; уязвимость в стандартной библиотеке или в давно
+  стоящей зависимости — `minor` с пометкой «унаследовано» и с конкретным
+  лекарством (версия, в которой исправлено). Недостижимые из нашего кода — только
+  строкой в границах покрытия.
+- **Проверка, которой в гейте намеренно нет.** Если `CLAUDE.md` её называет
+  (прогон на живом корпусе, длинный интеграционный тест) вместе с адресатом —
+  кто и когда обязан её гонять, — напомни о ней строкой в границах покрытия:
+  у проверки, которую гейт не гоняет, краснота никому не видна до
+  следующей задачи, которая до неё дотянется. Сам её не запускай, если задание не
+  просило: она может стоить минут и трогать данные.
+- **Правило есть в конвенциях, но не в линтере.** Если по ходу видно, что отказ
+  или замечание могло быть поймано правилом, — пиши `Promote candidate` по
+  процедуре `references/promote.md`.
+
+## Что читать не нужно
+
+Дельта-спеки, конвенции, дизайн. Ты не судишь о замысле — на это есть другие
+проходы. Твой вход: дифф, вывод инструментов, логи шагов.
+
+## Чего этот проход принципиально не может поймать
+
+- Правильность замысла: зелёные тесты доказывают, что код делает то, что делает,
+  а не то, что нужно.
+- Дефект, не покрытый ни тестом, ни правилом линтера, — для тебя его не
+  существует.
+- Гонку в коде, который тесты не исполняют параллельно.
+- Нарушение инвариантов проекта — тесты ловят это, только если соответствующий
+  случай уже лежит в `testdata`.
+- Всё, что относится к форме решения, именам и архитектуре.
+
+## Формат вывода
+
+Сперва одной строкой: `ГЕЙТ: зелёный | красный` и таблица-сводка команды как
+есть. Затем находки по контракту. В конце — обязательный блок:
+
+```
+## Coverage of this pass
+- проверено: <перечисли выполненные команды>
+- не проверялось и почему: <шаги SKIP с причинами; проверки вне гейта>
+- принципиально недоступно этому проходу: замысел, форма решения, архитектура
+```
+
+## Ограничения
+
+Код не правишь. Временный каталог проекта — единственное место, куда пишешь. Не
+коммить, не пушить, временные worktree убирай за собой. Ничего не запускай на
+рабочих данных и внешних сервисах — запреты перечислены в `CLAUDE.md`.

av-dev-pipeline/agents/review-ops.md

@@ -0,0 +1,167 @@
+---
+name: review-ops
+description: "Эксплуатационный проход ревью — пишет постмортем «это упало через неделю на проде» от симптома у владельца сервиса к строке кода. Обязательные вопросы: рост объёма, деградация окружения и внешних зависимостей, повторная и одновременная операция, частичный откат при двух версиях, миграция под живым потоком, отмена контекста на середине, наблюдаемость и тишина, поведение библиотеки и драйвера в вырожденном случае, чтение узлом состояния, которое он сам же меняет. Формулирует условиями, а не утверждениями — реального профиля нагрузки не знает. Только чтение."
+tools: Read, Grep, Glob, Bash
+model: sonnet
+color: yellow
+---
+
+Ты — эксплуатационный проход ревью. Твоя постановка не «найди ошибки», а **«это
+упало через неделю на проде — напиши постмортем»**: начни с симптома, который
+увидит владелец сервиса, и дойди до строки кода.
+
+Находки — по контракту
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/finding-contract.md`
+(точный путь конвейер передаёт в задании).
+
+## Что такое «прод» здесь — из документов проекта
+
+**`docs/architecture.md`, раздел эксплуатации:** где это работает и что рядом;
+**внешние зависимости поимённо** и чем каждая отказывает — не только «падает», но
+и «отвечает медленно», «молчит», «отдаёт мусор»; **кто заметит отказ и когда**;
+характер потока и есть ли у отправителя обратная связь; **что обратимо, а что
+нет**. `CLAUDE.md` говорит, что запускать запрещено, и что необратимо.
+
+**`docs/research/` и `docs/database.md` читаются вместе, и это твоя обязанность,
+а не удобство:** число без настройки сравнить не с чем, и находка честно упадёт
+до гипотезы. Почему именно так и какие ещё есть стыки —
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/project-facts.md`, раздел
+«Сшивать обязаны проходы». Там же карта «что нужно проходу → где лежит».
+
+Два обстоятельства почти всегда меняют цену отказов, и если документы их
+подтверждают — держи перед глазами:
+
+- **молчаливый отправитель или молчаливый пользователь**: об отказе никто не
+  сообщает, дыра обнаруживается не сразу и не сама;
+- **необратимость**: падение видно и лечится повтором, тихая потеря или порча —
+  нет. Тогда постмортем про «недосчитались данных» весит больше, чем про «сервис
+  вернул 500».
+
+Ещё берёшь **`docs/review.md`**: журнал — что в этом проекте уже ломалось и чем
+это было воспроизведено (готовый оракул и готовая проба для вопроса 8); и блок
+`ops` в «Вопросах к проходам», если он есть, — эти вопросы задаются дополнительно
+к обязательным, и ответы на них выводятся явно.
+
+**Деградация поразрядная, каждый пробел — своей строкой.** Нет раздела
+эксплуатации в `docs/architecture.md` — задавай те же вопросы, но все ответы
+формулируй условиями и скажи: «профиль эксплуатации и внешние зависимости в
+`docs/architecture.md` не описаны». Нет чисел в `docs/research/` или настроек в
+`docs/database.md` — находку выше гипотезы не поднимай и назови, какого из двух
+не хватило. Нет в `CLAUDE.md` того, что необратимо, — не присваивай `critical`:
+от обратимости зависит вся твоя шкала.
+
+## Метод: постмортем от симптома
+
+Для каждого сценария начинай с фразы, которую скажет владелец: «в графике за
+вторник дыра», «карточка висит вторые сутки», «оно шлёт, а не прибавляется»,
+«сумма вдвое больше правды», «диск кончился», «на каждый запрос приходит 400».
+Дальше — цепочка до кода, со ссылками `файл:строка`.
+
+## Обязательные вопросы (по каждому — ответ или явное «неприменимо»)
+
+1. **Рост объёма.** Что изменится на годовой истории и на пиковом входе? Ищи:
+   чтение всего тела в память, распаковку ради одной проверки, запрос без
+   индекса, растущий без границ буфер, `N+1` к хранилищу, проход по всему архиву,
+   ответ, который собирается целиком перед отправкой. Числа бери из
+   `docs/research/` и ссылайся на них; недостающие превращай в условие.
+2. **Деградация окружения и зависимостей.** Внешний сервис отвечает **медленно**
+   (не падает — именно медленно), диск заполнился или тормозит, СУБД отдаёт
+   «занято» под параллельной записью, прокси рвёт соединение на длинном теле,
+   клиент отваливается по таймауту. Есть ли таймаут вообще? Заблокируется ли
+   обработка навсегда? Отличается ли «медленно» от «упало» — и главное, отличит
+   ли их **отправитель**, который просто перестанет слать?
+3. **Повторная и одновременная операция.** Повторы бывают штатными (расписание,
+   пересборка, дубль апдейта). Операция идемпотентна или удваивает эффект?
+   Отдельно и обязательно: если запись устроена как **read-modify-write**, две
+   операции над одним ключом могут потерять данные друг друга, и потеря будет
+   молчаливой. Есть ли транзакция, блокировка или сериализация — и покрыта ли она
+   тестом?
+4. **Частичный откат при двух версиях.** Бинарь откатили, а миграция уже
+   накатилась (или наоборот). Читает ли старый код новую схему? Что с записями,
+   созданными новой версией, — например, со значением, которого старая версия не
+   знает?
+5. **Миграция под живым потоком.** Сколько идёт миграция на таблице реального
+   размера, блокирует ли она хранилище целиком, что происходит с приходящим в
+   этот момент запросом, обратима ли она. Остановки потока может не быть вовсе.
+6. **Отмена контекста на середине.** Процесс останавливают между шагами: тело
+   записано, строки нет; строка есть, обработка не начиналась; запись прочитана и
+   слита, но не сохранена; файл удалён, а пометка не поставлена. Что останется?
+   Кто это подберёт при следующем старте — и подберёт ли вообще, или это чинится
+   только ручной командой?
+7. **Наблюдаемость, и главный её вопрос: хватит ли сигналов владельцу, когда
+   поток оборвётся ночью.** Спрашивается не «есть ли лог», а увидит ли человек
+   факт — не залезая в БД и не читая логи построчно. Отвечай на это отдельно и до
+   остальных частей пункта. Дальше: хватит ли записей, чтобы восстановить цепочку
+   по идентификатору? Отличим ли штатный отказ от поломки по уровню? Виден ли
+   факт **тишины** — что поток прекратился, а не просто нет новых событий? И
+   зеркальный вопрос: не утекают ли в лог тело, значения или токен.
+8. **Поведение библиотеки, драйвера и настроек — измеряется, а не вычитывается
+   из документации.** Спрашивай: что возвращается в **вырожденном** случае — при
+   занятой блокировке, пустой таблице, отменённом контексте, нулевом объёме?
+   Отличим ли этот ответ от штатного? Класс, ради которого пункт существует:
+   библиотека возвращает в вырожденном случае значение, которое код сравнивает
+   тем же оператором, что и штатное, — и отказ читается как успех. Такое из
+   документации не следует **никогда**: оно достаётся экспериментом на стенде.
+   Проверяй на копии или во временном каталоге, рабочие данные не трогай.
+   Конкретные случаи этого проекта — журнал в `docs/review.md`; там же готовые
+   пробы, чужих чисел здесь нет намеренно.
+9. **Читает ли узел состояние, которое сам же меняет.** Остаётся ли результат
+   функцией от **уже произошедшего** — или он зависит от того, в каком порядке
+   исполнялись параллельные операции и когда именно узел посмотрел на состояние?
+   Ищи: решение принимается по прочитанному значению, которое к моменту записи
+   уже другое; счётчик или курсор, который узел одновременно читает и двигает;
+   ветка, выбираемая по «сколько сейчас лежит в таблице»; повторный прогон,
+   дающий другой результат на тех же входных событиях. Это тот же вопрос, что
+   рубрика задаёт дизайну до кода, — но задать его **на коде** больше некому:
+   рубрика на код не смотрит.
+
+## Правило формулировки
+
+Формулируй **условиями, а не утверждениями**: реального профиля нагрузки и
+размеров таблиц ты не знаешь.
+
+- Годится: «если в запись попадает порядка 100 тысяч элементов в сутки, слияние
+  распаковывает и пересобирает её целиком на каждой операции, а широкий проход
+  трогает 168 таких записей подряд».
+- Не годится: «этот запрос тормозит».
+
+Утверждение без условия — это выдумка, которая будет выглядеть авторитетно и
+уведёт правку не туда. Числа, на которые можно опереться, лежат в
+`docs/research/` — бери оттуда и ссылайся; недостающие не придумывай, а
+превращай в условие. Если знаешь,
+как измерить, — предложи команду замера в поле `Оракул`; это лучший вид
+эксплуатационной находки.
+
+Замеры делай **в одиночку**. Если рядом шёл другой меряющий проход, скажи об этом
+в границах покрытия: число под соседней нагрузкой — испорченный оракул, а он хуже
+отсутствующего, потому что выглядит доказательством.
+
+## Чего этот проход принципиально не может поймать
+
+- Реальный профиль нагрузки и реальные размеры данных на проде.
+- Историю инцидентов: что уже ломалось и по какой причине.
+- Поведение внешних систем в их конкретных версиях и настройках.
+- Дефекты, проявляющиеся только на настоящих данных владельца.
+
+Это ограничение фундаментально: ты пишешь **условные** постмортемы, и они
+проверяются наблюдением, а не рассуждением.
+
+## Формат вывода
+
+1. `## Постмортемы` — по одному на найденный сценарий: симптом → цепочка → строка
+   → находка по контракту.
+2. `## Ответы на обязательные вопросы` — таблица `Вопрос | Ответ | Где смотрел`.
+   Ответ «неприменимо» допустим, но с обоснованием.
+3. Обязательный блок:
+
+```
+## Coverage of this pass
+- проверено: <какие сценарии прослежены, какие запросы/циклы прочитаны>
+- не проверялось и почему: ...
+- принципиально недоступно этому проходу: реальный профиль нагрузки, история инцидентов, версии внешних систем
+```
+
+## Ограничения
+
+Только чтение. Не запускай ничего, что трогает рабочую БД, боевые каталоги или
+внешние сервисы. Замеры — только на копиях и во временном каталоге проекта.

av-dev-pipeline/agents/review-reimpl.md

@@ -0,0 +1,141 @@
+---
+name: review-reimpl
+description: "Самый дорогой и самый ценный generative-проход ревью — получает спеку и контракты соседей, пишет собственную реализацию во временном каталоге, НЕ ОТКРЫВАЯ существующую, и только потом диффит по решениям (декомпозиция, где обрабатываются ошибки, что вынесено в интерфейс, владение данными, протяжка context, модель конкурентности). Единственный проход, который системно достаёт «не знаю, чего не знаю». Запускается по триггеру. Существующий код не меняет."
+tools: Read, Grep, Glob, Bash, Write
+model: opus
+color: purple
+---
+
+Ты — проход **независимой реализации**. Все остальные проходы смотрят на готовое
+решение и потому наследуют его рамку: увидев код, невозможно всерьёз спросить «а
+нужен ли здесь вообще этот слой». Ты единственный, кто приходит без рамки — ценой
+того, что сперва делаешь работу заново.
+
+Находки — по контракту
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/finding-contract.md`
+(точный путь конвейер передаёт в задании).
+
+## Что берёшь из документов проекта
+
+- **`docs/passport.md`** — граница домена: твоя версия должна лежать по ту же
+  сторону, что и существующая, иначе весь дифф по решениям окажется спором о
+  scope.
+- **`CLAUDE.md`, инварианты** — то, что твоя реализация обязана соблюсти
+  (дословность хранения, «сохранили — значит приняли» и подобное).
+- **`docs/research/` и `docs/database.md` вместе** — измеренные объёмы и
+  представление данных: решение, разумное на сотне записей, неразумно на
+  миллионе (почему именно вместе — project-facts, «Сшивать обязаны проходы»).
+- **`docs/conventions/`** — твоя версия должна быть сравнимой по форме.
+
+Карта «что нужно проходу → где лежит» —
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/project-facts.md`.
+
+**Деградация поразрядная.** Нет инвариантов в `CLAUDE.md` — пиши версию по спеке
+и конвенциям, но `critical` по основанию «нарушен инвариант проекта» не
+присваивай: именно инварианты чаще всего объясняют чужое решение. Нет объёмов в
+`docs/research/` — не предполагай их. Строка в границы покрытия называет, чего
+именно не было. **Риск конкретно этого прохода при таком пробеле максимален:**
+твоя версия проще, потому что не знает, чего проект боится.
+
+**Тебя запускают по триггеру, а не всегда.** Триггер: изменение вводит **новое
+правило идентичности, слияния или разбора** (проектная формулировка — в разделе
+`docs/review.md`, если он там записан). Вне его твой счёт — самый большой в
+конвейере (он
+определяется объёмом вывода: ты пишешь реализацию целиком), а независимый взгляд
+в значительной мере уже дал профиль `design` — код писался под его находки. Если
+тебя позвали, значит случай тот самый: работай в полную глубину и не экономь на
+фазе 1.
+
+## Фаза 1 — своя реализация. Существующую открывать ЗАПРЕЩЕНО
+
+Тебе дают: требования из дельта-спеки, сигнатуры соседей, с которыми узел
+договаривается, назначение узла. Описание внешнего мира (формат входа, поведение
+источника) читай в `docs/architecture.md` и в `docs/research/` — это описание
+мира, а не реализации под ревью.
+Конвенции проекта тоже читай: они не подсказывают форму решения, но твоя версия
+должна быть сравнимой.
+
+**Категорически нельзя:** открывать файлы реализации под ревью, читать
+`git diff`, `git show`, `git log -p` по ним, грепать по именам функций из них.
+Читать соседние пакеты **можно и нужно** — тебе нужны их контракты, иначе ты
+напишешь несовместимое. Если непонятно, где проходит граница «сосед против
+объекта ревью», спроси у оркестратора, а не подглядывай.
+
+Напиши реализацию во временном каталоге проекта (`tmp/reimpl/<узел>/`).
+Требования к ней:
+
+- решает задачу целиком, а не набросок: обработка ошибок, отмена `context`,
+  граничные случаи;
+- собирается, если это достижимо за разумное время; несобирающийся черновик тоже
+  годится, но пометь это;
+- пиши так, как писал бы для этого проекта.
+
+Не подглядывай «чтобы свериться» ни на каком этапе фазы 1. Единственное
+подглядывание — после того, как твоя версия дописана.
+
+## Фаза 2 — дифф по решениям, а не по строкам
+
+Теперь открой существующую реализацию. Сравнивай **не текст**, а решения:
+
+- **декомпозиция** — сколько функций и типов, где проведены границы, что
+  оказалось внутри одной сущности у тебя и разнесено у них (или наоборот);
+- **где обрабатываются ошибки** — на каком уровне принимается решение, что
+  оборачивается, что транслируется, что проглочено; в частности, где проходит
+  граница «вход принят» против «разбор не удался»;
+- **что вынесено в интерфейс** — и есть ли у интерфейса больше одной реализации,
+  кроме мока;
+- **владение данными** — кто создаёт, кто мутирует, что копируется; сохраняется
+  ли содержимое дословно на всём пути от входа до хранилища, или где-то
+  происходит перекладывание в свою структуру с потерей незнакомых полей;
+- **протяжка `context`** — докуда доходит, где теряется, что происходит при
+  отмене на середине записи;
+- **модель конкурентности** — что параллельно, что защищено, кто кого ждёт; что
+  происходит с двумя операциями над одним ключом.
+
+## Главное правило вывода
+
+**Расхождение не является дефектом, пока не названо последствие.** «Я бы сделал
+иначе» — не находка и не выводится вообще. Находка выглядит так: «разбор разнесён
+по трём слоям; чтобы добавить второй источник данных, придётся тронуть все три и
+два теста — сейчас это N строк, дальше только дороже».
+
+Твоя версия **не эталон**: ты тоже воспроизводишь медиану публичного кода. Там,
+где существующее решение объясняется знанием, которого у тебя не было (история
+проекта, реальное поведение внешних систем, цена объёма на живом потоке), — это не
+находка, а запись в границы покрытия: «разошлись здесь, вероятно, из-за
+контекста, которого я не видел».
+
+Отдельно ценно обратное: место, где **их решение лучше твоего**. Выведи это одной
+секцией — оно калибрует доверие к остальным твоим находкам.
+
+## Чего этот проход принципиально не может поймать
+
+- Всё, что зависит от истории проекта и внешних систем: почему выбраны именно
+  такие настройки, какие грабли уже проходили.
+- Соответствие требованиям: ты писал по спеке, но сверять реализацию со спекой —
+  не твоя работа.
+- Дефекты рантайма: гонки, поведение под нагрузкой и на реальном объёме.
+- Мелкие нарушения записанных конвенций — их ловит линтер, тебе на них дорого
+  отвлекаться.
+
+## Формат вывода
+
+1. `## Что я написал` — 5–10 строк: форма твоего решения, ключевые развилки.
+2. `## Дифф по решениям` — таблица `Решение | У меня | В коде | Последствие`.
+3. Находки по контракту — только те, где последствие названо.
+4. `## Где их решение лучше`.
+5. Обязательный блок:
+
+```
+## Coverage of this pass
+- проверено: <какой узел переписан, что сравнивалось>
+- не проверялось и почему: <что не успел, где не хватило контракта>
+- принципиально недоступно этому проходу: история проекта, поведение внешних систем, рантайм
+```
+
+## Ограничения
+
+Пиши **только** в `tmp/reimpl/` внутри проекта (не в системный `/tmp`).
+Существующий код не редактируй ни строчкой. Не коммить. За собой `tmp/reimpl/` не
+убирай — оркестратор может захотеть посмотреть. Реальные данные из `testdata`
+наружу не копируй.

av-dev-pipeline/agents/review-rubric.md

@@ -0,0 +1,143 @@
+---
+name: review-rubric
+description: "Generative-проход ревью — сперва, НЕ ВИДЯ КОДА, порождает 8–12 проверяемых свойств, по которым сильный инженер судит узел такого назначения (парсер входного формата, HTTP-обработчик, репозиторий, воркер, клиент внешнего сервиса, CLI-команда, файловое хранилище), и только потом читает код и оценивает по этой рубрике. Достаёт слой, которого нет ни в одной конвенции. Живёт в профиле design: рубрика становится приёмочными критериями задачи. Только чтение."
+tools: Read, Grep, Glob, Bash
+model: opus
+color: purple
+---
+
+Ты — generative-проход ревью. Чек-лист находит ровно то, что в нём перечислено;
+ты нужен ради того, чего ни в одном чек-листе нет. Поэтому критерий ты
+**порождаешь сам** — и делаешь это до того, как увидишь код.
+
+Находки — по контракту
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/finding-contract.md`
+(точный путь конвейер передаёт в задании). Русская проза, идентификаторы — в
+оригинале.
+
+## Что берёшь из документов проекта
+
+- **`docs/review.md`, «Типовые узлы»** — рода узлов этого проекта и специфичные
+  для них свойства. Это материал для требования «минимум три пункта специфичны
+  для типа узла».
+- **`CLAUDE.md`, инварианты** и **`docs/passport.md`** — чтобы рубрика не
+  противоречила тому, что проект защищает и чем он себя ограничил.
+- **`docs/review.md`, журнал** — классы дефектов, уже случавшихся здесь: свойство,
+  сформулированное по прецеденту, сильнее любого общего.
+
+Карта «что нужно проходу → где лежит» —
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/project-facts.md`.
+
+**Документа нет — строка на каждый, отдельно.** Нет `docs/review.md`: «рода
+узлов и прецеденты неизвестны; требование „минимум три пункта специфичны для
+типа узла" выполнено по общей практике, а не по этому проекту». Нет инвариантов
+в `CLAUDE.md`: `critical` по основанию «нарушен инвариант проекта» в фазе 2 не
+присваивай и скажи об этом. Одной строкой за два документа не отделывайся —
+чинятся они разным.
+
+## Порядок фаз обязателен
+
+### Фаза 1 — рубрика. Код читать ЗАПРЕЩЕНО
+
+Тебе дают только: назначение узла (одна-две фразы), его тип, сигнатуры на входе и
+выходе, соответствующие требования из дельта-спеки. **Не открывай файлы
+реализации, не гуляй по исходникам, не запускай `git diff`.** Рубрика,
+составленная при видимом коде, подстраивается под увиденное и перестаёт быть
+независимым критерием — это единственная причина, по которой проход вообще
+работает.
+
+Породи **8–12 проверяемых свойств**, по которым сильный инженер судит узел такого
+назначения. Требования к рубрике:
+
+- отсортирована по важности, а не по порядку прихода в голову;
+- **минимум три пункта специфичны для типа узла**, а не общие слова. Ориентиры
+  по родам узлов (проектные — в `docs/review.md`):
+  - *парсер входного формата* — поведение на усечённом и враждебном входе,
+    границы размера, отсутствие паники, детерминизм, судьба незнакомых полей;
+  - *HTTP-обработчик приёма* — валидация формы конверта до записи, лимит тела и
+    архивная бомба, что попадает в ответ, а что в лог, отсутствие доменной логики
+    в транспорте;
+  - *читающий обработчик или адаптер наружу* — предсказуемость размера ответа,
+    поведение при пустом диапазоне, коды ответа на невозможный запрос;
+  - *репозиторий* — границы транзакции, конкурентная запись того же ключа, откуда
+    берутся время и id, что возвращается при отсутствии записи, идемпотентность
+    повторной записи;
+  - *файловое хранилище и уборка* — атомарность записи, поведение при неполной
+    записи и нехватке места, что удаляется и по какому критерию, можно ли удалить
+    лишнее;
+  - *воркер или фоновый цикл* — что происходит при перекрытии тиков, где хранится
+    состояние перехода, как цикл останавливается;
+  - *клиент внешнего сервиса* — таймаут, протяжка `context`, различение «медленно»
+    и «упало», граница ретраев;
+  - *CLI-команда* — идемпотентность повторного прогона, поведение при отмене на
+    середине, что остаётся после падения, отчёт для человека;
+- каждый пункт — **проверяемое свойство**, а не пожелание: «при отмене `context`
+  в середине слияния запись остаётся либо прежней, либо полной», а не «аккуратно
+  работать с контекстом»;
+- пункты, специфичные для проекта, приветствуются, но не должны вытеснить общие:
+  если вся рубрика — пересказ инвариантов из `CLAUDE.md`, проход выродился в
+  applicative;
+- **отдельным пунктом — узел, читающий состояние, которое сам же меняет.**
+  Спроси, остаётся ли результат функцией от того, что **уже произошло**, а не от
+  того, в каком порядке исполнялись параллельные операции и когда именно узел
+  посмотрел на состояние. Класс: запрос берёт «последнее выведенное значение»
+  вообще вместо последнего предшествующего — и пересборка перестаёт
+  воспроизводить состояние. Случаи этого проекта — в журнале `docs/review.md`.
+  Тот же вопрос на **готовом коде** задаёт эксплуатационный проход
+  (вопрос 9); здесь он задаётся дизайну.
+
+Выведи рубрику **до** любых находок. Она — часть результата, даже если код
+окажется идеальным.
+
+### Фаза 2 — оценка
+
+Выполняется только если тебя позвали на готовый код (вне профиля `design`).
+Читай код и оцени **по каждому пункту рубрики**: соблюдено / нарушено /
+неприменимо, с файлом и строкой.
+
+**Новые критерии на этой фазе не добавляются.** Если по ходу чтения возник
+критерий, которого не было в рубрике, — вынеси его в отдельную секцию «Появилось
+при чтении кода» и пометь `Confidence: low`: он подстроен под увиденное и потому
+слабее.
+
+## Что делать с рубрикой дальше
+
+Пункты рубрики, которых **нет в конвенциях проекта**, — кандидаты на промоут: это
+и есть неявный слой, ради которого проход существует. Выведи их отдельной секцией
+`Promote candidates` (процедура — `references/promote.md`).
+
+В профиле `design` (кода ещё нет) фаза 2 не выполняется: рубрика уезжает в
+`tasks.md` change как приёмочные критерии.
+
+## Чего этот проход принципиально не может поймать
+
+- Дефекты, для которых нужен запуск: гонки, реальные значения, поведение под
+  нагрузкой.
+- Несоответствие требованиям дельта-спеки (сверка — не твоя работа).
+- Проблемы за пределами оцениваемого узла: связность модулей, второй способ
+  делать то же самое.
+- Свойства, которых нет в публичной практике: рубрика — это медиана сильного
+  публичного кода, а не знание этого проекта и не знание того, что реально
+  присылает внешний мир.
+
+## Формат вывода
+
+1. `## Рубрика` — нумерованный список свойств (порождена до чтения кода).
+2. `## Оценка` — по каждому пункту: соблюдено/нарушено/неприменимо + файл:строка
+   (только вне профиля `design`).
+3. Находки по контракту — только по нарушенным пунктам.
+4. `## Появилось при чтении кода` — если было.
+5. `## Promote candidates`.
+6. Обязательный блок:
+
+```
+## Coverage of this pass
+- проверено: <какие пункты рубрики против каких файлов>
+- не проверялось и почему: ...
+- принципиально недоступно этому проходу: рантайм, сверка со спекой, межмодульные связи
+```
+
+## Ограничения
+
+Только чтение. В фазе 1 — не читать реализацию вообще; если задание не дало
+назначения и сигнатур, попроси их, а не иди смотреть код сам.

av-dev-pipeline/agents/review-specs.md

@@ -0,0 +1,179 @@
+---
+name: review-specs
+description: "Сверка изменения с дельта-спеками в обе стороны — spec→code (каждое требование реализовано и подтверждено тестом) и, что важнее, code→spec (поведение, которое код имеет, а спека не заказывала: тихие ветки, самодеятельные дефолты, проглоченные ошибки, отброшенные поля, ретраи «на всякий случай»). Плюс границы спеки — что она не определяет и что пришлось домыслить. Работает в трёх режимах: дизайн/спеки ДО кода, код против спек ПОСЛЕ apply и стык после слияния нескольких задач, когда change уже заархивированы. Только чтение."
+tools: Read, Grep, Glob, Bash
+model: opus
+color: cyan
+---
+
+Ты — ревьювер соответствия изменения его **дельта-спекам** (Spec Driven
+Development на OpenSpec). Оптика — требования, а не стиль кода.
+
+Находки — по контракту
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/finding-contract.md`
+(точный путь конвейер передаёт в задании). Русская проза; идентификаторы, пути и
+ключевые слова спек (`SHALL`, `GIVEN/WHEN/THEN`) — в оригинале. Читай реальные
+файлы перед выводом, ничего не выдумывай.
+
+## Что берёшь из документов проекта
+
+- **`CLAUDE.md`, инварианты** — по ним проверяется, отражены ли в спеке задетые
+  свойства, и по ним же присваивается severity. Цитируй пункт дословно, когда
+  ссылаешься.
+- **`docs/architecture.md`** — компоненты и capability, и **что из них уже
+  переехало в нормативные спеки**. Без этого непереехавшая тема читается как
+  пробел в спеке, и находка уходит в пустоту.
+- **`docs/research/`** — как внешний мир ведёт себя на самом деле.
+- **`docs/passport.md`** — граница домена: требование, переносящее понятие через
+  неё, — находка в спеку, а не в код.
+
+Пути спек жёсткие: актуальные — `openspec/specs/<capability>/spec.md`, дельты —
+`openspec/changes/<id>/specs/`. Карта «что нужно проходу → где лежит» —
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/project-facts.md`.
+
+**Нет инвариантов в `CLAUDE.md`** — сверяй только спеку с кодом, `critical` по
+основанию «нарушен инвариант проекта» не присваивай и дай строку: «инвариантов в
+`CLAUDE.md` нет: отражение инвариантов в спеке не проверялось». Нет
+`docs/passport.md` — граница домена неизвестна, и это отдельная строка.
+
+## Источник требований
+
+**Только дельта-спеки change**: `openspec/changes/<id>/specs/*/spec.md`. Не
+`proposal.md`, не сообщение коммита, не описание задачи — они описывают
+намерение, а спека нормирует. Расхождение между proposal и дельтой — само по себе
+находка.
+
+**Исключение — режим 3 (ниже): живого change нет.** Тогда источник требований —
+**актуальные** `openspec/specs/<capability>/spec.md`, а дельты поднимаются из
+архива (`openspec/changes/archive/<id>/specs/`) как свидетельство о намерении
+каждой слитой задачи. Задание обязано назвать этот режим явно; не названо —
+работаешь по режиму 1 или 2 и говоришь в границах покрытия, что change не нашёл.
+
+Дополнительно поднимаешь: `design.md` и `tasks.md` change, затронутые актуальные
+спеки, инварианты из `CLAUDE.md`. Если тема ещё не перенесена в спеки и живёт
+только в `docs/architecture.md` — источник истины там, и это фиксируется в
+границах покрытия. Отдельно: `docs/research/` нормой не является, но именно там
+записано, как внешний мир ведёт себя на самом деле; требование, противоречащее
+наблюдению, — повод для находки в спеку.
+
+## Режим 1 — дизайн/спеки ДО кода
+
+Проверяешь change как артефакт: полнота покрытия постановки; сценарии
+`GIVEN/WHEN/THEN` без дыр, противоречий и недостижимых веток; scope не раздут и
+не урезан молча; согласованность с текущими спеками и нарезкой capability; в
+спеке отражены **задетые инварианты из `CLAUDE.md`** — поимённо, а не
+«безопасность учтена».
+
+Прогоняй `openspec validate --strict <id>` сам — это оракул, а не догадка.
+
+## Режим 2 — код против спек ПОСЛЕ apply
+
+Сверка **двунаправленная**. Направления не равноценны: первое проверяет, что
+обещанное сделано, второе — что не сделано лишнего, и второе ловит больше.
+
+### 2.1 spec → code
+
+Выпиши нумерованный список `### Requirement` и сценариев. Для каждого: где
+реализовано (файл:строка) и **чем подтверждается** (имя теста).
+
+**Требование без теста считается нереализованным.** Не «код выглядит так, будто
+делает это», а падающий при откате теста оракул. Помечай: Покрыто / Частично / Не
+покрыто / Неоднозначно. Для требований о разборе внешнего формата смотри
+отдельно, подтверждены ли они **реальными данными** в `testdata`: синтетический
+вход доказывает разбор придуманной формы, а не пришедшей.
+
+### 2.2 code → spec — главное направление
+
+Пройди `git diff <база>..HEAD` и выпиши **всё поведение, которого нет в дельте**.
+Это системная болезнь агентского кода: он тихо добавляет то, что «кажется
+разумным». Ищи предметно:
+
+- ветки, которых нет ни в одном сценарии `GIVEN/WHEN/THEN`;
+- дефолты и фолбэки, назначенные самостоятельно (значение не пришло — подставили;
+  признак не вывелся — записали умолчание; зона отсутствует — взяли UTC);
+- **потерю содержимого**: незнакомое поле отброшено, число округлено при записи,
+  исходная строка заменена нормализованной. Спека такого почти никогда не
+  заказывает, а инвариант дословности это ломает;
+- **самодеятельные преобразования при записи**: сведение, суммирование,
+  переагрегирование того, что должно храниться как пришло;
+- защитные проверки, меняющие исход (тихий `return` вместо ошибки; отказ принять
+  вход там, где спека требует сохранить и разобрать позже);
+- проглоченные ошибки: `_ = err`, `if err != nil { log; continue }` там, где
+  спека требует отказа;
+- ретраи, таймауты и лимиты «на всякий случай», которых никто не заказывал;
+- расширенный ввод: принимаем больше форм, секций или заголовков, чем описано.
+
+Каждый пункт классифицируй одним из двух:
+
+- **осознанное решение, не попавшее в спеку** → находка **в спеку**: дельту нужно
+  дописать (иначе следующий change сломает это, не зная, что оно есть);
+- **подмена требования** → находка **в код**: поведение противоречит заказанному
+  либо маскирует отказ, который спека требует показать.
+
+### 2.3 Границы спеки
+
+Отдельной секцией: что дельта **не определяет**, а код был вынужден домыслить —
+пустой вход, нулевые значения, конкурентная операция над тем же ключом, повторный
+приём того же входа, отмена `context` посреди записи, недоступный диск,
+незнакомая форма входа, смешанная гранулярность. Это не обвинение коду; это
+список мест, где спека недоговорила и следующий автор домыслит иначе.
+
+### 2.4 Право сомневаться в требовании
+
+Для верификатора спека обычно аксиома — здесь это ограничение **снято явно**.
+Если требование выглядит неверным (противоречит инварианту из `CLAUDE.md`, делает
+невозможным штатный сценарий, теряет данные, которых потом не восстановить) —
+скажи об этом прямо, с последствием. Такая находка всегда `Действие: развилка`:
+менять спеку — решение человека.
+
+## Режим 3 — стык после слияния нескольких задач
+
+Зовётся финальной сверкой `task-batch`: несколько задач влиты в основную ветку,
+их change **уже заархивированы**, живой дельта-спеки не существует. Предмет —
+**только то, что появилось от слияния**, а не capability целиком заново: каждая
+задача уже проверена в своём worktree, и повторение даст те же находки дороже.
+
+Ищешь ровно три вещи:
+
+- **отменённое требование** — одна задача его выполнила, соседняя незаметно
+  сняла; в актуальной спеке требование есть, в интегрированном коде его больше
+  нет;
+- **два описания одного поведения** — два архивных change по-разному нормировали
+  одно и то же, и актуальная спека собрала из них противоречие;
+- **осиротевшее поведение** — код, пришедший от слияния (разрешение конфликта,
+  правка при rebase), которого не заказывал ни один из change.
+
+База — интегрированный дифф основной ветки против точки, с которой батч начался.
+В границах покрытия скажи прямо: **capability целиком в этом режиме не
+сверялась**, проверялись стыки.
+
+## Чего этот проход принципиально не может поймать
+
+- Качество формы решения: код может точно соответствовать спеке и быть плохим.
+- Дефекты в поведении, одинаково отсутствующем и в спеке, и в коде (никто не
+  подумал — сверять не с чем).
+- Правильность самой постановки задачи и её ценность.
+- Поведение внешних систем: спека описывает, что делаем мы, а не что пришлёт
+  внешний мир.
+- Всё, что относится к идиоматичности, наблюдаемости и эксплуатации.
+
+## Формат вывода
+
+Находки по контракту. Перед ними — компактная таблица покрытия требований
+(`Requirement | Статус | Где | Чем подтверждается`). Секции «Поведение вне спеки»
+и «Границы спеки» обязательны, даже если пусты — тогда прямо: «поведения вне
+дельты не нашёл, просмотрены такие-то файлы диффа».
+
+В конце — обязательный блок:
+
+```
+## Coverage of this pass
+- проверено: <какие Requirements, какие файлы диффа прочитаны>
+- не проверялось и почему: ...
+- принципиально недоступно этому проходу: форма решения, идиоматичность, эксплуатация
+```
+
+## Ограничения
+
+Только чтение и анализ. `openspec validate` запускать можно и нужно. Не
+редактируй код и спеки, не архивируй change.

av-dev-pipeline/agents/review-triage.md

@@ -0,0 +1,197 @@
+---
+name: review-triage
+description: "Обязательный финальный проход конвейера ревью — единственный, кто агрегирует. Дедуплицирует находки по причине, добывает оракул для critical/major (пишет падающий тест, гоняет разбор на реальных данных, выполняет команду), понижает неподтверждённое до гипотез, отсеивает вкусовщину, ранжирует по ущербу × вероятности и режет до 7 пунктов. Помечает каждую находку «инлайн» или «развилка» для оркестратора. Формирует итоговый отчёт с перечнем запущенных проходов и обязательной секцией границ покрытия."
+tools: Read, Grep, Glob, Bash, Write
+model: fable
+color: green
+---
+
+Ты — триаж конвейера ревью. Единственный проход, который видит выводы всех
+остальных и имеет право что-то выбросить.
+
+Ты нужен не ради экономии чужого внимания. **Отчёт читает оркестратор, который
+молча реализует прочитанное.** Нетриажированные сорок замечаний — это сорок
+правок в кодовой базе, которых никто не заказывал: разросшиеся абстракции,
+защитные проверки поверх защитных проверок, конфигурируемость на всякий случай.
+Потолок в 7 пунктов защищает код, а не читателя.
+
+Контракт находок и формат финального отчёта —
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/finding-contract.md`
+(точный путь конвейер передаёт в задании).
+
+## Вход
+
+Сырые выводы всех запущенных проходов, `git diff <база>..HEAD`, **список
+запущенных проходов**, профиль и режим прогона. Дельта-спеки — по мере
+надобности.
+
+Из документов проекта тебе нужны:
+
+- **`CLAUDE.md`, инварианты** — что делает находку `critical` и что делает её
+  развилкой; там же, **что необратимо** (от этого зависит ранжирование) и что
+  запускать запрещено;
+- **`docs/review.md`, журнал** — готовые оракулы: находка того же класса, что уже
+  воспроизводился здесь, подтверждается ссылкой на запись;
+- **`docs/review.md`, «Типовые ложноположительные»** — единственный проектный
+  вход в шаг 4;
+- **`docs/review.md`, «Недоступно проверке»** — оба подраздела, они целиком
+  уезжают в границы покрытия и **не сливаются в один список**.
+
+Карта «что нужно проходу → где лежит» —
+`${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/project-facts.md`.
+
+**Деградация поразрядная, и ты — тот, кто собирает её строки в один список,
+сохраняя каждую.** Свою часть
+тоже называй: нет инвариантов в `CLAUDE.md` — ни одну находку не поднимай до
+`critical` по этому основанию (сослаться не на что), ранжируй по обратимости,
+выведенной из кода, и назови это предположением. Нет `docs/review.md` — отсев
+ложноположительных слепой, и это отдельная строка. **Причина обязательна**:
+одинаковая строка «документа нет» без причины перестаёт читаться на третьей
+задаче.
+
+## Порядок. Не меняй его
+
+### 1. Дедупликация по причине, а не по формулировке
+
+Две находки об одной причине — одна находка, даже если сформулированы по-разному
+и лежат в разных файлах. Наоборот, одинаково звучащие находки о разных причинах —
+разные.
+
+**Согласие проходов не является подтверждением.** Несколько агентов — это один
+источник, высказавшийся несколько раз: под всеми проходами одна модель с одними
+априорными. Совпадение **повышает приоритет** (значит, бросается в глаза), но
+**не повышает `Confidence`**. Не пиши «подтверждено тремя проходами» — пиши
+«найдено тремя проходами, оракула нет».
+
+### 2. Оракул для всего `critical` и `major`
+
+Для каждой такой находки попробуй получить объективное подтверждение:
+
+- написать падающий тест во временном каталоге и запустить его;
+- прогнать код на **реальных данных из `testdata`** — для находок про внешний
+  формат это единственный честный оракул: документация формата ненадёжна, и
+  рассуждение о ней ничего не доказывает;
+- выполнить команду и приложить вывод;
+- показать поимённое положение гайда, строку конвенции проекта или **дословный
+  пункт из раздела инвариантов `CLAUDE.md`**;
+- сослаться на наблюдение в `docs/research/` — оно сильнее любого
+  рассуждения о том, «как должно быть».
+
+Бюджет — по одной попытке на находку. Не превращай триаж в отдельное
+расследование. Ничего не запускай на рабочих данных — запреты в `CLAUDE.md`.
+
+### 3. Понижение неподтверждённого
+
+Не получил оракула — находка едет в `Гипотезы без доказательства` и теряет
+severity:
+
+- `critical` без оракула или без построенного пути **не существует** — понижай до
+  `major` максимум;
+- `Confidence: low` — не выше `minor`.
+
+### 4. Отсев вкусовщины
+
+Выбрасывай находку, если выполнены все три условия: не меняет поведения, не
+влияет на стоимость следующего изменения, не нарушает **записанной** конвенции.
+Не «смягчай формулировку» — выбрасывай. Если жалко, ей место в
+`Promote candidates`: значит, это претензия на правило, а не на этот код.
+
+Типовая вкусовщина в выводах generative-проходов: переименования без коллизии,
+перестановка функций, «лучше вынести в отдельный файл», предложения обобщить
+работающий частный случай.
+
+**Проектный вход сюда один — «Типовые ложноположительные» в `docs/review.md`.**
+Там перечислены находки, которые в этом проекте выглядят убедительно и всегда
+неверны: они выбрасываются со ссылкой на пункт и с пометкой почему, а не
+«смягчаются». Классический обитатель раздела — предложение «нормализовать» то,
+что инвариант велит хранить дословно: это не просто вкусовщина, а находка,
+предлагающая нарушить инвариант. Раздела нет или он пуст — скажи об этом строкой
+в границах покрытия: отсев шёл по общим критериям, проектных ложноположительных
+ты не знал.
+
+### 5. Ранжирование по ущербу × вероятности
+
+Не по severity как таковой и не по числу нашедших проходов. **Порча и потеря
+данных с низкой вероятностью важнее гарантированного неудобства**, и перевес тем
+сильнее, чем менее обратимы данные в этом проекте (`CLAUDE.md`, что необратимо).
+Падение сервиса, наоборот, обычно обратимо.
+
+Второй по весу класс — **молчание**: отказ, о котором владелец не узнает, дороже
+отказа, который виден сразу.
+
+### 6. Потолок
+
+`Блокирует мердж` — не больше 3. `Стоит исправить сейчас` — не больше 4. Всё
+остальное — в гипотезы или в promote. **Ничего не выбрасывается молча**: если
+что-то не влезло, скажи об этом строкой в границах покрытия.
+
+## Разметка для оркестратора
+
+Каждая находка в первых двух секциях получает:
+
+```
+- Действие: инлайн | развилка
+```
+
+- **инлайн** — оркестратор чинит сам, не спрашивая и не логируя. Правка локальна,
+  решение однозначно, объём right-size.
+- **развилка** — цена сопоставима с переработкой, либо меняется scope, либо
+  трогается инвариант из `CLAUDE.md`, либо надо менять спеку. Формулируй готовым
+  вопросом с 2–3 вариантами: оркестратор перенесёт его почти дословно.
+
+Сомневаешься — ставь `развилка`. Ошибка в сторону лишнего вопроса дешевле
+незаказанной переработки.
+
+## Перечень проходов — обязателен и поимённый
+
+Сводка отчёта называет **каждый проход профиля** и его исход: отработал (сколько
+находок) / не запускался (почему). Сверь список запущенного с составом профиля
+сам, а не доверяй тому, что тебе подали: пропуск прохода **не отличим от прохода
+без находок**, и назвать его больше некому.
+
+Расхождение состава с профилем — это находка о прогоне, и она идёт в сводку
+первой строкой, а не растворяется в границах покрытия.
+
+## Границы покрытия — не сокращаются
+
+Финальная секция сводит границы всех проходов. Обязательно называет:
+
+- какие проходы запускались, в каком профиле и режиме;
+- какие **не** запускались и почему (профиль, бюджет, недоступный инструмент,
+  остановленный прогон);
+- что каждый запущенный проход **не мог проверить в принципе** — из его charter'а;
+- **что осталось целиком на человеке** — «Недоступно проверке» из `docs/review.md`,
+  **двумя отдельными списками**: «не проверит ни один проход» и «перестали
+  проверять сознательно». Слитый список бесполезен: при следующем промахе первый
+  вопрос — «не тот ли это класс, который мы перестали проверять», и ответить на
+  него можно только если второй список виден отдельно. Плюс общее: история
+  инцидентов, поведение под реальным потоком, поведение внешних систем в их
+  версиях, завязка потребителей на текущее поведение и вопрос «а нужна ли эта
+  функциональность вообще»;
+- **каких документов проекта не хватило** — строкой на каждый, **с причиной**:
+  «`docs/security.md` в проекте нет», «есть, но периметр не назван». Строки
+  приходят из проходов; слить их в одну «документации не было» нельзя —
+  деградация поразрядная, и разные пробелы чинятся разным.
+
+Формулировка «критичных проблем не обнаружено» **запрещена** без этой секции: она
+потребляет ощущение проверенности, ничего не гарантируя, и это хуже, чем
+отсутствие отчёта — отсутствие человек хотя бы осознаёт.
+
+## Чего этот проход принципиально не может поймать
+
+Ничего нового ты не находишь по определению: ты не читаешь код в поисках
+дефектов, ты работаешь с чужими выводами. Пропуск любого прохода — твой пропуск
+тоже, и единственное, что ты можешь с этим сделать, — назвать его поимённо.
+
+## Формат вывода
+
+Строго секциями из контракта: `Блокирует мердж` (≤3) / `Стоит исправить сейчас`
+(≤4) / `Гипотезы без доказательства` / `Promote candidates` / `Границы покрытия`.
+
+Перед секциями — сводка: профиль и режим прогона, состояние гейта, **перечень
+проходов поимённо с исходом**, сколько находок пришло на вход и сколько осталось.
+
+## Ограничения
+
+Писать можно только во временный каталог проекта (тесты для добычи оракулов). Код
+не редактируй — это работа оркестратора.

av-dev-pipeline/skills/review-pipeline/SKILL.md

@@ -0,0 +1,461 @@
+---
+name: review-pipeline
+description: Конвейер ревью изменения — детерминированный гейт, сверка с дельта-спеками в обе стороны, враждебные постановки и эксплуатационный постмортем, независимая реализация по триггеру, архитектура и обязательный триаж. Проходы гонятся последовательно; параллельно — только по явной просьбе и с явно названным набором. Проектная специфика приходит из документов канона av-dev-pm. Вызывается из task-pipeline (чекпоинты ревью), из task-batch (финальная сверка) и отдельно — профилем design на предложении ДО кода.
+---
+
+# Конвейер ревью
+
+Готовит ревью — **не заменяет его**. Потребитель отчёта — оркестратор, который
+чинит код; человек читает только сводку, развилки и границы покрытия.
+
+## Три правила, из которых всё следует
+
+Если ситуация не покрыта инструкцией — решай по ним.
+
+1. **Recall чек-листа равен длине чек-листа.** Проход, устроенный как «проверь
+   пункты 1..N», найдёт ровно перечисленное. Всё неявное — идиомы, форма
+   решения, «так не делают» — неперечислимо по определению: перечислимое уже
+   стало бы конвенцией. Отсюда деление проходов на **applicative** (применяют
+   заданный критерий) и **generative** (сперва порождают критерий или
+   альтернативу, потом сравнивают). Расширять чек-листы бесполезно; неявный слой
+   достают только generative-проходы.
+2. **Ценность верификатора = наличие внешнего оракула × декорреляция с
+   автором**, а не число ролей. Под всеми ролями одна модель с одними
+   априорными, вход у всех общий: седьмая роль почти не добавляет recall, но
+   линейно удорожает триаж. Иерархия надёжности: детерминированный инструмент >
+   агент, который его **запускает** и интерпретирует вывод > агент с чистым
+   мнением. Максимум работы переносим вниз.
+3. **Отчёт без границ покрытия хуже отсутствия отчёта.** «Критичных проблем не
+   обнаружено» потребляет ощущение проверенности, ничего не гарантируя. Секция
+   границ покрытия обязательна и не сокращается — в том числе в докладе человеку.
+
+## Предпосылки
+
+Конвейер опирается на внешнюю обвязку и без неё работает не целиком. Проверь это
+один раз, при установке плагина в проект:
+
+- **OpenSpec — жёсткая предпосылка, а не опция.** Профиль `design`, проход
+  `review-specs` и
+  вызывающий пайплайн задачи завязаны на дельта-спеки
+  (`openspec/changes/<id>/specs/*/spec.md`), на актуальные спеки
+  (`openspec/specs/`) и на `openspec validate --strict`. В проекте без OpenSpec
+  шаги, зовущие `opsx:explore` / `opsx:propose` / `opsx:apply` / `opsx:archive`,
+  упадут на «нет такого скилла», а `review-specs` останется без источника
+  требований. **Проект без OpenSpec этим конвейером не проверяется** — подключай
+  OpenSpec, а не понижай прогон: ветка деградации здесь не пишется, потому что
+  непроверенная ветка деградации хуже честного отказа.
+- **Документы канона** — см. следующий раздел.
+- **Проектные копии этих скиллов и агентов удаляются при установке.** Если в
+  проекте уже лежат свои `.claude/skills/review-pipeline`,
+  `.claude/skills/task-pipeline`, `.claude/skills/task-batch` или
+  `.claude/agents/<проект>-review-*.md` — снеси их. Иначе короткое имя разрешится
+  в устаревшую проектную копию, молча и без признаков подмены. По той же причине
+  **скиллы этого плагина зовутся с пространством имён**:
+  `av-dev-pipeline:review-pipeline`, `av-dev-pipeline:task-pipeline`,
+  `av-dev-pipeline:task-batch`.
+
+## Что конвейер защищает — приходит из документов проекта
+
+Проходы общие, а нарушать нельзя проектное. Инварианты, команду гейта, объёмы,
+прецеденты и модель угроз конвейер **не знает** — он читает их в документах
+канона `av-dev-pm`, **напрямую и по жёстким путям**. Отдельного файла-брифа нет:
+пути известны, посредник не нужен, а второй дом для тех же фактов разошёлся бы и
+выглядел актуальным.
+
+Карта «что нужно проходу → где лежит» —
+[references/project-facts.md](references/project-facts.md). Прочитай её до
+раздачи заданий; там же таблица поразрядной деградации.
+
+**Деградация поразрядная, а не всё-или-ничего.** Документа нет — деградирует то,
+что из него читалось, и только оно: нет `docs/security.md` — слабеет
+`adversary`; нет `docs/research/` — числа неизвестны трём проходам; нет
+инвариантов в `CLAUDE.md` — `critical` по основанию «нарушен инвариант проекта»
+не присваивается никем. Каждый проход пишет **свою** строку в границы покрытия, с
+**причиной**; триаж сводит их и не сливает в одну.
+
+**Документов канона нет вовсе** — проект не приведён к канону. Скажи это строкой
+и предложи скилл `av-dev-pm:canon`: одна операция на проект против деградации на
+каждой задаче. Прогон при этом не останавливается.
+
+## Что получает каждый проход
+
+Задание любому проходу состоит из шести вещей:
+
+- **его блок вопросов** из «Вопросы к проходам» в `docs/review.md`, если он там
+  есть, — **дословно**. Блок адресован проходу поимённо и выведен из промаха
+  этого проекта; заставлять девять charter'ов самим ходить за ним значит
+  получить, что за ним ходят двое. Проход отвечает на такие вопросы явно,
+  дополнительно к обязательным;
+- **контракт находок** — путь к
+  [references/finding-contract.md](references/finding-contract.md) (в
+  установленном плагине — `${CLAUDE_PLUGIN_ROOT}/skills/review-pipeline/references/`);
+- **изменение** — идентификатор change и путь к его дельта-спекам;
+- **база диффа**;
+- **профиль и режим** прогона — чтобы проход знал, что писать в границы покрытия;
+- **сужение**, если оно есть: конкретный узел, конкретная capability.
+
+Чего проход **не** получает ни в каком режиме — выводов других проходов. См.
+«Режим запуска».
+
+## Модель по проходу
+
+Следует из правила 2: чем больше работы делает детерминированный инструмент,
+тем дешевле может быть модель; чем больше проход **порождает** критерий, тем
+дороже. Модель задана во frontmatter каждого агента, менять её здесь не нужно.
+
+| Модель | Проходы | Почему |
+|---|---|---|
+| `sonnet` | gate, code, ops | вход структурный, критерий записан заранее |
+| `opus` | specs, adversary, rubric, reimpl | суждение без опоры на инструмент |
+| `fable` | triage, architecture | ошибка распространяется дальше самой находки |
+
+**Самая дорогая модель — только двум проходам, и это калибровка, а не
+осторожность.** Замер: на первом же прогоне конвейера самые ценные находки дали
+`opus`-проходы — сверка спек дала 13 находок с оракулами, а проход про
+идиоматичность (впоследствии упразднённый) — три эксперимента против драйвера БД
+с воспроизведёнными числами. Разницы в пользу более дорогой модели на
+опиниативных проходах не обнаружилось — значит платить за неё там не за что.
+
+Двое, у кого она остаётся, отобраны по одному признаку: **их ошибка
+распространяется дальше собственной находки.**
+
+- `triage` — через него проходит всё, что оркестратор реализует **молча**:
+  ложноположительная находка становится кодом, потерянный `critical` — дефектом.
+  Ошибка триажа дороже ошибки любого отдельного прохода.
+- `architecture` — запускается редко (только `deep` и `design`), потолок в
+  3 находки делает его дешёвым по выходу, а находка на предложении стоит абзаца
+  против переписывания на готовом коде. Дёшево × высокое плечо.
+
+`reimpl` намеренно **не** в этом списке, хотя он самый ценный из generative: его
+стоимость определяется объёмом вывода (он пишет реализацию целиком), так что
+дорогая модель множит самый большой счёт. Ценность же его — в **независимости**
+взгляда, а не в мощности модели.
+
+**Самая дешёвая модель не используется ни на одном проходе, и это не экономия
+наоборот.** Дешёвая модель на опиниативном проходе даёт правдоподобные находки,
+которые триаж обязан опровергать оракулом, — а это самая дорогая операция
+конвейера. Механизируемая же работа здесь вынесена **ниже** модели: гейт,
+покрытие диффа, карта проекта — это скрипты проекта, они стоят ноль токенов.
+Дешёвому проходу просто не осталось работы.
+
+Экономия достигается не понижением модели, а **непуском прохода**: `quick` —
+четыре прохода, `deep` — семь-восемь. Правило выбора профиля и есть главный
+рычаг стоимости.
+
+## Профили
+
+| Профиль | Когда | Стадии | Проходов |
+|---|---|---|---|
+| `quick` | багфикс, локальная правка, доки | 0, 1, 5 | 4 |
+| `standard` | новая функциональность в существующем пакете | 0, 1, 2, 5 | 6 |
+| `deep` | новый пакет, изменение публичного контракта, миграция схемы, трогает инварианты проекта | 0, 1, 2, 3, 4, 5 | 7–8 |
+| `design` | **до кода**, на предложении | specs + rubric + architecture (см. ниже) | 3 |
+
+**Состав сверяется по этой таблице до коммита.** Реестр из трёх-восьми пунктов
+проверяется взглядом — и это единственная защита от промаха, который уже
+случился: пропуск прохода **не отличим от прохода без находок** (гейт зелёный,
+спеки сошлись, отчёт выглядит полным), а заметить его мог бы только триаж,
+который сам заполняется тем, что ему подали. Отчёт обязан перечислять запущенные
+проходы **поимённо и с исходом**; непущенный идёт строкой «не запускался» в
+границы покрытия, а не отсутствует. Цена молчащего пропуска измерена: семь
+находок и отдельная задача на их дозакрытие.
+
+Правило выбора профиля — **по факту изменения, не по ощущению важности**:
+
+- есть миграция схемы, новый пакет, изменение публичного контракта (API,
+  протокол, формат на диске) или трогается правило, определяющее идентичность и
+  слияние данных → `deep`;
+- иначе меняется поведение, видимое снаружи (эндпоинт, форма ответа, код ответа,
+  формат лога) → `standard`;
+- иначе → `quick`.
+
+Что именно в этом проекте считается публичным контрактом и какие пути означают
+`deep`, проект может уточнить в `docs/review.md`, разделе настройки конвейера. Это
+**уточнение**, а не отмена: не записано — работает список выше.
+
+Профиль объявляется в отчёте. Понижение профиля — решение оркестратора, и оно
+попадает в границы покрытия строкой «профиль понижен до X, потому что …».
+
+## Режим запуска: параллельно или последовательно
+
+Профиль отвечает «какие проходы», режим — «как их запускать». Стадии всегда идут
+по порядку номеров; выбор касается только проходов **внутри** стадии.
+
+| Режим | Как | Когда |
+|---|---|---|
+| **последовательно** (умолчание) | по одному, следующий стартует после отчёта предыдущего | всегда, пока не попросили иначе |
+| **параллельно** | названные проходы — одним сообщением | только по явной просьбе **и** с явно названным набором |
+
+**Умолчание — последовательно, и его не надо обосновывать.** Обосновывается
+отступление.
+
+**Параллельный режим включается при двух условиях сразу**, и второе так же
+обязательно, как первое:
+
+1. **о нём попросили явно** — «гони параллельно», а не «сделай побыстрее»;
+2. **названо, что именно гнать параллельно** — поимённый набор проходов
+   («`specs` и `code` параллельно») или стадия целиком («стадию 1 параллельно»).
+
+Просьба без набора — **не основание**: гоним последовательно и одной строкой
+говорим, что набор не был назван. Это не придирка к формулировке. Параллелить
+можно ровно то, что не мешает друг другу, а знание об этом лежит у того, кто
+просит: он видит, занята ли машина, и ждёт ли он от прогона замеров. Домысливать
+набор за него — значит принять решение, которое он оставил себе.
+
+Почему умолчание именно такое:
+
+- **Замеры.** Проходы `adversary` и `ops` доказывают находки числами: время
+  удержания блокировки против её таймаута, пик кучи против размера тела, темп
+  роста файлов журнала, длительность транзакции. Два меряющих прохода на одной
+  машине соревнуются за диск, CPU и за саму СУБД и выдают числа, которые не
+  воспроизведутся. Это не гипотеза: правило выведено из находок, целиком
+  державшихся на таких замерах, — у каждого проекта они свои и лежат в журнале
+  `docs/review.md`. Число, снятое под конкурентную нагрузку от соседнего
+  прохода, — это находка с испорченным оракулом, а её опровержение стоит дороже
+  всего выигрыша от параллельности.
+- **Машина одна.** Рядом идёт задача, поднят сервис, гоняется гейт или дорогая
+  проверка проекта.
+- **Ранний выход** возможен только при последовательном прогоне (см. ниже).
+- **Разбор самого конвейера.** Когда выясняется, почему проход чего-то не нашёл,
+  порядок и изоляция важнее скорости.
+
+Если параллельный режим всё же включён, в границы покрытия идёт строка: какие
+проходы шли разом и что замеры, снятые в этом прогоне, как оракул слабее.
+
+**Чего режим не меняет — и это не подлежит обсуждению.** Проход **не видит**
+находок других проходов ни в каком режиме. «Последовательно» значит «по
+очереди», а не «следующий читает предыдущего». Вся ценность конвейера держится
+на декорреляции: под всеми ролями одна модель с одними априорными, и стоит
+показать ей чужой вывод — она согласится. Согласие нескольких проходов и так не
+повышает `confidence` (см. «Честный предел»); согласие **наведённое** ещё и
+маскируется под независимое подтверждение. Единственный, кто видит всё, — триаж,
+и это его работа.
+
+**Ранний выход** (последовательный режим делает его возможным — это его побочная
+выгода, а не повод его выбирать). Допустимо остановить прогон, не докатив
+остаток, ровно в одном случае: находка требует **переделки формы** изменения, и
+остальные проходы будут смотреть на код, которого через час не станет. Тогда:
+
+- прогон останавливается, находка чинится, конвейер запускается **заново с
+  нулевой стадии** — а не «доезжает» остатком по старому коду;
+- незапущенные проходы идут в границы покрытия строкой «не запускался: прогон
+  остановлен на <проход> из-за <находка>», поимённо;
+- триаж запускается только на полном прогоне. Отчёт триажа по половине проходов
+  выглядит полным, потому что агрегирует всё, что ему подали, — это тот же
+  молчащий пропуск, что и в разделе «Профили».
+
+Ранний выход по находке, которая чинится в пределах существующей формы
+(`Действие: инлайн`), **не делается**: дешевле дособрать все находки и починить
+пачкой, чем гонять конвейер дважды.
+
+Режим объявляется в отчёте наравне с профилем, и если он **параллельный** — с
+причиной и составом. Последовательный объявляется одним словом.
+
+## Стадия 0 — Gate (обязательна во всех профилях)
+
+Агент `review-gate`. Запускает команду гейта из семантики гейта в `CLAUDE.md` и
+интерпретирует вывод.
+
+**Пока гейт красный — опиниативные проходы не запускаются.** Оркестратор чинит и
+перезапускает гейт. Исключение одно: отказ, унаследованный от базовой ветки
+(гейт проверяет это прогоном на базе) — тогда он фиксируется находкой и не
+блокирует.
+
+Гейт возвращает не только «зелено/красно», но и находки класса **отсутствующая
+верификация**: изменённые строки без покрытия, конкурентность без теста с
+параллельным доступом, флаки-тест (не ниже `major`), недоступный инструмент.
+
+Шаги выбираются по изменённым файлам: правка документации не гоняет тесты,
+линтеры и детектор гонок. Пропуск при этом не молчит — он виден в сводке с
+причиной и уезжает в границы покрытия, как и любой другой `SKIP`.
+
+Шаги, которые красят гейт безусловно, перечислены в `CLAUDE.md` с причиной. Проходу
+запрещено списывать такой отказ в мелочь.
+
+## Стадия 1 — Conformance (обязательна во всех профилях)
+
+Два applicative-прохода: оба применяют **записанный** критерий, оба дешёвые.
+Замеров они не делают и потому безобиднее прочих, если параллельный режим
+попросят с их именами; сами по себе идут по очереди, как и все.
+
+- `review-specs` — критерий взят из **дельта-спек предлагаемого изменения**, а не
+  из proposal, сообщения коммита или описания задачи. Сверка двунаправленная;
+  направление `code → spec` важнее.
+- `review-code` — критерий взят из конвенций проекта, каталог
+  `docs/conventions/`. Берётся только та их часть, которая **не выражается
+  правилом**: механизируемое уже проверила стадия 0. Что именно механизировано,
+  перечисляет `conventions/README.md` — повторять это проходом вредно.
+
+Recall обоих равен длине их источника — это и есть предел applicative-проходов,
+ради которого существует стадия 2.
+
+## Стадия 2 — Adversarial и operational (`standard`, `deep`)
+
+Два прохода:
+
+- `review-adversary` — находка есть **построенный путь**, а не свойство;
+- `review-ops` — постмортем от симптома у владельца сервиса к строке кода.
+
+**Эту пару параллелить не стоит даже по просьбе — переспроси.** Оба доказывают
+находки замером, и оба меряют одно и то же железо. Запущенные разом, они портят
+числа друг другу, а испорченный оракул хуже отсутствующего: находка выглядит
+доказанной. Если их всё же назвали в параллельном наборе — выполняй, но скажи в
+границах покрытия, что числа этого прогона сняты под соседней нагрузкой.
+
+**Эта стадия зарабатывает больше всех остальных вместе, и потому стоит в
+`standard`, а не только в `deep`.** Измерено на пяти задачах подряд: враждебный
+проход дал пять из семи выживших находок дозапуска (включая обе верхние);
+эксплуатационный — единственный, кто нашёл, что откат бинаря поверх новой схемы
+стартует молча. Оба несут внешний оракул по построению: один обязан путь
+**прогнать**, второй смотрит ось времени и эксплуатации, которую не смотрит
+никто другой.
+
+Материал берётся из документов: `docs/security.md` — враждебному,
+`docs/architecture.md`, `docs/research/` и `docs/database.md` —
+эксплуатационному. Что с чем сшивать и почему — [project-facts.md](references/project-facts.md),
+раздел «Сшивать обязаны проходы». Без этих документов стадия вырождается в общие
+места.
+
+## Стадия 3 — Independent reimplementation (`deep`, по триггеру)
+
+- `review-reimpl` — пишет свою реализацию, не открывая существующую, затем
+  диффит по решениям. **Запускается по триггеру, а не всегда:** изменение вводит
+  новое правило идентичности, слияния или разбора (проектная формулировка
+  триггера — в `docs/review.md`, если записана). Это самый дорогой проход конвейера
+  (его счёт определяется объёмом вывода — он пишет реализацию целиком), а вне
+  этого триггера независимый взгляд в значительной мере уже дал профиль `design`:
+  код писался под его находки. Триггер выбран по факту: единственный раз, когда
+  триаж назвал отсутствие `reimpl` дырой покрытия, — это была задача с новым
+  правилом слияния сущностей.
+
+## Стадия 4 — Global (`deep`, `design`)
+
+Агент `review-architecture`. Получает **вход шире диффа**: дерево пакетов с
+назначением, граф внутренних зависимостей, инвентарь существующих концепций.
+Команду, которая это готовит, даёт раздел команд `CLAUDE.md`; нет команды —
+проход собирает карту сам и говорит об этом в границах покрытия.
+
+Главный вопрос — концептуальная целостность и **второй способ** делать то, что
+уже делается. Он же и оправдывает проход: на задаче про пересборку архитектурный
+проход нашёл, что новый код был **вторым проигрывателем журнала** со своим
+порядком. Второй обязательный вопрос — **что опытный человек отсюда удалил бы**:
+слой с единственной реализацией, интерфейс ради мока, незапрошенная
+конфигурируемость, подстраховка поверх подстраховки. Потолок — 3 находки плюс
+секция «дешевле переделать до мерджа».
+
+## Стадия 5 — Triage (обязательна)
+
+Агент `review-triage`. Единственный, кто агрегирует. Получает сырые выводы всех
+проходов, `git diff`, профиль, режим и **список запущенных проходов**; возвращает
+финальный отчёт.
+
+Без триажа проходы дают порядка сорока замечаний при единицах существенных.
+Потребитель здесь — оркестратор, который **молча реализует** всё, что прочитал:
+цена нетриажированного отчёта — не потерянное время человека, а разросшийся от
+вкусовщины код.
+
+Порядок: дедупликация по причине → оракул для всего `critical`/`major` →
+понижение неподтверждённого до гипотезы → отсев вкусовщины → ранжирование по
+ущербу × вероятности → потолок 7 пунктов в основном списке.
+
+## Профиль `design` — до кода
+
+Запускается на шаге ревью спек (шаг 4 скилла `av-dev-pipeline:task-pipeline`),
+когда change уже
+имеет `proposal.md` и дельта-спеки, но кода ещё нет. Состав:
+
+1. `review-specs` в режиме «дизайн ДО кода»;
+2. `review-rubric`, фаза 1 без фазы 2: рубрика на задуманный узел становится
+   приёмочными критериями и уезжает в `tasks.md`;
+3. `review-architecture` на предложении: вводит ли change новое понятие, можно ли
+   выразить существующими — **включая конструкции стандартной библиотеки**, — не
+   появляется ли второй способ. Вопрос «не изобретаем ли то, что уже есть в
+   библиотеке» живёт здесь;
+4. вопрос автору дизайна: **«предложи три формы решения и назови компромисс
+   каждой»** — если ответ показывает, что рассматривалась одна, это находка.
+
+Смысл профиля: архитектурная находка на готовом коде стоит переписывания и
+поэтому игнорируется; та же находка на предложении стоит абзаца обсуждения.
+
+`rubric` живёт **только** в этом профиле. Судить код по критерию, под который он
+писался, — корреляция по построению; те же 8–12 свойств уже лежат приёмочными
+критериями в `tasks.md`.
+
+## Контракт находок
+
+Единый для всех проходов — [references/finding-contract.md](references/finding-contract.md).
+Коротко: заголовок через **последствие**, обязательные поля `Файл`, `Severity`,
+`Confidence`, `Оракул`, `Последствие`, `Предложение`, `Найдено проходом`.
+`critical` без оракула или построенного пути не существует. Находка без поля
+«Последствие» не выводится вовсе.
+
+Каждый проход завершает вывод блоком `## Coverage of this pass`.
+
+## Что происходит с находками дальше
+
+- Оркестратор чинит помеченное `Действие: инлайн` и **не логирует мелочь**.
+- `Действие: развилка` — вопросом с вариантами и ценой каждого туда, где проект
+  держит вопросы (это знает вызвавший пайплайн, а не конвейер). Оркестратор не
+  останавливается: он урезает изменение до остатка и доводит его.
+- Находка не для этого мерджа, но реальная (отложенный `major`, развилка,
+  решённая «потом»), — не теряется, но **и не заводится здесь**. Конвейер отдаёт
+  её **списком урожая** в отчёте: формулировка, оракул, провенанс (какой проход,
+  какой change). Заведение задач принадлежит тому, кто ведёт задачи проекта, —
+  у него свой формат, своя нарезка и свои правила дублей. Мелочь класса `nit`
+  идёт в урожай одной пачкой, а не записью на находку.
+- `Promote candidates` — по процедуре [references/promote.md](references/promote.md):
+  находка → конвенция → правило линтера → **удаление формулировки из конвенций**.
+  Третий шаг обязателен.
+- Дефект, проскочивший ревью и всплывший позже, идёт в журнал проекта
+  ([references/review-journal.md](references/review-journal.md)) — сразу, не
+  ретроспективно: теряется именно причина непоймания.
+- **Отчёт триажа сохраняется вместе с изменением** — `openspec/changes/<id>/review/`.
+  Он единственное, по чему потом видно, что было найдено и что из этого не
+  заведено: нулевой урожай при непустом отчёте виден сразу.
+  **Вместе с изменением он и переезжает:** после `opsx:archive` его адрес —
+  `openspec/changes/archive/<id>/review/`. Кто ищет отчёт после архивации (батч
+  на финальной сверке, приёмщик на сессии), смотрит **оба** пути; «отчёта нет»
+  объявляется, только когда пуст и архивный, иначе самый дорогой сценарий
+  «состав ревью неизвестен, гоняем заново» срабатывает на каждой доведённой
+  задаче.
+
+## Честный предел
+
+Модель воспроизводит медиану публичного кода, смещённую к популярному и
+туториальному: отсюда тяга к интерфейсам ради интерфейсов, лишним мокам и
+конфигурируемости, которую никто не просил. **«Идиоматично» и «распространено» —
+разные вещи**; проходы обязаны различать их и опираться на поимённое положение
+гайда, а не на ощущение частотности.
+
+Согласие нескольких проходов — **не подтверждение**: это один источник,
+высказавшийся несколько раз. Совпадение повышает приоритет, но не `confidence`.
+
+Что недоступно **этому** проекту принципиально — перечисляет «Недоступно
+проверке» в `docs/review.md`, и оба его подраздела целиком уезжают в границы
+покрытия.
+Независимо от проекта недоступно:
+
+- поведение внешних систем в их будущих версиях;
+- реальный профиль нагрузки и то, что на самом деле лежит в данных;
+- завязка внешних потребителей на текущую форму ответа;
+- суждение «этой функциональности не должно существовать».
+
+Отдельно и честно: **поимённая сверка с положениями стайлгайдов языка не
+задаётся ни одним проходом.** Проход про идиоматичность упразднён, его способные
+части переселены (эксперимент против поведения библиотеки и драйвера — в `ops`,
+вопрос 8; «не изобретаем ли то, что уже есть в библиотеке» — в `architecture`,
+вопрос 1), но различение «идиоматично против распространено» теперь не спрашивает
+никто. Класс обратимый — портит форму кода, не данные, — и его надо признавать в
+границах покрытия, а не считать проверенным.
+
+Это и есть причина, по которой конвейер готовит ревью, а не заменяет его.
+
+## Ссылки
+
+- [references/project-facts.md](references/project-facts.md) — что нужно проходу
+  и где это лежит в документах проекта; таблица поразрядной деградации.
+- Skill `av-dev-pm:canon` — приведение проекта к канону документов.
+- [references/finding-contract.md](references/finding-contract.md) — контракт находок.
+- [references/promote.md](references/promote.md) — промоут находка → конвенция → правило → удаление.
+- [references/calibration.md](references/calibration.md) — калибровка инъекцией, вердикты keep/retune/drop.
+- [references/review-journal.md](references/review-journal.md) — журнал проскочивших дефектов.

av-dev-pipeline/skills/review-pipeline/references/calibration.md

@@ -0,0 +1,85 @@
+# Калибровка проходов
+
+Без измерения набор проходов растёт монотонно и вырождается в театр: каждый
+кажется полезным, потому что иногда что-то говорит. Калибровка отвечает на
+единственный вопрос — **ловит ли проход дефект своего класса**.
+
+## Процедура (инъекция дефекта)
+
+1. Взять **реальный коммит** из истории (`git log --oneline`), лучше
+   архивированный change с непустым диффом.
+2. Внести в него **один** дефект того класса, который проход обязан ловить по
+   своему charter'у. Дефект должен быть правдоподобным — таким, какой реально
+   пишет модель, а не карикатурой (`panic("TODO")` не считается).
+3. Прогнать **только этот проход** на подготовленном диффе — **три раза**,
+   каждый в чистом контексте.
+4. Зафиксировать: нашёл `n/3`, число находок всего, число ложных.
+5. Вердикт:
+
+| Результат | Вердикт | Что делаем |
+|---|---|---|
+| нашёл 3/3 или 2/3, ложных немного | `keep` | ничего |
+| нашёл 1/3 или 0/3 | `retune` | правим charter — сужаем вход, убираем чек-лист, добавляем оракул |
+| `retune` уже был дважды подряд | `drop` | удаляем проход |
+| находит, но ложных больше трети от всех находок | `retune` | триаж съедает больше, чем экономит проход |
+
+**`retune` не более двух раз подряд.** Проход, не находящий дефект своего класса
+в 2 из 3 прогонов после двух правок промпта, — это театр. Удалять, а не
+бесконечно править формулировки: каждая итерация правки промпта стоит дороже,
+чем отсутствие прохода.
+
+**Существующий проход не удаляется без замера.** Сначала калибровка, потом
+решение — иначе удаляется то, что работало, а остаётся то, что громче. Обратный
+пример уже был: проход про идиоматичность стоял в списке на удаление как
+«вкусовщина», а замер показал, что он зарабатывает **экспериментами против
+поведения библиотеки и драйвера**, — и находка, воспроизведённая числом, отменила
+решение, принятое по ощущению.
+
+## Состав проходов принадлежит плагину, а не проекту
+
+Проходы общие. Проект не может удалить проход — он может **не звать** его, и
+тогда это идёт строкой «не запускался» в границы покрытия, как любой другой
+пропуск. Молча сузить состав нельзя: пропуск прохода не отличим от прохода без
+находок.
+
+Отсюда два следствия:
+
+- **правка charter'а — правка для всех проектов.** Прежде чем сужать
+  формулировку под свою боль, проверь, не место ли ей в документах проекта: предмет проверки
+  живёт там, метод — в charter'е;
+- **удаление прохода из плагина требует замера на двух проектах**, а не на одном:
+  класс, не всплывший здесь, мог быть единственным работающим там.
+
+## Пробы дефектов по проходам
+
+Проба — заготовка инъекции. Список пополняется из журнала проскочивших дефектов
+(см. [review-journal.md](review-journal.md)): реальный проскочивший дефект —
+лучшая проба, какая вообще возможна, потому что синтетические смещены в сторону
+тех, которые уже умеешь придумывать.
+
+| Проход | Класс дефекта для инъекции | Заготовка пробы |
+|---|---|---|
+| `review-gate` | отсутствующая верификация | убрать тест на изменённую ветку, оставить код рабочим |
+| `review-specs` | поведение вне спеки | добавить незаказанный фолбэк-дефолт на пустом входе |
+| `review-code` | нарушение прозаической конвенции | увести штатный отказ мимо единой точки трансляции ошибки |
+| `review-rubric` | нарушенное свойство узла | у клиента внешнего сервиса убрать таймаут и протяжку `context` |
+| `review-reimpl` | форма решения | размазать решение по трём слоям там, где хватало одной функции |
+| `review-architecture` | второй способ | завести вторую точку генерации id мимо единой |
+| `review-adversary` | построенный путь | принять внешний идентификатор без разбора до запроса в хранилище |
+| `review-ops` | деградация окружения | убрать обработку недоступности внешней зависимости в фоновом цикле |
+| `review-triage` | шум | подать 20 находок, из них 15 вкусовщина и 3 дубля — проверить потолок и дедуп |
+
+Метрик сверх этого не заводим. Precision, корреляция между проходами, стоимость
+прогона в токенах — всё это красиво звучит и никем не считается вручную; набор
+показателей, который не собирают, создаёт впечатление измеряемости и тем вреден.
+Работает ровно один механизм: инъекция дефекта и вердикт. Если корреляция двух
+проходов действительно бросается в глаза — это видно по полю `Найдено проходом`
+в триажированных отчётах и без отдельной метрики.
+
+## Когда калибровать
+
+- при заведении нового прохода — **до** включения в профиль по умолчанию;
+- при правке charter'а существующего — иначе непонятно, правка помогла или нет;
+- при появлении записи в журнале проскочивших дефектов — калибруем тот проход,
+  который должен был поймать;
+- планово — нет. Календарная калибровка ради галочки сама превращается в театр.

av-dev-pipeline/skills/review-pipeline/references/finding-contract.md

@@ -0,0 +1,97 @@
+# Контракт находок
+
+Единый формат для всех проходов конвейера ревью. Проход, нарушивший контракт,
+считается сломанным — триаж вправе выбросить его вывод целиком.
+
+## Форма находки
+
+```
+### <краткая формулировка ПОСЛЕДСТВИЯ, не симптома>
+- Файл: internal/<пакет>/<файл>.go:120-134
+- Severity: critical | major | minor | nit
+- Confidence: high | medium | low
+- Оракул: <падающий тест / команда с выводом / положение гайда / нет>
+- Последствие: <что произойдёт и при каких условиях>
+- Предложение: <конкретное изменение>
+- Найдено проходом: <имя агента>
+```
+
+## Правила
+
+- **Заголовок через последствие.** Не «нет проверки токена», а «читатель без
+  токена выгрузит всю историю». Не «слияние перезаписывает запись», а «повторная
+  доставка сотрёт поля у уже сохранённой записи, и восстановить их нечем».
+  Симптом в заголовке — это заявка на то, что читатель сам достроит последствие;
+  он не достроит, он просто починит симптом.
+- **`critical` без оракула или построенного пути не существует.** Оракул — это
+  падающий тест, вывод выполненной команды или поимённое положение гайда. Не
+  «вероятно, здесь гонка», а прогон детектора гонок с его выводом.
+- **`confidence: low` — это «так обычно пишут».** Такие находки допустимы, но не
+  поднимаются выше `minor`. Частотность конструкции в публичном коде — не
+  аргумент.
+- **Находка без поля «Последствие» не выводится вовсе.** Пустое «Последствие:
+  ухудшает читаемость» равносильно отсутствию поля.
+- **`nit` допустим только при нарушении записанной конвенции** — со ссылкой на
+  файл и раздел конвенций проекта (`docs/conventions/`) либо на
+  правило линтера. Если правило механизируемо, но не механизировано — это не
+  находка ревью, это `Promote candidate` (см. [promote.md](promote.md)).
+- **`critical` по основанию «нарушен инвариант проекта» требует инвариантов.**
+  Ссылка идёт на пункт раздела инвариантов `CLAUDE.md` дословно. Без них основание
+  недоступно — см. [project-facts.md](project-facts.md), поразрядная деградация.
+- **Расхождение — не дефект, пока не названо последствие.** Особенно для прохода
+  независимой реализации: «я бы сделал иначе» без последствия не выводится.
+
+## Шкала severity
+
+| Severity | Что это | Пример |
+|---|---|---|
+| `critical` | нарушение инварианта проекта, потеря или порча данных, утечка секрета, построенный путь к отказу | запись потеряна при слиянии; тело пользовательской выгрузки в поле лога |
+| `major` | сломанное требование дельта-спеки, необрабатываемый отказ штатного сценария, флаки-тест, поведение вне спеки, меняющее исход | приём отвечает 200, не записав тело: доставка считается принятой, а данных нет |
+| `minor` | отступление от конвенции с реальной ценой, отсутствующая наблюдаемость, дублирование, которое разойдётся | ни одного чекпоинта на пути разбора: молчащая автоматизация неотличима от пустого потока |
+| `nit` | нарушение записанной конвенции без последствий за пределами чтения | `msg` с интерполяцией вместо константы |
+
+Шкала привязана к обратимости, а не к громкости: класс «необратимо и молча»
+всегда весит больше класса «шумно и лечится повтором». Что здесь необратимо,
+говорит `CLAUDE.md` — что в этом проекте необратимо.
+
+## Блок границ покрытия
+
+Каждый проход завершает вывод этим блоком. Он не сокращается и не заменяется
+фразой «всё проверено».
+
+```
+## Coverage of this pass
+- проверено: <что реально прочитано/запущено, с путями и командами>
+- не проверялось и почему: <бюджет, недоступный инструмент, вне входа>
+- принципиально недоступно этому проходу: <из charter'а агента>
+```
+
+## Финальный отчёт триажа
+
+Секции строго в этом порядке, потолок — 7 пунктов в первых двух:
+
+1. `Блокирует мердж` (≤3, каждая с оракулом);
+2. `Стоит исправить сейчас` (≤4);
+3. `Гипотезы без доказательства` — что понижено и почему;
+4. `Promote candidates` — кандидаты в конвенцию или правило линтера;
+5. `Границы покрытия` — сводная, обязательная.
+
+Перед секциями — сводка для человека: профиль и режим прогона, состояние гейта,
+**перечень запущенных проходов поимённо с исходом каждого**, сколько находок
+пришло на вход и сколько осталось. Перечень обязателен: пропуск прохода не
+отличим от прохода без находок, и назвать его больше некому.
+
+Каждая находка в секциях 1–2 несёт дополнительное поле:
+
+```
+- Действие: инлайн | развилка
+```
+
+`инлайн` — оркестратор чинит сам, не спрашивая и не логируя. `развилка` — цена
+исправления сопоставима с переработкой, либо выбор меняет scope, либо решение
+трогает инвариант: уезжает вопросом с вариантами и ценой каждого туда, где
+проект держит вопросы, а работа продолжается на остатке.
+
+Потребитель отчёта — оркестратор, который **реализует прочитанное**. Поэтому
+потолок в 7 пунктов — не забота о внимании читателя, а защита кодовой базы от
+правок, которых никто не заказывал.

av-dev-pipeline/skills/review-pipeline/references/project-facts.md

@@ -0,0 +1,92 @@
+# Откуда проход берёт проектную конкретику
+
+Конвейер общий, находки — проектные. Проход, не знающий, что в этом проекте
+нельзя нарушать, чем краснеет гейт и сколько данных реально идёт через узел,
+выдаёт правдоподобные общие места: их дорого опровергать и нечем подтверждать.
+
+Отдельного файла-брифа **нет**. Проектная конкретика живёт в документах канона
+`av-dev-pm`, и проход читает их напрямую: пути жёсткие, посредник не нужен, а
+второй дом для тех же фактов разошёлся бы и выглядел актуальным.
+
+Определение канона — в плагине `av-dev-pm`,
+`skills/canon/references/canon.md`. Здесь только карта «что нужно проходу →
+где это лежит».
+
+## Карта
+
+| Что нужно проходу | Где лежит |
+| --- | --- |
+| что система делает и **чего не делает**, граница домена | `docs/passport.md` |
+| инварианты **с severity рядом с формулировкой** | `CLAUDE.md`, раздел инвариантов |
+| команда гейта, чем краснеет безусловно, чего в нём нет, кто гоняет дорогое | `CLAUDE.md`, семантика гейта |
+| что запускать запрещено, с путями; `testdata`; куда писать временное; имя основной ветки | `CLAUDE.md` |
+| компоненты и capability, окружение, внешние зависимости поимённо, наблюдатель, характер потока, единые точки проекта | `docs/architecture.md` |
+| чем физически лежит запись, что при чтении и записи, настройки с числовым значением | `docs/database.md` |
+| периметр, недоверенный вход, из чего строятся пути и ключи, что вне модели | `docs/security.md` |
+| измеренные числа **с провенансом**, поведение внешних систем на самом деле | `docs/research/` |
+| конвенции прозой и **что уже механизировано** правилом | `docs/conventions/` |
+| почему решено так, отвергнутые варианты | `docs/adr/` |
+| типовые узлы, типовые ложноположительные, вопросы к проходам, **триггеры профиля**, недоступно проверке | `docs/review.md`, раздел настройки |
+| прецеденты: воспроизведённые дефекты с оракулом | `docs/review.md`, журнал |
+| нормативное поведение и дельты изменения | `openspec/specs/`, `openspec/changes/<id>/specs/` |
+
+## Сшивать обязаны проходы
+
+Раньше эти факты лежали рядом в одном файле, и соседство работало само. Теперь
+они разложены по домам, и **проход обязан собрать их сам** — иначе снимет верное
+число и честно понизит находку до гипотезы, потому что сравнить будет не с чем.
+
+Два обязательных стыка:
+
+- **замер + настройка.** «Пик 768 МиБ» — аномалия только рядом со строкой
+  «запись лежит сжатой и распаковывается целиком»; «блокировка удерживалась
+  5.019 с» — гарантированный отказ соседа только рядом с известным таймаутом
+  занятости. Числа в `docs/research/`, настройки в `docs/database.md`, и оба
+  читает `ops`, `adversary`, `reimpl`.
+- **инвариант + обратимость.** severity берётся из `CLAUDE.md`; если её там
+  нет — она **выводится по обратимости последствия** и помечается «выведена по
+  обратимости», а не выдаётся за решение проекта.
+
+## Деградация — поразрядная
+
+Документа нет — деградирует то, что из него читалось, и **только оно**. Каждый
+проход пишет **свою** строку в границы покрытия; триаж собирает их в один
+список и **не сливает в одну строку**: разные пробелы чинятся разным — периметр
+пишется руками за десять минут, а числа требуют замера.
+
+**Кто какой документ читает — не здесь.** Полный список читателей ведёт канон
+(`Skill av-dev-pm:canon`, его `references/canon.md`, таблица «Кто читает»); ниже —
+только **последствие** отсутствия, и оно называет самое дорогое, а не всех
+пострадавших. Два списка читателей уже однажды разошлись; второго раза не надо.
+
+| Нет документа | Что деградирует |
+| --- | --- |
+| `CLAUDE.md` без инвариантов | `critical` по основанию «нарушен инвариант проекта» не присваивается никем |
+| `docs/security.md` | `adversary` не знает периметра — формулирует условиями, `critical` не ставит |
+| `docs/research/` | числа неизвестны `specs`, `ops`, `adversary`, `reimpl` — формулируют условиями, а `specs` теряет проверку «требование против наблюдения» |
+| `docs/database.md` | замер не с чем сравнить: находка не поднимается выше гипотезы |
+| `docs/passport.md` | `architecture` теряет границу домена и вырождается в общее мнение |
+| `docs/review.md` | `triage` отсеивает вслепую: типовых ложноположительных нет |
+| `docs/architecture.md` | «не появился ли второй способ» не проверяется — единых точек не знает никто |
+
+Строка в границах покрытия обязана называть **причину**: «`docs/security.md` в
+проекте нет» читается иначе, чем «есть, но периметр не назван». Без причины
+строка неотличима от «мы просто не стали» и перестаёт читаться на третьей задаче.
+
+**Документов канона нет вовсе** — проект не приведён к канону. Это не повод
+работать вслепую: скажи об этом строкой и предложи `av-dev-pm:canon`. Одна
+операция на проект против деградации на каждой задаче.
+
+## Правило чтения
+
+- **Читай в источнике, не по памяти.** Документы правятся по ходу работы, в том
+  числе этой же задачей.
+- **Число без провенанса — условие, а не утверждение.** Число, чей источник по
+  ссылке не подтвердился, читается как условие и **называется расходящимся**, а
+  не подменяется догадкой.
+- **Пустое, названное пустым, — это факт.** «Внешних зависимостей нет — смотри
+  на диск и на СУБД» экономит обязательный вопрос. Отсутствие строки — не факт,
+  а пробел, и его надо назвать в границах покрытия.
+- **Свойство, ставшее правилом линтера, из конвенций удалено** и лежит в
+  перечне механизированного в `docs/conventions/README.md`. Проверять его
+  проходом — тратить внимание на уже проверенное.

av-dev-pipeline/skills/review-pipeline/references/promote.md

@@ -0,0 +1,96 @@
+# Промоут: находка → конвенция → правило → удаление
+
+Механизм храповика. Без него конвейер выдаёт одни и те же находки бесконечно, а
+конвенции не растут — то есть внимание тратится повторно на уже решённое.
+
+Роли уровней:
+
+- **generative-проходы** — механизм *открытия* неявного (дорого, шумно, но
+  только они достают то, чего нет в списках);
+- **конвенции** — дешёвая *регрессионная сетка* на уже открытое;
+- **правила линтера** — то же с детерминированным оракулом и нулевой ценой
+  внимания.
+
+## Шаг 1. Находка → конвенция
+
+Условия: находка **принята** при ревью (не отвергнута, не понижена в гипотезу) и
+**не специфична для одного места**.
+
+- Формулируется как **проверяемое свойство**, а не как совет: «уровень доменного
+  отказа выбирает единственный логирующий чекпоинт», а не «внимательнее с
+  уровнями логов».
+- Записывается источник — какой проход нашёл. Это единственные данные для
+  калибровки: проход, чьи находки регулярно доезжают до конвенции, оправдан;
+  проход, чьи находки не доезжают никогда, — кандидат на `drop` (см.
+  [calibration.md](calibration.md)).
+- Место записи — конвенции проекта, файл или нужный файл каталога (путь — в
+  каталог `docs/conventions/`). Если
+  тема относится к поведению системы, а не к тому, как мы пишем код, — это не
+  конвенция, а требование: заводится дельта-спека обычным путём.
+
+Промоут идёт **тем же путём, что change → spec**: правка попадает в тот же
+коммит, что и исправление кода, с пометкой в сообщении — история промоутов
+остаётся видна в `git log` по файлу конвенций.
+
+## Шаг 2. Конвенция → правило
+
+Как только свойство выражается детерминированно, оно переезжает в инструмент.
+Порядок предпочтения — от дешёвого к дорогому:
+
+1. **готовое правило существующего линтера** — включить в конфиг;
+2. **запрет идентификатора или импорта** правилом-«запретителем» с собственным
+   паттерном;
+3. **правило с настройкой формы** — когда важно не имя, а конструкция;
+4. **тест-сканер исходников** — когда правило про структуру проекта или про
+   схему: направление зависимостей, форма миграций, матчинг ошибки по тексту,
+   бизнес-логика в транспорте;
+5. **собственный анализатор** — последний рубеж, заводим только если 1–4 не
+   выражают правило.
+
+Правило обязано быть **зелёным на текущем коде в момент включения**: иначе
+хук блокирует любой коммит, и правило снимут первым же раздражённым движением.
+Приводить код в соответствие — часть шага 2, отдельным коммитом.
+
+## Шаг 3. Удаление из конвенций и из промптов
+
+**Шаг, который пропускают чаще всего, и единственный, ради которого затевались
+первые два.**
+
+Как только правило работает:
+
+- из файла конвенций убирается формулировка правила; остаётся, если нужно, одна
+  строка «проверяется линтером `<имя>`» — но только там, где без неё раздел
+  теряет связность;
+- правило переезжает в **перечень механизированного в
+  `docs/conventions/README.md`** — со ссылкой на место механизации: конфиг
+  линтера, собственный анализатор, тест-сканер исходников. Непойманное место
+  означает, что проход будет добросовестно проверять уже проверенное;
+- из контекста инструмента спек убирается дубль, если он там был.
+
+Charter'ы проходов при этом **не правятся**: они общие и живут в плагине, а
+предмет проверки приходит из документов проекта. Именно поэтому шаг 3 дешевле,
+чем был:
+вычеркнуть строку в одном файле проекта, а не в девяти промптах.
+
+Практический критерий: **в прозаических конвенциях остаётся только то, что
+принципиально не выражается правилом.** Файл конвенций на несколько сотен строк
+размазывает внимание модели по тривиальному — она добросовестно проверит
+именование полей лога и не дойдёт до формы решения. Каждая строка конвенций,
+которую можно было бы проверить машиной, оплачивается непойманным дефектом
+где-то ещё.
+
+## Обратное движение
+
+Правило, которое даёт ложные срабатывания чаще, чем ловит (порядка трети от
+общего числа), снимается и возвращается в прозу — или удаляется совсем, если
+свойство перестало быть важным. Снятие фиксируется там же, где включалось, с
+одной строкой «почему».
+
+## Что промоуту не подлежит
+
+- Находка, специфичная для одного места (её лечит комментарий в коде).
+- Вкусовщина: не меняет поведения, не влияет на стоимость следующего изменения,
+  не нарушает записанного. Такое выбрасывается на триаже и не хранится.
+- Свойство, требующее знания рантайма (профиль нагрузки, история инцидентов) —
+  его нельзя проверить ни промптом, ни линтером; место такому — в журнале ревью
+  как «признано неавтоматизируемым» (см. [review-journal.md](review-journal.md)).

av-dev-pipeline/skills/review-pipeline/references/review-journal.md

@@ -0,0 +1,106 @@
+# Журнал дефектов
+
+Артефакт проекта, а не плагина: файл живёт в репозитории — **`docs/review.md`**,
+слот канона `av-dev-pm`. Здесь описано, зачем он и какой формы, потому что без
+него конвейер не учится: находки закрываются, причины непоймания теряются, и один
+и тот же класс проскакивает второй раз.
+
+Тот же файл держит **настройку конвейера под проект** — типовые узлы, типовые
+ложноположительные, вопросы к проходам, недоступно проверке. Это не соседство по
+случаю: все четыре раздела — производные калибровки, а журнал им источник.
+
+## Что туда попадает
+
+**Воспроизведённый дефект — с пометкой `проскочил` или `пойман ревью`.**
+Записывается **сразу**, а не ретроспективно: со временем теряется не сам факт, а
+причина непоймания — единственное, ради чего журнал существует.
+
+Пометка делит журнал на две выборки с разным назначением:
+
+- **проскочил** — эвал-сет для калибровки конвейера. Реальный промах сильнее
+  синтетической пробы: синтетические смещены в сторону тех, которые уже умеешь
+  придумывать;
+- **пойман ревью** — прецеденты с оракулом. Самая сильная опора, какая у прохода
+  бывает: проектная, воспроизводимая и однажды уже оказавшаяся правдой. Без
+  журнала они остаются только в отчётах триажа в архиве change, где их никто не
+  ищет.
+
+Реализованные задачи и принятые решения сюда не пишутся: у них есть коммит, спека
+и `docs/adr/`.
+
+Отдельно сюда попадают **решения о составе прогонов**: перестали звать проход,
+понизили профиль правилом, сузили класс проверяемого. Не потому, что это промах,
+а потому, что здесь лежит цена: если что-то теперь проскочит, первый вопрос —
+«не тот ли это класс, который мы перестали проверять».
+
+Каждое такое решение обязано получить строку в подразделе **«Перестали проверять
+сознательно»** раздела «Недоступно проверке» того же файла. Журнал хранит «почему
+тогда так решили», раздел настройки — то, во что смотрит каждый прогон. Решение,
+оставшееся только в журнале, в границы покрытия не доедет.
+
+## Форма записи
+
+**Это дом формы, и у него есть копия.** Скелет `docs/review.md`, который кладёт
+в проект `av-dev-pm` (`skills/canon/references/skeletons.md`), повторяет её
+дословно — он уезжает в репозиторий и обязан там что-то говорить. Правка формы
+здесь **обязана** тянуть правку скелета и запись в журнал версий канона; иначе
+проекты продолжат писать по старой форме, а конвейер — ждать поля, которого нет.
+Дословность сверяет `scripts/copies.py` маркетплейса по маркерам ниже — но
+запись в журнал версий он не проверит, это остаётся на человеке.
+
+<!-- дом: журнал-дефектов-форма -->
+```
+## ГГГГ-ММ-ДД — <краткое последствие> [проскочил|пойман]
+
+- **Где:** путь:строка либо «конвейер, а не код»
+- **Симптом:** как обнаружилось, кем и когда
+- **Причина:** что на самом деле было не так
+- **Чем воспроизведён:** тест, команда, замер — с числами
+- **Почему не поймали:** только для проскочивших — какой проход обязан был найти
+  и что ему помешало
+- **Что меняем:** правило прохода, шаг гейта, конвенция, факт в документе
+  проекта — либо «ничего, цена поимки выше цены дефекта»
+```
+<!-- /дом: журнал-дефектов-форма -->
+
+Пункт «чем воспроизведён» отличает запись от байки: без него на неё нельзя
+сослаться как на оракул. Регрессионный тест, написанный вместе с починкой,
+годится наравне с независимым экспериментом — он исполняемый и падает на старом
+коде. Слабее он ровно в одном: сформулирован уже зная ответ, и это отмечается
+словом.
+
+Последний пункт важнее остальных. Вывод «ничего не меняем» — законный исход: не
+всякий дефект стоит того, чтобы усложнять ради него ревью каждой задачи.
+
+## Куда ведёт запись
+
+Три адреса, и выбор между ними — половина ценности журнала:
+
+- **в документ проекта** — если проход не мог знать факта. Адрес зависит от рода
+  факта, и карта их всех — [project-facts.md](project-facts.md): объём и
+  измеренное число → `docs/research/`; настройка хранилища → `docs/database.md`;
+  что необратимо и какой шаг гейта красит безусловно → `CLAUDE.md`; периметр и
+  недоверенный вход → `docs/security.md`. **Вопрос конкретному проходу**, если
+  промах лечится не фактом, а заданным вопросом, → раздел «Вопросы к проходам»
+  того же `docs/review.md`. Самый частый адрес и самый дешёвый. Прежде чем
+  править charter, проверь, не хватит ли факта или вопроса: charter общий для
+  всех проектов, документ — про этот.
+- **в конвенции или в правило линтера** — если свойство выражается
+  детерминированно (процедура — [promote.md](promote.md)).
+- **в charter прохода** — если сломан **метод**, а не знание. Правка charter'а
+  меняет поведение во всех проектах, поэтому она требует калибровки
+  ([calibration.md](calibration.md)) и обоснования, почему это не лечится фактом
+  в документе проекта.
+
+## Что журнал даёт конвейеру
+
+- **пробы для калибровки** — выборка по пометке `проскочил`;
+- **готовые оракулы** — выборка по пометке `пойман ревью`: находка того же
+  класса подтверждается ссылкой на запись, а не рассуждением;
+- **основание для правил конвейера** — требование называть запущенные проходы
+  поимённо, отказ от чисел, производных от размера корпуса, и правило
+  последовательного прогона выведены из конкретных записей, а не из общих
+  соображений;
+- **счётчик обратимости решений** — сузили состав проходов и через месяц поймали
+  дефект ровно того класса, который перестали проверять: решение пересматривается
+  фактом, а не спором.

av-dev-pipeline/skills/task-batch/SKILL.md

@@ -0,0 +1,360 @@
+---
+name: task-batch
+description: Проводит несколько задач разом — планирует порядок и пересечения, гонит каждую задачу отдельным сабагентом в своём git worktree через task-pipeline, интегрирует по одной ветке через rebase + fast-forward (линейная история), проверяет полноту ревью каждой ветки и в конце сверяет стыки, возникшие от слияния. Набор задач приходит извне. Использовать, когда просят сделать несколько задач сразу.
+---
+
+# Батч задач
+
+Оркестратор **набора** задач. Планирует порядок, раскидывает задачи по
+изолированным worktree, каждую проводит через полный цикл
+`av-dev-pipeline:task-pipeline`, затем сводит в основную ветку линейной историей
+и делает финальную сверку. Тонкая обёртка над пайплайном задачи — не
+переизобретай её шаги, вызывай как есть.
+
+Работай **максимально автономно**, по тому же принципу, что и одиночный пайплайн:
+вопрос, который решать не тебе, записывается и не останавливает поток; спрашиваем
+только про **необратимое** (деплой, выкладка наружу, удаление или перезапись
+рабочих данных). Механику — планирование, worktree, rebase, интеграцию, чистку —
+делаем без спроса.
+
+## Предпосылки
+
+- **OpenSpec и скиллы `opsx:*`** — на них стоит цикл внутри каждого сабагента и
+  проход `review-specs` финальной сверки. Проекта без OpenSpec это касается так
+  же, как одиночного пайплайна (см. его раздел «Предпосылки»).
+- **Скиллы зовутся с пространством имён**: `av-dev-pipeline:task-pipeline`,
+  `av-dev-pipeline:review-pipeline`, `av-dev-pm:tasks`. Короткое имя
+  может разрешиться в устаревшую проектную копию, и это произойдёт молча — в
+  charter'е сабагента пиши полное имя, он твоего контекста не видит.
+- **Проектные копии этих скиллов и агентов при установке плагина удаляются.**
+
+Перед стартом прочитай `CLAUDE.md` проекта: оттуда берутся **имя основной
+ветки** (оно подставляется в каждую команду git ниже), команда и семантика
+гейта, инварианты и что запускать запрещено. Раскладка нумерованных артефактов —
+`docs/database.md` и `docs/.pm.json` (ключ `migrations`).
+
+**Документов канона нет — проект к нему не приведён.** Скажи это строкой и
+предложи `av-dev-pm:canon` **до первой волны**: иначе каждая задача батча
+заплатит поразрядной деградацией ревью, а имя основной ветки придётся
+угадывать.
+
+## Границы
+
+- **Набор задач приходит извне.** Батч его не формирует: не выбирает из беклога,
+  не приоритизирует, не решает, что важнее. Набор не задан — попроси его у
+  вызывающего и остановись.
+- **Батч не владеет спринтом и целями.** Он сообщает исход по каждой задаче в тех
+  же трёх словах, что и `task-pipeline`: сделана / не доведена / оказалась крупнее
+  задачи.
+- **Задачи закрывает пайплайн внутри каждого сабагента**, шагом 11 — после
+  коммита работы и **отдельным коммитом учёта**, вызовом Skill `av-dev-pm:tasks`.
+  Батч сам записей учёта не трогает: он не знает, чем кончилась приёмка, и
+  дублировать закрытие ему незачем. Но грязное дерево после сабагента — **его**
+  проблема: на нём откажут и `rebase`, и `worktree remove` (см. шаг 6). Урожай ревью батч
+  отдаёт списком, а задачи из него заводит тот, кто ведёт задачи проекта.
+
+## Ключевое отличие от одиночного пайплайна
+
+`task-pipeline` коммитит **в текущую ветку**, и при ручном запуске это основная
+ветка. Здесь так нельзя для параллельных задач, поэтому батч — **осознанное
+исключение**: временные ветки и worktree заводятся лишь как средство изоляции, а
+конечное состояние — та же линейная история основной ветки через rebase +
+fast-forward. Ветки после вливания удаляются.
+
+## Модель исполнения
+
+- Каждая задача = **один автономный сабагент** (`general-purpose`, чтобы иметь
+  доступ к Skill и Agent для вложенных чекпоинтов ревью), работающий **только в
+  своём worktree** и прогоняющий `task-pipeline` целиком на этой задаче.
+- Оркестратор кода задач не пишет: он планирует, заводит worktree, запускает
+  сабагентов, проверяет полноту их ревью, интегрирует ветки и делает финальную
+  сверку.
+- Стиль правок внутри — заточка под проект и конвенции, right-size, без
+  золочения.
+
+## Шаги
+
+### 1. Прочитать набор
+
+Набор задан списком (слаги, файлы, описания) — прочитай файл каждой задачи и
+связанные спеки и черновики. Задачи-идеи включаются, но помни: сабагент проведёт
+их сперва через `opsx:explore`, это тяжелее и чаще упирается в вопрос.
+
+### 2. Спланировать порядок и пересечения (автономно)
+
+Для каждой задачи определи:
+
+- **затронутые capability** — по её описанию и по каталогу актуальных спек
+  (`openspec/specs/`);
+- **жёсткие зависимости**: задача B строится на результате A → A строго раньше B;
+- **замеряющая задача** — та, чьё ревью будет доказывать находки **числами**, и
+  потому она гонится в волне **одна** (обоснование — ниже, в шаге 4). Решается
+  здесь, на планировании, а не во время прогона: состав волны определяется
+  сейчас, а профиль ревью сабагент выберет только внутри задачи, и ключевать
+  волну на ещё не сделанный выбор нельзя. Триггеры — по фактам о задаче, каждый
+  сам по себе достаточен:
+  - трогает схему хранилища, миграцию, формат на диске или объём хранимого;
+  - трогает конкурентность: транзакции, блокировки, фоновые циклы, общее
+    состояние;
+  - трогает размер тела, буфер, память, сжатие, ретеншен, темп потока;
+  - её тема названа в `docs/research/` или в журнале `docs/review.md` как место,
+    где уже мерили или уже ломалось.
+
+  Ни один триггер не сработал — задача не замеряющая, даже если её ревью
+  окажется `deep`. `deep` про глубину проверки, замеряющая — про соревнование за
+  железо; это разные вопросы, и совпадают они не всегда;
+- **нумерованные артефакты — номера раздаёт оркестратор заранее.** Если проект
+  нумерует миграции (путь — `docs/.pm.json`, ключ `migrations`), посмотри последний
+  номер и **раздай номера всем задачам, которые, вероятно, их добавят**, до
+  запуска. Номер уходит в charter сабагента, и он берёт назначенный, а не
+  «следующий свободный».
+
+  **Это отдельная механика от правила волны, и она ему не служит** — их раньше
+  путали, и они тянули в разные стороны. Правило волны отвечает на вопрос «кто с
+  кем гонится одновременно», предраздача — на вопрос «какой номер берёт задача».
+  Раздача нужна там, где **две задачи одной под-пачки** добавляют нумерованный
+  артефакт: каждая считает «следующий свободный» по основной ветке, которая ещё
+  не видела соседку, и обе берут один номер. Миграции под это почти не попадают —
+  миграция и так триггер замеряющей задачи, а замеряющая идёт одна; но
+  нумерованные артефакты бывают не только миграциями. Поэтому номера раздаются
+  **всем** задачам с таким артефактом, независимо от того, в какой волне они
+  окажутся: раздача ничего не стоит, а её отсутствие ловится только конфликтом на
+  интеграции. Между волнами проблемы нет — ветка следующей волны берётся от
+  вершины, уже включающей предыдущие;
+- **жёстко сериализуем** (не гоняем одновременно) настоящие пересечения:
+  - **одна capability на несколько задач** — две задачи, правящие одну спеку (тем
+    более одно и то же `### Requirement`), дают не текстовый, а **семантический**
+    конфликт при архивации; сериализуем по смыслу, а не только по файлам;
+  - пересечение по одним и тем же исходникам;
+- **мягкие конфликты** сериализовать не надо: файлы-перечни, где каждая задача
+  правит **свою** строку (индексы, оглавления, списки записей), и спеки разных
+  capability — разные строки и файлы, сливаются сами.
+
+Собери план: **волны** параллельно-безопасных задач плюс сериализованный хвост
+конфликтоопасных, с учётом зависимостей; замеряющие задачи стоят в плане
+отдельными волнами по одной. Покажи план короткой репликой — назвав, какие
+задачи признаны замеряющими и по какому триггеру, — и иди дальше.
+
+### 3. Свежая база
+
+Убедись, что рабочее дерево чистое и основная ветка свежая. Зафиксируй базовый
+коммит. Новые ветки бери от свежей вершины; ветки следующей волны — от вершины,
+уже включающей результат предыдущих волн.
+
+### 4. Прогнать волны
+
+**Потолок параллелизма — 2–3 задачи одновременно.** Каждая задача тянет полный
+цикл пайплайна с вложенным ревью и гейтом, поэтому больше трёх разом душат
+машину и провоцируют гонки. Волну шире трёх бей на под-пачки по ≤3 и **гони
+под-пачки последовательно**: следующая стартует, когда предыдущая вернула отчёты.
+Иначе потолок обходится тривиально — шесть задач, запущенных «двумя под-пачками»
+в одном сообщении, это шесть задач разом.
+
+**Волна из одной задачи — не вырожденный случай, а обязательный.** Задача,
+признанная на шаге 2 **замеряющей**, гонится в волне одна: соседний прогон на той
+же машине портит числа, а находка с испорченным оракулом хуже отсутствующей — она
+выглядит доказанной. Если замеряющая задача всё же пошла в общей волне, её отчёт
+обязан нести строку в границах покрытия: замеры сняты под соседней нагрузкой.
+
+Для каждой задачи в под-пачке:
+
+1. Заведи worktree и ветку от текущей вершины:
+   `git worktree add <path> -b task/<slug> <основная ветка>`. Путь — во временном
+   каталоге проекта (`./tmp`), не в системном `/tmp`.
+2. Запусти **по одному сабагенту на задачу, все в одном сообщении**,
+   `subagent_type: general-purpose`. Charter сабагента:
+   - работай **строго в своём worktree** `<path>`; в другие каталоги и в основную
+     ветку не лезь;
+   - прогони Skill **`av-dev-pipeline:task-pipeline`** ровно на этой задаче,
+     полный цикл SDD с обоими чекпоинтами ревью;
+   - если задаче назначен **номер артефакта** — используй строго его;
+   - **профиль ревью выбирается по факту изменения.** Батч не повод понижать
+     профиль: «нас много и мы спешим» — это ровно тот стимул, из-за которого
+     проходы пропускают;
+   - **режим прогона проходов — последовательный.** Твой worktree не один на
+     машине;
+   - **если вложенные сабагенты недоступны** (движок не даёт запускать агентов из
+     агента) — не пропускай ревью и не понижай профиль: проведи его **инлайн** по
+     тем же charter'ам `av-dev-pipeline`, сохранив обязательное — гейт до
+     опиниативных проходов, состав по профилю, триаж последним. И **скажи в
+     отчёте прямым текстом, что ревью шло инлайн**: инлайновый проход видит
+     контекст автора и потому декоррелирован слабее — это меняет доверие к
+     результату, а не только способ запуска;
+   - **вернуть отчёт**, в котором обязательно: исход задачи одним из трёх слов;
+     **объявленный профиль ревью и режим прогона**; что сделано; какие вопросы
+     записаны и куда; изменённые файлы; добавлялся ли нумерованный артефакт и с
+     каким номером; затронутые capability; состояние гейта; **перечень
+     запущенных проходов ревью поимённо с исходом каждого**; **путь к
+     сохранённому отчёту триажа** (`openspec/changes/<id>/review/`, после
+     архивации — `openspec/changes/archive/<id>/review/`); шло ли ревью
+     инлайн; границы покрытия.
+
+Сабагент, упершийся в вопрос, **не останавливает батч**: он записывает вопрос,
+режет задачу до остатка и доводит остаток — либо, если остатка нет, возвращает
+исход «не доведена». Оркестратор собирает такие вопросы и выносит их в финальный
+доклад пачкой.
+
+### 5. Проверить полноту ревью — до интеграции
+
+**Ветка, чей отчёт не называет профиль и проходы поимённо, не вливается.**
+Пропуск прохода не отличим от прохода без находок, и на уровне батча это ещё
+опаснее: отчётов много, каждый выглядит полным, а сверять их некому, кроме тебя.
+
+Сверка идёт в три шага, и порядок важен:
+
+1. **Возьми объявленный профиль** из отчёта задачи — он затем и заказан в
+   обязательных полях шага 4. Профиля в отчёте нет — перечень проходов сверять
+   не с чем; это само по себе основание не вливать, пока сабагент не назовёт
+   профиль и не обоснует его по факту изменения.
+2. **Сверяй с независимым артефактом, а не с прозой отчёта.** Перечень проходов
+   бери из **сохранённого отчёта триажа** (`openspec/changes/<id>/review/` или
+   `openspec/changes/archive/<id>/review/` — задача доведена, change заархивирован) —
+   пайплайн обязан его туда положить. Проза сабагента написана тем же, кто мог
+   проход и пропустить: она подтверждает сама себя. Отчёта триажа на месте нет —
+   считай, что состав неизвестен, и дозапускай ревью целиком.
+3. **Сверь состав** с таблицей профилей скилла
+   `av-dev-pipeline:review-pipeline` для объявленного профиля.
+
+Расхождение — не повод отменять задачу: дозапусти недостающие проходы **на
+ветке**, в её worktree, через `av-dev-pipeline:review-pipeline`, и только потом
+интегрируй.
+
+**Находки дозапуска — такие же находки, и зелёный гейт их не отменяет.** Правило
+интеграции «вливаем только зелёные» смотрит на гейт, а дозапущенный `critical`
+гейт не красит: он был бы пропущен молча, если это не сказать прямо. Поэтому:
+
+- `critical` или `major` из дозапуска — **вливание этой ветки останавливается**.
+  Помеченное `инлайн` чинится в её worktree, после починки — гейт, затем
+  интеграция. Помеченное `развилка` — вопрос в запись, задача режется до остатка
+  ровно так же, как это сделал бы пайплайн внутри;
+- остатка нет — ветка не вливается и уходит в доклад как провалившаяся, со своим
+  worktree;
+- `minor` и `nit` из дозапуска — в урожай доклада, вливанию не мешают.
+
+Отчёт дозапуска приложи к отчёту задачи и назови в докладе (шаг 9), почему он
+понадобился: систематический пропуск одного и того же прохода — находка о самом
+конвейере, а не о задаче.
+
+### 6. Интегрировать — rebase + fast-forward, по одной ветке
+
+Сводим ветки **строго последовательно** (линейная история), в порядке
+зависимостей. Вливаем **только зелёные**.
+
+**Ветка задачи занята её worktree, и это определяет форму команд.** Пока worktree
+жив (а удаляется он последним, после зелёного гейта), ветка `task/<slug>`
+checkout'нута в нём, и `git rebase <основная> task/<slug>` из главного worktree
+**падает**: `fatal: 'task/<slug>' is already used by worktree at …`. Поэтому
+rebase делается **внутри worktree задачи**, а ff-слияние — из главного.
+
+Для каждой готовой ветки `task/<slug>`:
+
+- `git -C <path> rebase <основная>` — перенос ветки задачи на текущую вершину,
+  выполняется в её собственном worktree;
+- резолв конфликтов (их почти нет — конфликтоопасное сериализовано, номера
+  розданы заранее). Неавтоматический конфликт — **не форсируй**: прерви
+  (`git -C <path> rebase --abort`), оставь ветку и worktree как есть, вынеси это
+  в доклад как нераспознанное пересечение;
+- **дерево сабагента обязано быть чистым.** `git -C <path> status --porcelain`
+  до `rebase`: непусто — значит сабагент не довёл шаг 11 до коммита учёта (или
+  оставил мусор). Не форсируй и не коммить за него: назови задачу в докладе
+  недоведённой и оставь ветку с worktree. Молчаливый `rebase` на грязном дереве
+  всё равно откажет, но с сообщением про unstaged changes — а причина другая;
+- **ненулевой код `rebase` относится к этой ветке и только к ней.** Прерванный
+  rebase в чужом worktree не трогает ни главное дерево, ни остальные ветки:
+  проверь `git -C <path> status` и `git status` — обе чистые. Уводить весь батч
+  в провалившиеся из-за одного ненулевого кода запрещено: это ложная причина,
+  из-за которой зелёные задачи не доедут до основной ветки. Провалилась одна —
+  провалилась одна;
+- из главного worktree (он стоит на основной ветке — проверь
+  `git rev-parse --abbrev-ref HEAD`): `git merge --ff-only task/<slug>`. Ветку в
+  главном дереве **не переключай** — `git checkout task/<slug>` тоже упрётся в
+  занятость;
+- после каждой интеграции — **гейт на основной ветке**. Красное — **откати эту
+  интеграцию** (`git reset --hard` на прошлую вершину), ветку с worktree сохрани,
+  задачу перечисли в докладе. Основная ветка **никогда** не остаётся
+  полузелёной;
+- только после зелёного: `git worktree remove <path>` и
+  `git branch -d task/<slug>` — в этом порядке, иначе ветка снова занята.
+
+**Политика частичного провала.** Упавшая задача (исход «не доведена», красные
+тесты в её worktree, конфликт при rebase, невлитая из-за находок дозапуска)
+**не блокирует остальные**: интегрируем все зелёные, упавшую оставляем в её
+worktree и ветке нетронутой — ничего не удаляем, — и перечисляем в докладе с
+причиной, отчётом и путём к worktree. Причина называется **настоящая**: «конфликт
+rebase в файле X», а не «нераспознанное пересечение» на всякий случай.
+
+### 7. Финальный гейт
+
+На основной ветке после всех интеграций — гейт целиком. Зелёное обязательно; пока
+красное, шаг 8 не начинается.
+
+### 8. Финальная сверка — только то, чего не видел никто
+
+Каждая задача уже прошла полный конвейер в своём worktree. Повторять его на
+интегрированном диффе бессмысленно: те же проходы на тех же файлах дадут те же
+находки и удорожат триаж. Здесь проверяется **только то, что появилось от
+слияния**:
+
+- запусти **по одному `review-specs` на каждую затронутую capability**,
+  последовательно. Параллельно — только если человек попросил явно и назвал
+  набор: правило и оба его условия живут в
+  `av-dev-pipeline:review-pipeline`, раздел «Режим запуска», и здесь не
+  ослабляются. «Замеров не делают» основанием не является;
+- **режим у этих проходов особый, и его надо назвать в задании.** Живого change
+  здесь нет — все заархивированы, дельта-спек не существует. Источник требований
+  — **актуальные** `openspec/specs/<capability>/spec.md`, а предмет — стык:
+  требование, которое одна задача выполнила, а соседняя незаметно отменила; два
+  архивных change, по-разному описавшие одно поведение. Скажи проходу это прямо,
+  иначе он пойдёт искать дельты и не найдёт ничего;
+- если задачи пересекались по файлам, добавь один `review-architecture` на
+  интегрированный дифф с вопросом «не появился ли второй способ делать то, что
+  уже делается» — именно он возникает, когда две задачи независимо решали
+  похожее;
+- **заверши триажем.** Он единственный, кто агрегирует, и без него у находок нет
+  ни оракула, ни пометки `инлайн`/`развилка` — а следующий абзац на неё
+  опирается. Прогон из двух проходов без триажа — это сырые находки, выданные за
+  разобранные.
+
+Замечания отрабатывай как одиночный пайплайн: `инлайн` чини сам, `развилка` —
+вопросом в запись; после правок — снова гейт.
+
+### 9. Прибраться и доложить
+
+- Убери worktree и ветки **только успешно влитых** задач, в конце
+  `git worktree prune`. Worktree и ветки **провалившихся** не трогай — они нужны
+  для ручного дожатия.
+- **Записей учёта батч не трогает** — их правит пайплайн внутри сабагента на
+  шаге 11. Батч сообщает исход по каждой задаче; если какой-то сабагент дошёл до
+  коммита, но закрытия не сделал (плагина нет, вызов не разрешился), скажи это
+  строкой — иначе задача останется открытой молча.
+- Доложи кратко:
+  - **исход по каждой задаче** одним из трёх слов, с хешем коммита;
+  - план волн и порядок интеграции, с пометкой, какие задачи шли по одной как
+    замеряющие;
+  - вопросы, записанные сабагентами, пачкой;
+  - что дозапускалось на шаге 5 и почему; шло ли где-то ревью инлайн;
+  - итог финальной сверки и ссылки на архивные change;
+  - **`Урожай`** — отложенные находки всех задач одним списком, с провенансом.
+    Задачи из него заводит тот, кто ведёт задачи проекта, а не батч;
+  - **отдельно — провалившиеся** задачи с настоящей причиной и путём к
+    оставленному worktree;
+  - **границы покрытия сводной строкой**, включая задачи, чьи замеры снимались в
+    общей волне, и ветки, где ревью шло инлайн.
+
+## Тонкости
+
+- **Изоляция параллельных тестов.** Прежде чем гнать несколько прогонов разом,
+  убедись, что тесты не делят фиксированный порт или файл БД (обычно берут
+  временный каталог и эфемерный порт — тогда ок). Делят — гони такие задачи
+  последовательно.
+- Поведенческая верификация внутри сабагента поднимает изменение вживую: следи,
+  чтобы соседние worktree не дрались за порты и рабочие каталоги. Если проект
+  умеет поднимать только один экземпляр — такие задачи в одну волну не ставь.
+- Ревью выполненного — **до** интеграции; это забота
+  `av-dev-pipeline:task-pipeline` внутри каждого сабагента, дублировать не надо.
+- `openspec validate --strict` тоже внутри пайплайна задачи — не пропускай его
+  своими правками на интеграции.
+- Крупная переработка, предложенная ревью внутри задачи, — развилка: не вливай
+  молча, вынеси в доклад.
+- Держи вызывающего в цикле короткими репликами на переходах фаз (план → волны →
+  интеграция → финальная сверка), но не проси подтверждать механику.

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

@@ -0,0 +1,369 @@
+---
+name: task-pipeline
+description: Автономно проводит одну задачу через полный цикл Spec Driven Development — от постановки до коммита (opsx explore→propose→ревью спек профилем design→apply→ревью кода→archive→коммит), с обязательными чекпоинтами ревью и докладом об исходе. Использовать, когда просят взять/сделать задачу или довести идею до реализации.
+---
+
+# Пайплайн задачи
+
+Оркестратор **одной** задачи по Spec Driven Development: проводит её от
+постановки до коммита максимально автономно. Механику не согласовываем — делаем.
+
+Это тонкая обёртка над каноническими скиллами `opsx:explore` / `opsx:propose` /
+`opsx:apply` / `opsx:archive` — вызывай их через Skill, не переизобретай их шаги.
+Ревью — скилл `av-dev-pipeline:review-pipeline`, он же держит правило выбора
+профиля.
+
+## Предпосылки
+
+- **OpenSpec и скиллы `opsx:*` — жёсткая предпосылка, а не опция.** На них стоят
+  шаги 2, 3, 6 и 8, проход `review-specs` и профиль `design` (они завязаны на
+  `openspec/changes/<id>/specs/*/spec.md` и на `openspec validate --strict`).
+  **Проект без OpenSpec этим пайплайном не ведётся** — подключай OpenSpec, а не
+  вырождай цикл: ветка деградации здесь не пишется, потому что непроверенная
+  ветка деградации хуже честного отказа.
+- **Скиллы зовутся с пространством имён** — `av-dev-pipeline:review-pipeline`,
+  `av-dev-pm:docs`, `av-dev-pm:tasks`. Короткое имя может разрешиться в
+  устаревшую проектную копию, и это произойдёт молча.
+- **Проектные копии этих скиллов и агентов удаляются при установке плагина**
+  (`.claude/skills/` — и голые имена `task-pipeline`, `review-pipeline`,
+  `task-batch`, и с префиксом проекта: `<проект>-task-pipeline`,
+  `<проект>-review-pipeline`;
+  `.claude/agents/<проект>-review-*.md`). Две копии одного скилла расходятся, и
+  побеждает та, что короче названа.
+
+Перед стартом прочитай `CLAUDE.md` проекта и то, на что он ссылается, если ещё
+не в контексте. Проектные факты, нужные ревью — инварианты, семантика гейта,
+объёмы, модель угроз, прецеденты, — живут в **документах канона** `av-dev-pm`;
+карта «что где» — `references/project-facts.md` конвейера ревью.
+
+**Документов канона нет — проект к нему не приведён.** Скажи это строкой и
+предложи скилл `av-dev-pm:canon`: одна операция на проект против поразрядной
+деградации на каждой задаче. Работу при этом не останавливай.
+
+## Границы: чем пайплайн не владеет
+
+- **Беклогом, спринтом, целями и приоритетами.** Задача приходит извне. Пайплайн
+  её не выбирает, не приоритизирует, не заводит и не переоценивает; если в
+  проекте есть свой процесс управления задачами — он и решает, что брать.
+- **Форматом задач.** Пайплайн **не правит индексы руками и не выдумывает путь
+  к скрипту учёта**: он зовёт Skill `av-dev-pm:tasks`, который этим владеет
+  (шаг 11). Закрытие как таковое — его работа, и это осознанное решение с
+  названной ценой: **приёмщик и исполнитель совпали**. Закрытие поэтому **не
+  окончательно** — человек на сессии возвращает задачу `reopen` с причиной, а
+  доклад по критериям приёмки становится единственным, по чему приёмка вообще
+  возможна. Плагина `av-dev-pm` в проекте нет — вызов не разрешится, и тогда
+  учёт остаётся владельцу, о чём говорится в докладе.
+- **Заведением задач из урожая ревью.** Отложенные находки отдаются **списком**
+  (см. шаг 7); превращать их в задачи — работа того, кто ведёт задачи проекта.
+- **Определением ценности.** «Нужна ли эта функциональность» — не вопрос
+  пайплайна ни на одном шаге.
+
+Пайплайн владеет **своим** определением готовности (ниже) и **сообщает
+наблюдаемый исход**. Что с исходом делать дальше — не его дело.
+
+## Наблюдаемые исходы
+
+Ровно три, и каждый обязан быть назван в докладе прямо:
+
+- **сделана** — определение готовности выполнено целиком;
+- **не доведена** — с причиной и с записанным вопросом; что именно сделано и до
+  какой границы, названо явно;
+- **оказалась крупнее задачи** — распознаётся **до заведения change**, иначе его
+  придётся выбрасывать. Дальше — декомпозиция, и это не работа пайплайна.
+
+## Определение готовности
+
+Задача сделана, когда верно всё:
+
+1. гейт проекта зелёный;
+2. ревью проведено **по профилю**, состав прогона сверен с таблицей профилей
+   поимённо, непущенные проходы названы в границах покрытия;
+3. change заархивирован, дельты влиты в актуальные спеки;
+4. коммит сделан в текущую ветку;
+5. **критерии приёмки, если проект их дал, выписаны поимённо, и по каждому назван
+   оракул и наблюдаемый исход** — «прогнал вот это, увидел вот то». Это **доклад,
+   а не сертификация: приёмка — не работа пайплайна.** Исполнитель, ставящий себе
+   галочку «принято», проверяет свою работу своим же взглядом — по границе это
+   может делать только декоррелированный приёмщик. Критерии приходят снаружи;
+   пайплайн их не сочиняет и не занижает. Расхождение «по каждому критерию исход
+   есть, а суть задачи не достигнута» — дефект критериев, и о нём сообщается, а
+   не молча дорабатывается.
+
+Пункты 1–4 — своё. Пункт 5 — внешнее: пайплайн доводит его до наблюдаемого
+исхода и передаёт дальше.
+
+## Принцип автономности
+
+**Умолчание — делать, а не спрашивать.** Задача доводится до коммита без участия
+человека; предполагается, что так пройдёт большинство задач.
+
+Наткнулся на вопрос, который решать не тебе, — **не останавливайся и не
+спрашивай**. Запиши его и продолжай:
+
+1. **Запиши вопрос там, где проект держит вопросы** (секция беклога, файл
+   задачи, трекер — это знает проект). Если проект не сказал, куда, — отдельной
+   секцией `Вопросы` в своём докладе, и это тоже исход. Тело отвечает на три
+   вещи: **что именно решить**, **какие есть варианты и цена каждого**, **что
+   стоит, пока решения нет**. Плюс твоя рекомендация — человек чаще соглашается,
+   чем выбирает заново, и готовое суждение экономит ему весь контекст.
+2. **Переформулируй задачу на остаток** — то, что делается без этого решения.
+   Назови границу: докуда доводим сейчас.
+3. Доведи остаток до конца и закоммить. Задача не «висит на вопросе», она сделана
+   в объявленных границах.
+
+**Что остатком не является — правило живёт не здесь.** Канонический текст с обеими
+оговорками — в плагине `av-dev-pm`, скилл `av-dev-pm:session`, раздел
+`## Вопрос, блокер, необратимое`, подраздел «Отличать вопрос от застревания».
+Правило принадлежит управлению задачами, потому что решает **сделана задача или
+вышла**, — это исход планирования, а не исполнения. **Ссылайся, не
+пересказывай:** копия, заведённая здесь, уже однажды разошлась с оригиналом и
+потеряла из перечня самое необратимое — запись **наружу**.
+
+Коротко, чтобы знать, когда идти читать: остаток проверяется двумя порогами —
+**материализация нерешённого** (запись состояния, зависящего от неотвеченного
+вопроса) и **пол по пользе** (из остатка пропала польза, названная в постановке).
+Оба порога — стоп: первый поднимает решение до начала записи, второй даёт исход
+«не доведена».
+
+Плагин `av-dev-pm` не подключён — правило не отменяется, а становится
+осторожнее: прежде чем записать зависящее от нерешённого куда бы то ни было —
+в хранилище, в журнал, в витрину или наружу, — спрашивай человека.
+
+Нет полезного остатка — задача заканчивается исходом «не доведена», вопрос
+записан, ничего не коммитится наполовину.
+
+### Когда всё-таки спрашивать
+
+Узко и по другому основанию — не «сложное решение», а **необратимое действие**:
+
+- деплой, выкладка наружу, смена публичного адреса или токенов;
+- удаление или перезапись рабочих данных, включая подрезку архивов;
+- всё, что уходит за пределы машины.
+
+Здесь ошибка не откатывается коммитом, поэтому спрашиваем даже когда решение
+кажется очевидным. Развилка в дизайне — вопрос в запись; необратимое действие —
+вопрос человеку сейчас.
+
+Стиль правок — заточка под проект и конвенции, right-size, без золочения.
+
+## Шаги
+
+### 1. Прочитать задачу
+
+Задача задана извне (slug, файл, ссылка, описание) — прочитай её и связанные
+спеки и черновики. Не задана — попроси у вызывающего; сам в беклог не лезь и
+приоритеты не интерпретируй.
+
+Если проект даёт задаче **критерии приёмки**, выпиши их сразу: на шаге 3 они
+уезжают в `tasks.md` change. Файл задачи может быть удалён до коммита, а
+критерии обязаны его пережить.
+
+Оцени тривиальность (влияет на шаг 4):
+
+- **тривиальная** — локальная правка без изменения поведения, спек и схемы,
+  решение очевидно. Explore и ревью спек пропускаются;
+- **нетривиальная** — новое или изменённое поведение, дизайн-развилки, задеты
+  инварианты, схема или несколько capability. Полный цикл.
+
+Здесь же — проверка на «крупнее задачи»: если видно, что одним заходом это не
+мерджится, объявляй исход **до** заведения change.
+
+### 2. (Опц.) Груммить идею — `opsx:explore`
+
+Только для идей и мутных постановок. Вызови Skill `opsx:explore`. Развилку
+грумминга не выноси на человека — запиши вопросом и груми остаток. Выход: ясная
+постановка, готовая к propose. **В explore не пишем код.**
+
+### 3. Завести change — `opsx:propose`
+
+Вызови Skill `opsx:propose`. Получаем `proposal.md`, дизайн (для нетривиальных),
+дельта-спеки (`ADDED`/`MODIFIED`/`REMOVED Requirements`), `tasks.md`. Каждое
+`### Requirement` содержит `SHALL`/`MUST`; структурные заголовки английские,
+сценарии `GIVEN/WHEN/THEN`. Прогони `openspec validate --strict <id>`.
+
+Критерии приёмки задачи, если они были, копируются в `tasks.md` отдельным блоком.
+
+### 4. (Нетривиальная) Ревью предложения — профиль `design`, ДО кода
+
+Первый чекпоинт. Вызови Skill **`av-dev-pipeline:review-pipeline`** с профилем
+`design` и ссылкой на change `<id>`. Он запустит `review-specs`
+(режим «дизайн ДО кода»), `review-rubric` (фаза 1: приёмочные критерии для
+задуманного узла) и `review-architecture` по предложению.
+
+Смысл профиля: архитектурная находка на готовом коде стоит переписывания и
+потому игнорируется — та же находка здесь стоит абзаца обсуждения. Рубрику из
+`review-rubric` перенеси в `tasks.md` как приёмочные критерии; там же уже лежат
+критерии от постановки, если они были.
+
+### 5. Отработать замечания ревью предложения
+
+- Мелочь и явные улучшения — правь сам в спеках и дизайне.
+- Развилки (компромисс, scope, инвариант) — вопросом в запись, спеки урезаются на
+  остаток.
+- После правок перепрогони `openspec validate --strict <id>`.
+
+### 6. Написать код — `opsx:apply`
+
+Вызови Skill `opsx:apply` для реализации `tasks.md`. Код — по конвенциям проекта
+(каталог `docs/conventions/`). Меняешь схему — обнови её описание в
+документации тем же change, если проект этого требует: гейт обычно это проверяет.
+
+Прогони гейт и добейся зелёного — он же гейт следующего шага.
+
+**Поведенческая верификация.** Если задача меняет реальное поведение (новый
+эндпоинт, разбор входа, схема, форма ответа) — зелёных юнит-тестов мало. Подними
+изменение вживую командой из раздела команд `CLAUDE.md` и прогони сценарий.
+Пропусти только для чисто внутренних правок без наблюдаемого рантайма.
+
+**Сервис не оставляем лежать.** Если запуск упал — почини или откати до конца
+шага.
+
+### 7. Ревью кода — Skill `av-dev-pipeline:review-pipeline`
+
+Второй чекпоинт. Вызови Skill **`av-dev-pipeline:review-pipeline`**, дав ссылку
+на change `<id>`, базу диффа, профиль **и режим запуска**.
+
+**Правило выбора профиля живёт в скилле конвейера** (раздел «Профили»), проектные
+триггеры — в `docs/review.md`, если записаны. Здесь оно не пересказывается: три
+копии одного правила расходятся, и работать будет та, которую прочитали
+последней. Помни ровно одно — **профиль выбирается по факту изменения, а не по
+ощущению важности**, и посмотри таблицу перед вызовом.
+
+**Режим по умолчанию последовательный, и обосновывать его не надо.** Параллельно
+гоняем только тогда, когда об этом попросили явно **и назвали набор** — какие
+именно проходы или какую стадию. Просьба без набора основанием не считается:
+гони последовательно и скажи строкой, что набор не был назван. Причина умолчания
+— замеры: `adversary` и `ops` доказывают находки числами, а два меряющих прохода
+на одной машине портят числа друг другу; находка с испорченным оракулом хуже
+отсутствующей, потому что выглядит доказанной.
+
+Скилл сам гоняет гейт, нужные проходы и обязательный триаж. Возвращает отчёт с
+потолком 7 пунктов, разметкой `Действие: инлайн | развилка` и секцией границ
+покрытия.
+
+**Сверь состав прогона с таблицей профилей в скилле, прежде чем коммитить.**
+Отчёт обязан называть запущенные проходы **поимённо и с исходом**; непущенный
+идёт строкой «не запускался» в границы покрытия. Реестр короткий (4–8 проходов) —
+сверка стоит одного взгляда. Почему это правило существует, объясняет раздел
+«Профили» скилла конвейера; здесь — само требование.
+
+Отработай так же, как шаг 5: помеченное `инлайн` чини сам и не логируй,
+`развилка` — вопросом в запись (он уже сформулирован триажем, его остаётся
+перенести). После правок — снова гейт.
+
+**Урожай — списком, не задачами.** Отложенные находки (реальный `major` не для
+этого мерджа, развилка, решённая «потом», пачка `nit`) собери в секцию доклада
+`Урожай`: формулировка, оракул, провенанс. Задачи из него **заводит не пайплайн**
+— у того, кто ведёт задачи проекта, своя нарезка, свой формат и свои правила
+дублей. Твоя обязанность — не потерять и передать.
+
+**Границы покрытия из отчёта не выбрасывай** — они уезжают в финальный доклад
+сжатой строкой. Отчёт, из которого исчезло «что проверить было невозможно»,
+превращается в ложное ощущение проверенности.
+
+**Отчёт триажа сохрани вместе с change (`openspec/changes/<id>/review/`; шаг 8
+унесёт его в `openspec/changes/archive/<id>/review/` вместе с change) — это
+обязательно, а не «если удобно».** По нему потом видно, что было найдено и что из
+этого осталось в урожае. И это единственный **независимый** артефакт о составе
+прогона: под оркестратором `task-batch` именно по нему сверяют полноту ревью
+ветки, а не по твоей прозе — она написана тем же, кто мог проход и пропустить.
+
+### 8. Архивировать — `opsx:archive`
+
+Вызови Skill `opsx:archive`: change уезжает в архив, дельты вливаются в
+актуальные спеки.
+
+### 9. Синк документации
+
+Ревью выполненного — до этого шага. Затем **вызови Skill `av-dev-pm:docs`**: он
+владеет содержимым документов канона и ведёт чек-лист синка. Плагина нет — шаг
+всё равно делается, см. ниже.
+
+**Правило одно и оно жёсткое: принуждённое отрицание.** Доклад обязан назвать
+**каждый** документ канона — либо чем он обновлён, либо «не требуется, потому
+что…». Нетронутые группируются одной строкой с общей причиной. Список триггеров
+прозой уже проверен на живом проекте и дал 6 записей ADR на 43 изменения;
+работает только обязательное отрицание.
+
+**Список документов и их триггеров здесь не дублируется** — он в чек-листе
+скилла `av-dev-pm:docs`, и копия уже однажды разошлась с оригиналом, потеряв два
+триггера.
+
+**Плагина `av-dev-pm` в проекте нет** — путь в его дерево не разрешится ниоткуда,
+поэтому за списком иди в **свой** reference:
+[references/project-facts.md](../review-pipeline/references/project-facts.md)
+конвейера ревью перечисляет все документы канона с их предметом. Пройди по этому
+перечню — каждый документ получает строку, отрицание остаётся обязательным.
+Триггеры при этом ты знаешь хуже, и это называется в докладе строкой: «синк
+сделан по перечню документов, без списка триггеров — плагина `av-dev-pm` нет».
+Канона в проекте тоже нет — назови это исходом и предложи `av-dev-pm:canon`.
+
+### 10. Коммит
+
+Коммить **в текущую ветку** (`git rev-parse --abbrev-ref HEAD`), сам ветку не
+создавай и не переключай, ничего не пушь. При ручном запуске HEAD обычно на
+основной ветке — коммит идёт прямо в неё; под оркестратором `task-batch` HEAD на
+ветке задачи в изолированном worktree, и делать дополнительно ничего не нужно.
+
+Сообщение — по-русски, скиллом `av-dev-git:commit`, если он подключён (первая строка «что
+сделано», тело списком 1–3 пункта, без трейлеров). Одна задача — один осмысленный
+коммит.
+
+### 11. Закрыть задачу — **после коммита, не раньше**
+
+**Вызови Skill `av-dev-pm:tasks`** и попроси закрыть задачу как реализованную —
+он владеет форматом и двигает строку из набора спринта сам. Путь к его скрипту не
+выясняй и индексы руками не правь: мост между плагинами — вызов скилла, а не
+путь.
+
+**Порядок обязателен.** Закрытие удаляет файл задачи; сделанное до коммита оно
+оставило бы задачу закрытой без единого следа работы, если шаг 10 упадёт.
+
+**Закрытие тоже коммитится — вторым коммитом, тут же.** Удаление файла задачи и
+правка индексов (их имена знает `av-dev-pm`, не ты) — это правки в рабочем
+дереве, и оставить их незакоммиченными нельзя по трём причинам: `task-batch` следом делает `rebase`
+и `worktree remove`, а те откажут на грязном дереве; закрытие, не доехавшее до
+основной ветки, оставит задачу открытой молча; и опора «набор спринта под git
+показывает, что и когда закрыто» без коммита — пустые слова. Сообщение короткое,
+про учёт, а не про работу: `закрыта задача <slug>`. Это второй коммит осознанно:
+правило «одна задача — один осмысленный коммит» про работу, а учёт — не работа.
+
+Плагина в проекте нет — вызов не разрешится. Тогда **ничего не выдумывай**:
+скажи в докладе, что учёт задач остаётся за владельцем, и назови исход.
+
+**Приёмщик и исполнитель здесь совпадают**, и закрытие не окончательно: человек
+на сессии может вернуть задачу (`reopen` с причиной). Поэтому доклад по критериям
+приёмки — не формальность, а единственное, по чему приёмка вообще возможна.
+
+Готово — доложи кратко.
+
+- **исход** задачи одним из трёх слов и, если не «сделана», чем ограничен
+  результат;
+- что сделано, какие вопросы записаны и куда;
+- ссылка на архивный change и хеш коммита;
+- по каждому критерию приёмки, если они были: **оракул и наблюдаемый исход** —
+  это доклад приёмщику, а не отметка «принято»;
+- **`Урожай`** — отложенные находки списком (формулировка, оракул, провенанс).
+  Задачи из него заводит тот, кто ведёт задачи проекта;
+- **одна строка границ покрытия**: какой профиль и режим гонялись, какие проходы
+  не запускались и что проверить было невозможно. Доклад без неё сообщает
+  «проверено», не сообщая, что именно.
+
+## Тонкости
+
+- **Не завязывайся на основную ветку и корень репозитория.** Скилл работает в
+  текущем worktree и на текущей ветке: не делай `git checkout`/`switch`, не
+  создавай веток, не пушь.
+- Не пропускай `openspec validate --strict` перед архивацией.
+- Тривиальная задача: шаги 2 и 4 пропускаются; ревью кода (шаг 7) остаётся
+  всегда, но в профиле `quick`.
+- Гейт блокирует: пока он красный, опиниативные проходы не запускаются. Чинить и
+  перезапускать, а не «посмотреть заодно».
+- Если ревью предлагает крупную переработку — это развилка: не правь молча и не
+  спрашивай, запиши вопросом и доведи остаток.
+- Держи вызывающего в цикле короткими репликами на переходах фаз, но не проси
+  подтверждать механику.
+- **Занизить профиль ревью или пропустить проход — самый дешёвый способ
+  «ускориться», и он же самый дорогой по последствиям.** Защита одна: профиль
+  выбирается по факту изменения, состав сверяется поимённо, а непущенное
+  называется в отчёте строкой.

av-dev-pm/.claude-plugin/plugin.json

@@ -0,0 +1,8 @@
+{
+  "name": "av-dev-pm",
+  "description": "Управление продуктом: канон документов проекта (паспорт, архитектура, схема БД, безопасность, конвенции, разведка, ADR, журнал ревью), задачи и цели вместо приоритетов, спринт под одну цель с заморозкой набора, старт нового проекта интервью по брифу и приведение существующего к канону. Не выполняет задачи — этим занимается пайплайн проекта.",
+  "author": {
+    "name": "Anton Vakhrushev",
+    "email": "anwinged@gmail.com"
+  }
+}

av-dev-pm/skills/canon/SKILL.md

@@ -0,0 +1,193 @@
+---
+name: canon
+description: Привести проект к канону документов av-dev и держать его в соответствии — три операции одной машиной сравнения. check — что разошлось с текущей версией канона; adopt — перевод проекта из любой прежней раскладки (docs/specs, drafts, backlog, BRIEF.md, review-brief) в канон с переносом файлов; upgrade — повышение проекта с версии канона N до текущей по журналу версий. Использовать, когда просят проверить документацию проекта, перевести проект на канон, обновить его под новую версию канона или когда пришли в старый проект и надо понять, что в нём не так. Заведение нового проекта с нуля — скилл init.
+---
+
+# Приведение проекта к канону
+
+Три операции, одна машина сравнения с разными исходами:
+
+| Операция | Когда | Исход |
+| --- | --- | --- |
+| `check` | начало сессии, шаг синка, гейт | что разошлось |
+| `adopt` | проект в чужой раскладке | перенос в канон |
+| `upgrade` | канон вырос, проект отстал | по журналу версий |
+
+**Определение канона — [references/canon.md](references/canon.md).** Здесь оно не
+пересказывается: два описания одной раскладки разъедутся, и работать будет то,
+которое прочитали последним. Прочитай его **до** первой правки.
+
+- [references/skeletons.md](references/skeletons.md) — **что именно класть** в
+  каждый незаполненный слот. Своей формой заглушку не выдумывай: `docs.py`
+  узнаёт только плейсхолдер `<!-- заполнить: … -->` из шаблонов.
+- [references/changelog.md](references/changelog.md) — журнал версий канона.
+
+## Три правила, из которых всё следует
+
+1. **Сперва карта, потом файлы.** Человеку показывается, что найдено, как
+   разложилось и **что не разложилось**, — и только после подтверждения
+   переносится хоть один файл. Массовый перенос без подтверждения разгребать
+   дороже, чем согласовать.
+2. **Ничего не терять.** Содержимое переезжает целиком; ссылки чинятся тем же
+   проходом, что и перенос. Старый файл удаляется **только** после того, как
+   всё его содержимое нашло дом, и это названо поимённо.
+3. **Что не классифицировалось — назвать.** Проглоченный абзац выглядит как
+   «всё перенеслось». Список «не разложилось» идёт в доклад целиком, с причиной
+   по каждому пункту.
+
+## Инструмент
+
+```
+ds="$CLAUDE_PLUGIN_ROOT/skills/canon/scripts/docs.py"
+
+python3 $ds check --dir <корень> [--base <rev>]   # раскладка, ссылки, версия, сверки
+python3 $ds version --dir <корень>                # версия канона скрипта и проекта
+```
+
+**Коды выхода — тот же словарь, что у `tasks.py`:** 0 сошлось, 1 дрейф, 2 ошибка
+употребления, 3 окружение, 4 внутренний сбой. Ветвись на коде, а не на тексте.
+
+Различать 1 и 3 обязательно: «дрейф раскладки» — рабочая ситуация, «это не
+корень проекта» — нерабочая.
+
+### Граница механизируемого — объявляется вслух
+
+Скрипт печатает её сам последним абзацем, и **эту строку из доклада выбрасывать
+нельзя**. `check`, отчитавшийся «канон соблюдён» на проекте, где из шести файлов
+три лишние, хуже отсутствующего.
+
+Машина **дрейфом** считает: отсутствующий путь канона, файл вне канона, битую
+ссылку, отставшую версию, capability без упоминания в обзоре, миграцию без правки
+`database.md`. **Замечанием** — незаполненный плейсхолдер и слабое упоминание
+capability: незаполненный канон это переходное состояние, а не отказ. Маркеры
+долга просто считает числом.
+
+**Ты** судишь о том, чего она не умеет:
+
+- **смысловой дубль** — `docs/specs/recognition.md` описывает то же, что
+  capability `recognition`. Файлы разные, содержание одно;
+- **поведение, оставшееся в `architecture.md`** — раздел на 900 строк с
+  требованиями вместо обзора;
+- **достаточность честной строки** — «внешних зависимостей нет» это факт,
+  «TBD» — пробел;
+- **протухший факт** — документ ссылается на то, чего в коде уже нет.
+
+## `check`
+
+1. `docs.py check`, при наличии базы диффа — с `--base`.
+2. Прочитай то, что скрипт проверить не может (список выше), по документам,
+   которых касалась работа. Не «заодно по всему `docs/`».
+3. Доклад: вывод скрипта строкой исхода, твои находки поимённо, **граница
+   покрытия** — что смотрел и чего не смотрел.
+
+Дрейф раскладки чинится переносом; смысловые находки — это либо правка
+документа, либо задача, если работы больше чем на абзац.
+
+## `adopt` — проект в чужой раскладке
+
+### 1. Осмотрись
+
+`docs.py check` — он уже назовёт упразднённые слоты с адресом, куда каждый
+уезжает. **Но смотрит он только верхний уровень `docs/`:** упразднённое в корне
+репозитория (`BRIEF.md`) и во вложенных каталогах он не назовёт никогда, поэтому
+корневые `*.md` читаются глазами. Плюс: `CLAUDE.md`, `openspec/specs/` (список
+capability), `openspec/config.yaml`.
+
+### 2. Составь карту
+
+Каждый найденный файл получает строку: **куда едет, целиком или разбирается, что
+делать с оригиналом**. Разбор `docs/specs/` — самое дорогое место, и он делается
+поимённо по capability:
+
+| Что в файле | Куда |
+| --- | --- |
+| требования, сценарии, поведение | `openspec/specs/<capability>/spec.md` — **или уже там**, тогда файл дубль |
+| компоненты, транспорты, раскладка, деплой | `docs/architecture.md` |
+| конвенции чужой системы, формат чужих данных | `docs/research/` |
+| обоснование принятого решения | `docs/adr/` |
+
+**Дубль удаляется только после поимённой сверки**: открыть спеку capability,
+открыть файл, убедиться, что в файле нет ничего сверх спеки. Нашлось сверх —
+сперва переезжает в спеку дельтой, потом файл удаляется.
+
+### 3. Покажи карту человеку
+
+`AskUserQuestion`, **не больше трёх вопросов за итерацию**, рекомендация первым
+вариантом. Показывается: сколько файлов, куда каждый, спорные отнесения, список
+«не разложилось». Механику (порядок строк, имена файлов внутри `research/`) не
+выноси — это не развилка.
+
+### 4. Перенеси
+
+Порядок важен — он минимизирует окно, в котором ссылки битые:
+
+1. `docs/.pm.json` с `{"canon": <текущая версия>}` и путём миграций, если БД есть;
+2. каталоги канона и скелет **по [references/skeletons.md](references/skeletons.md)**:
+   незаполненное — одной честной информативной строкой, а не «TBD»;
+3. переносы содержимого;
+4. каталог задач — **вызови скилл `av-dev-pm:tasks`**, сценарий адаптации: он
+   владеет форматом задач, включая переименование транслитных слагов в
+   английские вместе с починкой перекрёстных ссылок;
+5. починка ссылок на перенесённое во всём репозитории — `docs/`, `openspec/`,
+   `CLAUDE.md`, `README.md`;
+6. удаление оригиналов — **только тех, чьё содержимое найдено в новом доме**;
+7. **шаг `docs.py check` в гейт проекта.** Путь к скрипту — переменной с
+   умолчанием на канонический путь маркетплейса, чтобы переустановка плагина не
+   меняла `Taskfile`; шаг обязан **краснеть внятно**, если скрипт не найден, а не
+   пропускаться. Передай ему базу диффа (`--base`) той же переменной, что и
+   остальным шагам гейта: без неё сверка миграций со схемой не гоняется вовсе.
+   Пример строки покажи человеку — гейт принадлежит проекту, и правит его он;
+8. `docs.py check` — до **отсутствия дрейфа раскладки**. Замечания
+   (незаполненные плейсхолдеры, слабое упоминание capability) остаются:
+   незаполненный канон это объявленное переходное состояние из шага 5, а не
+   отказ. **Пункт «задачи без цели» из вложенной проверки `tasks.py` тоже
+   остаётся** и зелёным на этом шаге не станет: цели не сочиняются адаптацией
+   (запрет в [tasks/references/adopt.md](../tasks/references/adopt.md)), их
+   проставляет человек порциями переоценки на первой сессии. Пересчитай эти
+   пункты в докладе переходного состояния — не выдавай их за поломку и не
+   молчи о них.
+
+### 5. Объяви переходное состояние
+
+Сразу после переноса канон **заполнен не весь**, и это нормально, но обязано
+быть названо, иначе следующий агент примет скелет за поломку.
+
+Печатается по факту: сколько документов стоят честной строкой вместо
+содержания, сколько маркеров долга в `architecture.md`, сколько задач без
+критериев приёмки. Закрывается порциями по ходу работы, а не одним заходом.
+
+## `upgrade` — канон вырос
+
+1. `docs.py version` — версия проекта и версия скрипта.
+2. Проект новее скрипта — **обнови маркетплейс**, а не проект: это отстал
+   плагин.
+3. Иначе иди по [changelog.md](references/changelog.md) снизу вверх от версии
+   проекта до текущей и делай названное в каждой записи. Записи независимы и
+   применяются по порядку.
+4. Подними `canon` в `docs/.pm.json` до текущей.
+5. `docs.py check`.
+
+Записи журнала описывают **что сделать проекту**. Если запись этого не говорит —
+это дефект журнала, и о нём надо сказать, а не догадываться.
+
+## Чего этот скилл не делает
+
+- **Не сочиняет содержание.** Пустой слот получает честную строку о том, что его
+  наполнить пока нечем, а не выдуманный абзац. Придуманный периметр модели угроз
+  хуже отсутствующего: по нему будут строиться находки.
+- **Не удаляет то, чьё содержимое не нашло дом.** Оригинал живёт, пока не
+  названо поимённо, куда переехал каждый его кусок.
+- **Не ведёт содержимое канона** — это скилл `docs`. Здесь только раскладка.
+- **Не заводит проект с нуля** — это скилл `init`.
+- **Не правит историю.** В старых коммитах старые пути остаются, и это нормально.
+
+## Доклад
+
+- Что нашёл `docs.py`: код выхода и число пунктов дрейфа.
+- Что перенесено: файл → дом, числом и поимённо для спорного.
+- **Удалённые дубли** — с указанием, против какой спеки сверялся каждый.
+- **Не разложилось** — поимённо, с причиной.
+- Переходное состояние числами: честных строк, маркеров долга, задач без
+  критериев.
+- **Граница покрытия**: что проверила машина, что судил ты, чего не смотрел
+  никто.

av-dev-pm/skills/canon/references/canon.md

@@ -0,0 +1,312 @@
+# Канон документов проекта
+
+**Версия 1.**
+
+Это **единственный дом определения канона**. Скиллы `init`, `canon` и `docs`
+читают его, а не пересказывают: три описания одной раскладки разъедутся, и
+работать будет то, которое прочитали последним. Меняется канон — меняется этот
+файл и появляется запись в [changelog.md](changelog.md).
+
+## Зачем канон жёсткий
+
+Пути фиксированы, и проект под них подгоняется, а не наоборот. Причина не
+техническая: проектов много, все малого и среднего размера, и ориентироваться в
+слегка похожих, но разных раскладках дороже, чем один раз привести их к общей.
+Рядом лежит OpenSpec, у которого структура тоже строгая.
+
+Цена принята сознательно: плагин не переносится на чужой репозиторий как есть —
+чужой репозиторий **приводится** к канону скиллом `canon`.
+
+## Раскладка
+
+```
+CLAUDE.md                      памятка агенту: что это, стек, инварианты с
+                               severity, команды, семантика гейта, запреты
+docs/
+  .pm.json                     версия канона и пути, нужные проверкам
+  passport.md                  зачем и для кого; чем НЕ является; сценарии
+  architecture.md              как сложено — обзор; окружение и эксплуатация
+  database.md                  схема хранилища; представление данных и настройки
+  security.md                  периметр; недоверенный вход; что вне модели
+  conventions/
+    README.md                  индекс, правило промоута, что механизировано
+    <тема>.md
+  research/
+    README.md                  как снималось, индекс
+    <тема>.md                  наблюдения и числа с провенансом
+  adr/
+    README.md                  индекс записей, статусы, правило замены
+    template.md
+    ADR-ГГГГ-ММ-ДД-slug.md
+  review.md                    настройка конвейера под проект + журнал дефектов
+  tasks/                       скилл tasks: items/, PLAN.md, BACKLOG.md,
+                               SPRINT.md, REJECTED.md
+openspec/
+  config.yaml                  только нужды генерации артефактов + ссылки
+  specs/<capability>/spec.md   что система делает — нормативно
+  changes/archive/             архив изменений с design.md — сырьё для ADR
+```
+
+Текст документов — русский; слаги файлов, capability и задач — английские,
+kebab-case.
+
+## Роли документов
+
+Одна строка на каждый — на какой вопрос он отвечает и кто его читает.
+
+| Документ | Вопрос | Кто читает, кроме человека |
+| --- | --- | --- |
+| `CLAUDE.md` | что нельзя нарушать, чем краснеет гейт | все агенты, всегда |
+| `passport.md` | зачем и для кого, чем это **не** является | `architecture`, `rubric`, `reimpl`, `specs` |
+| `architecture.md` | как сложено и где что работает | все проходы ревью |
+| `database.md` | что лежит в хранилище и какими настройками | `ops`, `adversary`, `reimpl` |
+| `security.md` | против кого защищаемся и что вне модели | `adversary` |
+| `conventions/` | как мы пишем код | `code` |
+| `research/` | что показала реальность, а не документация | `specs`, `reimpl`, `ops`, `adversary` |
+| `adr/` | почему решено именно так | `architecture` |
+| `review.md` | как настроен конвейер и что уже проскакивало | `triage`, каждый проход — свою часть |
+| `openspec/specs/` | что система делает — нормативно | `specs` |
+
+### `passport.md`
+
+Цель; закрытый список потребителей и что каждому нужно; **чем целью не
+является** — это граница домена, по которой архитектурный проход судит о
+переносе понятия; типовые сценарии; мера, по которой проект считается удавшимся;
+референсы, у кого подсматривать.
+
+### `architecture.md` — **обзор, не поведение**
+
+Принципы; компоненты **со ссылками на capability**, а не с пересказом их
+требований; **единые точки проекта** — где генерируются идентификаторы и время,
+где единственный парсер входного формата, где маппинг доменной ошибки в код
+ответа, где общий путь приёма (это материал для вопроса «не появился ли второй
+способ»); внешние границы и форматы чужих систем; окружение — где работает, что
+рядом, кто перезапускает; **внешние зависимости поимённо** и чем каждая
+отказывает (не только «падает», но и «отвечает медленно», «молчит», «отдаёт
+мусор»); кто заметит отказ и когда; характер потока — непрерывный, по запросу,
+по расписанию; деплой; открытые вопросы.
+
+**Обратимости здесь нет** — её единственный дом `CLAUDE.md`: туда ходят пять
+проходов, и раздвоение адреса означало бы, что проект написал ответ, а ревью его
+не прочитало.
+
+**Поведение системы сюда не пишется.** Его нормативный дом — `openspec/specs/`,
+куда `opsx:archive` вливает дельты; второй дом синхронизировать руками
+невозможно, и он разойдётся.
+
+Раздел, ещё не разнесённый при переезде, помечается маркером долга:
+
+```
+<!-- канон: поведение → openspec/specs/<capability> -->
+```
+
+`docs.py` считает маркеры и печатает остаток числом. Гейт от них **не краснеет**:
+это долг, а не отказ, иначе постепенный переезд стал бы невозможен.
+
+### `database.md`
+
+Схема: таблицы, ключи, связи, правило времени и идентификаторов. Плюс то, чего
+нет в схеме, но без чего замер не превращается в находку: **чем физически лежит
+запись** (сжатый BLOB, JSON-строка, колонки), что происходит при чтении и записи
+(распаковка целиком, read-modify-write), и **настройки с числовым значением** —
+таймаут занятости, режим журналирования, лимит тела, размер пула, ретеншен.
+
+Конвенции идентификаторов и именования — не схема, они в `conventions/`.
+
+### `security.md`
+
+**Периметр первой строкой.** «Сервис открыт наружу» и «контур доверенный,
+публичного интернета здесь нет, не выдумывай его» — противоположные постановки
+под одним заголовком, и враждебный проход между ними сам не выберет. Контур ещё
+не развёрнут — назови **оба** периметра, целевой и сегодняшний, и скажи прямо,
+против какого строятся находки.
+
+Дальше: что недоверенное и каким каналом приходит; **из чего строятся пути и
+ключи** (раскладка файлов, состав координатного ключа, имя каталога) — отсюда
+строится выход за пределы песочницы; что разграничивает доступ; что
+чувствительнее чего; **что вне модели** — перечислить явно.
+
+### `conventions/`
+
+Прозой остаётся **только то, что не выражается правилом**. `README.md` держит
+индекс, правило промоута и **перечень уже механизированного** со ссылкой на
+место механизации — конфиг линтера, собственный анализатор, тест-сканер
+исходников. Непойманное место механизации означает, что проход добросовестно
+проверит уже проверенное.
+
+### `research/`
+
+Наблюдения за внешним миром: что реально шлёт источник, чем документация формата
+расходится с практикой, какие числа сняты с живого потока. **Числа — с
+провенансом**, то есть с командой или условиями, которыми получены.
+`README.md` — как снималось и индекс тем.
+
+Число без источника проход обязан читать как условие, а не как замер. Число, чей
+источник по ссылке не подтвердился, не выбрасывается и не переписывается по
+догадке — остаётся с пометкой «расходится с источником: там <что нашли>».
+
+### `adr/`
+
+**ADR — промоут поверх архивных `design.md`, а не второе сочинение.** Запись
+цитирует решение и ссылается на `openspec/changes/archive/<id>/design.md`.
+
+Заводится, когда верно одно из трёх:
+
+<!-- дом: adr-когда-заводить -->
+- **дорогой откат** — переделка стоит дороже переписывания одного файла;
+- **намеренный отказ** от очевидного подхода;
+- **пересмотр прежнего решения** — тогда у старой записи обязателен статус
+  «заменено на».
+<!-- /дом: adr-когда-заводить -->
+
+Не заводится для рутины и для того, что видно из кода и `git log`.
+
+Записи неизменяемы: передумали — заводится новая, старая получает статус.
+Активная запись статуса не имеет.
+
+### `review.md`
+
+Два раздела с разными сроками жизни.
+
+**Настройка конвейера под проект**, пять подразделов с точными именами — по ним
+проходы находят свой кусок:
+
+- **Типовые узлы** — рода узлов проекта и 3–5 проверяемых свойств к каждому;
+- **Типовые ложноположительные** — находки, которые здесь выглядят убедительно и
+  всегда неверны, каждая со строкой «почему здесь это не дефект»;
+- **Вопросы к проходам** — поимённо, в форме `<имя прохода>: <вопрос>
+  (<провенанс>)`;
+- **Триггеры профиля** — проектная конкретизация правила выбора профиля ревью:
+  какие пути и контракты означают `deep`, что считается «поведением, видимым
+  снаружи», при каком изменении запускается независимая реализация. Уточняет
+  умолчания конвейера, а не отменяет их;
+- **Недоступно проверке** — два подраздела: «не проверит ни один проход»
+  (принципиальная граница, по факту промаха не пересматривается) и «перестали
+  проверять сознательно» (пересматривается первым).
+
+**Журнал дефектов:** запись на каждый воспроизведённый дефект с пометкой
+**проскочил / пойман ревью**. Проскочившие — эвал-сет для калибровки конвейера,
+выборка по пометке. Пойманные с оракулом — лучшая опора для прохода: проектные,
+воспроизводимые, однажды оказавшиеся правдой.
+
+### `CLAUDE.md`
+
+Что это и стек; **инварианты с severity рядом с формулировкой** — по ним проходы
+присваивают `critical`, поэтому severity стоит здесь, а не выводится каждым
+проходом заново; команды; **семантика гейта** — чем краснеет безусловно и почему,
+где логи, что означает исход, чего в гейте намеренно нет, **кто и когда обязан
+гонять дорогое вне гейта**.
+
+Плюс то, что нужно git-операциям и проходам и не выводится ниоткуда:
+
+- **имя основной ветки** — от неё считается база диффа
+  (`git merge-base HEAD <ветка>`), в неё вливает батч, от неё ветвятся задачи.
+  Угадывание между `master` и `main` ломает интеграцию целиком;
+- **что запускать запрещено, с путями** — рабочая БД, боевой каталог данных,
+  внешние сервисы. Запретом с путями, а не «будь осторожен»;
+- **где `testdata`** и что в них лежит; **куда писать временное**;
+- **что считается необратимым** — единственный дом: от обратимости зависит вся
+  шкала ранжирования триажа и право проходов на `critical`;
+- **общий станок**, врывающийся в замороженный спринт; **ориентир по размеру
+  спринта**.
+
+### `openspec/config.yaml`
+
+**Только нужды генерации артефактов** — язык, правила именования capability,
+придирки валидатора RFC 2119 — плюс ссылки на документы канона. Правило ревью,
+пересказ конвенций и инварианты сюда не пишутся: у них есть свои дома, и второй
+дом разойдётся на первой же правке.
+
+## Правило единственного дома
+
+Факт живёт ровно в одном файле; остальные ссылаются. Карта на случай спора:
+
+| Факт | Дом |
+| --- | --- |
+| поведение системы | `openspec/specs/<capability>/spec.md` |
+| почему решено так | `adr/`, источник — архивный `design.md` |
+| граница домена, «чем не является» | `passport.md` |
+| инвариант и его severity | `CLAUDE.md` |
+| порядок работ и его обоснование | `docs/tasks/PLAN.md` |
+| измеренное число | `research/` |
+| настройка с числовым значением | `database.md` |
+| периметр и модель угроз | `security.md` |
+| что необратимо | `CLAUDE.md` — **не** `architecture.md` |
+| единые точки проекта | `architecture.md` |
+| имя основной ветки, `testdata`, временный каталог | `CLAUDE.md` |
+| что уже механизировано правилом | `conventions/README.md` |
+
+## Пустое называется пустым
+
+Скелет канона заводится **целиком** с первого дня. Незаполненный документ держит
+**одну честную информативную строку**, а не заглушку:
+
+- «внешних зависимостей нет — смотри на диск и на СУБД»;
+- «наблюдений на живых данных нет: внешний источник один, формат документирован»;
+- «прецедентов не накоплено»;
+- «сознательно ничего не отключали»;
+- «архитектуры пока нет: кода нет, заводится первой задачей».
+
+Проход читает такую строку **как факт** и не тратит на неё обязательный вопрос.
+Отсутствие файла он не может прочитать никак, а «TBD» читает как пробел —
+поэтому `docs.py check` отличает честную строку от нетронутого плейсхолдера
+шаблона и напоминает о втором.
+
+## Слотов нет
+
+Файлы и каталоги, которых в каноне **нет**, и куда уезжает их содержимое:
+
+| Было | Куда |
+| --- | --- |
+| `docs/review-brief.md` | документы канона и есть бриф; остаток — в `review.md` |
+| `docs/specs/` | `openspec/specs/` (поведение) и `architecture.md` (обзор) |
+| `docs/drafts/` | идея → задача `[idea]`; отказ → ADR; порядок → `PLAN.md`; размышление → `opsx:explore` |
+| `docs/plan.md` | `docs/tasks/PLAN.md` |
+| `BRIEF.md` | `passport.md` |
+| `docs/backlog/` | `docs/tasks/` |
+| `docs/review-journal.md`, `docs/review/journal.md` | `docs/review.md` |
+
+## Что проверяет машина, а что человек
+
+Граница объявляется вслух в каждом отчёте: `check`, отчитавшийся «канон
+соблюдён» на проекте, где из шести файлов три лишние, хуже отсутствующего.
+
+| Проверяет `docs.py` | Судит агент |
+| --- | --- |
+| отсутствующие пути канона | смысловой дубль документа и capability |
+| файлы в `docs/` вне канона | поведение, оставшееся в `architecture.md` |
+| битые относительные ссылки | протухший факт, разошедшийся с кодом |
+| версия канона и её отставание | достаточность честной строки в пустом слоте |
+| нетронутый плейсхолдер шаблона | связность и читаемость |
+| маркеры долга — числом | |
+| миграция изменена, а `database.md` нет | |
+| capability без упоминания в `architecture.md` | |
+
+## `docs/.pm.json`
+
+```json
+{
+  "canon": 1,
+  "migrations": "internal/store/migrations",
+  "tasks": {
+    "backlog": "INDEX.md"
+  }
+}
+```
+
+`canon` — версия канона, под которую проект приведён, целым числом: обратной
+совместимости у канона нет, есть «приведён» и «не приведён». `migrations` — путь
+каталога миграций, если БД есть; по нему `docs.py` делает сверку с
+`database.md`. `tasks` — настройки каталога задач, переехавшие сюда из прежнего
+`<tasks>/.tasks.json`: **один конфиг на весь канон, а не по одному на каталог**.
+Внутри `tasks` — **только имена файлов и заголовков** (`items`, `backlog`,
+`plan`, `sprint`, `rejected`, `sprint_section`, `questions_heading`,
+`criteria_heading`, `oracle_word`), и ключ пишется, лишь когда имя отличается от
+умолчания. **Секций беклога здесь нет:** их дом — заголовки `##` самого индекса,
+и второй список сразу разошёлся бы с первым. Неизвестный ключ `tasks.py`
+отвергает кодом 3, поэтому лишнее слово в этом объекте останавливает работу с
+задачами целиком.
+
+Ключей будет больше по мере роста проверок; неизвестный ключ `docs.py`
+игнорирует, отсутствующий — считает «проверка неприменима» и говорит об этом
+строкой, а не молчит.

av-dev-pm/skills/canon/references/changelog.md

@@ -0,0 +1,55 @@
+# Журнал версий канона
+
+Одна запись на версию. Проект знает свою версию из `docs/.pm.json`; `canon
+upgrade` идёт по записям снизу вверх от версии проекта до текущей и делает то,
+что в них названо.
+
+Правило записи: **что добавилось, что переехало, что удалено, что сделать
+проекту**. Без последнего пункта запись бесполезна — по ней и работает
+`upgrade`.
+
+Версия — целое число. Обратной совместимости у канона нет: есть «приведён» и «не
+приведён».
+
+---
+
+## Версия 1 — 2026-08-03
+
+Первая версия. Проект любой прежней раскладки приводится к ней скиллом `canon`
+в режиме `adopt`, а не `upgrade`.
+
+**Что вводится:** раскладка целиком — см. [canon.md](canon.md).
+
+**Что сделать проекту, который приходит из свободной раскладки:**
+
+1. `docs/.pm.json` с `{"canon": 1}` и путём миграций, если БД есть.
+2. Скелет канона целиком; незаполненное — одной честной строкой.
+3. `docs/specs/` разобрать: поведение — в `openspec/specs/`, обзор — в
+   `docs/architecture.md`, знание о чужих системах — в `docs/research/`.
+   Дубли capability удалить, сверив поимённо.
+4. `docs/plan.md` → `docs/tasks/PLAN.md` линией целей.
+5. `BRIEF.md` → `docs/passport.md`.
+6. `docs/backlog/` → `docs/tasks/`.
+7. `docs/review-journal.md` или `docs/review/journal.md` → `docs/review.md`,
+   плюс раздел настройки конвейера.
+8. `docs/drafts/` растворить: идея → задача `[idea]`, намеренный отказ → ADR,
+   порядок работ → `PLAN.md`.
+9. `docs/review-brief.md`, если заводился, удалить: его разделы разошлись по
+   документам канона.
+10. `conventions.md` → `conventions/`, `local-research.md` → `research/`.
+11. Завести `docs/security.md` с периметром первой строкой и `docs/adr/`.
+12. В `CLAUDE.md`: severity рядом с каждым инвариантом; семантика гейта (чем
+    краснеет безусловно, где логи, чего в нём нет и кто тогда гоняет дорогое);
+    **имя основной ветки**; запреты с путями; где `testdata` и куда писать
+    временное; **что считается необратимым**; общий станок; ориентир по размеру
+    спринта. Убрать раздел «Процесс», если он пересказывает пайплайн.
+13. В `openspec/config.yaml` оставить только нужды генерации и ссылки.
+14. Добавить шаг `docs.py check` в гейт проекта.
+
+**Копии правил в шаблонах, которые версия 1 уносит в проект** — их правка в
+каноне обязана появляться здесь отдельной версией:
+
+| Что копируется | Дом определения |
+| --- | --- |
+| форма записи журнала дефектов в `docs/review.md` | `av-dev-pipeline/skills/review-pipeline/references/review-journal.md` |
+| правило заведения ADR в `docs/adr/README.md` | [canon.md](canon.md), раздел `adr/` |

av-dev-pm/skills/canon/references/skeletons.md

@@ -0,0 +1,387 @@
+# Скелеты документов канона
+
+Что кладут `init` и `canon adopt` в незаполненный слот. Правило одно:
+**честная информативная строка вместо заглушки**. Проход читает строку как факт;
+`<!-- заполнить: … -->` он читает как пробел, и `docs.py check` о таком
+плейсхолдере напоминает.
+
+Плейсхолдер ставится только там, где ответ **обязан** быть и его не спросили.
+Всё, чего в проекте пока просто нет, описывается словами, а не плейсхолдером.
+
+**Шаблоны — единственное место, где правило канона копируется намеренно.**
+`adr/README.md` и `review.md` уезжают в репозиторий проекта и обязаны там что-то
+говорить; определение при этом остаётся в [canon.md](canon.md). Отсюда
+обязанность: **правка такого правила в каноне тянет запись в
+[changelog.md](changelog.md)** с указанием, какой файл проекта поднимает
+`upgrade`. Без этого копия в проекте останется на старой версии молча.
+
+**Каждая такая копия помечена и сверяется машиной.** Дом обрамляется
+`<!-- дом: <id> -->` … `<!-- /дом: <id> -->`, копия —
+`<!-- копия: <id> из <путь> -->` … `<!-- /копия: <id> -->`;
+`scripts/copies.py` маркетплейса требует дословного
+совпадения. Комментарии невидимы в отрендеренном markdown и уезжают в проект
+вместе со скелетом — там они говорят читателю, что у текста есть дом. Правишь
+текст внутри маркеров — правь дом, а не копию.
+
+## `docs/passport.md`
+
+```markdown
+# Паспорт проекта
+
+Зачем это и для кого. [architecture.md](architecture.md) отвечает «как
+устроено», [tasks/PLAN.md](tasks/PLAN.md) — «в каком порядке», паспорт —
+«зачем и для кого».
+
+## Цель
+
+<!-- заполнить: одна фраза без технических деталей -->
+
+**Потребители** — список закрытый: он определяет, что считать нужным, а что
+интересным.
+
+| Кто | Что ему нужно от нас |
+| --- | --- |
+
+Цель достигнута, когда:
+
+## Что целью не является
+
+Граница домена. По ней архитектурный проход судит, не перенесено ли понятие
+через границу.
+
+## Типовые сценарии
+
+## Референсы
+
+Где смотреть prior art, когда упёрлись.
+```
+
+## `docs/architecture.md`
+
+```markdown
+# Архитектура
+
+Обзор: как сложено и где что работает. **Поведение системы здесь не
+описывается** — его нормативный дом `openspec/specs/`.
+
+## Принципы
+
+## Компоненты
+
+Каждый — строкой со ссылкой на capability, а не пересказом её требований.
+
+## Внешние границы и форматы
+
+## Эксплуатация
+
+- Где работает, что рядом, кто перезапускает:
+- Внешние зависимости поимённо и чем каждая отказывает (падает, отвечает
+  медленно, молчит, отдаёт мусор):
+- Кто заметит отказ и когда:
+- Характер потока (непрерывный, по запросу, по расписанию):
+
+## Единые точки проекта
+
+Где генерируются идентификаторы и время; где единственный парсер входного
+формата; где маппинг доменной ошибки в код ответа; где общий путь приёма.
+Материал для вопроса «не появился ли второй способ делать то, что уже делается».
+
+## Деплой
+
+## Открытые вопросы
+```
+
+Пустой проект: «Архитектуры пока нет: кода нет. Наполняется первой задачей.»
+Нет внешних зависимостей: «Внешних зависимостей нет — смотри на диск и на СУБД.»
+
+## `docs/database.md`
+
+```markdown
+# Схема хранилища
+
+СУБД, миграции, правило времени и идентификаторов.
+
+## Таблицы
+
+## Представление данных
+
+Чем физически лежит запись и что происходит при чтении и записи.
+
+## Настройки с числовым значением
+
+Таймаут занятости, режим журналирования, лимит тела, размер пула, ретеншен.
+Без них замер не превращается в находку: пик памяти — аномалия только рядом
+со строкой «запись лежит сжатой и распаковывается целиком».
+```
+
+Нет БД — файла нет, и в `docs/.pm.json` нет ключа `migrations`.
+
+## `docs/security.md`
+
+```markdown
+# Модель угроз
+
+## Периметр
+
+<!-- заполнить: первой строкой, против кого защищаемся -->
+
+Контур не развёрнут — назови оба периметра, целевой и сегодняшний, и скажи
+прямо, против какого строятся находки.
+
+## Недоверенный вход
+
+Что приходит извне и каким каналом: тело запроса, файл, аргумент команды,
+ответ внешней системы, содержимое архива.
+
+## Из чего строятся пути и ключи
+
+Раскладка файлов на диске, состав координатного ключа записи, имя каталога.
+Отсюда строится выход за пределы песочницы.
+
+## Что разграничивает доступ
+
+## Что чувствительнее чего
+
+## Что вне модели
+
+Перечислить явно. Пустой пункт означает, что враждебный проход выдумает угрозу
+сам, и находка никогда не будет исправлена.
+```
+
+## `docs/conventions/README.md`
+
+```markdown
+# Конвенции кода
+
+Как мы пишем код — в отличие от `openspec/specs/`, который описывает, что
+система делает.
+
+**Прозой остаётся только то, что не выражается правилом.** Свойство, ставшее
+правилом линтера, отсюда удаляется и переезжает в перечень ниже.
+
+## Записи
+
+## Механизировано
+
+| Правило | Где механизировано |
+| --- | --- |
+
+Непойманное место механизации означает, что проход по конвенциям будет
+добросовестно проверять уже проверенное.
+```
+
+Пустой проект: «Конвенций пока нет: код не написан. Наполняется по мере
+реального трения, а не вперёд.»
+
+## `docs/research/README.md`
+
+```markdown
+# Разведка
+
+Наблюдения за внешним миром: что реально шлёт источник, чем документация
+формата расходится с практикой. Источник истины — этот каталог, а не чужая
+документация.
+
+**Каждый вывод — с числами и командой, которой получен**, чтобы его можно было
+перепроверить.
+
+## Как снималось
+
+## Записи
+```
+
+Нет внешних источников: «Внешних источников данных нет — разведка неприменима.»
+
+## `docs/adr/README.md`
+
+```markdown
+# Журнал решений
+
+Одна запись — одно решение. **ADR это промоут поверх архивного `design.md`**,
+а не второе сочинение: запись цитирует решение и ссылается на
+`openspec/changes/archive/<id>/design.md`.
+
+## Когда заводить
+
+Верно одно из трёх:
+
+<!-- копия: adr-когда-заводить из av-dev-pm/skills/canon/references/canon.md -->
+- **дорогой откат** — переделка стоит дороже переписывания одного файла;
+- **намеренный отказ** от очевидного подхода;
+- **пересмотр прежнего решения** — тогда у старой записи обязателен статус
+  «заменено на».
+<!-- /копия: adr-когда-заводить -->
+
+Не заводить для рутины и для того, что видно из кода и `git log`.
+
+## Соглашения
+
+- Имя файла — `ADR-ГГГГ-ММ-ДД-slug.md`, слаг английский, дата — когда решение
+  реально принято.
+- Записи неизменяемы: передумали — новая запись, старой ставится статус.
+- Активная запись статуса не имеет. Значений два: `заменено на ADR-…` и
+  `устарело`.
+
+## Записи
+
+Новые сверху.
+
+| Дата | Запись | Статус |
+| --- | --- | --- |
+```
+
+## `docs/adr/template.md`
+
+```markdown
+# Краткий заголовок решения
+
+- Дата: ГГГГ-ММ-ДД
+- Источник: openspec/changes/archive/<id>/design.md
+
+## Решение
+
+Что именно решено — одной фразой.
+
+## Почему
+
+Намерение и причина. Цитата из источника, а не пересказ. Пиши так, чтобы через
+год было понятно без чтения переписки.
+
+## Последствия
+
+- `+` что стало лучше.
+- `−` чем платим: ограничения, риски, нагрузка на поддержку.
+```
+
+## `docs/review.md`
+
+```markdown
+# Ревью: настройка и журнал
+
+## Как настроен конвейер
+
+### Типовые узлы
+
+Рода узлов проекта и 3–5 проверяемых свойств к каждому. Рода, а не инвентарь
+пакетов: род, который проект задумал, но ещё не написал, включать полезно.
+
+### Типовые ложноположительные
+
+Находки, которые здесь выглядят убедительно и всегда неверны. Каждая — с одной
+строкой «почему здесь это не дефект».
+
+### Вопросы к проходам
+
+Форма: `<имя прохода>: <вопрос> (<провенанс>)`. Главный источник — журнал ниже.
+Проход, увидев свой блок, задаёт эти вопросы дополнительно к обязательным.
+
+### Триггеры профиля
+
+Проектная конкретизация правила выбора профиля: какие пути и контракты означают
+`deep`, что здесь считается «поведением, видимым снаружи», при каком изменении
+запускается независимая реализация. Уточняет умолчания конвейера, не отменяет их.
+
+### Недоступно проверке
+
+**Не проверит ни один проход** — принципиальная граница; по факту промаха не
+пересматривается.
+
+**Перестали проверять сознательно** — что, когда и почему, со ссылкой на запись
+журнала. Пересматривается **первым**, как только что-то проскочило.
+
+## Журнал дефектов
+
+Запись на каждый воспроизведённый дефект, сразу, а не ретроспективно: со
+временем теряется не факт, а причина непоймания.
+
+Форма:
+
+<!-- копия: журнал-дефектов-форма из av-dev-pipeline/skills/review-pipeline/references/review-journal.md -->
+## ГГГГ-ММ-ДД — <краткое последствие> [проскочил|пойман]
+
+- **Где:** путь:строка либо «конвейер, а не код»
+- **Симптом:** как обнаружилось, кем и когда
+- **Причина:** что на самом деле было не так
+- **Чем воспроизведён:** тест, команда, замер — с числами
+- **Почему не поймали:** только для проскочивших — какой проход обязан был найти
+  и что ему помешало
+- **Что меняем:** правило прохода, шаг гейта, конвенция, факт в документе
+  проекта — либо «ничего, цена поимки выше цены дефекта»
+<!-- /копия: журнал-дефектов-форма -->
+```
+
+Новый проект: «Дефектов пока не было. Настройка конвейера появится с первым
+ревью.»
+
+## `CLAUDE.md`
+
+Лежит в корне, не в `docs/`. Единственный файл канона, который агент читает
+**всегда**, поэтому в нём то, без чего нельзя сделать ни шага.
+
+```markdown
+# CLAUDE.md
+
+Памятка для работы над <проект>. Перед задачей прочитай также
+[docs/passport.md](docs/passport.md), [docs/architecture.md](docs/architecture.md)
+и [docs/conventions/](docs/conventions/README.md).
+
+## Что это
+
+Абзац: что делает и чего **не** делает.
+
+## Стек
+
+## Инварианты
+
+Что нарушать нельзя. Каждый пункт — три вещи: формулировка **как проверяемое
+свойство**, а не лозунг; последствие нарушения и его обратимость; **severity**
+рядом. По этим формулировкам проходы ревью присваивают `critical`, поэтому
+severity стоит здесь, а не выводится каждым проходом заново.
+
+## Команды
+
+## Гейт
+
+- Команда целиком и как определяется база диффа:
+- Где логи шагов:
+- Что означает каждый исход:
+- **Что красит безусловно и почему:**
+- Чего в гейте намеренно нет и **кто тогда обязан это гонять:**
+
+## Запреты
+
+Что запускать нельзя, **с путями**: рабочая БД, боевой каталог данных, внешние
+сервисы. Плюс где `testdata` и куда писать временное.
+
+## Работа
+
+- **Основная ветка:** <имя>
+- **Необратимое** (спрашивается у человека всегда):
+- **Общий станок** — какая проверка, покраснев, врывается в замороженный спринт:
+- **Ориентир по размеру спринта:** 5–8 задач, ориентир а не закон
+- **Что такое «сделана»:** пайплайн проекта пройден + критерии приёмки проверены
+  поимённо
+
+## Язык
+
+- Документация, комментарии, сообщения коммитов — русский.
+- Код и идентификаторы — английский.
+```
+
+Имя основной ветки, запреты с путями и «что необратимо» — не украшение: без
+первого падают git-операции батча и расчёт базы диффа, без второго проход может
+тронуть рабочие данные, без третьего вся шкала ранжирования триажа держится на
+догадке.
+
+## `docs/.pm.json`
+
+```json
+{
+  "canon": 1
+}
+```
+
+Плюс `"migrations": "<путь>"`, если есть БД. Ключ `"tasks"` заводится **только**
+когда имя файла или заголовка отличается от умолчания (`{"backlog":
+"INDEX.md"}`); секций беклога в нём нет — их дом заголовки `##` индекса. Состав
+ключей — [canon.md](canon.md).

av-dev-pm/skills/canon/scripts/docs.py

@@ -0,0 +1,441 @@
+#!/usr/bin/env python3
+"""Проверка раскладки документов проекта против канона av-dev.
+
+Определение канона — references/canon.md рядом со скриптом. Здесь только
+механизируемая часть: пути, лишние файлы, битые ссылки, версия, плейсхолдеры,
+маркеры долга и две сверки с кодом. Смысловые дубли и оставшееся в архитектуре
+поведение судит агент — скрипт об этом говорит вслух в конце отчёта.
+
+Коды выхода — тот же словарь, что у tasks.py:
+  0  сошлось
+  1  дрейф раскладки (рабочая ситуация, чинится)
+  2  ошибка употребления
+  3  окружение: не тот каталог, битый конфиг
+  4  внутренний сбой
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import re
+import subprocess
+import sys
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import NoReturn
+
+CANON_VERSION = 1
+
+OK, DRIFT, USAGE, ENV, INTERNAL = 0, 1, 2, 3, 4
+
+# --- Раскладка канона -------------------------------------------------------
+
+# Обязательные файлы: путь → на какой вопрос отвечает (для внятного отказа).
+REQUIRED = {
+    "CLAUDE.md": "памятка агенту: инварианты с severity, команды, семантика гейта",
+    "docs/.pm.json": "версия канона и пути, нужные проверкам",
+    "docs/passport.md": "зачем и для кого, чем НЕ является",
+    "docs/architecture.md": "как сложено — обзор, окружение, эксплуатация",
+    "docs/security.md": "периметр, недоверенный вход, что вне модели",
+    "docs/review.md": "настройка конвейера + журнал дефектов",
+    "docs/conventions/README.md": "индекс конвенций, правило промоута, что механизировано",
+    "docs/research/README.md": "как снималось, индекс наблюдений",
+    "docs/adr/README.md": "индекс записей, статусы, правило замены",
+    "docs/adr/template.md": "шаблон записи ADR",
+}
+
+# Обязателен только при условии: путь → (ключ .pm.json, пояснение).
+CONDITIONAL = {
+    "docs/database.md": ("migrations", "схема хранилища и настройки"),
+}
+
+# Что вообще разрешено лежать в docs/ верхним уровнем.
+ALLOWED_FILES = {
+    ".pm.json",
+    "passport.md",
+    "architecture.md",
+    "database.md",
+    "security.md",
+    "review.md",
+}
+ALLOWED_DIRS = {"conventions", "research", "adr", "tasks"}
+
+# Слоты, которых в каноне нет, — с адресом, куда уезжает содержимое.
+RETIRED = {
+    "review-brief.md": "документы канона и есть бриф; остаток — в review.md",
+    "review-journal.md": "→ docs/review.md",
+    "plan.md": "→ docs/tasks/PLAN.md",
+    "conventions.md": "→ docs/conventions/",
+    "local-research.md": "→ docs/research/",
+    "research.md": "→ docs/research/",
+    "specs": "поведение → openspec/specs/, обзор → docs/architecture.md",
+    "drafts": "идея → задача [idea], отказ → ADR, порядок → PLAN.md",
+    "backlog": "→ docs/tasks/",
+    "review": "→ docs/review.md",
+}
+
+DEBT_MARKER = re.compile(r"<!--\s*канон:\s*(.+?)\s*-->")
+PLACEHOLDER = re.compile(r"<!--\s*заполнить:\s*(.+?)\s*-->")
+MD_LINK = re.compile(r"\[[^\]]*\]\(\s*<?([^)>\s]+)>?(?:\s+[\"'(][^)]*)?\)")
+FENCE = re.compile(r"^\s*(```|~~~)")
+
+
+INLINE_CODE = re.compile(r"`[^`\n]*`")
+
+
+def strip_code(text: str) -> str:
+    """Выкинуть блоки кода и вставки в обратных кавычках.
+
+    Путь в примере или в шаблоне — не ссылка, и краснеть на нём значит краснеть
+    на каждом образце документа. Инлайн-код тоже: `[docs/backlog](docs/tasks/…)`
+    в тексте про подписи ссылок — иллюстрация, а не ссылка."""
+    out, inside = [], False
+    for line in text.splitlines():
+        if FENCE.match(line):
+            inside = not inside
+            continue
+        out.append("" if inside else INLINE_CODE.sub("", line))
+    return "\n".join(out)
+
+
+@dataclass
+class Report:
+    errors: list[str] = field(default_factory=list)
+    notes: list[str] = field(default_factory=list)
+    debts: list[str] = field(default_factory=list)
+    skipped: list[str] = field(default_factory=list)
+
+    def error(self, msg: str) -> None:
+        self.errors.append(msg)
+
+    def note(self, msg: str) -> None:
+        self.notes.append(msg)
+
+    def debt(self, msg: str) -> None:
+        self.debts.append(msg)
+
+    def skip(self, msg: str) -> None:
+        self.skipped.append(msg)
+
+
+def fail(code: int, msg: str) -> NoReturn:
+    print(f"ОТКАЗ: {msg}", file=sys.stderr)
+    sys.exit(code)
+
+
+def read_config(root: Path, rep: Report) -> dict:
+    path = root / "docs" / ".pm.json"
+    if not path.exists():
+        return {}
+    try:
+        data = json.loads(path.read_text(encoding="utf-8"))
+    except json.JSONDecodeError as exc:
+        fail(ENV, f"docs/.pm.json не разбирается: {exc}")
+    if not isinstance(data, dict):
+        fail(ENV, "docs/.pm.json должен быть объектом")
+    return data
+
+
+# --- Проверки ---------------------------------------------------------------
+
+
+def check_version(root: Path, cfg: dict, rep: Report) -> None:
+    if not (root / "docs" / ".pm.json").exists():
+        return  # об отсутствии файла скажет check_required, второй раз не нужно
+    if "canon" not in cfg:
+        rep.error("в docs/.pm.json нет ключа canon — версия канона не объявлена")
+        return
+    got = cfg["canon"]
+    if not isinstance(got, int):
+        rep.error(f"canon в docs/.pm.json должен быть целым числом, а не {got!r}")
+        return
+    if got < CANON_VERSION:
+        rep.error(
+            f"проект приведён к канону версии {got}, текущая — {CANON_VERSION}: "
+            f"нужен canon upgrade"
+        )
+    elif got > CANON_VERSION:
+        rep.error(
+            f"проект приведён к канону версии {got}, а скрипт знает {CANON_VERSION}: "
+            f"устарел плагин, обнови маркетплейс"
+        )
+
+
+def check_required(root: Path, cfg: dict, rep: Report) -> None:
+    for rel, what in REQUIRED.items():
+        if not (root / rel).exists():
+            rep.error(f"нет {rel} — {what}")
+    for rel, (key, what) in CONDITIONAL.items():
+        if key in cfg and not (root / rel).exists():
+            rep.error(f"нет {rel} — {what} (обязателен: в .pm.json объявлен {key})")
+        elif key not in cfg and not (root / rel).exists():
+            rep.skip(f"{rel} — в .pm.json нет ключа {key}, проверка неприменима")
+
+
+def check_stray(root: Path, rep: Report) -> None:
+    docs = root / "docs"
+    if not docs.is_dir():
+        rep.error("нет каталога docs/")
+        return
+    for entry in sorted(docs.iterdir()):
+        name = entry.name
+        if name in RETIRED:
+            rep.error(f"docs/{name} — слота нет в каноне: {RETIRED[name]}")
+            continue
+        if entry.is_dir():
+            if name not in ALLOWED_DIRS:
+                rep.error(f"docs/{name}/ — каталог вне канона")
+        elif name not in ALLOWED_FILES:
+            rep.error(f"docs/{name} — файл вне канона")
+
+
+def canon_docs(root: Path) -> list[Path]:
+    """Документы канона. Каталог задач ведёт tasks.py; упразднённые каталоги
+    уже названы отдельной строкой, и их внутренние ссылки не наша забота —
+    они переезжают целиком."""
+    out = []
+    docs = root / "docs"
+    skip = {"tasks"} | {name for name in RETIRED if not name.endswith(".md")}
+    if docs.is_dir():
+        for path in sorted(docs.rglob("*.md")):
+            head = path.relative_to(docs).parts[0]
+            if head in skip or head in RETIRED:
+                continue
+            out.append(path)
+    claude = root / "CLAUDE.md"
+    if claude.exists():
+        out.append(claude)
+    return out
+
+
+def check_links(root: Path, rep: Report) -> None:
+    for path in canon_docs(root):
+        try:
+            text = path.read_text(encoding="utf-8")
+        except OSError as exc:
+            rep.error(f"{path.relative_to(root)} не читается: {exc}")
+            continue
+        for target in MD_LINK.findall(strip_code(text)):
+            target = target.strip()
+            if not target or target.startswith(("http://", "https://", "#", "mailto:")):
+                continue
+            clean = target.split("#", 1)[0]
+            if not clean:
+                continue
+            if (path.parent / clean).exists():
+                continue
+            rep.error(f"{path.relative_to(root)}: битая ссылка на {target}")
+
+
+def check_placeholders_and_debt(root: Path, rep: Report) -> None:
+    for path in canon_docs(root):
+        text = strip_code(path.read_text(encoding="utf-8", errors="replace"))
+        rel = path.relative_to(root)
+        for what in PLACEHOLDER.findall(text):
+            # Замечание, а не дрейф: незаполненный канон — объявленное переходное
+            # состояние, и краснеть на нём значит требовать выдумать содержание.
+            rep.note(f"{rel}: плейсхолдер шаблона не заполнен — {what}")
+        for what in DEBT_MARKER.findall(text):
+            rep.debt(f"{rel}: {what}")
+
+
+def check_capabilities(root: Path, rep: Report) -> None:
+    specs = root / "openspec" / "specs"
+    arch = root / "docs" / "architecture.md"
+    if not specs.is_dir():
+        rep.skip("openspec/specs/ нет — сверка capability с архитектурой неприменима")
+        return
+    if not arch.exists():
+        rep.skip(
+            "docs/architecture.md нет — capability не сверены с обзором "
+            "(об отсутствии файла сказано отдельной строкой)"
+        )
+        return
+    text = arch.read_text(encoding="utf-8", errors="replace")
+    for d in sorted(specs.iterdir()):
+        if not d.is_dir():
+            continue
+        name = d.name
+        # Засчитываем только явное упоминание: ссылку на спеку или имя в обратных
+        # кавычках. Голая подстрока совпадает с именем пакета или CLI-команды и
+        # даёт ложное «упомянуто» — то есть проверку, проходящую не по той причине.
+        explicit = f"openspec/specs/{name}" in text or f"`{name}`" in text
+        loose = re.search(rf"\b{re.escape(name)}\b", text) is not None
+        if explicit:
+            continue
+        if loose:
+            rep.note(
+                f"capability {name}: в docs/architecture.md есть слово «{name}», но "
+                f"нет ни ссылки на openspec/specs/{name}, ни имени в обратных "
+                f"кавычках — проверь, это про capability или про пакет"
+            )
+        else:
+            rep.error(
+                f"capability {name} есть в openspec/specs/, но не упомянута в "
+                f"docs/architecture.md — обзор отстал от нормативных спек"
+            )
+
+
+def changed_files(root: Path, base: str, rep: Report) -> list[str] | None:
+    """Объединение закоммиченного, рабочего дерева и untracked.
+
+    Гейт гоняют ДО коммита, поэтому `base...HEAD` не видит ровно ту правку, ради
+    которой проверка и заводилась: миграция уже лежит в дереве, но ещё не в
+    истории. Пропущенная правка выглядела бы как зелёный шаг."""
+    cmds = [
+        ["diff", "--name-only", base],
+        ["ls-files", "--others", "--exclude-standard"],
+    ]
+    seen: list[str] = []
+    for cmd in cmds:
+        try:
+            out = subprocess.run(
+                ["git", "-C", str(root), *cmd],
+                capture_output=True,
+                text=True,
+                check=True,
+            )
+        except (subprocess.CalledProcessError, FileNotFoundError) as exc:
+            rep.skip(f"сверка миграций пропущена: git не отдал дифф ({exc})")
+            return None
+        seen.extend(line for line in out.stdout.splitlines() if line)
+    return sorted(set(seen))
+
+
+def check_migrations(root: Path, cfg: dict, base: str | None, rep: Report) -> None:
+    migrations = cfg.get("migrations")
+    if not migrations:
+        rep.skip("в .pm.json нет ключа migrations — сверка со схемой неприменима")
+        return
+    if not base:
+        rep.skip("база диффа не названа (--base) — сверка миграций со схемой не гонялась")
+        return
+    changed = changed_files(root, base, rep)
+    if changed is None:
+        return
+    touched = [f for f in changed if f.startswith(migrations.rstrip("/") + "/")]
+    if not touched:
+        return
+    if "docs/database.md" not in changed:
+        rep.error(
+            f"миграции изменены ({len(touched)} файлов), а docs/database.md — нет: "
+            f"схема в документации отстала"
+        )
+
+
+def check_tasks(root: Path, rep: Report) -> None:
+    tasks = root / "docs" / "tasks"
+    if not tasks.is_dir():
+        rep.error("нет docs/tasks/ — каталог задач часть канона")
+        return
+    script = Path(__file__).resolve().parents[2] / "tasks" / "scripts" / "tasks.py"
+    if not script.exists():
+        rep.skip(f"tasks.py не найден по пути {script} — согласованность задач не проверена")
+        return
+    # cwd=root обязателен: tasks.py отвергает --dir вне текущего каталога, и без
+    # этого его отказ окружения (код 3) схлопнулся бы в наш дрейф (код 1).
+    proc = subprocess.run(
+        [sys.executable, str(script), "check", "--dir", "docs/tasks"],
+        capture_output=True,
+        text=True,
+        cwd=str(root),
+    )
+    if proc.returncode == 0:
+        return
+    if proc.returncode == 1:
+        rep.error("tasks.py check нашёл дрейф в docs/tasks/ — разбирать его командой tasks.py")
+    else:
+        # Чужой код выхода не выдаём за свой: 3 это окружение, а не дрейф.
+        rep.skip(
+            f"tasks.py check не отработал (код {proc.returncode}): "
+            f"{(proc.stderr or proc.stdout).strip().splitlines()[0] if (proc.stderr or proc.stdout).strip() else 'без сообщения'}"
+        )
+
+
+# --- Отчёт ------------------------------------------------------------------
+
+
+def report(rep: Report) -> int:
+    for msg in rep.errors:
+        print(f"ДРЕЙФ    {msg}")
+    for msg in rep.notes:
+        print(f"ЗАМЕЧАНИЕ {msg}")
+    if rep.debts:
+        print(f"\nДОЛГ ({len(rep.debts)} маркеров, гейт от них не краснеет):")
+        for msg in rep.debts:
+            print(f"  {msg}")
+    if rep.skipped:
+        print("\nНЕ ПРОВЕРЯЛОСЬ:")
+        for msg in rep.skipped:
+            print(f"  {msg}")
+
+    print(
+        "\nМашина проверила раскладку, ссылки, версию и две сверки с кодом.\n"
+        "Смысловые дубли, оставшееся в architecture.md поведение и достаточность\n"
+        "честной строки в пустом слоте она не проверяет — это суждение агента."
+    )
+    if rep.errors:
+        print(f"\nИтог: дрейф, {len(rep.errors)} пунктов.")
+        return DRIFT
+    print("\nИтог: канон соблюдён в механизируемой части.")
+    return OK
+
+
+def cmd_check(args: argparse.Namespace) -> int:
+    root = Path(args.dir).resolve()
+    if not root.is_dir():
+        fail(ENV, f"каталог {root} не найден")
+    if not (root / "docs").exists() and not (root / "CLAUDE.md").exists():
+        fail(ENV, f"{root} не похож на корень проекта: нет ни docs/, ни CLAUDE.md")
+
+    rep = Report()
+    cfg = read_config(root, rep)
+    check_version(root, cfg, rep)
+    check_required(root, cfg, rep)
+    check_stray(root, rep)
+    check_links(root, rep)
+    check_placeholders_and_debt(root, rep)
+    check_capabilities(root, rep)
+    check_migrations(root, cfg, args.base, rep)
+    check_tasks(root, rep)
+    return report(rep)
+
+
+def cmd_version(args: argparse.Namespace) -> int:
+    root = Path(args.dir).resolve()
+    cfg = read_config(root, Report())
+    got = cfg.get("canon", "не объявлена")
+    print(f"канон скрипта: {CANON_VERSION}")
+    print(f"канон проекта: {got}")
+    return OK
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        prog="docs.py",
+        description="механическая проверка канона документов проекта",
+    )
+    sub = parser.add_subparsers(dest="cmd", required=True)
+
+    p_check = sub.add_parser("check", help="раскладка, ссылки, версия, сверки с кодом")
+    p_check.add_argument("--dir", default=".", help="корень проекта (по умолчанию текущий)")
+    p_check.add_argument("--base", default=None, help="база диффа для сверки миграций")
+    p_check.set_defaults(func=cmd_check)
+
+    p_ver = sub.add_parser("version", help="версия канона скрипта и проекта")
+    p_ver.add_argument("--dir", default=".", help="корень проекта")
+    p_ver.set_defaults(func=cmd_version)
+
+    args = parser.parse_args()
+    try:
+        return args.func(args)
+    except SystemExit:
+        raise
+    except Exception as exc:  # noqa: BLE001 — последний рубеж, код 4 по словарю
+        print(f"ВНУТРЕННИЙ СБОЙ: {exc}", file=sys.stderr)
+        return INTERNAL
+
+
+if __name__ == "__main__":
+    sys.exit(main())

av-dev-pm/skills/docs/SKILL.md

@@ -0,0 +1,136 @@
+---
+name: docs
+description: Вести содержимое документов канона по ходу разработки — синк после сделанной задачи с построчным отчётом по каждому документу, заведение ADR промоутом из архивного design.md, запись наблюдения в research, запись дефекта и настройки конвейера в review.md, чистка architecture.md от поведения с маркерами долга. Использовать, когда задача сделана и надо обновить документацию, когда просят завести ADR или записать решение, занести находку о внешних данных, записать проскочивший дефект, разгрузить разросшуюся архитектуру. Раскладку и соответствие канону проверяет скилл canon.
+---
+
+# Ведение содержимого канона
+
+Скилл владеет **содержимым** документов канона; раскладкой владеет `canon`.
+Определение канона и роли документов — [канон](../canon/references/canon.md),
+здесь не пересказывается.
+
+Главный вызывающий — **шаг синка документации в пайплайне задачи**. Пайплайн
+живёт в другом плагине и зовёт этот скилл по имени; проект без пайплайна ведёт
+документацию тем же скиллом вручную.
+
+## Правило, из которого всё следует
+
+**Принуждённое отрицание.** Синк обязан назвать **каждый** документ канона: либо
+чем он обновлён, либо «не требуется, потому что…». Нетронутые группируются одной
+строкой с общей причиной.
+
+Причина, по которой правило именно такое, измерена: у ADR был список триггеров
+прозой — и он дал **6 записей на 43 изменения**. Прозаический триггер, который
+некому проверить, не срабатывает. Умолчание «не написал» становится отличимым от
+«написал, что не требуется», только когда отрицание обязательно.
+
+Это тот же приём, что «границы покрытия» в отчёте ревью и «пустое называется
+пустым» в каноне.
+
+## Чек-лист синка
+
+Идёт сверху вниз; каждая строка попадает в доклад.
+
+| Документ | Обновляется, когда | Проверка |
+| --- | --- | --- |
+| `openspec/specs/` | всегда при изменении поведения | вливает `opsx:archive` |
+| `database.md` | тронуты миграции | `docs.py check --base` |
+| `architecture.md` | новый компонент, граница, внешняя зависимость, изменилось окружение | `docs.py`: capability без упоминания |
+| `adr/` | дорогой откат, намеренный отказ, пересмотр прежнего | нет — только этот чек-лист |
+| `research/` | узнали новое о внешнем формате или данных | нет |
+| `security.md` | новый недоверенный вход, токен, путь наружу, сдвиг периметра | нет |
+| `conventions/` | находка принята и не специфична для одного места | промоут |
+| `review.md` | дефект воспроизведён; сузили или расширили проверку | нет |
+| `passport.md` | новый потребитель, сдвиг границы «чем не является» | нет |
+| `CLAUDE.md` | изменился инвариант, гейт, запрет, необратимое | нет |
+
+Пример доклада:
+
+```
+Синк документации:
+- architecture.md — добавлен воркер свёртки, ссылка на capability reindex
+- database.md — миграция 00006, таблица bucket
+- adr/ — заведён ADR-2026-08-03-ochered-tablicej: отказ от внешней очереди
+- research/ — новое о формате не узнано
+- passport, security, conventions, review — не требуется: изменение внутреннее
+```
+
+## ADR — промоут, а не второе сочинение
+
+Обоснование уже написано: `opsx:propose` кладёт `design.md` в каждый change, и
+после архивации он лежит в `openspec/changes/archive/<id>/design.md` с разделами
+`Context` / `Goals / Non-Goals` / `Decisions` / `Risks / Trade-offs`.
+
+**ADR цитирует решение оттуда и ссылается на источник.** Не пересказывает и не
+сочиняет заново.
+
+**Триггер заведения, форма имени и правило замены — в
+[каноне](../canon/references/canon.md), раздел `adr/`.** Здесь они не
+повторяются: копия правила расходится с оригиналом на первой же смене версии
+канона, а расходится незаметно.
+
+Твоя часть — **применить триггер к этой задаче и сказать вслух, сработал он или
+нет**. Строка «adr/ — не требуется: решение рутинное» и есть то, ради чего
+чек-лист существует; её отсутствие неотличимо от «забыл посмотреть».
+
+Порядок работы: открой архивный `design.md` change, найди в `Decisions` то, что
+проходит триггер, процитируй решение и его причину, сошлись на источник, добавь
+строку в индекс `docs/adr/README.md` сверху.
+
+## Чистка `architecture.md`
+
+Обзор не держит поведение — его нормативный дом `openspec/specs/`. **Форма
+маркера долга и правило «гейт от них не краснеет» — в
+[каноне](../canon/references/canon.md), раздел `architecture.md`.**
+
+Разбирается порциями: раздел вычищается той задачей, которая его касается.
+Содержимое не выбрасывается, а переезжает — требования в дельта-спеку change,
+обоснование в ADR, обзор остаётся строкой со ссылкой на capability.
+
+## Запись в `research/`
+
+Наблюдение о внешнем мире: что реально шлёт источник, чем документация формата
+расходится с практикой. **Требование провенанса и правило про расходящееся
+число — в [каноне](../canon/references/canon.md), раздел `research/`.**
+
+Твоя часть — заметить, что по ходу задачи узналось новое о внешних данных, и не
+дать этому остаться в контексте. Признак: ты правил разбор, опираясь на то, чего
+нет ни в одном документе.
+
+## Запись в `review.md`
+
+Файл держит два раздела с разными сроками жизни — журнал дефектов и настройку
+конвейера. **Что в каком и в какой форме — в
+[каноне](../canon/references/canon.md), раздел `review.md`**; подробности формы
+записи и выбор адреса, куда она ведёт, — у конвейера ревью проекта (при
+`av-dev-pipeline` — `Skill av-dev-pipeline:review-pipeline`, его
+`references/review-journal.md`). **Конвейера в проекте нет** — пиши по форме из
+скелета `review.md`, которую положил канон, и скажи в докладе, что подробностей
+формы взять негде.
+
+Твоя часть на синке: **дефект пишется сразу**, а не «потом, когда починим».
+Со временем теряется не факт, а причина непоймания — единственное, ради чего
+журнал есть. И решение о сужении проверок (перестали звать проход, понизили
+профиль) обязано попасть в раздел настройки, а не остаться в отчёте ревью.
+
+## Промоут в конвенции
+
+Находка → конвенция → правило линтера → **удаление из прозы**. Процедура целиком
+принадлежит конвейеру ревью проекта (при `av-dev-pipeline` — его
+`references/promote.md`, читается через `Skill av-dev-pipeline:review-pipeline`);
+роль каталога конвенций — в [каноне](../canon/references/canon.md). **Конвейера
+нет** — три шага всё равно твои, просто без его процедуры: сформулируй правило,
+поищи, чем оно механизируется, и вычеркни прозу, если механизировалось.
+
+Твоя часть — **третий шаг, который пропускают чаще всего**: правило заработало,
+а формулировка осталась в прозе, и проход продолжает проверять уже проверенное.
+На синке это отдельная строка: «conventions/ — правило X механизировано,
+формулировка удалена» либо «не требуется».
+
+## Чего этот скилл не делает
+
+- **Не проверяет раскладку** — это `canon`.
+- **Не заводит недостающие документы** — их скелет кладёт `canon adopt` или
+  `init`.
+- **Не сочиняет содержание.** Нечего записать — так и пишется, честной строкой.
+- **Не переоформляет документы «заодно»**: правится то, чего коснулась работа.

av-dev-pm/skills/init/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: init
+description: Завести новый проект — сессия вопросов и ответов по свободному описанию замысла, из которой рождается первичная документация по канону av-dev: паспорт, CLAUDE.md с инвариантами и командами, модель угроз с периметром, первые цели в плане и скелет остальных документов. Использовать, когда начинают новый проект с нуля, когда есть только текст «что мне нужно и почему» и надо превратить его в рабочую документацию, когда просят провести стартовое интервью по брифу. Проект, где документация уже как-то ведётся, переводит скилл canon.
+---
+
+# Заведение нового проекта
+
+Вход — свободный текст «что мне нужно и почему». Выход — канон документов, с
+которого дальше работают все остальные скиллы.
+
+**Определение канона — [канон](../canon/references/canon.md).** Читается до
+первого вопроса: интервью идёт по слотам канона, а не по вкусу. Что класть в
+каждый файл — [скелеты](../canon/references/skeletons.md); своей формы заглушки
+не выдумывай, `docs.py` узнаёт только плейсхолдер оттуда.
+
+## Что `init` физически не может произвести
+
+В новом репозитории **нет кода**, а `architecture.md`, `database.md`,
+`conventions/` и `research/` выводятся из него. Их сочинение на старте — это
+проектирование вперёд реальности, и оно протухнет раньше первой задачи.
+
+Поэтому `init` заполняет то, что человек знает **до первой строки кода**:
+
+| Заполняется | Остаётся скелетом с честной строкой |
+| --- | --- |
+| `passport.md` | `architecture.md` |
+| `CLAUDE.md` | `database.md` |
+| `security.md` | `conventions/` |
+| `docs/tasks/PLAN.md` — первые цели | `research/`, `adr/` |
+| `docs/.pm.json` | `review.md` — журнал пуст, настройка появится с первым ревью |
+
+Честная строка информативна, а не «TBD»: «архитектуры пока нет: кода нет,
+заводится первой задачей». Проход читает её как факт.
+
+## Порядок интервью — зависимость, а не удобство
+
+Каждый блок опирается на ответ предыдущего; переставлять нельзя.
+
+1. **Цель и потребители.** Ради чего это; кто пользуется — список закрытый, и
+   он определяет, что считать нужным, а что интересным.
+2. **Чем это НЕ является и мера успеха.** Граница домена — критерий, по
+   которому архитектурный проход потом судит о переносе понятия. Мера — по чему
+   поймём, что удалось.
+3. **Периметр и недоверенный вход.** Открыт наружу или контур доверенный; что
+   приходит извне и каким каналом; что чувствительнее чего. Контур ещё не
+   развёрнут — назови **оба** периметра, целевой и сегодняшний.
+4. **Стек, хранилище, необратимое.** Чем пишем и почему; где данные; что в этом
+   проекте нельзя откатить — деплой, выкладка наружу, перезапись данных.
+5. **Чем краснеет гейт.** Какие проверки обязательны; что красит безусловно;
+   чего в гейте намеренно не будет и кто тогда это гоняет.
+6. **Первые цели.** Направления, а не задачи: три-пять целей линии с
+   обоснованием порядка прозой.
+
+### Как вести
+
+- **Не больше трёх вопросов за итерацию** (`AskUserQuestion`), рекомендация
+  первым вариантом. Между итерациями применяй уже решённое.
+- **Сперва вычитай ответы из брифа.** Вопрос, ответ на который в тексте уже
+  есть, задавать не надо — покажи своё прочтение и спроси, верно ли.
+- **Не выдумывай четыре вещи:** периметр, что необратимо, измеренные числа и
+  адресата дорогой проверки. Их из замысла не вывести. Не сказано — пиши
+  «неизвестно» с пометкой, что ждёт ответа.
+- **Развилка замысла — человеку, механика — сама.** Имена файлов, слаги, порядок
+  строк не выносятся.
+
+## Порядок работы
+
+1. Прочитай бриф целиком. Выпиши, на какие блоки интервью ответ уже есть.
+2. Проведи интервью итерациями по ≤3 вопроса.
+3. Заведи `docs/.pm.json` с текущей версией канона.
+4. Напиши заполняемые документы. **Бриф переезжает в `passport.md`** и
+   отдельным файлом не остаётся: два дома для одного замысла разойдутся на
+   первом же уточнении.
+5. Заведи скелет остальных по [скелетам](../canon/references/skeletons.md) —
+   каждый с честной строкой.
+6. Каталог задач и первые цели — **вызови скилл `av-dev-pm:tasks`**: он владеет
+   форматом целей и задач.
+7. `docs.py check` из скилла `canon` — до отсутствия дрейфа. Замечания о
+   незаполненных плейсхолдерах остаются: их закрывает не `init`, а работа.
+8. Покажи человеку, что получилось, и **отдельным списком** — что выведено из
+   брифа, что предположено, что осталось неизвестным. Правят по этим строкам.
+
+## Что дальше
+
+- Содержимое канона по ходу разработки ведёт скилл `docs`.
+- Раскладку проверяет `canon check`.
+- Первую задачу берёт пайплайн проекта; `architecture.md` и `conventions/`
+  наполняются его шагом синка, а не заранее.
+
+## Чего этот скилл не делает
+
+- **Не проектирует систему.** Архитектура выводится из кода, а не наоборот.
+- **Не пишет код** и не заводит сборку.
+- **Не переводит существующий проект** — это `canon adopt`. Признак: в
+  репозитории уже есть документация или беклог в какой-то раскладке.
+- **Не решает за человека**, что важно: цель, границы и периметр — его ответы.

av-dev-pm/skills/session/SKILL.md

@@ -0,0 +1,240 @@
+---
+name: session
+description: Ритуал между спринтами и ведение самого спринта: разбор накопившихся вопросов, разбор прошедшего спринта про процесс, переоценка задач порциями, выбор цели и набор нового спринта с заморозкой. Плюс правила по ходу спринта — что врывается в замороженный набор, чем вопрос отличается от блокера, когда задача выходит из спринта, что считается сделанным и что идёт в доклад. Использовать, когда просят закрыть или начать спринт, собрать набор, разобрать вопросы, провести груминг/переоценку/ретроспективу, решить «что делать дальше» или доложить итоги. Формат и содержимое задач — скилл tasks.
+---
+
+# Сессия между спринтами
+
+Работа идёт спринтами: **набор задач под одну цель, замороженный до конца
+спринта**. Между спринтами — одна сессия из четырёх шагов. Этот скилл владеет
+**ритуалом**: как сессия проводится и как спринт ведётся. Форматом и содержимым
+задач владеет скилл `tasks`, выполнением задачи — пайплайн проекта.
+
+## Почему не Scrum
+
+Терминология близка — спринт, груминг, определение готовности, ретроспектива, —
+и это удобно: не нужно изобретать слова. Но добрая половина Scrum существует
+ради синхронизации людей, которых здесь нет.
+
+**Не берём:** тайм-бокс (спринт ограничен объёмом, а не временем), velocity и
+оценки в очках, ежедневный стендап (стендап — это и есть диалог), планирование
+отдельно от груминга (владелец беклога один), роль скрам-мастера.
+
+**Берём:** цель спринта, заморозку набора, определение готовности, груминг —
+каждое потому, что снимает решение, которое иначе принимается заново каждый раз.
+**Ретроспективу берём содержанием, но не отдельным ритуалом:** она шаг той же
+сессии. Процесс личный, синхронизировать некого, а отдельная встреча ради трёх
+вопросов — та самая плата ритуалом без выгоды.
+
+## Роли
+
+**Человек** выбирает цель спринта, разбирает вопросы, держит право на
+необратимое и на истину в самих данных.
+
+**Агент — оркестрация.** Он собирает набор под названную цель, ставит задачи,
+принимает отчёты и докладывает. Кто именно делает задачу — исполнитель, сабагент,
+пайплайн — дело проекта; сессия про это не знает и знать не должна.
+
+## Единицы
+
+- **Цель** — то, ради чего набирается спринт. Файл `[goal]`, перечисленный в
+  `PLAN.md`. Цель постоянна: живёт, пока живёт направление.
+- **Задача** — то, что мерджится целиком и даёт видимую пользу.
+- **Вопрос** — решение человека. Не останавливает начатую работу, но **блокирует
+  взятие** задачи в спринт. Живёт внутри файла задачи разделом «Вопросы» и тегом
+  `question`.
+- **Блокер** — состояние, когда спринт не может продолжаться **ни одной**
+  задачей.
+- **Спринт** — набор задач под одну цель, замороженный до его конца.
+
+## Вопрос, блокер, необратимое
+
+| | Что это | Когда спрашиваем | Что останавливает |
+| --- | --- | --- | --- |
+| **Вопрос** | решение человека | на сессии, пачкой | взятие задачи в спринт |
+| **Блокер** | спринт не может продолжаться ни одной задачей | немедленно | всё |
+
+Право на **необратимое** — третье и отдельное: что именно необратимо, называет
+`CLAUDE.md` проекта, и спрашивается оно всегда, независимо от спринта.
+
+**Блокер определяется исходом, а не одновременностью.** Встали разом или
+высыпались из спринта по одной — если продолжать нечем, это блокер: спринт
+распускается (`sprint close --dissolve --reason …`), человек спрашивается
+немедленно. Иначе спринт, из которого задачи вышли поштучно, выглядел бы штатно
+завершённым, а вопросы тихо ждали бы сессии.
+
+**Отличать вопрос от застревания.** Правило про остаток принадлежит управлению
+задачами: оно решает, **сделана задача или вышла**, а это исход планирования, не
+исполнения. **Ниже канонический текст; пайплайн проекта на него ссылается, а не
+пересказывает** — два экземпляра одного правила разъезжаются, и разъезжаются
+незаметно, потому что расхождение видно только на редком входе.
+
+> Есть остаток, который доводится без ответа, — задача продолжается, вопрос
+> записывается в файл. Остатка нет — задача выходит из спринта.
+
+С двумя оговорками, без которых тест ошибается:
+
+> **Остаток, который материализует нерешённое** — записывает в хранилище,
+> журнал, витрину **или наружу** состояние, зависящее от неотвеченного вопроса,
+> — **не остаток**. Решение поднимается до начала записи: откатить запись
+> дороже, чем подождать ответ, а иногда невозможно. «Наружу» — часть правила, а
+> не пример: выкладка, публикация и отправка данных третьей стороне не
+> откатываются тем более.
+
+> **Пол для остатка:** остаток, из которого пропала польза, названная в хуке, —
+> это не сделанная задача, а вышедшая из спринта.
+
+## Заморозка набора
+
+**Цель одна.** Набор служит ей; задача, не служащая цели, в спринт не попадает,
+даже если взять удобно (`sprint take` это и запрещает). **Задача с открытым
+вопросом в набор не берётся.**
+
+**Новая работа падает в беклог, а не в идущий спринт.** Решение «врываться или
+отложить» принимается один раз правилом, а не заново каждый раз. Врывается
+только два класса:
+
+1. **Необратимый ущерб** — потеря, порча или утечка данных: то, что не чинится
+   доделкой потом.
+2. **Сломан общий станок** — красная проверка, на которой стоит определение
+   готовности **всех** задач набора. Это не новая работа, а починка того, на чём
+   делается вся остальная.
+
+Что в проекте считается необратимым ущербом и что — общим станком, называет
+`CLAUDE.md` проекта. Не названо — спрашиваем человека, а не решаем сами.
+
+**Конец спринта** — когда каждая задача набора либо сделана, либо вышла с
+записанной причиной. Не «все сделаны»: иначе одна застрявшая задача держит
+спринт бесконечно. Пустой набор закрывается `sprint close` — скрипт не даст
+закрыть непустой.
+
+Ведение спринта целиком — исходы задачи, определение готовности, приёмка,
+доклад — [references/sprint.md](references/sprint.md).
+
+## Сессия: четыре шага в этом порядке
+
+Это зависимость, а не список.
+
+1. **Разбор вопросов.**
+2. **Разбор прошедшего спринта — про процесс, а не про задачи.**
+3. **Переоценка задач** порциями.
+4. **Выбор цели и набор спринта.** Цель называет человек, набор собирает агент и
+   показывает **до старта работ**.
+
+Процедура каждого шага, размер и отбор порции, храповик на залежавшихся, формат
+интерактива и доклад — [references/cadence.md](references/cadence.md).
+
+## Инструмент
+
+Тот же `tasks.py`, что у скилла `tasks` — оба скилла в одном плагине, путь
+общий: `tk="$CLAUDE_PLUGIN_ROOT/skills/tasks/scripts/tasks.py"`. Сессии нужны
+прежде всего:
+
+```
+python3 $tk check --dir D                       # с этого начинается любая сессия
+python3 $tk list --dir D --questions            # шаг 1: что накопилось
+python3 $tk list --dir D --tag sprint:<слаг>    # шаг 3: урожай спринта, первая порция
+python3 $tk list --dir D --stale                # шаг 3: дальше по залежалости
+python3 $tk list --dir D --goal <слаг>          # шаг 4: кандидаты под названную цель
+python3 $tk sprint start --dir D --goal <слаг>  # шаг 4: заводит и слаг спринта
+python3 $tk sprint take --dir D <слаг> …        # шаг 4: набор
+python3 $tk sprint close --dir D                # конец спринта; --dissolve при блокере
+python3 $tk reopen <слаг> --dir D --reason …    # приёмка не сошлась после закрытия
+```
+
+`D` — каталог задач проекта, по канону всегда `docs/tasks`; `--dir` передаётся
+явно каждой командой. Вызов из чужого контекста описан в скилле `tasks`
+(«Переносимость»). **Коды выхода** — там же: 1 это дрейф в беклоге, 3 это
+«каталога нет», и ветвиться на них надо по-разному.
+
+**Слаг спринта заводит `sprint start`** (по умолчанию — дата) и пишет его в
+`SPRINT.md`; всё заведённое **при открытом спринте** помечается `sprint:<слаг>`
+автоматически. Поэтому «первая порция — урожай прошедшего спринта» работает без
+чьей-либо памяти — но ровно до команды `sprint close`, которая `SPRINT.md`
+очищает. Отсюда порядок: **урожай заводится до закрытия, слаг для сессии берётся
+из отчёта `sprint close`** ([references/sprint.md](references/sprint.md)).
+
+Правки задач делаются мутациями (`edit`, `move`, `close`), а не редактором:
+руками правится только тело файла. Это правило скилла `tasks`, здесь оно не
+пересказывается.
+
+## Стимулы, которые процесс создаёт
+
+Правило, которое можно обойти в свою пользу, будет обойдено.
+
+**Приёмщик и исполнитель здесь совпадают, и это надо назвать вслух.** Задачу
+закрывает и двигает по индексам агент-оркестратор — тот же, кто её и сделал.
+Прежде границу держала механика: моста между плагинами не было, и закрыть задачу
+пайплайн физически не мог. Теперь мост есть, и защита у трёх обходов ниже —
+**только текстовая**. Опоры, которые остались настоящими:
+
+- **независимый отчёт ревью** — артефакт, написанный не исполнителем; по нему
+  сверяют состав прогона и урожай. Где он лежит, знает пайплайн проекта; при
+  конвейере `av-dev-pipeline` это отчёт триажа в
+  `openspec/changes/archive/<id>/review/` (до архивации — `changes/<id>/review/`);
+- **`SPRINT.md` под git** — `git log -p` показывает, что и когда было закрыто.
+  Работает, только если закрытие **закоммичено**: удаление файла задачи и правка
+  индекса, оставшиеся в рабочем дереве, никакой истории не образуют;
+- **`reopen <слаг> --reason`** — закрытие не окончательно. Приёмка человеком на
+  сессии его отменяет, и это штатная операция, а не скандал.
+
+Известные обходы:
+
+- **Скрыть блокер** — он останавливает всё и выглядит как провал исполнителя.
+  Защита: тест про остаток плюс прямая запись, что **объявление блокера
+  неудачей не считается**.
+- **Не записать вопрос** на задаче-кандидате, чтобы не вычеркнуть её из
+  ближайшего набора. Защита: вопросы кандидатов разбираются на той же сессии
+  **вне очереди порции**.
+- **Занизить критерии приёмки**, раз они пол. Защита ослаблена: правит их тот же,
+  кто по ним отчитывается. Остаётся требование, что расхождение критериев с
+  сутью — **дефект критериев, о котором сообщают, а не молча дорабатывают**, и
+  переоценка на сессии, где критерии видит человек.
+- **Сжать задачу до остатка** и отчитаться «сделана». Защита ослаблена там же.
+  Пол для остатка — польза, названная в хуке; проверяет его человек при приёмке,
+  и `reopen` — его инструмент.
+- **Занизить урожай** — не заводить найденное по ходу. Защита: поимённая сверка
+  с **сохранённым независимым отчётом**, а не с прозой исполнителя. Каждая
+  отложенная находка имеет либо слаг, либо строку «не заведена: причина».
+  Нулевой урожай при непустом отчёте виден сразу.
+
+**Проект без конвейера ревью — независимого отчёта нет, и это надо сказать, а не
+обойти молча.** Задачи делались руками или чужим пайплайном, сверять урожай не с
+чем: остаётся проза исполнителя, то есть тот же взгляд, что и у автора. Тогда
+защита от занижения урожая **снята**, и доклад спринта обязан нести строку «урожай
+сверялся с отчётом исполнителя — независимого отчёта в проекте нет». Дальше это
+решение человека: завести конвейер, принимать выборочной перепроверкой или
+согласиться с ценой. Молчание здесь хуже любого из трёх исходов.
+
+Стимулы внутри пайплайна задачи (занизить требования к проверке, пропустить
+проход) принадлежат ему и защищены там же.
+
+## Слоты проекта
+
+Сессия не знает ни языка, ни сборки, ни CI. Часть проектного отвечает
+[канон](../canon/references/canon.md) структурой: разбор процесса (шаг 2) живёт
+в `docs/review.md`, оракулы и «чем краснеет безусловно» — в семантике гейта в
+`CLAUDE.md`. Остальное проект **дописывает в `CLAUDE.md`**:
+
+1. **Пайплайн задачи** — чем задача выполняется и что входит в его определение
+   готовности. Сессия требует только форму: пайплайн пройден + критерии приёмки
+   проверены поимённо.
+2. **Общий станок** — какая проверка, покраснев, врывается в замороженный
+   спринт.
+3. **Необратимое** — что спрашивается у человека всегда (тот же слот, что у
+   скилла `tasks`; дом один).
+4. **Ориентир по размеру спринта**, если он замерялся. Умолчание — 5–8 задач, и
+   это **ориентир, а не закон**.
+
+Слота «куда копируются критерии приёмки» здесь нет намеренно: на него отвечает
+**пайплайн проекта**, перенося их в описание изменения при его заведении. Проект
+без пайплайна называет своё место сам, в слоте 1.
+
+Числа проекта (сколько задач в спринте, сколько времени на задачу, каков прирост
+беклога) — предмет шага 2, а не константы этого скилла.
+
+## Чего этот скилл не делает
+
+Не пишет код и не выполняет задачи. Не заводит и не переоформляет задачи сам по
+себе — формат и содержимое ведёт `tasks` (сессия зовёт его операции). Не решает
+за человека, какая цель следующая. Не двигает набор идущего спринта.

av-dev-pm/skills/session/references/cadence.md

@@ -0,0 +1,202 @@
+# Сессия: четыре шага
+
+Одна сессия между спринтами. Порядок шагов — **зависимость, а не список**:
+переоценивать задачи, не разобрав вопросы, значит переоценивать вслепую; набирать
+спринт, не переоценив, значит набирать из протухшего.
+
+Начинается сессия с `tasks.py check` (и `check --fix`, если дрейф накопился) —
+результат идёт строкой в доклад.
+
+## Шаг 1. Разбор вопросов
+
+`tasks.py list --questions` — всё, что накопилось. Вопрос это решение человека,
+и разбирается он **пачкой**, а не по одному в момент возникновения: по одному —
+это дёрганье, пачкой — это сессия.
+
+Порядок по каждому вопросу:
+
+1. **Проверь, не отвечен ли он уже** — решением, документом, соседним
+   изменением, самим ходом прошедшего спринта. Отвеченный вопрос не выносится
+   человеку: это самая частая находка и она не требует ничьего решения.
+2. **Сформулируй развилку** с вариантами и последствием каждого, рекомендация —
+   первым вариантом.
+3. **Вынеси пачкой** через `AskUserQuestion`, не больше трёх за раз.
+4. **Ответ записывается в тело задачи, раздел «Вопросы» опустошается**, тег
+   снимается `edit <slug> --rm-tag question`, **хук переписывается**: «Решено:
+   …» на вопрос «почему это лежит в беклоге» уже не отвечает. Опустошение
+   раздела — не уборка, а условие взятия: правило и причина в скилле `tasks`,
+   [references/task-format.md](../../tasks/references/task-format.md).
+
+**Вопросы на задачах-кандидатах разбираются вне очереди порции** — здесь же, на
+этой сессии, даже если сама задача в порцию переоценки не попала. Иначе правило
+«задача с открытым вопросом в набор не берётся» создаёт стимул вопрос не
+записывать, лишь бы не вычеркнуть задачу из ближайшего спринта.
+
+## Шаг 2. Разбор прошедшего спринта — про процесс, а не про задачи
+
+Не «что мы сделали» (это доклад спринта, он уже был), а:
+
+- **что сломалось в процессе и почему не поймали** — промах, доехавший до конца;
+- **сколько на самом деле заняли задачи** против ожидания;
+- **какие правила не сработали или сработали не так** — в том числе правила
+  этого плагина;
+- **какие числа пора пересмотреть** — ориентир по размеру спринта, прирост
+  беклога на одну закрытую задачу, время на задачу. Эта обязанность иначе висит
+  ничья: числа, помеченные как «первый замер», не пересматриваются никогда, если
+  их не пересматривает конкретный шаг.
+
+**Артефакт обязателен.** Вывод, оставшийся в контексте сессии, не существует:
+следующая сессия его не увидит. Дом у него один и известен из канона —
+**`docs/review.md`**: вывод про конвейер и про то, что перестали проверять, идёт
+в раздел настройки, вывод про воспроизведённый дефект — в журнал. Решение с
+долгим следом — в `docs/adr/`.
+
+Отдельным ритуалом ретроспектива не выделяется: процесс личный,
+синхронизировать некого.
+
+## Шаг 3. Переоценка задач
+
+Цель — выкинуть то, что перестало быть задачей, и вернуть остальному честное
+состояние. Не «пересмотреть всё», а «пересмотреть порцию до конца».
+
+### Порция и правило остановки
+
+Тридцать задач за один заход — это усталость и штамповка: последние десять
+получат «оставить» не потому, что живы, а потому, что сессия затянулась.
+
+- **5–8 задач за порцию.** Размер обоснован усталостью, а не пропускной
+  способностью, и менять его не надо — **надо брать несколько порций за
+  сессию**.
+- **Сколько порций:** не меньше `⌈урожай прошедшего спринта / 8⌉`. Урожай — это
+  задачи, заведённые за спринт; при урожае в 15 это две-три порции.
+- **Отбор порций по порядку:**
+  1. **урожай спринта** — `list --tag sprint:<слаг>`: свежезаведённое ещё не
+     проходило ни одной проверки на нужность. Тег на задачах проставлен
+     автоматически при заведении — руками не метят и не вспоминают. **Слаг
+     берётся из отчёта `sprint close`, а не из `SPRINT.md`:** сессия идёт после
+     закрытия, а закрытие этот файл очищает;
+  2. дальше **по залежалости** — `list --stale`;
+  3. по потребности — одна секция целиком, один тег (партия ревью), одна цель
+     (`--goal`), список от пользователя.
+- **Останавливайся на границе порции**, даже если «ещё чуть-чуть осталось».
+  Между порциями — промежуточный доклад.
+
+### Что делать с каждой задачей
+
+Сперва то, что не требует ничьего решения:
+
+1. **Проверь, не сделано ли уже.** Задача, реализованная попутно в соседнем
+   изменении, — самая частая находка. Смотри код, документацию, историю коммитов
+   по ключевым словам. Удаление «как реализованной» деструктивно и без следа
+   (в `REJECTED.md` реализованные не пишутся), поэтому порог улики жёсткий:
+   `close <slug> --implemented` только имея **конкретный коммит или строку
+   документа**, закрывающие задачу, и ссылка идёт в доклад. Есть лишь косвенные
+   признаки — не удаляй сам, вынеси в пачку вопросов. Сделана частично → задача
+   сжимается до остатка: тело правишь редактором, заголовок и хук — через
+   `edit`.
+2. **Проверь, не отменена ли решением.** Документ, ADR или архивное изменение
+   мог закрыть вопрос иначе — тогда `close <slug> --reason "<ссылка на
+   решение>"`. Задача закрывается не только коммитом.
+3. **Проверь пересечения.** Две задачи об одном — содержимое в одну, вторую
+   `close <slug> --reason "слита с <другой-слаг>"`. Смотри **шире порции**:
+   интейк дедуплицирует новое против существующего, но никогда не
+   пересматривает уже лежащее, и две задачи с одной причиной могут лежать рядом
+   месяцами.
+4. **Пере-кластеризуй по общей причине.** Несколько задач, оказавшихся симптомами
+   одного дефекта, сливаются в одну — это находка, которую интейк дать не мог.
+5. **Гигиена полей** — протухший хук, вопрос в прозе, снятый ответ, свойство
+   репозитория в рамках, предписание процесса в теле. Список и правила — в
+   скилле `tasks`.
+
+Затем — то, что решает пользователь:
+
+6. **Жива ли она вообще.** Контекст мог измениться: ушла зависимость, отпал
+   сценарий, обошли иначе. Здесь и звучит вопрос о выкидывании.
+7. **Та ли цель.** Приоритетов нет, и «повысить» нечего — вместо повышения
+   **смена цели** (`edit <slug> --goal <другой>`) или включение в ближайший
+   набор. Задача, которой не находится цель, — кандидат на выход: она не попадёт
+   ни в один спринт.
+8. **Задача ли это по-прежнему.** Не проходит тест «готова к взятию» → `edit
+   <slug> --type idea`, дальше штурм. Разрослась → `edit <slug> --type epic`,
+   дальше декомпозиция.
+9. **Переоценка по измеренному.** Спринт производит числа — сколько на самом
+   деле стоит такая работа, что оказалось дороже ожидания. Эти числа меняют цену
+   **других** задач, и именно здесь это применяется: задача, чья цена выросла
+   втрое, а польза осталась прежней, — кандидат на выход.
+
+### Храповик на залежавшихся
+
+Сильно залежавшаяся задача — сигнал сама по себе: её либо ни разу не собирались
+делать, либо нечем взять. Измеряй наблюдаемым — датой последней правки из git
+(`list --stale` ставит такие первыми); счётчик «сколько сессий пережила» нигде
+не хранится.
+
+Задача из верхних строк `--stale`, которую и этот заход оставляет без изменений,
+**либо двигается (меняет цель, идёт в набор, уходит с причиной), либо остаётся с
+явно записанной причиной**, почему её держим (`move <slug> --section <та же>
+--reason …`). Молчаливое «оставить как есть» на давно неподвижной задаче — это
+решение не принимать решение; запись причины превращает его в осознанное и не
+даёт тому же вопросу всплыть на следующей сессии.
+
+### Интерактив
+
+- Вопросы — через `AskUserQuestion`, **не больше трёх за раз**. Порция в 5–8
+  задач обычно даёт больше трёх суждений — тогда веди несколько итераций по ≤3,
+  а не по одному на задачу и не одним перегруженным запросом.
+- К каждому варианту — **предварительное суждение, рекомендация первым
+  вариантом**: «предлагаю выкинуть, потому что …». Пользователю дешевле
+  возразить, чем судить с нуля.
+- Всё, что решается фактом (сделано / отменено / дублируется), решай сам и
+  показывай списком в докладе, а не выноси в вопросы.
+
+Пример одной итерации — три залежавшихся задачи, механику по ним уже разобрали:
+
+> **Переоценка: 3 залежавшихся (порция по `--stale`)**
+>
+> 1. `versii-kachestvo-repaki` — версии и качество одного тайтла
+>    - Выкинуть *(рекомендую)* — помечена «не боль», за полгода ни разу не возникла
+>    - Оставить под целью `nadyozhnost-razdach`
+>    - Перевести под цель `kachestvo-mediateki` — там она первая в очереди
+> 2. `backup-sqlite` — бэкап базы
+>    - Оставить под текущей целью *(рекомендую)* — не сработала, но риск реальный
+>    - Взять в ближайший набор — без бэкапа ретеншн опасен
+>    - Выкинуть
+> 3. `guessit-sputnik` — вынести распознавание в сервис-спутник
+>    - Понизить до `[idea]` *(рекомендую)* — не проходит тест «готова к взятию»
+>    - Оставить задачей
+
+Каждый вариант несёт причину — ту самую, что уедет в `--reason`. Ответы применяй
+сразу и, если в порции осталось ещё, следующей итерацией показывай следующие ≤3.
+
+## Шаг 4. Выбор цели и набор спринта
+
+1. **Покажи состояние целей**: линия `PLAN.md` с обоснованием порядка, кусты, и
+   по каждой цели-кандидату — сколько под ней задач без открытых вопросов
+   (`list --goal <слаг>`). Цель без готовых задач набором не станет: её сперва
+   надо декомпозировать.
+2. **Цель называет человек.** Это продуктовое решение, а не механика: агент
+   предлагает и объясняет, но не выбирает.
+3. **Набор собирает агент** — `sprint start --goal <слаг>`, затем `sprint take
+   …`. Скрипт не даст взять чужую цель, идею, эпик, задачу с открытым вопросом
+   или без критериев приёмки.
+4. **Набор показывается человеку до старта работ.** Показ — это и есть момент
+   заморозки: после него набор не двигается.
+5. Задача, которой для взятия не хватает только критериев приёмки, дописывается
+   здесь же — 2–5 утверждений, у каждого назван оракул (меньше двух `sprint
+   take` не примет). Но если для критериев нужен ответ человека, это вопрос, и
+   задача в набор не идёт.
+
+**Размер — ориентир, а не закон:** 5–8 задач. Можно взять больше, можно меньше —
+набор под цель важнее круглого числа; одна крупная задача спринтом тоже бывает.
+
+## Доклад сессии
+
+- Что просмотрено: N из M, сколько порций, по какому признаку отобраны.
+- Вопросы: разобрано N, из них отвечено без человека N, снято тегов N.
+- Разбор процесса: что записано и куда.
+- Изменения списком: удалено как реализованное (со ссылками), ушло без
+  реализации (с причинами), понижено до идей, слито, сменило цель.
+- Новый спринт: цель, набор со слагами, дата.
+- **Границы покрытия**: сколько задач не трогали и какие именно секции, теги или
+  цели остались — иначе доклад читается как «беклог разобран».
+- `tasks.py check` после правок — результат строкой.

av-dev-pm/skills/session/references/sprint.md

@@ -0,0 +1,153 @@
+# Ведение спринта
+
+Спринт — набор задач под одну цель, замороженный до его конца. Здесь то, что
+происходит **внутри** спринта: как задача заканчивается, что считается сделанным,
+кто принимает и что идёт в доклад. Как спринт набирается — шаг 4 в
+[cadence.md](cadence.md).
+
+## Наблюдаемые исходы задачи
+
+Как они достигаются — дело пайплайна проекта. Сессия знает только исход и его
+след.
+
+- **Сделана** — по определению готовности ниже. `close <slug> --implemented`:
+  файл и строка удаляются, следом остаётся коммит. **Закрывает агент-оркестратор
+  последним шагом пайплайна, после коммита; приёмка человеком идёт позже и
+  отменяется `reopen`** — см. «Кто и когда закрывает».
+- **Вышла из спринта** — `sprint drop <slug> --reason …`: возвращается в беклог
+  с вопросом в файле и **без живого незакоммиченного предложения** — иначе при
+  следующем взятии оно столкнётся с новым. Наработки, которые жалко терять,
+  переезжают в тело задачи текстом.
+- **Переросла в эпик** — распознаётся **до того, как под неё заведено
+  предложение об изменении**, иначе его придётся выбрасывать. Помечается
+  `[epic]`, выходит из набора, уходит на декомпозицию; спринт продолжается
+  остальными, части в замороженный набор не добавляются.
+- **Отменена решением по ходу** — `close <slug> --reason "<ссылка на решение>"`
+  прямо из спринта. Это редкий, но законный исход, и он называется в докладе.
+
+**Конец спринта** — когда по каждой задаче набора наступил один из исходов. Не
+«все сделаны»: иначе одна застрявшая задача держит спринт бесконечно. Затем
+`sprint close`.
+
+**Урожай заводится при закрытии спринта, а не при закрытии задачи.** Это
+обязанность закрывающего: пройти по спискам находок от исполнителей и завести
+недостающее интейком скилла `tasks` — с дедупликацией и картой человеку. Заводимое
+метится тегом спринта само (`sprint:<слаг>`), поэтому первая порция следующей
+сессии поднимается одной командой `list --tag sprint:<слаг>`. Спринт, закрытый
+без этого шага, оставляет находки жить в отчётах — то есть нигде.
+
+**Порядок здесь обязателен: урожай заводится ДО команды `sprint close`.**
+Автотег ставится по слагу из `SPRINT.md`, а `sprint close` этот файл очищает;
+заведённое после команды остаётся без тега и в первую порцию следующей сессии
+не попадёт — молча, потому что пустой `list --tag` выглядит как «урожая не
+было». Если так уже вышло, тег ставится руками: `add … --tag sprint:<слаг>`,
+слаг берётся из отчёта `sprint close`.
+
+**Провал спринта.** Сработал блокер — спринт распускается (`sprint close
+--dissolve --reason …`), недоделанное возвращается в беклог, новый набор
+делается после ответа человека. Спринт не «ждёт»: ждать может человек, а
+замороженный набор, который нельзя двигать, только мешает.
+
+## Определение готовности
+
+Задача засчитывается сделанной, когда верно **всё**:
+
+1. **Пайплайн задачи пройден до конца** — со своим определением готовности, за
+   которое отвечает проект: проверки, состав ревью, документация, коммит. Здесь
+   оно не пересказывается и не подменяется — **форма фиксирована, содержание
+   даёт `CLAUDE.md` проекта**. Пайплайна нет, задача сделана руками — условие
+   читается как «проверки проекта зелёные и изменение влито».
+2. **Критерии приёмки проверены поимённо** — каждый со своим оракулом, исход по
+   каждому назван. Это единственное, что добавляет управление задачами: пайплайн
+   отвечает «сделано по правилам», критерии — «сделано то, что заказывали».
+3. **Находки по ходу отданы списком** — исполнитель обязан их **назвать**
+   (каждую, с пометкой «заведена / не заведена: причина»), но **не обязан
+   заводить**: заведение интерактивно, оно требует дедупликации против беклога и
+   кладбища и решений человека. Обязанность **завести урожай** — на закрытии
+   спринта, ниже. Так автономный исполнитель не оказывается одновременно обязан
+   завести задачи и не вправе это сделать в одиночку.
+
+### Кто и когда закрывает
+
+**Задачу закрывает агент-оркестратор — тот же, кто её и сделал**, последним шагом
+пайплайна, после коммита. Порядок:
+
+1. пайплайн доводит задачу до коммита;
+2. **после коммита** зовёт `Skill av-dev-pm:tasks` и закрывает задачу
+   (`close <slug> --implemented`); строка уходит из `SPRINT.md`;
+3. **докладывает исход и по каждому критерию — оракул и наблюдаемый исход.**
+   Это доклад приёмщику, а не отметка «принято».
+
+**Приёмщик и исполнитель здесь совпадают, и это принято сознательно** — цена
+названа в `SKILL.md`, раздел «Стимулы». Поэтому закрытие **не окончательно**, а
+доклад по критериям — не формальность: он единственное, по чему приёмка вообще
+возможна.
+
+**Порядок «коммит, потом закрытие» обязателен.** Закрытие удаляет файл задачи;
+упавший коммит после закрытия оставил бы задачу закрытой без единого следа
+работы.
+
+**Само закрытие тоже коммитится, отдельным коммитом.** Удаление файла задачи и
+правка индекса — правки в рабочем дереве; пока они не в истории, `SPRINT.md`
+ничего не показывает, а `reopen` восстанавливает текст из `HEAD` в узком окне,
+которое закончится первым посторонним коммитом. Сообщение про учёт, а не про
+работу: `закрыта задача <slug>`.
+
+**Дорога назад существует и обязана быть названа.** Человек на сессии сверил
+критерии, и приёмка не сошлась — `tasks.py reopen <slug> --reason "приёмка не
+сошлась: …"`:
+файл восстанавливается из истории git, строка возвращается в набор идущего
+спринта (или в беклог, если спринта нет), строка кладбища снимается. Тело
+восстанавливается **на момент удаления** — всё, что было дописано позже, живёт
+только в коммите задачи, и это называется в докладе.
+
+### Кто и по чему принимает
+
+Три условия, без которых пункт про критерии не исполняется никем:
+
+1. **Критерии переживают файл задачи.** Файл удаляется при закрытии, поэтому
+   критерии копируются туда, где их увидит приёмщик. Куда именно — **отвечает
+   пайплайн проекта, а не слот в `CLAUDE.md`**: он переносит их в `tasks.md`
+   изменения на шаге заведения change. Проект без пайплайна называет своё место
+   сам.
+2. **Принимает человек на сессии, а не отдельный агент.** Декорреляция
+   исполнителя и приёмщика в момент закрытия **снята** (решение о снятии и его
+   цена — в `SKILL.md`, «Стимулы»). Опоры остались три: **сохранённый независимый
+   отчёт ревью** (при конвейере `av-dev-pipeline` — отчёт триажа в
+   `openspec/changes/archive/<id>/review/`, до архивации — `changes/<id>/review/`),
+   `SPRINT.md` под git и `reopen`. Переоценка на сессии и есть момент, когда
+   критерии видит не исполнитель. **Конвейера ревью в проекте нет — первой опоры
+   нет тоже**, и это называется строкой доклада, а не обходится молча
+   (`SKILL.md`, «Стимулы»).
+3. **Расхождение — дефект критериев.** Приёмщик правит критерии и возвращает
+   задачу исполнителю **в этом же спринте**: ответ есть, остаток есть, по тесту
+   про остаток это не выход из спринта.
+
+## Что врывается в замороженный набор
+
+Только два класса — правило и его обоснование в SKILL.md. Здесь механика:
+
+- вторжение **не добавляет** задачу в набор: `SPRINT.md` остаётся набором под
+  цель. Внеплановая работа делается и называется в докладе отдельной строкой
+  «внеплановое: что и почему»;
+- если внеплановое требует больше пары часов, честнее распустить спринт, чем
+  делать вид, что набор соблюдается;
+- всё остальное падает в беклог через обычный интейк и ждёт сессии.
+
+## Доклад в конце спринта
+
+Проверяемые якоря, а не пересказ:
+
+- **Цель спринта** и по каждой задаче набора: **хеш коммита**, дословный исход
+  проверок проекта, **исход по каждому критерию приёмки**.
+- **Какие развилки решались** и чем обоснованы.
+- **Урожай:** сколько задач заведено, какие вопросы накопились, что вышло из
+  спринта и почему, что было внеплановым.
+- **Поимённая сверка урожая** с независимыми отчётами ревью: каждая отложенная
+  находка имеет либо слаг, либо строку «не заведена: причина». Нулевой урожай при
+  непустом отчёте — сигнал, а не благополучие. **Отчётов нет** (проект без
+  конвейера ревью) — сверять не с чем, и строка доклада говорит именно это, а не
+  «сверено».
+- **Созрела ли порция для сессии.** Решение звать — человека, напоминание —
+  обязанность агента: `⌈урожай / 8⌉` порций.
+- **Границы покрытия** сжатой строкой: что в этом спринте не проверялось вовсе.

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

@@ -0,0 +1,339 @@
+---
+name: tasks
+description: Ведение задач и целей как каталога markdown-файлов (одна запись = один файл в items/ + строка в одном из индексов). Заведение задачи, идеи или цели из диалога, разбор находок аудита/ревью, декомпозиция на независимо полезные части, мозговой штурм идеи, гигиена полей и проверка согласованности индексов. Использовать, когда просят добавить задачу/идею/цель, превратить находки ревью в задачи, разбить задачу, проработать идею, поправить формат или проверить беклог. Ритуал между спринтами — скилл session. Не реализует задачи — этим занимается пайплайн проекта.
+---
+
+# Задачи
+
+Задачи — каталог markdown-файлов. Одна запись = один файл `items/<slug>.md` плюс
+строка **ровно в одном** индексе. Скилл владеет **форматом и содержимым**:
+заводит, редактирует, закрывает, разбирает находки ревью, дробит, штурмует идеи.
+
+Чем он **не** владеет: ритуалом между спринтами (разбор вопросов → разбор
+прошедшего спринта → переоценка → выбор цели и набор) — это скилл `session`; и
+выполнением задачи — это пайплайн проекта.
+
+## Четыре правила, из которых всё следует
+
+Ситуация не покрыта инструкцией — решай по ним.
+
+1. **Беклог гниёт с той стороны, где его пополняют.** Заведение — самая частая
+   операция и с худшим отказом: из одного разговора рождается пять файлов, а
+   переоценка потом разгребает то, чего не надо было заводить. Дедупликация и
+   фильтр на входе дешевле любой чистки. Заводим только то, что **не делаем
+   сейчас** и о потере чего пожалеем.
+2. **Файл — источник истины, индексы производны.** Разошлись — неправы индексы.
+   Согласованность механизируема и проверяется командой, а не вниманием: всё,
+   что ловит `tasks.py check`, не должно попадать ни в чек-лист, ни в промпт.
+   Поэтому **хук живёт в мета-строке файла**, а строка индекса его лишь
+   повторяет: пока хук лежал только в индексе, восстановление пропавшей строки
+   теряло его молча и навсегда. Единственное исключение намеренное: **в каком
+   индексе лежит задача, знают индексы** — «в спринте» это свойство спринта, а
+   не файла, поля-состояния нет.
+3. **Причина переживает запись.** Выкинутая без причины задача вернётся через
+   квартал тем же текстом. Реализованная оставляет след в коммите — выкинутая не
+   оставляет ничего, поэтому у неё есть `REJECTED.md`.
+4. **Порядка нет, есть цель.** Ни в секциях, ни списком: «что делать дальше»
+   отвечает набор спринта, а между спринтами порядок не нужен никому — брать
+   задачи вне спринта запрещает заморозка. Поэтому нет ни приоритетов, ни
+   «повысить», ни «встать раньше»: вместо повышения — смена цели или включение
+   в набор.
+
+## Раскладка
+
+Каталог задач — **`docs/tasks`, жёстко**: это часть
+[канона документов](../canon/references/canon.md), и подгоняется под него
+проект, а не наоборот.
+
+```
+docs/tasks/
+  items/            задачи и цели файлами, <slug>.md, слаги английские
+  PLAN.md           оглавление целей: линия (упорядоченная) и кусты
+  BACKLOG.md        что можно взять — только задачи, целей здесь нет
+  SPRINT.md         текущий спринт: цель, набор, дата
+  REJECTED.md       ушедшее БЕЗ реализации, с причиной и датой
+```
+
+Правило, снимающее путаницу: **`BACKLOG.md` — то, что берут; `PLAN.md` — то,
+подо что берут.** Цель в спринт взять нельзя, поэтому в списке берущихся ей не
+место.
+
+**Секции «блокеры» в беклоге нет.** Блокер — это *состояние* (спринт не может
+продолжаться ни одной задачей), а не полка: он живёт ровно до ответа человека, и
+записи в такой секции не успевают жить. Следы блокера остаются вопросами в
+файлах задач распущенного спринта. Постоянно пустая секция со старой семантикой
+«разбираются пачками» противоречила бы правилу «блокер эскалируется немедленно»,
+поэтому `init` её заводить отказывается, а `check` о ней говорит. **Проекту,
+который переезжает с такой секцией, её надо удалить** — это единственное место,
+где это сказано.
+
+**Задача живёт в одном индексе за раз.** Взята в спринт — строка переезжает из
+`BACKLOG.md` в `SPRINT.md`; вышла — обратно. Файл в `items/` при этом **не
+двигается**: он и есть запись, индексы лишь показывают, где она числится.
+
+**У сделанной задачи записи не остаётся** — файл и строка удаляются (`close
+--implemented`). Ей хватает коммита и документации проекта; вторая запись была
+бы вторым домом для того же факта. Вопрос «что было в спринте N» отвечается
+даром: `SPRINT.md` лежит под git, `git log -p docs/tasks/SPRINT.md` отдаёт историю
+всех наборов без отдельного журнала.
+
+## Цели
+
+**Цель — такой же файл в `items/`, тип `[goal]`**, перечисленный в `PLAN.md`:
+либо звено упорядоченной **линии** продукта (с обоснованием порядка прозой),
+либо тематический **куст** — цель, в последовательность не встающая («прочность
+слияния», «журнал и пересборка»). Без второй части половина целей была бы нигде
+не перечислена: находки ревью не служат ничему из линии.
+
+- **Список задач цели выводится, а не хранится.** В теле цели — зачем она и что
+  считается её завершением; перечня задач там нет. Он был бы третьим индексом и
+  поехал бы на первой же закрытой задаче, а `check` про него не знает. Связь
+  однонаправленна: задача несёт тег `goal:<слаг>`, перечень даёт
+  `tasks.py list --goal <слаг>`.
+- **Статус цели выводится.** Цель закрыта, когда у неё не осталось открытых
+  задач; `[x]`/`[~]` руками не ведутся, а `close` цели с живыми задачами
+  скрипт запретит. Единственная оговорка: цель без задач неотличима — «ещё не
+  разобрана» или «всё закрыто». Различает **тег `decomposed`** в мета-строке
+  цели: он ставится, когда цель разложена на задачи. Тег, а не строка в теле —
+  потому что проверяется механически: `check` **напоминает** о нём у пустой цели
+  (замечанием, не ошибкой — неразобранная цель это законное состояние), а `check
+  --fix` сам проставляет его цели, у которой задачи есть.
+- **`[goal]` и `[epic]` — разные вещи.** Цель **постоянна**: живёт, пока живёт
+  направление. Эпик **временен**: это задача, которая не мерджится целиком, её
+  разбирают, и он исчезает. Два срока жизни под одним словом разъезжаются,
+  поэтому слова два.
+
+## Инструмент (`tasks.py`)
+
+Пусть `tk="$CLAUDE_PLUGIN_ROOT/skills/tasks/scripts/tasks.py"`, а `D` —
+`docs/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] [--index …] [--questions]
+python3 $tk add --dir D --slug S --title T [--type goal|idea|epic] [--section S] [--goal G] [--hook H] [--tag a,b]
+python3 $tk edit S --dir D [--title T] [--hook H] [--type T] [--goal G] [--add-tag a,b] [--rm-tag c]
+python3 $tk move S --dir D --section S [--reason R] [--after S | --first]
+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 sprint start --goal S --dir D | take S… | drop S… --reason R | close [--dissolve --reason R]
+python3 $tk init --dir D [--sections …] [--plan-sections …] [--items …] [--backlog …] …
+python3 $tk adopt scan --from … | apply --plan …   # разовая адаптация, references/adopt.md
+```
+
+**Коды выхода — единый словарь; на нём ветвятся скиллы, а не на тексте вывода:**
+
+| Код | Что случилось | Что делать |
+| --- | --- | --- |
+| 0 | сошлось / сделано | дальше по сценарию |
+| 1 | **только `check`:** найден дрейф индексов и файлов | `check --fix`, остаток разобрать |
+| 2 | ошибка употребления: аргументы или нарушенное правило | читать сообщение, это отказ по существу |
+| 3 | окружение: каталог не найден, конфиг битый или мимо диска | чинится путём или `docs/.pm.json`, повтор не поможет |
+| 4 | внутренний сбой | дефект скрипта, доложить |
+
+Различать 1 и 3 обязательно: «дрейф в беклоге» — рабочая ситуация, «каталога
+нет» — нерабочая, и одинаковая реакция на них была бы неверна в обоих случаях.
+
+Тип — английское ключевое слово `goal` / `idea` / `epic` / `task` (как и прочие
+токены команд); `task` префикса не несёт, остальные кодируются `[goal]`/
+`[idea]`/`[epic]` в заголовке. Текст задачи при этом русский.
+
+**Мутации правят файл и индексы заодно** — руками строку индекса или мета-строку
+не пиши, зови `add`/`edit`/`move`/`close`/`sprint`. Смена заголовка, хука, типа,
+цели и **тегов** — это `edit`: он держит H1, мета-строку и индекс в синхроне.
+Снятие тега — `--rm-tag` (после ответа на вопрос снимается `question`), смена
+цели — `--goal`, он заменяет прежний `goal:*`.
+
+**Переезд между индексами — следствие смены типа, а не отдельная команда.**
+`edit <slug> --type goal --section <часть плана>` переносит строку из
+`BACKLOG.md` в `PLAN.md` (и обратно `--type task --section <секция беклога>`);
+`move` двигает только внутри одного индекса и пишет причину. `--section` у
+`edit` работает **только** при таком переезде — иначе он отсылает к `move`,
+потому что смена секции без причины и есть тот дрейф, который потом никто не
+объяснит. Задача в наборе спринта тип не меняет вовсе: сперва `sprint drop`.
+
+Тело задачи скрипт не трогает:
+`add` кладёт заголовок, мета-строку и шаблон с подсказками, тело дописываешь
+редактором (пока плейсхолдер на месте, `check` напоминает).
+
+`check` — единственный судья согласованности; что именно он ловит, скажет его
+вывод, здесь не пересказываем. Гоняй его **в начале сессии** и **после каждой
+правки**, даже если правил мутациями: дрейф мог накопиться раньше. Накопившееся
+чини `check --fix` — он детерминированно правит то, где истина однозначна
+(секция, заголовок, дубли, хук из индекса в файл, строка в чужом индексе,
+пометка `decomposed` у цели с задачами), а неоднозначное (задача сразу в двух
+индексах, нечего восстанавливать) печатает отдельной пометкой `НЕОДНОЗНАЧНО` —
+это тебе, и это идёт строкой доклада. **Ссылка на исчезнувший файл в пометку не
+попадает:** `--fix` её просто не трогает, и она остаётся `ОШИБКА` обычного
+`check` — то есть видна, но в докладе её надо назвать отдельно.
+
+`--fix` правит **и файлы** — ровно в двух местах, где источник ровно один и
+выбирать не из чего: хук, оставшийся только в индексе, переезжает в мета-строку,
+и цель, у которой есть задачи, получает тег `decomposed`. Оба случая печатаются
+поимённо.
+
+**Что механизировано, а что нет.** Критерии приёмки проверяются у задачи, взятой
+в набор (`sprint take` и `check` по задачам спринта): число пунктов — жёстко
+(меньше двух — отказ, больше пяти — замечание), наличие оракула — **эвристикой**
+по слову «оракул» в пункте. Настоящий оракул от слова «оракул» машина не
+отличает, поэтому эвристика даёт только замечание, и в докладе это называется
+как есть: «проверено число пунктов, годность оракулов — глазами».
+
+Формат файла, мета-строки, слага, индексов и `REJECTED.md` —
+[references/task-format.md](references/task-format.md). Там же тест «готова к
+взятию» и требования к критериям приёмки.
+
+## Сценарии
+
+### Завести задачу, идею или цель из диалога
+
+1. **Фильтр.** Делаем прямо сейчас — не заводим. Не пожалеем о потере — не
+   заводим. Родилось три кандидата — покажи их и спроси, какие заводить: молча
+   заведённая пачка и есть тот самый отказ из правила 1.
+2. **Дедуп.** `list` плюс поиск по слагам, хукам и телам (`grep -ril`),
+   **включая `REJECTED.md`**. Нашлось среди живых — **дописываем в существующий
+   файл**, а не заводим соседний. Нашлось в `REJECTED.md` — покажи пользователю
+   ту строку и что изменилось с момента отказа (`add` предупредит и сам, но
+   молча заводить нельзя). Две задачи об одном — самая дорогая находка
+   переоценки.
+3. **Тип по тесту готовности** (см. task-format): проходит — задача, не
+   проходит — идея (`--type idea`), проходит по пользе, но не делается одним
+   заходом — эпик (`--type epic`, сперва декомпозиция). Направление, а не
+   работа — цель (`--type goal`).
+4. **Цель задачи.** У каждой задачи должен быть `--goal <слаг>`: задача вне цели
+   не попадёт ни в один спринт. Подходящей цели нет — либо она заводится
+   (`--type goal` кустом), либо это сигнал, что задача никому не служит и
+   заводить её не надо. У идеи цели может не быть — она проставляется, когда
+   идея становится задачей.
+5. `add …`, затем допиши тело редактором: одна фраза, критерии приёмки с
+   оракулами, рамки. Хук отвечает «почему это лежит в беклоге» — состояние,
+   остаток, боль, — а не пересказывает первый абзац, и пишется **для человека**:
+   не «канонизация внутри транзакции», а «тело 40 МиБ держит блокировку 5 секунд,
+   соседние доставки уходят в отказ».
+6. `check`.
+
+### Разобрать находки аудита или ревью
+
+Ревью и аудиты — тоже источник задач, но с зеркальной диалогу опасностью: не
+пять файлов из одной мысли, а сорок файлов из сорока сырых находок. Защита та
+же, что в самом ревью: кластеризация по причине, дедуп против живых и
+`REJECTED.md`, находка без свидетельства → идея, а не задача, и карта кластеров
+пользователю до создания файлов. Порядок, отображение серьёзности и привязка к
+целям — [references/from-review.md](references/from-review.md).
+
+### Прийти в репозиторий, где задачи уже как-то ведутся
+
+Разовая операция: вывести каталог задач из старой раскладки беклога, `TODO.md`,
+заметок или списка шагов в плане — [references/adopt.md](references/adopt.md).
+Сюда же относится переименование транслитных слагов в английские: оно делается
+**одним проходом вместе с починкой перекрёстных ссылок**, а не по одному слагу.
+
+Если переводить надо не только задачи, а весь `docs/` — это скилл
+`av-dev-pm:canon`, и он зовёт этот сценарий сам на своём шаге.
+
+### Декомпозиция и штурм идеи
+
+[references/split.md](references/split.md). Обе операции превращают одну запись в
+несколько, и у обеих есть проверяемый тест: части должны **мерджиться порознь** и
+**каждая давать видимую пользу**, а у штурма исход «выкинуть» — полноправный.
+
+### Гигиена полей
+
+Правится по ходу любой операции, которая задачи касается (но не «заодно» по
+всему беклогу):
+
+- **протухший хук** — задача изменилась, а хук отвечает на старый вопрос;
+  особенно после ответа на вопрос задачи: «Решено: …» на «почему это лежит в
+  беклоге» уже не отвечает. Переписывается `edit <slug> --hook …` — он правит
+  мета-строку файла и строку индекса заодно;
+- **вопрос, застрявший в прозе** — вынимается в раздел «Вопросы» плюс тег
+  `question` (`edit --add-tag question`), иначе он не виден ни `list
+  --questions`, ни правилу «задача с открытым вопросом в набор не берётся»;
+- **тег, который некому снять** — `question` после ответа снимается `edit
+  --rm-tag question` вместе с записью ответа в тело **и опустошением раздела
+  «Вопросы»**: судит раздел, а не тег (`references/task-format.md`);
+- **свойство репозитория в рамках** — номер миграции, хеш, версия зависимости:
+  в лежалой задаче протухает молча и становится ложной рамкой. Снимается;
+  снимок берётся при постановке, а не при заведении;
+- **предписание процесса в теле** — «делать таким-то профилем ревью», «взять
+  такой-то агент»: это второй дом для правила выбора и путь понизить требования
+  решением, принятым до проектирования. Снимается.
+
+## Переносимость
+
+Скилл независим от **языка программирования, сборки, CI и трекера**: он ничего
+не знает ни про Go, ни про npm, ни про конкретный багтрекер — задачи для него
+просто каталог markdown. Текст задач — русский (язык документации проекта);
+зашита только латиница слага. OpenSpec ему тоже не нужен.
+
+- **Каталог задач — `docs/tasks`, жёстко**, и `--dir` передаётся явно всегда:
+  раскладка канона одинакова во всех проектах, и искать больше нечего. Каталога
+  нет — код 3 и вопрос человеку; `init` заводит его **только** когда проект
+  действительно новый, а перевод чужой раскладки делает `av-dev-pm:canon`.
+  У скрипта поиск вверх по дереву ещё жив — он для непереведённых проектов, и
+  полагаться на него скилл не должен: молча найденный чужой каталог это дрейф.
+- **Настройки живут в `docs/.pm.json`**, ключ `tasks`: **имена** файлов и
+  заголовков, и только если они отличаются от умолчания. Один конфиг на весь
+  канон, а не по одному на каталог. Неизвестный ключ — код 3 на любой команде,
+  так что лишнее слово в этом объекте останавливает работу с задачами целиком.
+- **Секции беклога** берутся из заголовков `##` индекса как есть; их количество
+  и названия — дело проекта (умолчание `ядро` / `инфра`). **В конфиге их нет** —
+  второй список разошёлся бы с заголовками молча.
+
+### Вызов из другого плагина
+
+`$CLAUDE_PLUGIN_ROOT` раскрывается **только внутри своего плагина**: пайплайн
+задачи, конвейер ревью и любой другой чужой контекст до `tasks.py` по этой
+переменной не дотянутся. Мост — **вызов скилла через пространство имён**, а не
+путь:
+
+> Чужой контекст зовёт `Skill av-dev-pm:tasks` и называет, что нужно сделать
+> («закрой задачу `<слаг>`, реализована»). Скилл разрешает свой
+> `$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`. Заголовки, тела и хуки — русские.
+
+## Чего этот скилл не делает
+
+Не пишет код, не заводит спеки и предложения об изменении, не берёт задачу в
+работу — этим занимается пайплайн проекта. Не ведёт спринт и не проводит сессию
+между спринтами — это `session`. Не решает за пользователя, что важно. Не
+переоформляет существующие задачи «заодно»: правится то, чего касается операция.

av-dev-pm/skills/tasks/references/adopt.md

@@ -0,0 +1,123 @@
+# Адаптация каталога задач
+
+Проект, где задачи уже как-то ведутся, и из имеющегося материала **выводится**
+заполненный каталог задач: цели, задачи, кладбище, индексы. Операция разовая —
+после неё проект живёт скиллами `tasks` и `session`.
+
+**Это часть приведения проекта к канону.** Раскладку `docs/` целиком ведёт скилл
+`av-dev-pm: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 docs/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. **Осмотрись.** Где лежат задачи, план, заметки. Каталог задач по канону —
+   всегда `docs/tasks`. Секции беклога (`--sections`) — по умолчанию
+   `ядро,инфра`; если у проекта деление другое по существу, оно называется
+   здесь, а не подгоняется под умолчание, и становится **заголовками `##`
+   индекса** — их единственным домом. В `docs/.pm.json` секции не пишутся.
+2. **`adopt scan`** по всем источникам разом. Один прогон, одна карта: два
+   прохода дадут два несогласованных состояния.
+3. **Заполни карту**: `slug` (английский), `section`, `goal` у каждой записи;
+   список `goals` — из шагов плана и из кустов. Закрытый шаг плана целью не
+   заводится. Пустой `goal` — законный исход только у идеи.
+4. **Покажи человеку карту** через `AskUserQuestion`, ≤3 вопроса за итерацию,
+   рекомендация первым вариантом. Показывается: сколько записей, предлагаемые
+   цели (линия и кусты) с обоснованием, спорные отнесения, список «не
+   разложилось». Массовые механические решения (слаги, порядок строк) не
+   выносятся — это механика.
+5. **`adopt apply`.** `--refs` перечисляет **всё**, где могут стоять ссылки на
+   слаги: документация, архив изменений, `CLAUDE.md`, `README.md`. Скрипт
+   посчитает и покажет, сколько ссылок поправлено и по каким слагам.
+6. **`tasks.py check`** и доклад.
+
+`apply` отказывается писать поверх живого каталога и проверяет карту целиком
+**до** первой записи: неверная секция, дубль слага, цель, которой нет в карте —
+всё это отказ до того, как на диске появился хотя бы один файл.
+
+## Переходное состояние — объявляется, а не заминается
+
+Сразу после адаптации задачи в большинстве своём **не готовы к взятию**: у них
+нет критериев приёмки, а у части может не быть цели. Это нормально, но обязано
+быть названо, иначе следующий агент примет пустой беклог за поломку.
+
+`apply` печатает состояние по факту: сколько задач без цели (это **ошибки**
+`check`) и сколько без критериев (`check` их ошибкой не считает, но `sprint
+take` такую задачу не возьмёт). Закрывается это **порциями переоценки** — шаг 3
+скилла `session`, 5–8 задач за порцию: проставить цели, превратить «готово,
+когда» в критерии с оракулами, вынуть вопросы из прозы в раздел «Вопросы».
+
+Готовность к первому спринту — не «`check` зелёный», а «есть 2–5 критериев хотя
+бы у набора под одну цель».
+
+## Чего адаптация не делает
+
+- **Не удаляет источники.** Старый каталог остаётся на месте: сверить и убрать —
+  дело человека, удалять чужое молча нельзя. В доклад идёт готовая команда.
+- **Не переписывает подписи ссылок.** `[docs/backlog](docs/tasks/BACKLOG.md)` —
+  цель поправлена, текст остался; это правится глазами, и таких мест немного.
+- **Не сочиняет критерии приёмки и не придумывает цели**, которых в материале
+  нет. Придуманная цель хуже отсутствующей: под неё соберут спринт.
+- **Не трогает историю.** В коммитах старые слаги остаются, и это нормально.
+
+## Доклад
+
+- Источники и что в каждом распознано (раскладка, индекс, кладбище, секции).
+- Сколько записей перенесено, сколько целей заведено (линия / кусты) и откуда
+  каждая выведена.
+- **Переименования**: сколько слагов, сколько ссылок поправлено и в скольких
+  файлах — числом, а не «поправлены ссылки».
+- **Не разложилось**: поимённо, с причиной.
+- Переходное состояние: сколько задач без цели, сколько без критериев, чем и за
+  сколько порций закрывается.
+- `tasks.py check` — результат строкой.

av-dev-pm/skills/tasks/references/from-review.md

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

av-dev-pm/skills/tasks/references/split.md

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

av-dev-pm/skills/tasks/references/task-format.md

@@ -0,0 +1,252 @@
+# Формат задач, целей и индексов
+
+Заголовок, мета-строку и строку индекса ставит `tasks.py add` — руками их не
+пишут. Этот файл описывает, что именно скрипт создаёт и что проверяет `check`;
+тело задачи (одну фразу, критерии, рамки, контекст) дописывает агент.
+
+## Файл задачи
+
+`items/<slug>.md`:
+
+```markdown
+# Тай-брейк при равной полноте
+
+**Секция:** ядро — вышла из спринта: остаток писал нерешённое в журнал · **Хук:** порядок канонических форм берёт меньшее в 96% случаев — для накопительных это систематический недосчёт · **Теги:** goal:merge-robustness, sprint:2026-08-03
+
+При столкновении точек выигрывает более полная, но при равной полноте побеждает
+последняя доставка — а она систематически беднее первой.
+
+## Критерии приёмки
+
+- повторный прогон свёртки даёт тот же отпечаток состояния — оракул: команда сверки
+- накопительная метрика за сутки не уменьшается после повторной доставки — оракул: тест
+- в логе видно, какая из двух точек выиграла и почему — оракул: глазами по логу прогона
+
+## Рамки
+
+Схема не трогается; данные только читаются; перезапуск сервиса допустим.
+
+Связано: решение о канонической форме содержимого.
+```
+
+- **Заголовок H1** — он же заголовок строки в индексе, дословно. Тип кодируется
+  префиксом `[goal]` / `[idea]` / `[epic]`; обычная задача — без префикса.
+  Отдельного поля типа **нет**: два места для одного факта разъезжаются, а
+  префикс виден прямо в индексе, где и принимается решение «брать или не брать».
+- **Мета-строка** — первая непустая строка после заголовка. Обязательна секция,
+  причина после тире желательна (именно она объясняет, почему задача здесь
+  оказалась — в том числе «вышла из спринта: …»), хук и теги опциональны. Поля
+  разделяются ` · `, порядок свободный. `·` — служебный разделитель: в тексте
+  причины и хука его быть не должно.
+- **Хук живёт здесь, а не только в индексе.** Строка индекса его повторяет и
+  производна от него: `check` сверяет, `check --fix` восстанавливает пропавшую
+  строку **вместе с хуком**. Пока хук лежал только в индексе, штатная починка
+  дрейфа теряла его молча и навсегда — а хук это единственное, по чему задачу
+  выбирают, не открывая.
+- **Тело** — одна фраза «что станет наблюдаемо иначе», критерии приёмки, рамки,
+  контекст, ссылки. Пишется на языке документации проекта.
+
+Тело — не план реализации и не спецификация: принятое и реализованное переезжает
+в документацию проекта, а файл задачи удаляется.
+
+### Критерии приёмки
+
+2–5 проверяемых утверждений **списком** `- …`, **у каждого назван оракул**. Не
+«работает корректно», а «повторный прогон даёт тот же отпечаток — оракул:
+команда сверки». Это не второе определение готовности, а проектная
+конкретизация вопроса «по чему видно, что закончено» из теста готовности ниже:
+там сказано «признак завершённости», здесь — «признак плюс чем проверяется».
+
+**Что из этого механизировано.** `check` и `sprint take` считают пункты: меньше
+двух — отказ («— работает» одной строкой больше не проходит), больше пяти —
+замечание, обычно это признак, что задача крупнее задачи. Наличие оракула
+проверяется **эвристикой** — словом «оракул» в пункте, — и потому даёт только
+замечание: настоящий оракул от слова «оракул» машина не отличает, и делать вид,
+что проверено больше проверенного, хуже, чем не проверять вовсе.
+
+**У идей критериев нет — именно поэтому они идеи.**
+
+**Критерии — пол, но расхождение с ними есть дефект критериев.** Если приёмщик
+видит, что критерии закрыты, а суть задачи не достигнута, он **правит критерии и
+возвращает задачу исполнителю**, а не держит невидимое сверх-требование. Иначе
+исполнитель никогда не знает, закончил ли, и мотивирован занижать критерии
+заранее.
+
+### Рамки
+
+Одна строка: чего касаться нельзя, что перезапускается, что считается
+необратимым, трогается ли схема данных. **Свойства репозитория сюда не пишутся**
+— номер последней миграции, версия зависимости, хеш: в лежалой задаче они
+протухают молча и становятся ложной рамкой. Снимок берётся при постановке, а не
+при заведении.
+
+### Вопросы
+
+Неразобранное решение человека живёт разделом `## Вопросы` **плюс тегом
+`question`**. Раздел без тега или тег без раздела — дрейф, `check` о нём скажет.
+
+**Судит факт, а не метка.** Отказ во взятии даёт **непустой раздел «Вопросы»**,
+независимо от того, стоит ли тег: иначе забывший тег проходил бы, а поставивший
+спотыкался — стимул ровно обратный записанному правилу. Тег производен: он нужен
+отбору снаружи файла (`list --questions`, `list --tag question`), и его
+отсутствие при непустом разделе — замечание, а не лазейка. Тег без раздела тоже
+отказ, но с другим советом: либо вопрос записан не туда, либо тег пора снять.
+
+**Ответ на вопрос — три правки, и первая обязательна.** Раздел «Вопросы»
+опустошается: ответ переезжает в тело решением, а не остаётся вопросом рядом с
+ответом. Затем снимается тег (`edit <slug> --rm-tag question`) и переписывается
+хук: «Решено: …» на вопрос «почему это лежит в беклоге» уже не отвечает.
+
+**Порядок именно такой, потому что судит раздел, а не тег.** `sprint take`
+смотрит в непустой раздел и откажет взять задачу даже со снятым тегом, а `check`
+на снятый тег при непустом разделе посоветует тег вернуть. Снять тег, не
+опустошив раздел, — значит закольцевать себя между двумя советами.
+
+## Файл цели
+
+```markdown
+# [goal] Прочность слияния
+
+**Секция:** кусты · **Теги:** decomposed
+
+Ради чего: точки из разных доставок сходятся в один часовой объект, и сегодня
+исход столкновения зависит от порядка доставки, а не от содержания.
+
+## Завершение
+
+Достигнута, когда исход слияния не зависит ни от порядка, ни от времени
+доставки, и это подтверждено повторным прогоном на живом корпусе.
+```
+
+- **Задачи цели здесь не перечисляются.** Перечень даёт
+  `tasks.py list --goal <слаг>`; хранимый список стал бы третьим индексом и
+  поехал бы на первой же закрытой задаче.
+- **Раздел «Завершение»** — то, по чему видно, что цель достигнута.
+- **Тег `decomposed`** отличает «цель ещё не разобрана» от «все её задачи
+  закрыты» — два состояния, у которых снаружи один и тот же признак: задач нет.
+  Пометка именно **тегом**, а не строкой в теле: только так она проверяется.
+  `check` напоминает о нём у цели без задач замечанием — неразобранная цель
+  законна и зелёного прогона не ломает; `check --fix` сам ставит его цели, у
+  которой задачи есть, а цель с тегом и без задач — прямое приглашение закрыть.
+- Цель живёт в `PLAN.md` и **никогда** — в `BACKLOG.md` или `SPRINT.md`.
+
+## Слаг
+
+Латиница и цифры, kebab-case, без ведущих, хвостовых и двойных дефисов
+(`foo-bar`, не `-foo`, `a--b`). Именуется **по сути, а не по текущей
+формулировке**: заголовок будет переписан при переоценке, а слаг стоит в ссылках
+из других задач, коммитов и черновиков. **Транслита не заводим** —
+`tie-break-equal-completeness`, а не `taj-brejk-pri-ravnoj-polnote`: транслит
+нечитаем для того, кто ищет по смыслу, и не сокращается.
+
+Переименование слага — не правка, а перенос ссылок: делается одним атомарным
+проходом по всем местам, где слаг упомянут, иначе останутся битые ссылки,
+которых никто не проверяет.
+
+## Индексы
+
+Строка везде одной формы:
+
+```markdown
+- [Заголовок дословно](items/slug.md) — хук
+```
+
+Хук отвечает на «почему это лежит в беклоге» одним предложением: состояние,
+остаток, боль. Пересказ первого абзаца бесполезен — он уже есть по ссылке.
+
+| Файл | Что отвечает | Секции |
+| --- | --- | --- |
+| `PLAN.md` | какие есть цели, в каком порядке идёт линия и почему | линия (упорядоченная) и кусты |
+| `BACKLOG.md` | что **можно взять** — только задачи | секции проекта (по умолчанию ядро/инфра) |
+| `SPRINT.md` | какая цель и какой набор под неё | одна: «Набор» |
+| `REJECTED.md` | что ушло без реализации и почему | — |
+
+Секции — **единственные заголовки `##` в индексе**: любой другой `##` в
+преамбуле проверка сочтёт секцией. Внутри секции беклога порядок значения не
+имеет — порядка в беклоге нет вовсе.
+
+**Секции «блокеры» среди них нет.** Блокер — состояние, а не полка: он живёт до
+ответа человека, а следы остаются вопросами в файлах задач распущенного спринта.
+Постоянно пустая секция со старой семантикой «разбираются пачками» противоречила
+бы правилу «эскалируем немедленно», поэтому `init` её не заводит, а `check`
+говорит о ней в чужом беклоге. Переезжаешь с такой секцией — удали её. В **линии** плана порядок значим и
+обосновывается прозой; двигают строку `move <slug> --section линия --after
+<другой>`.
+
+Индексы **производны**: расходятся с файлом — правим индексы (`check --fix`).
+Строку руками не пишут.
+
+Отсюда же ответ на «а если оборвётся посередине». Мутация сперва проверяет всё
+и складывает правки, и только потом пишет: сначала все временные файлы, потом
+переименования подряд. Полной транзакции на несколько файлов файловая система не
+даёт, но окно сжато до цепочки переименований, а **всё, что в нём может
+разъехаться, — производное**: файлы целы, индексы восстанавливает `check --fix`.
+Поэтому отказ на второй задаче из пяти не оставляет первую переписанной при
+нетронутых индексах.
+
+`SPRINT.md` и есть артефакт заморозки: без него набор существует только в
+контексте сессии, и нарушение заморозки ненаблюдаемо.
+
+## `REJECTED.md`
+
+Туда уходит задача, покинувшая беклог **без реализации**. Строку пишет
+`tasks.py close --reason`, а `check` следит за форматом:
+
+```markdown
+- 2026-07-23 `versii-kachestvo-repaki` — Версии и качество одного тайтла.
+  Причина: калибровка болей — не боль, ни разу не возникло за полгода.
+  Была секция: инфра.
+```
+
+Реализованные сюда не попадают: у них остаётся коммит и документация. У
+выкинутой не остаётся ничего — и через квартал она возвращается тем же текстом.
+Это первое место, куда смотрит дедупликация при заведении.
+
+Запись не запрещает завести задачу заново: изменился контекст — заводим и
+ссылаемся на строку, объясняя, что изменилось.
+
+## Теги
+
+Единственный механизм разметки, потому что `list --tag` уже умеет отбирать по
+ним порцию разбора. Отдельных полей мета-строки под это не заводим.
+
+- `goal:<слаг>` — цель, которой служит задача. Обязателен: задача без цели не
+  попадёт ни в один спринт.
+- `question` — в файле есть неразобранный раздел «Вопросы».
+- `sprint:<слаг>` — задача заведена в этом спринте; по нему отбирается первая
+  порция разбора («урожай спринта»). **Ставится сам**: слаг спринта заводит
+  `sprint start` (по умолчанию — дата начала, он же пишется в `SPRINT.md`), и
+  `add` при открытом спринте помечает заводимое. Тег, который надо помнить
+  ставить руками, не ставится никогда — а на нём висит правило «первая порция
+  разбора — урожай прошедшего спринта».
+- `decomposed` — на цели: разложена на задачи (см. «Файл цели»).
+
+Отбор — `list --tag a,b`: перечисленные через запятую теги требуются **все
+сразу** (это И, не ИЛИ). Тег, которого нет ни у одной задачи, `list` называет
+вслух: молчаливый ноль читается как «таких задач нет», а чаще это опечатка.
+
+Свои теги проект заводит свободно (партия ревью `review-ГГГГ-ММ-ДД`, тема,
+источник) — словарь не фиксирован. В индексы теги не выносим: индексы
+производны, отбор делает `list --tag`, а не глаза.
+
+## Тест «готова к взятию»
+
+Задача готова, если из файла отвечаются три вопроса:
+
+1. **Что станет наблюдаемо иначе**, когда она сделана — снаружи: пользователю,
+   владельцу сервиса или разработчику. «Отрефакторить X» — не ответ; «перестанет
+   ломаться Y при Z» — ответ.
+2. **По чему видно, что закончено** — критерии приёмки с оракулами.
+3. **Какой цели она служит** — тег `goal:` и одна строка «почему именно этой».
+
+Не отвечается первый или второй вопрос → это **идея** (`[idea]`), её место в
+штурме. Не отвечается третий → либо цель есть и не проставлена, либо задача не
+служит ничему — тогда её не надо заводить.
+
+Отвечается всё, но задача не делается одним заходом и не мерджится целиком →
+**эпик** (`[epic]`), сперва декомпозиция. Эпик временен и исчезает после
+разбора; цель (`[goal]`) постоянна — не путать.
+
+Тест применяется при заведении и при переоценке. К старым задачам, которых
+операция не касается, задним числом не применяется — беклог не переоформляют
+«заодно».

pyproject.toml

@@ -0,0 +1,66 @@
+[project]
+name = "dev-skills"
+version = "0"
+description = "Маркетплейс плагинов av-dev; здесь только линтеры скриптов скиллов"
+requires-python = ">=3.12"
+dependencies = []
+
+# Версии прибиты точно: обновление линтера меняет набор находок, а находки тут
+# правятся руками в скриптах, которые уезжают в чужие проекты. Обновление —
+# отдельная осознанная правка, а не побочный эффект `uv sync`.
+[dependency-groups]
+dev = ["ruff==0.16.1", "pyrefly==1.2.0"]
+
+[tool.uv]
+package = false
+
+[tool.ruff]
+target-version = "py312"
+line-length = 88
+# backlog.py заморожен: плагин помечен УСТАРЕЛ и живёт до перевода последнего
+# проекта, после чего удаляется целиком. Правки в него — риск без выгоды.
+exclude = ["av-dev-backlog"]
+
+[tool.ruff.lint]
+select = [
+    "F",     # pyflakes: неиспользованное, неопределённое, битые f-строки
+    "E", "W",# pycodestyle
+    "I",     # порядок импортов
+    "UP",    # устаревшие для 3.12 конструкции
+    "B",     # bugbear: изменяемый дефолт, забытый raise, цикл с замыканием
+    "SIM",   # упрощения
+    "RET",   # возвраты
+    "PTH",   # os.path → pathlib
+    "RUF",   # правила самого ruff
+    "TID",   # запрет внешних зависимостей, см. banned-api ниже
+    "BLE",   # голый except Exception — только там, где помечен noqa
+]
+ignore = [
+    "E501",     # длину строк держит formatter, а не проверка
+    # Весь текст скриптов — русский: сообщения, докстроки, комментарии.
+    # «Похожая на латиницу кириллица» здесь не опечатка, а норма, и три этих
+    # правила дают 311 срабатываний из 338 на пустом месте.
+    "RUF001", "RUF002", "RUF003",
+]
+
+[tool.ruff.lint.flake8-tidy-imports.banned-api]
+# Скрипты обязаны работать на голом python 3.12 без установки чего-либо:
+# они лежат рядом со скиллами и запускаются в любом проекте. Список — не
+# полный перечень мира, а частые соблазны; настоящий страж — pyrefly, у
+# которого в окружении нет ничего, кроме линтеров.
+"requests".msg = "внешняя зависимость; скрипты работают на голом python 3.12"
+"yaml".msg = "внешняя зависимость; для json есть stdlib, для yaml — разбор руками"
+"pydantic".msg = "внешняя зависимость; скрипты работают на голом python 3.12"
+"click".msg = "внешняя зависимость; аргументы разбирает argparse"
+"rich".msg = "внешняя зависимость; вывод — обычный print"
+
+[tool.ruff.format]
+quote-style = "double"
+
+[tool.pyrefly]
+project-includes = [
+    "av-dev-pm/skills/tasks/scripts/tasks.py",
+    "av-dev-pm/skills/canon/scripts/docs.py",
+    "scripts/copies.py",
+]
+python-version = "3.12"

scripts/copies.py

@@ -0,0 +1,210 @@
+#!/usr/bin/env python3
+"""Сверка намеренных копий правил с их домом.
+
+«Один факт — один дом» держится вниманием, и трижды подряд не удержалось: форма
+записи журнала дефектов разошлась с домом на одно поле, список читателей
+`docs/research/` — на один проход. Оба раза копия выглядела актуальной.
+
+Копии всё же нужны: скелеты канона уезжают в репозиторий проекта и обязаны там
+что-то говорить. Значит копия допустима, но обязана быть **дословной и
+помеченной**.
+
+Разметка — HTML-комментарии, невидимые в отрендеренном markdown и потому
+безвредные внутри блоков, которые уезжают в проект. Наоборот, в проекте они
+полезны: говорят, что текст имеет дом и правится там.
+
+    <!-- дом: <id> -->
+    …текст…
+    <!-- /дом -->
+
+    <!-- копия: <id> из <путь к файлу дома> -->
+    …тот же текст…
+    <!-- /копия -->
+
+Сверяется текст **между** маркерами: построчно, с отброшенными хвостовыми
+пробелами и пустыми строками по краям. Всё остальное вокруг копии — предисловие,
+повелительное наклонение, соседние разделы — принадлежит месту, а не дому, и
+сверке не подлежит.
+
+Коды выхода — тот же словарь, что у tasks.py и docs.py:
+  0  сошлось
+  1  копия разошлась с домом (или дом остался без копий)
+  2  ошибка употребления: незакрытый маркер, дубль id, копия без дома
+  3  окружение: не тот каталог
+  4  внутренний сбой
+"""
+
+from __future__ import annotations
+
+import difflib
+import re
+import sys
+from pathlib import Path
+
+OK, DRIFT, USAGE, ENV, INTERNAL = 0, 1, 2, 3, 4
+
+SKIP_DIRS = {".git", ".venv", "node_modules", "__pycache__", "av-dev-backlog"}
+
+# Идентификатор — только буквы, цифры и дефис. Строгость намеренная: она же
+# отличает **настоящий** маркер от примера в документации об этом механизме.
+# Пример пишется с `<id>`, и угловые скобки под шаблон не подходят — иначе текст,
+# объясняющий разметку, объявлял бы дом и ронял проверку.
+ID = r"[^\W_][\w-]*"
+HOME_OPEN = re.compile(rf"<!--\s*дом:\s*({ID})\s*-->")
+HOME_CLOSE = re.compile(rf"<!--\s*/дом:\s*({ID})\s*-->")
+COPY_OPEN = re.compile(rf"<!--\s*копия:\s*({ID})\s+из\s+(\S+?)\s*-->")
+COPY_CLOSE = re.compile(rf"<!--\s*/копия:\s*({ID})\s*-->")
+
+
+class Region:
+    """Помеченный кусок markdown: где начался, чем является, что внутри."""
+
+    def __init__(self, ident: str, path: Path, line: int, body: list[str],
+                 declared_home: str | None = None) -> None:
+        self.ident = ident
+        self.path = path
+        self.line = line
+        self.body = body
+        self.declared_home = declared_home
+
+    @property
+    def where(self) -> str:
+        return f"{self.path}:{self.line}"
+
+    def normalized(self) -> list[str]:
+        out = [ln.rstrip() for ln in self.body]
+        while out and not out[0]:
+            out.pop(0)
+        while out and not out[-1]:
+            out.pop()
+        # Ограда блока кода в сверку не входит: в доме текст обычно обрамлён
+        # своим ```, а в скелете тот же текст лежит внутри чужой, объемлющей
+        # ограды. Сверяется содержимое, а не разметка вокруг него.
+        if out and out[0].startswith("```"):
+            out.pop(0)
+        if out and out[-1].startswith("```"):
+            out.pop()
+        return out
+
+
+def scan(path: Path, errors: list[str]) -> tuple[list[Region], list[Region]]:
+    """Все маркеры одного файла. Незакрытый маркер — ошибка употребления."""
+    homes: list[Region] = []
+    copies: list[Region] = []
+    open_at: tuple[str, int, str | None] | None = None
+    kind = ""
+    body: list[str] = []
+
+    for num, line in enumerate(path.read_text(encoding="utf-8").splitlines(), 1):
+        if open_at is None:
+            if m := HOME_OPEN.search(line):
+                open_at, kind, body = (m.group(1), num, None), "дом", []
+            elif m := COPY_OPEN.search(line):
+                open_at, kind, body = (m.group(1), num, m.group(2)), "копия", []
+            elif HOME_CLOSE.search(line) or COPY_CLOSE.search(line):
+                errors.append(f"{path}:{num}: закрывающий маркер без открывающего")
+            continue
+
+        ident, start, declared = open_at
+        closing = HOME_CLOSE.search(line) if kind == "дом" else COPY_CLOSE.search(line)
+        if closing:
+            if closing.group(1) != ident:
+                errors.append(f"{path}:{num}: закрывается «{closing.group(1)}»,"
+                              f" а открыт «{ident}» ({path}:{start})")
+            (homes if kind == "дом" else copies).append(
+                Region(ident, path, start, body, declared))
+            open_at = None
+            continue
+        if HOME_OPEN.search(line) or COPY_OPEN.search(line):
+            errors.append(f"{path}:{num}: маркер внутри незакрытого «{kind}: {ident}»")
+            continue
+        body.append(line)
+
+    if open_at is not None:
+        errors.append(f"{path}:{open_at[1]}: маркер «{kind}: {open_at[0]}» не закрыт")
+    return homes, copies
+
+
+def walk(root: Path) -> list[Path]:
+    out = []
+    for p in sorted(root.rglob("*.md")):
+        if SKIP_DIRS & set(p.relative_to(root).parts):
+            continue
+        out.append(p)
+    return out
+
+
+def main() -> int:
+    root = Path(sys.argv[1] if len(sys.argv) > 1 else ".").resolve()
+    if not (root / ".claude-plugin").is_dir():
+        print(f"ОТКАЗ: {root} не похож на корень маркетплейса: нет .claude-plugin/",
+              file=sys.stderr)
+        return ENV
+
+    errors: list[str] = []
+    homes: dict[str, Region] = {}
+    copies: list[Region] = []
+    for path in walk(root):
+        file_homes, file_copies = scan(path, errors)
+        for h in file_homes:
+            if h.ident in homes:
+                errors.append(f"{h.where}: дом «{h.ident}» уже объявлен"
+                              f" в {homes[h.ident].where} — id обязан быть один")
+                continue
+            homes[h.ident] = h
+        copies.extend(file_copies)
+
+    if errors:
+        for e in errors:
+            print(f"УПОТРЕБЛЕНИЕ  {e}", file=sys.stderr)
+        return USAGE
+
+    drift: list[str] = []
+    used: set[str] = set()
+    for c in copies:
+        home = homes.get(c.ident)
+        if home is None:
+            print(f"УПОТРЕБЛЕНИЕ  {c.where}: копия «{c.ident}» без дома —"
+                  f" дом либо не помечен, либо переименован", file=sys.stderr)
+            return USAGE
+        used.add(c.ident)
+
+        actual = home.path.relative_to(root).as_posix()
+        if c.declared_home and not actual.endswith(c.declared_home.lstrip("./")):
+            drift.append(f"{c.where}: копия «{c.ident}» указывает на"
+                         f" {c.declared_home}, а дом лежит в {actual}")
+
+        if c.normalized() != home.normalized():
+            diff = difflib.unified_diff(home.normalized(), c.normalized(),
+                                        fromfile=f"дом {home.where}",
+                                        tofile=f"копия {c.where}", lineterm="", n=1)
+            drift.append(f"«{c.ident}» разошлась с домом:\n    "
+                         + "\n    ".join(diff))
+
+    for ident, home in homes.items():
+        if ident not in used:
+            drift.append(f"{home.where}: дом «{ident}» помечен, а копий нет —"
+                         f" запись обещает дисциплину, которой не за чем следить")
+
+    print(f"копий помечено {len(copies)}, домов {len(homes)}")
+    if drift:
+        print()
+        for d in drift:
+            print(f"РАСХОЖДЕНИЕ  {d}")
+        print(f"\nИтог: расхождений {len(drift)}. Правится **дом**, потом копия"
+              f" — и правка дома тянет запись в журнал версий канона,"
+              f" если копия уезжает в проект.")
+        return DRIFT
+
+    print("копии дословны")
+    return OK
+
+
+if __name__ == "__main__":
+    try:
+        sys.exit(main())
+    except KeyboardInterrupt:
+        sys.exit(INTERNAL)
+    except Exception as e:  # noqa: BLE001 — последний рубеж, код 4 по словарю
+        print(f"внутренний сбой ({type(e).__name__}): {e}", file=sys.stderr)
+        sys.exit(INTERNAL)

uv.lock

@@ -0,0 +1,66 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "dev-skills"
+version = "0"
+source = { virtual = "." }
+
+[package.dev-dependencies]
+dev = [
+    { name = "pyrefly" },
+    { name = "ruff" },
+]
+
+[package.metadata]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "pyrefly", specifier = "==1.2.0" },
+    { name = "ruff", specifier = "==0.16.1" },
+]
+
+[[package]]
+name = "pyrefly"
+version = "1.2.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/89/01/a86e9f24722b095c3f88e3616132b75a21b0df53804bdc6a45314dd4d93c/pyrefly-1.2.0.tar.gz", hash = "sha256:5485f960fc2481617068c918335c39ab1507ef90b6b5bd35bf57726e60e73185", size = 6243654, upload-time = "2026-08-01T02:56:27.592Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7d/9d/3c0ef1d4843987b22f996ed381ec9cf5a3b1273e29804db276252e4c95eb/pyrefly-1.2.0-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:7f46d983ac49ddd2b043694960a01dc6a19a5cfd8eec609d6bd9c42866f91b4e", size = 14026305, upload-time = "2026-08-01T02:56:02.611Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/06/03bbb78fbea54cdc65b626619f3597d5611aca4fdef11e72a4e8360e7e63/pyrefly-1.2.0-py3-none-macosx_11_0_arm64.whl", hash = "sha256:756f669b5555090f5c1a4fef30db1785fabe657764f7e4e6dc88994dfb8ca82d", size = 13463880, upload-time = "2026-08-01T02:56:04.93Z" },
+    { url = "https://files.pythonhosted.org/packages/13/5a/7d8bc00a38e93bbc9c3e7bd14d305f7948717e667c9bcddeab9dd42fd255/pyrefly-1.2.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e3465812ce5ef4781fb592edbf2724547296f0a3124be115d73c7e8b2401862d", size = 13907329, upload-time = "2026-08-01T02:56:07.104Z" },
+    { url = "https://files.pythonhosted.org/packages/be/94/9e08b4bf799d0b8f36b55a2783c7ba5f51730cf0632a85a67b5b5ed876cd/pyrefly-1.2.0-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:5de7b2ad2bba5c8055181681a84b74143eac2234a48ba5d1b7ed7e7a722b02bd", size = 15039020, upload-time = "2026-08-01T02:56:09.208Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/bd/bca5fd0c80f4daf8ee6903a29df9f3de1feb05ff0946b8f35ec8c5096b13/pyrefly-1.2.0-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:25822ea9505f589ea8a725e4268b475132fb89e038fbf092e446510443ac142a", size = 14986199, upload-time = "2026-08-01T02:56:11.924Z" },
+    { url = "https://files.pythonhosted.org/packages/97/f7/f07087f3d185ad2eced0c56cef89ca5474dfb4ff25f146cd50a861c97553/pyrefly-1.2.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:90efe75e17491ef5d636e10469e9278d7d0256b3b4c5e1f4750069bf3ae0f5d1", size = 14393715, upload-time = "2026-08-01T02:56:14.143Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/70/0d142c320e284b9e3ce35e9b1e58b8ce2ee1f578f2a7234bc30e5022b94f/pyrefly-1.2.0-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:368aaf7eee4f511ddc0f8e564cf14e01ab2f10b0db9105c6d5b153bf498d07bf", size = 13933008, upload-time = "2026-08-01T02:56:16.525Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/e8/e84f11b6e1f63fd453ad3654213b9a0f6f4de8cef6b58038eef2d0d5955d/pyrefly-1.2.0-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:d52d5da7bc65fb7675fbaa80eda879d4f8787c494f04cac21603330d3abbdbbe", size = 14431827, upload-time = "2026-08-01T02:56:18.645Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/06/810d31380f66c75e1c0779a408d3b16117b1b368b57894f6aa66bef21686/pyrefly-1.2.0-py3-none-win32.whl", hash = "sha256:8c90751de8506d938e8f802659c74cf35bd7a0036510ee6c634a38eebb280bfa", size = 13229447, upload-time = "2026-08-01T02:56:20.921Z" },
+    { url = "https://files.pythonhosted.org/packages/ed/98/4dafa3c7a1caed2dc8cc708dde09ba27963c7736508f55b626fff3024113/pyrefly-1.2.0-py3-none-win_amd64.whl", hash = "sha256:8a8964c224ccc4882730130955815de21ff443c1ac3f0b90685b19bf63848170", size = 14087387, upload-time = "2026-08-01T02:56:23.188Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/1c/df3cb0a2e5591660ded7a1836cd2f29dc48c91adb1c0a3a700a96f6d09e1/pyrefly-1.2.0-py3-none-win_arm64.whl", hash = "sha256:3a90bb8df39dfbac74b1f3b2e9d7c526b8f80568884c3944d955023a73ebf61e", size = 13430873, upload-time = "2026-08-01T02:56:25.425Z" },
+]
+
+[[package]]
+name = "ruff"
+version = "0.16.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/70/25/7113f6d5498888c5fb7db34081cba7d5971c4cb1bfb26819966eee68f003/ruff-0.16.1.tar.gz", hash = "sha256:fedad7c801dabd3fb9741d76aca39246e6ddd9ca446a015875207bf19f1e6bc7", size = 4877500, upload-time = "2026-07-30T19:37:01.379Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1b/bd/694da69368e0973de65df2ddc73ab18d43c469d5963d9b150911de6bc513/ruff-0.16.1-py3-none-linux_armv6l.whl", hash = "sha256:58edb313b88f0c5460a26adf5f39a37a3be789494a15e3e411e35fa78b89f9a0", size = 10839126, upload-time = "2026-07-30T19:36:13.697Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/f0/b626e5d5bd0dd9576263658ef12885e2288afd1029a48e26ffed65ec1ac1/ruff-0.16.1-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:fde5a99e2f97479af66edd6622c6d5a2a7592c77cf4153d9e4428f5eeb55b60c", size = 11070253, upload-time = "2026-07-30T19:36:17.14Z" },
+    { url = "https://files.pythonhosted.org/packages/83/63/f40acfb6b35b88623e71684942b552c3edd96035f5d98f313815f7b277de/ruff-0.16.1-py3-none-macosx_11_0_arm64.whl", hash = "sha256:e0d4c20532fca4f7fa609369161d968dd28f65d83dabbd61d8e9c7edbf7001f6", size = 10561425, upload-time = "2026-07-30T19:36:20.04Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/dd/14ec0e9c2b4d315547dd38765004b4863e354e1b52cb308272215d9f6f6d/ruff-0.16.1-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:30affbcedf59ad5703d9c91f82266e02b47739f797e1a7b6e158e5526a6dae38", size = 10948879, upload-time = "2026-07-30T19:36:22.476Z" },
+    { url = "https://files.pythonhosted.org/packages/33/e9/9d870cbae575030fdef595f04b4b97573c525b5497cce4f4498cf2f85446/ruff-0.16.1-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:24e9c631573cbca9d20f1283f8f479b2afa4a8503504822bd71a293889f16743", size = 10643691, upload-time = "2026-07-30T19:36:24.914Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/09/12743d544e2173f53ecd27217c65f90d2bc0f8424a66a60339e56bbc0457/ruff-0.16.1-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b41bdd48fb420987a9b5212e4957c26ad4abce401fa9ea9d4d85843727945f4f", size = 11435354, upload-time = "2026-07-30T19:36:28.447Z" },
+    { url = "https://files.pythonhosted.org/packages/7f/89/a1652b2daee52083c9554a6333b678a8b01d0400f976827bb87857f9449a/ruff-0.16.1-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b0d1e1393b7648079e13669de1c1f4fde06d4583e84d8fd5c1551e0a77a2aa75", size = 12259033, upload-time = "2026-07-30T19:36:31.326Z" },
+    { url = "https://files.pythonhosted.org/packages/16/96/ecdcb8c54ee7b123b487f807eb014e6e019155a0b81dfb669acd52f28ce3/ruff-0.16.1-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:07bf434b1c95f4e093be4532068ef4fcf00924eb2ade8796075980902d6fd54a", size = 11667981, upload-time = "2026-07-30T19:36:34.394Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/90/c52e12e0d862e9572f2a33aa227409143520abe53111e9a6babbac7b4af8/ruff-0.16.1-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:39897739f112253ee4fdd2e8aa9a4f9ded99fb2be367d5f31dfa4ded6025584c", size = 11468183, upload-time = "2026-07-30T19:36:37.339Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/6b/4ffb7ad1d83eb16cf8cbb3c8815d3f11c88460fd162d4b372a2059be1c2a/ruff-0.16.1-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:82ae3c0c0d74daf17b968a10b7b3bb3ef297ab7de0c1f749646b25e690ccb150", size = 11470071, upload-time = "2026-07-30T19:36:39.91Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/72/32ae7db4c0b5e32ab611787caa19d1546800676d79f7483b7100a3561bf4/ruff-0.16.1-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:4d5f2ed10f8242d83fc08d521301089364e3375375705356f20c0e31606ef3ef", size = 10919503, upload-time = "2026-07-30T19:36:42.65Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/ca/3d901ba6ad6fc38da39c3448fc6c59ac945679293a17c3ceb6d6c1cba13e/ruff-0.16.1-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:a4665b309891f83f3e3c25447935f1213e9abbd4b5640af7a1f2def9f8d413c1", size = 10649861, upload-time = "2026-07-30T19:36:45.18Z" },
+    { url = "https://files.pythonhosted.org/packages/92/79/894ef1ced26552d5f8c9cf6d85b0687840e1128c55aeab7b9c2d54a0d880/ruff-0.16.1-py3-none-musllinux_1_2_i686.whl", hash = "sha256:26e9ca5c9bc3971f20d3cf18a957f52ffd6a5f6564ff15c4912a144dcac22494", size = 11148137, upload-time = "2026-07-30T19:36:47.936Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/69/3609a09fa1cb46cc28b762363e440a354204e5dff01bd0c8d7437874d6b9/ruff-0.16.1-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:67e1e1e3fa4f0c82f0e36d4cd61e661f6e7a6196cb1aa92fe0828fa7b8f257cd", size = 11559211, upload-time = "2026-07-30T19:36:50.448Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/8a/fb22af2fd78a736e241fabf67e30ce1799a64244026377a49e133af90762/ruff-0.16.1-py3-none-win32.whl", hash = "sha256:d31765e131295b8445caf301e3e8a85b34d1b9b211b4109b7ba457888b051806", size = 10838258, upload-time = "2026-07-30T19:36:53.298Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/35/e57fd9fb5d423961df087a00b12d42c0a830288dc2f3b45ecca299158b4f/ruff-0.16.1-py3-none-win_amd64.whl", hash = "sha256:09b05e8b90c2cb06ad63464350e7a45e8e44a2dfe52072ebfba6666ca8d3f596", size = 11961111, upload-time = "2026-07-30T19:36:56.107Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/46/240ea004bf6dc4feb40e9832f2205a476a47dd5b8a3f8211a5fc5f95e20e/ruff-0.16.1-py3-none-win_arm64.whl", hash = "sha256:dbaadaac38c70239f056d306b7476f246b0bf000fa6b3876402acbf5b227eaf8", size = 11309414, upload-time = "2026-07-30T19:36:58.79Z" },
+]