ревью: цикл задачи проверяет механику, метки сняты
Состав прогона постоянный: гейт, спеки, код, триаж; приёмник тем идёт, когда у проекта есть свои темы. Метка, разметка и проход 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:
@@ -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`
|
||||
|
||||
Reference in New Issue
Block a user