классификация задачи: три категории документов и метка вместо ступени

Канон 5 объявил «каждый документ docs/ — тема ревью». Правило верно ровно
наполовину и потому вредно целиком. Паспорт и схему хранилища ревью читает, но
темами они не являются: по ним нельзя сказать «в этом изменении сделано не так»,
они задают границу, по которой судит чужая тема. Журнал решений и журнал
наблюдений ревью изменения не нужны вовсе — ADR объясняет прошлое, а не
предъявляет требование. Разметчик, применявший правило буквально, обязан был
либо завести фантомные темы passport, adr, database, research и продублировать
ими работу architecture и operations, либо потерять четыре документа молча;
случались обе ветки, и в собственном образце плана docs/passport.md не попадал
ни строкой, а обязательная арифметика покрытия при этом не сходилась.

Категорий теперь три, разрез проверяемый. Тема — да, прямо: conventions,
security, architecture и любой свой документ проекта. Источник темы — нет, но он
задаёт границу для чужой: passport, database, CLAUDE.md, openspec/specs.
Процессный — нет, он про то, как мы работаем: tasks, review, adr, research,
.pm.json. Открыта одна категория из трёх, две другие перечислены поимённо, так
что документ вне раскладки — однозначно своя тема. adr и research прогон больше
не открывает ни одним проходом; docs/review остаётся читаемым, но как настройка
конвейера, а не критерий. Цена записана и стала обязательной строкой границ
покрытия: расхождение с записанным решением ловит теперь только сверка
документации, а число под находкой обязано быть снято на этом прогоне, с
приложенной командой.

Классификация выдаёт задаче метку — small, medium, large. Прежние quick,
standard и wide назывались ступенью и описывали ревью: как глубоко смотрим.
Классифицируется же задача, и пока величина называлась свойством прогона, её
естественно было пересчитывать на каждом прогоне — что конвейер и делал. Слово
«ступень» удалено, а не оставлено синонимом: два имени одной вещи расходятся.
Выводится метка из двух разведённых осей — размер (малое, среднее, крупное) и
сложность (знакомое, незнакомое), — и равна максимуму по ним. Метка не синоним
размера: малое незнакомое изменение получает large, трогая один узел, поэтому
план печатает три строки с обоснованием каждая и выводить одну из другой
запрещено. Оси остались русскими словами — это суждение прозой; метка
английская — это идентификатор, который проходы сравнивают.

Разметка переехала из ревью кода в шаг 4 пайплайна, сразу после propose. Она
шла первым проходом каждого ревью кода, а перед ревью дизайна ту же величину
называл сам пайплайн — то есть оркестратор, который только что довёл
предложение до propose. Одно и то же измерялось дважды, и один из двух раз без
разведённости с автором, ровно в той точке, ради которой разметчик заведён.
Теперь запуск один на задачу, диффа он не видит, план обслуживает обе стадии, и
метка после кода не пересматривается: расхождение факта с разметкой ловит журнал
дефектов постфактум, как и всякую другую ошибку выбора. На диск план не пишется —
четвёртый артефакт рядом с proposal, tasks и design пережил бы задачу и разошёлся
бы с ней молча.

Ревью дизайна тоже растёт меткой: small — specs, medium — плюс rubric, large —
плюс architecture и вопрос автору о трёх формах решения. Раньше rubric и
architecture включались одним условием, и medium получал ровно один проход, то
есть не отличался от quick ничем. Разведены они потому, что зарабатывают на
разном: рубрика порождает свойства узла и окупается уже на среднем изменении,
её выход уезжает приёмочными критериями в tasks.md; архитектура отвечает на
вопрос про второй способ, а он на среднем знакомом изменении отвечается «нет»
ещё до запуска.

small подешевел тремя способами сразу. Составом: приёмник тем не запускается,
три темы ядра переходят к code сверкой по записанным инвариантам CLAUDE.md с
потолком в одну находку, и это не «глубина ниже», а другой дом темы. Входом:
specs читает только дельта-спеку, code — только индекс конвенций. Потолком: он
появился у каждого опиниативного прохода, а не у одного basics, и у половин code
он раздельный, потому что конвенционных находок больше по построению и в общем
списке они вытеснили бы техническую половину. Сработавший потолок обязан быть
объявлен строкой — молчащий срез неотличим от «больше не нашлось». Отрицательный
тест small от этого стал жёстче, а не мягче: вопросы про обратимость миграции
задавал приёмник тем, и на этой метке их не задаст никто.

Пайплайн задачи вырос до двенадцати шагов. Тривиальность перестала решать состав
ревью — она влияет только на explore; глубину обеих стадий называет метка.

Проверено прогоном ревьюверов по готовому результату: девять расхождений найдено
и починено — контракт находок печатал старый перечень проходов вместо плана по
темам, три ссылки в task-batch указывали на шаг коммита вместо закрытия, запись
changelog не переводила вопросы, адресованные passport и database, ops и
adversary утверждали, что на нижних метках их вопросы задаёт basics, шаблон
покрытия в review-code зашивал потолки small намертво, триггеры метки рассыпались
на два списка против трёх, тема из директивы CLAUDE.md могла остаться без запуска
исполнителя. Гейт зелёный: фронтматтеры, копии, одиннадцать диаграмм, ruff,
pyrefly; docs.py прогнан на живом фикстуре и печатает категорию в отказе.

Канон повышен до версии 6 с записью, выполнимой upgrade. Решения — 40–44.

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

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

@@ -1,23 +1,35 @@
 ---
 name: review-basics
-description: "Тематический проход ревью для нижних ступеней и приёмник тем, у которых нет своего проходчика. Работает по темам из плана прогона на одной из двух глубин: сверка (открыть дом темы, открыть дифф, сравнить) или разбор (построить сценарий рассуждением). Ядро тем в уставе: security (недоверенный вход, утечка, путь и ключ из внешнего), operations (отказ соседа, повтор и одновременность, остановка на середине, откат при двух версиях, наблюдаемость, очевидный рост, настройки хранилища), architecture (второй способ мимо единой точки, лишнее, молча отменённое решение ADR). Проектные темы приходят из плана. Ничего не запускает и не меряет: замеры, построенные пути и карта проекта — профиль wide. Потолок 2 находки на сверке, 4 на разборе. Обязан сигналить о заниженной ступени. Только чтение."
+description: "Тематический проход ревью для метки medium и приёмник проектных тем при любой метке. Запускается тогда и только тогда, когда в задании есть темы: с меткой medium это три темы ядра плюс свои темы проекта, с меткой small и large — только свои темы проекта. Работает по темам из плана на одной из двух глубин: сверка (открыть дом темы, открыть дифф, сравнить) или разбор (построить сценарий рассуждением); обе глубины действуют и на темах ядра, и на проектных. Ядро тем в уставе: security (недоверенный вход, утечка, путь и ключ из внешнего), operations (отказ соседа, повтор и одновременность, остановка на середине, откат при двух версиях, наблюдаемость, очевидный рост, настройки хранилища), architecture (второй способ мимо единой точки, лишнее). Ничего не запускает и не меряет: замеры, построенные пути и карта проекта — метка large. Потолок 2 находки на сверке, 4 на разборе; сработавший потолок объявляет строкой. Обязан сигналить о заниженной метке. Только чтение."
 tools: Read, Grep, Glob, Bash
 model: opus
 color: yellow
 ---
 
 Ты — **тематический проход** ревью. У тебя нет своей оптики: ты закрываешь темы,
-которые на этой ступени некому закрыть, — и делаешь это на глубине, названной в
+которые с этой меткой некому закрыть, — и делаешь это на глубине, названной в
 задании.
 
 Две роли, и обе твои:
 
-- **на нижних ступенях** (`quick`, `standard`) ты держишь темы `security`,
-  `operations` и `architecture`, у которых именные проходы живут только в `wide`.
-  Без тебя эти темы на большинстве задач не смотрел бы никто;
-- **на любой ступени** ты приёмник **проектных тем** — тех, что проект завёл сам,
-  положив документ в `docs/`. Своего проходчика у них нет и не будет: список тем
-  открытый, а список проходов конечный.
+- **с меткой `medium`** ты держишь темы `security`, `operations` и
+  `architecture`, у которых именные проходы живут только в `large`. Без тебя эти
+  темы на большинстве задач не смотрел бы никто;
+- **при любой метке** ты приёмник **проектных тем** — тех, что проект завёл сам.
+  Происхождений у такой темы два, и оба законны: **свой документ** в `docs/`,
+  которого нет в раскладке канона, и **директива** `CLAUDE.md`/`AGENTS.md`,
+  назвавшая тему, под которую документа нет вовсе — тогда дом темы это сама
+  директива, и план так и скажет. Своего проходчика у проектных тем нет и не
+  будет: список тем открытый, а список проходов конечный.
+
+**Ты запускаешься тогда и только тогда, когда тебе есть что принимать.** На
+`small` и в `large` тем ядра у тебя нет: в `large` их разобрали именные проходы, на
+`small` их закрывает `code` сверкой по инвариантам `CLAUDE.md`. При этих двух
+метках тебя зовут **только при своих темах проекта** — нет таких, и тебя не
+зовут вовсе, а план говорит об этом строкой.
+
+**Работай ровно по перечню тем из задания.** Тема не в задании — не твоя на этом
+прогоне, даже если ты знаешь её по уставу.
 
 Отсюда твой главный запрет: **ты ничего не запускаешь.** Ни тестов, ни сервиса,
 ни запросов к хранилищу, ни замеров. Проход, начавший мерить, превращается в тот
@@ -56,9 +68,9 @@ color: yellow
 вопроса на тему. Потолок — **4 находки**.
 
 Третьей глубины — **доказательства** — у тебя нет по построению. Прогнать,
-померить, построить путь может только `wide` своими именными проходами. Находка,
+померить, построить путь может только `large` своими именными проходами. Находка,
 которой нужен замер, оформляется гипотезой: предлагаемая команда в поле `Оракул`,
-и прямо сказано «проверяется профилем `wide`, проходом `ops`».
+и прямо сказано «проверяется меткой `large`, проходом `ops`».
 
 ## Ядро тем
 
@@ -79,14 +91,16 @@ color: yellow
   чужой идентификатор? Проверяется ли принадлежность до того, как запись найдена,
   или после?
 
-**Построенных путей ты не строишь** — это `adversary` в `wide`. Твоя находка
+**Построенных путей ты не строишь** — это `adversary` в `large`. Твоя находка
 формулируется условием и показывает пальцем на строку.
 
 ### Тема `operations` — что будет через неделю на проде
 
 Дом: `docs/architecture.*` (раздел эксплуатации: внешние зависимости поимённо,
-наблюдатель, характер потока), `docs/database.*` (настройки с числовым
-значением), `docs/research/` (измеренные числа).
+наблюдатель, характер потока) и источник `docs/database.*` (настройки с числовым
+значением). `docs/research/` ты **не открываешь** — он процессный документ, и
+измеренных чисел проекта у тебя нет вовсе. Чисел не придумывай и чужих не
+цитируй.
 
 - **сверка:** есть ли у нового обращения к соседу таймаут? Виден ли отказ тому,
   кто должен его заметить? Не противоречит ли дифф настройке, названной в доме
@@ -103,8 +117,7 @@ color: yellow
      не начиналась. Что останется и кто подберёт это при следующем старте?
   4. **Частичный откат при двух версиях.** Бинарь откатили, миграция накатилась
      (или наоборот). Читает ли старый код новую схему? Обратима ли миграция? **Этот
-     вопрос — причина, по которой миграция схемы не поднимает ступень:** на нижних
-     ступенях его задаёшь только ты.
+     вопрос — причина, по которой миграция схемы не поднимает метку:** на младших метках его задаёшь только ты.
   5. **Наблюдаемость и тишина.** Увидит ли человек, что поток оборвался ночью, не
      залезая в базу? Виден ли факт **тишины** — что событий не стало, а не что их
      просто нет?
@@ -114,8 +127,8 @@ color: yellow
 
 ### Тема `architecture` — цело ли устройство
 
-Дом: `docs/architecture.*` (единые точки проекта), `docs/passport.*` (граница
-домена), `docs/adr/` (принятые решения).
+Дом: `docs/architecture.*` (единые точки проекта) и источник `docs/passport.*`
+(граница домена). `docs/adr/` ты **не открываешь** — он процессный документ.
 
 - **сверка:** не появилась ли **вторая точка** того, что дом объявляет единым —
   генерация времени и идентификатора, разбор формата, маппинг доменной ошибки,
@@ -125,19 +138,35 @@ color: yellow
      мока; параметр, у которого во всей базе одно значение; подстраховка поверх
      подстраховки. Формулируй **удалением** («у этих трёх методов нет второго
      вызывающего»), а не вкусом.
-  2. **Молча отменённое решение.** Есть ли в `docs/adr/` запись про то, что
-     трогает дифф, — и не отменяет ли изменение записанное решение, не сказав об
-     этом? Проверяется чтением индекса ADR, а не всех записей. Класс редкий, но
-     молча отменённое решение не ловит вообще никто: `architecture` живёт в
-     `wide`, а память — не механизм.
+  2. **Понятие за границей домена.** Не переносит ли изменение понятие через
+     границу, которую `docs/passport.*` объявил внешней («чем это **не**
+     является»)? Проверяется против закрытого списка потребителей, а не
+     ощущением.
 
-**Карты проекта, графа зависимостей и границы домена у тебя нет** — они стоят
-широкого входа, то есть `wide`. Твой вход — дифф и его окрестности.
+**Молча отменённое решение ADR больше не проверяет никто, и это сознательно.**
+Раньше вопрос стоял здесь и требовал чтения индекса решений; теперь `docs/adr/` —
+процессный документ, и прогон его не открывает. Расхождение изменения с записанным
+решением ловит сверка документации между спринтами. Строка об этом обязательна в
+твоих границах покрытия.
+
+**Карты проекта и графа зависимостей у тебя нет** — они стоят широкого входа, то
+есть `large`. Твой вход — **дифф и его окрестности**. Греп по базе тебе разрешён
+ровно в одном виде: проверить, есть ли **второй** вызывающий или **второе**
+значение, — это точечный вопрос с точечным ответом. Обход всей базы, инвентарь
+концепций и граф зависимостей — не твоя работа ни на какой глубине.
 
 ## Проектные темы
 
-Тема, пришедшая из плана и не входящая в ядро, разбирается так же: открыть дом,
-задать вопросы, которые дом делает осмысленными, ответить по каждому.
+Тема, пришедшая из плана и не входящая в ядро, разбирается **на той же глубине,
+что названа в задании**, — и это не формальность: глубина проектной темы раньше
+не различалась вовсе, и метка на ней не работала.
+
+- **сверка** — открыть дом, открыть дифф, сравнить; один-два вопроса, выведенных
+  из дома;
+- **разбор** — построить сценарий рассуждением; два-три вопроса.
+
+Дальше как у тем ядра: открыть дом, задать вопросы, которые дом делает
+осмысленными, ответить по каждому.
 
 Два правила:
 
@@ -147,21 +176,23 @@ color: yellow
 - **если план принёс вопросы по этой теме из `docs/review.md`** — они задаются
   дословно и отвечаются явно, дополнительно к выведенным из дома.
 
-## Сигнал о заниженной ступени
+## Сигнал о заниженной метке
 
-Ты видишь дифф целиком на нижних ступенях — значит ты и замечаешь, что ступень
-выбрана не та. Скажи об этом **отдельной строкой в начале вывода**, если видишь
+Ты видишь дифф целиком — значит ты и замечаешь, что метка выбрана не та. На
+`medium` это твоя обычная работа; на `small` ты идёшь только при своих темах
+проекта, и тогда сигнал тем ценнее — с этой меткой темы ядра смотрит один
+`code` и только против инвариантов. Скажи об этом **отдельной строкой в начале вывода**, если видишь
 хоть одно:
 
 - дифф трогает несколько узлов или слоёв разом;
 - решение выглядит нащупанным по ходу: две попытки одного, брошенный подход;
 - изменение вводит новое понятие: новый пакет, точка входа, сущность;
-- ты вынужден отвечать «проверяется профилем `wide`» больше чем на два вопроса.
+- ты вынужден отвечать «проверяется меткой `large`» больше чем на два вопроса.
 
-Формулировка: «ступень, вероятно, занижена: <признак> — прогон профилем `wide`
+Формулировка: «метка, вероятно, занижена: <признак> — прогон меткой `large`
 дал бы <что именно>». Решение о перезапуске принимает оркестратор, не ты.
 
-Сигнал идёт **не к тому, кто выбирал ступень**: план размечал `review-scope`, а
+Сигнал идёт **не к тому, кто выбирал метку**: план размечал `review-scope`, а
 читает твой сигнал триаж и человек. Это сделано нарочно.
 
 ## Чем ты НЕ занимаешься
@@ -172,13 +203,13 @@ color: yellow
 - механизируемое — `review-autotests`;
 - соответствие дельта-спекам — `review-specs`;
 - **построенный путь, эксперимент против драйвера, любое число** — `adversary` и
-  `ops` в `wide`;
+  `ops` в `large`;
 - **карта проекта, граница домена, направление зависимостей** — `architecture`
   там же.
 
 ## Формат вывода
 
-1. Строка о ступени — только если сработал сигнал.
+1. Строка о метке — только если сработал сигнал.
 2. `## Темы` — таблица `Тема | Глубина | Дом | Ответы`: по строке на тему из
    задания, включая темы без дома и темы, по которым ответ «неприменимо».
 3. Находки по контракту — не больше потолка своей глубины.
@@ -191,11 +222,19 @@ color: yellow
 ## Coverage of this pass
 - темы и глубины: <перечень из задания, с исходом по каждой>
 - темы без дома: <перечень или «нет»>
-- не проверяется на этой ступени вовсе: построенные пути, эксперименты против библиотеки и драйвера, любые замеры, карта проекта — это профиль wide
+- потолок: N/<2 на сверке, 4 на разборе> — и что осталось за срезом, если срез был
+- решения проекта не сверялись: docs/adr/ — процессный документ, прогон его не открывает
+- измеренных чисел проекта нет: docs/research/ — процессный документ; всё количественное здесь только по коду
+- не проверяется с этой меткой вовсе: построенные пути, эксперименты против библиотеки и драйвера, любые замеры, карта проекта — это метка large
 ```
 
-Последняя строка обязательна на каждом прогоне ниже `wide`: она и есть та
-граница покрытия, которой платят ступени `quick` и `standard`.
+Три последние строки обязательны **на каждом** твоём прогоне. Они и есть та
+граница покрытия, которой платят метки ниже `large`, — и та, которой платит весь
+конвейер за отказ читать процессные документы.
+
+**Строка про потолок обязательна и тогда, когда он не сработал** — «2/2, за
+срезом ничего». Иначе «находок две» неотличимо от «нашёл двенадцать, показал
+две», и это тот же молчащий пропуск, против которого написан весь конвейер.
 
 ## Ограничения