resolve: третий сценарий — обслуживание, у цикла SDD там нет входа

Задача, не меняющая поведения (тулчейн, зависимости, сборка, гит-хуки, перенос,
чистка), шла полным циклом решения. Все его шаги стоят на дельта-спеках, а у
chore их нет по построению: цикл не урезан ради дешевизны, он остаётся без входа.

Признак — связка: тип записи предлагает, отсутствие дельт подтверждает, а
расхождение признаков это стоп. Размер признаком не стал намеренно: «мелкое —
коротким путём» и есть самая дешёвая лазейка. Планового стопа у сценария нет
вовсе — объяснять человеку нечего, выбора там не делают; правило необратимого
поэтому действует жёстче, чем в двух других.

Ревью идёт фиксированным планом без метки и без разметчика — autotests и
operations, плюс conventions с техническим разбором, когда дифф трогает код.
Конвейер получил раздел «Прогон без change»: он написан вокруг change, и без
этой строки вызов упирался бы в предпосылку OpenSpec. Главный шаг сценария —
синк документации, а триггеры ADR работают стоп-признаком: своего источника у
обслуживания нет, и решение с ценой уходит в разведку.
This commit is contained in:
av
2026-08-13 09:22:50 +03:00
parent f22e7ed829
commit 42849c13eb
10 changed files with 579 additions and 47 deletions
+38 -1
View File
@@ -1,6 +1,6 @@
---
name: review
description: "Конвейер ревью изменения, устроенный по темам: документ проекта либо заводит тему ревью, либо питает чужую тему источником, либо процессный и в ревью не читается вовсе. Ядро тем — requirements, autotests, conventions, architecture, security, operations; список тем открытый, свои темы проект заводит документом. Разметка задачи идёт один раз, после propose: агент review-scope выводит размер и сложность, из их максимума — метка, и раздаёт темы проходам обеих стадий. Метка правит и ревью дизайна (small — только specs; medium — плюс rubric; large — плюс architecture), и ревью кода (small — гейт, спеки, код, триаж; medium — плюс приёмник тем; large — плюс доказательство: враждебные постановки, эксплуатационный постмортем, архитектурный проход на широком входе). Триаж обязателен всегда. Порядок прогона — граф зависимостей: гейт открывает опиниативные проходы, проходы с пометкой «держит машину» идут цепочкой, триаж — единственный сток. Проектная специфика приходит из документов канона av-dev-docs. Вызывается из скилла resolve — двумя стадиями: ревью дизайна до кода и ревью кода после apply."
description: "Конвейер ревью изменения, устроенный по темам: документ проекта либо заводит тему ревью, либо питает чужую тему источником, либо процессный и в ревью не читается вовсе. Ядро тем — requirements, autotests, conventions, architecture, security, operations; список тем открытый, свои темы проект заводит документом. Разметка задачи идёт один раз, после propose: агент review-scope выводит размер и сложность, из их максимума — метка, и раздаёт темы проходам обеих стадий. Метка правит и ревью дизайна (small — только specs; medium — плюс rubric; large — плюс architecture), и ревью кода (small — гейт, спеки, код, триаж; medium — плюс приёмник тем; large — плюс доказательство: враждебные постановки, эксплуатационный постмортем, архитектурный проход на широком входе). Триаж обязателен всегда. Порядок прогона — граф зависимостей: гейт открывает опиниативные проходы, проходы с пометкой «держит машину» идут цепочкой, триаж — единственный сток. Проектная специфика приходит из документов канона av-dev-docs. Вызывается из скилла resolve — двумя стадиями: ревью дизайна до кода и ревью кода после apply. Третий вызов идёт от сценария обслуживания: без change и без метки, фиксированным планом (autotests, operations, плюс conventions, если тронут код), разметчик при этом не запускается."
---
# Конвейер ревью
@@ -55,6 +55,9 @@ description: "Конвейер ревью изменения, устроенны
этим владеет скилл `av-dev-code:openspec` — он заводит каталог и заменяет
пример в `config.yaml` настройкой. Его же зовут `av-dev-docs:init` на новом
проекте и `av-dev-docs:canon` в режиме `adopt` — на переводимом.
**Предпосылка эта — про изменение поведения, а не про всякий прогон:**
сценарий обслуживания зовёт конвейер без change и без дельта-спек, и ни один
проход его плана на них не завязан. См. «Прогон без change».
- **Документы канона** — см. следующий раздел.
- **Проектные копии этих скиллов и агентов удаляются при установке.** Если в
проекте уже лежат свои `.claude/skills/review`,
@@ -638,6 +641,40 @@ flowchart TD
постфактум, и это единственный сигнал — ровно как и для всякой другой ошибки
выбора метки.
## Прогон без change — сценарий обслуживания
Третий вызывающий конвейера — сценарий обслуживания скилла `av-dev-code:resolve`
(тулчейн и сборка, зависимости, гит-хуки, перенос, чистка). Он приходит **без
change**: у работы, не меняющей поведения, дельта-спек нет по построению.
**Метка на таком прогоне не назначается, и разметчик не зовётся.** Обе его оси
здесь не определены: размер он выводит из `proposal.md`, `design.md`, `tasks.md`
и дельта-спек, а сложность — из формы решения, которая у обслуживания либо
известна заранее, либо задача туда не попала (незнакомое уходит в разведку).
Разметчик без своего корпуса вернул бы величину, выведенную из ничего, — и это
хуже отсутствующей метки, потому что выглядит измеренным.
**План приходит вызовом и фиксирован сценарием**, а не выводится здесь:
| Тема | Кто закрывает | Когда |
|---|---|---|
| `autotests` | `review-autotests` | всегда |
| `operations` | `review-basics`, глубина «сверка» | всегда |
| `conventions` + технический разбор | `review-code` | дифф трогает код, а не только оснастку |
Триаж обязателен и здесь — он единственный сток и единственный, кто сверяет план
с исходом. Темы `requirements` и `security` в плане отсутствуют: у первой нет
предмета, у второй нет проходчика на этом сценарии, — и обе обязаны быть названы
в границах покрытия. Дом плана — сценарий, а не этот скилл:
`av-dev-code:resolve`, `references/maintain.md`, раздел «Ревью — план фиксирован
сценарием».
**Правило гейта на таком прогоне работает жёстче обычного.** Правка, которая
трогает сам гейт, проверяется гейтом же — инструмент проверяет себя, — поэтому
сверяется не только цвет, но и состав шагов. Что считается составом, объявляет
проект семантикой гейта в `CLAUDE.md`; не объявил — это строка границ покрытия, а
не догадка прохода.
## Стадия 1 — Автотесты (обязательна при любой метке)
Агент `review-autotests`, тема `autotests`. Запускает команду гейта из семантики