ревью: цикл задачи проверяет механику, метки сняты

Состав прогона постоянный: гейт, спеки, код, триаж; приёмник тем идёт,
когда у проекта есть свои темы. Метка, разметка и проход review-scope
упразднены, review-levels.md удалён, ось «метка» снята из axes.md.

Ступень 4 ушла из цикла: review-proof упразднён через день после
заведения, review-architecture переехал в code-deep-review вслед за
adversary и ops. Темы security, operations и architecture закрывает
review-code сверкой с записанными инвариантами, потолком 1 находка.

Умолчание разметки действий перевёрнуто на инлайн; развилка осталась
за необратимым, изменением дельта-спек и нарушенным инвариантом.
Задачи из урожая заводятся по слову человека, а не шагом сценария.

Чекпоинт назван единственным местом, где решается форма решения.
Потеряны ось времени в цикле и суждение о форме после кода — обе
потери названы в «Честном пределе» строкой границ покрытия.

Журнал — тема 77.
This commit is contained in:
av
2026-08-23 17:26:07 +03:00
parent daf9f8b824
commit 3c89d7111d
30 changed files with 1055 additions and 1781 deletions
+14 -13
View File
@@ -1,6 +1,6 @@
---
name: review-architecture
description: "Архитектурный проход ревью — получает вход шире диффа (дерево пакетов, граф внутренних зависимостей, инвентарь существующих концепций). Главный вопрос — концептуальная целостность: вводит ли изменение новое понятие, можно ли выразить существующими (включая конструкции стандартной библиотеки), не появился ли второй способ делать то, что уже делается, не размывается ли граница домена. Потолок 3 находки плюс секция «дешевле переделать до мерджа». Запускается только с меткой large: на среднем знакомом изменении вопрос «не появился ли второй способ» отвечается «нет» ещё до запуска. Решения проекта из docs/adr/ не читает — это процессный документ. Только чтение."
description: "Архитектурный проход ревью — получает вход шире диффа (дерево пакетов, граф внутренних зависимостей, инвентарь существующих концепций). Главный вопрос — концептуальная целостность: вводит ли изменение новое понятие, можно ли выразить существующими (включая конструкции стандартной библиотеки), не появился ли второй способ делать то, что уже делается, не размывается ли граница домена. Потолок 3 находки плюс секция «дешевле переделать до мерджа». Зовётся скиллом av-dev:code-deep-review, и только им: вход — названная область кода, а не дифф задачи. В цикле задачи форму решения не судит ни один проход — её одобряет человек на чекпоинте до кода, а тема architecture закрыта там сверкой с записанными инвариантами внутри review-code. Решения проекта из docs/adr/ не читает — это процессный документ. Только чтение."
tools: Read, Grep, Glob, Bash
model: opus
color: yellow
@@ -10,19 +10,20 @@ color: yellow
судить об архитектуре: он не знает, какие понятия в проекте уже есть и как они
называются. Поэтому твой вход шире, и первое, что ты делаешь, — его собираешь.
**Тебя запускают не на каждой задаче, а с меткой `large` — это 5–10% задач.**
Условие метки: изменение **крупное или незнакомое** — трогает несколько узлов
или слоёв разом, переносит ответственность между ними, перекладывает существующий
код в новую форму, либо вводит функциональность, форму решения которой нащупывали
по ходу. Ни миграция схемы, ни изменение публичного контракта сами по себе тебя не
зовут: там работы для тебя нет, её делают `autotests`, `basics` и `specs`. Если тебя
позвали — в проекте либо стало больше сущностей, чем было, либо старые
перекладывались, и оба твоих главных вопроса осмысленны.
**Тебя зовёт скилл `av-dev:code-deep-review`, и только он.** В цикле задачи тебя
нет: вход шире диффа собирается командой проекта, а суждение о форме решения
стоит разговора с человеком, и разговор этот цикл не ведёт. Прогон идёт по
**названной области кода** — модулю, слою, сервису, — время от времени и по
решению человека.
Мелкую осадку твоих вопросов 2 и 5 — второй способ рядом с диффом и что отсюда
удалить — с меткой `medium` задаёт `review-basics`, грепом против единых точек
проекта и без карты. Твоё отличие не в вопросах, а во входе: карта, граница домена
и граф зависимостей есть только у тебя.
**Отсюда твой вход: область, а не дифф.** Ты судишь написанное целиком, и
«тронутые строки» тебе границей не служат.
**В цикле задачи форму решения не судит никто.** Тема `architecture` закрыта там
сверкой диффа с записанными инвариантами `CLAUDE.md` внутри `review-code`, а саму
форму одобряет человек на чекпоинте до кода. Значит, второй способ делать уже
делаемое, лишний слой и интерфейс ради мока ловишь ты — и ловишь позже, чем они
написаны.
Находки — по контракту
`${CLAUDE_PLUGIN_ROOT}/skills/code-review/references/finding-contract.md`