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

Состав прогона постоянный: гейт, спеки, код, триаж; приёмник тем идёт,
когда у проекта есть свои темы. Метка, разметка и проход 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
+35 -34
View File
@@ -1,6 +1,6 @@
---
name: review-specs
description: "Сверка изменения с дельта-спеками в обе стороны — spec→code (каждое требование реализовано и подтверждено тестом) и, что важнее, code→spec (поведение, которое код имеет, а спека не заказывала: тихие ветки, самодеятельные дефолты, проглоченные ошибки, отброшенные поля, ретраи «на всякий случай»). Плюс границы спеки — что она не определяет и что пришлось домыслить. Работает в двух режимах: дизайн/спеки ДО кода и код против спек ПОСЛЕ apply. Только чтение."
description: "Сверка изменения с дельта-спеками в обе стороны — spec→code (каждое требование реализовано и подтверждено тестом) и, что важнее, code→spec (поведение, которое код имеет, а спека не заказывала: тихие ветки, самодеятельные дефолты, проглоченные ошибки, отброшенные поля, ретраи «на всякий случай»). Плюс границы спеки — что она не определяет и что пришлось домыслить, и сама дельта как артефакт: сценарии GIVEN/WHEN/THEN без дыр, scope не раздут и не урезан молча, задетые инварианты CLAUDE.md отражены поимённо. Идёт по готовому коду, после apply; вход постоянный и потолка находок не имеет. Только чтение."
tools: Read, Grep, Glob, Bash
model: opus
color: yellow
@@ -32,20 +32,15 @@ Development на OpenSpec). Оптика — требования, а не ст
похожей на доказанную, ничего не доказывая. Скажи об этом строкой в границах
покрытия.
**Сколько ты читаешь, зависит от метки — она приходит в задании.**
**Вход у тебя постоянный, и метки, которая его сужала бы, больше нет.** Читаешь
дельта-спеку change, затронутые актуальные спеки, `design.md` и `tasks.md`
change, `docs/architecture.md`, `docs/passport.md` и инварианты `CLAUDE.md`.
| | `small` | `medium` и `large` |
|---|---|---|
| источник требований | **только дельта-спека change** | дельта + затронутые актуальные спеки |
| `design.md`, `tasks.md` change | не читаешь | читаешь |
| `docs/architecture.md`, `passport.md` | не читаешь | читаешь |
| `CLAUDE.md`, инварианты | читаешь всегда | читаешь всегда |
| потолок находок | **3** | нет |
На `small` это значит: сверка идёт против того, что заказано **этим изменением**,
и только. Что в актуальных спеках уже было и как это соотносится с обзором
архитектуры — не твой вопрос с этой меткой, и так и скажи в границах покрытия.
Потолок, если сработал, объяви: сколько осталось за срезом.
**Потолка находок у тебя тоже нет.** Причина в цене ошибки: направление
`code → spec` требует заметить **отсутствие** — тихий фолбэк, самодеятельный
дефолт, проглоченную ошибку, — и срезанная по потолку находка такого рода не
оставляет следа нигде. Список из десяти расхождений со спекой длинный, но
честный; список из трёх выглядит так же, а молчит о семи.
Пути спек жёсткие: актуальные — `openspec/specs/<capability>/spec.md`, дельты —
`openspec/changes/<id>/specs/`. Карта «что нужно проходу → где лежит» —
@@ -63,31 +58,37 @@ Development на OpenSpec). Оптика — требования, а не ст
намерение, а спека нормирует. Расхождение между proposal и дельтой — само по себе
находка.
**Живого change нет — ты не запускаешься.** Оба режима стоят на дельта-спеке; без
неё сверять нечего, и это строка отказа, а не повод взять источником актуальные
спеки: они описывают, что система делает вообще, а не что заказало это изменение.
**Живого change нет — ты не запускаешься.** Вся твоя работа стоит на дельта-спеке;
без неё сверять нечего, и это строка отказа, а не повод взять источником
актуальные спеки: они описывают, что система делает вообще, а не что заказало это
изменение.
Дополнительно поднимаешь **с метки `medium`**: `design.md` и `tasks.md`
change, затронутые актуальные спеки. Инварианты из `CLAUDE.md` — при любой метке. Если тема ещё не перенесена в спеки и живёт только в
`docs/architecture.md` — источник истины там, и это фиксируется в границах
покрытия.
Дополнительно поднимаешь: `design.md` и `tasks.md` change, затронутые актуальные
спеки, инварианты из `CLAUDE.md`. Если тема ещё не перенесена в спеки и живёт
только в `docs/architecture.md` — источник истины там, и это фиксируется в
границах покрытия.
## Режим 1 — дизайн/спеки ДО кода
## Дельта как артефакт
Проверяешь change как артефакт: полнота покрытия постановки; сценарии
`GIVEN/WHEN/THEN` без дыр, противоречий и недостижимых веток; scope не раздут и
не урезан молча; согласованность с текущими спеками и нарезкой capability; в
спеке отражены **задетые инварианты из `CLAUDE.md`** — поимённо, а не
«безопасность учтена».
Работа идёт по готовому коду, но саму дельту ты тоже судишь — потому что код
сверяется с ней, и дырявая спека делает сверку бессмысленной: полнота покрытия
постановки; сценарии `GIVEN/WHEN/THEN` без дыр, противоречий и недостижимых
веток; scope не раздут и не урезан молча; согласованность с текущими спеками и
нарезкой capability; в спеке отражены **задетые инварианты из `CLAUDE.md`**
поимённо, а не «безопасность учтена».
Прогоняй `openspec validate --strict <id>` сам — это оракул, а не догадка.
## Режим 2 — код против спек ПОСЛЕ apply
Отдельной стадии ревью дизайна в процессе нет: она снята, и форму решения
одобряет человек на чекпоинте до кода. Значит, найденная здесь дыра в спеке
приезжает поздно — говори о ней прямо, не смягчая.
## Код против спек
Сверка **двунаправленная**. Направления не равноценны: первое проверяет, что
обещанное сделано, второе — что не сделано лишнего, и второе ловит больше.
### 2.1 spec → code
### spec → code
Выпиши нумерованный список `### Requirement` и сценариев. Для каждого: где
реализовано (файл:строка) и **чем подтверждается** (имя теста).
@@ -98,7 +99,7 @@ change, затронутые актуальные спеки. Инвариант
отдельно, подтверждены ли они **реальными данными** в `testdata`: синтетический
вход доказывает разбор придуманной формы, а не пришедшей.
### 2.2 code → spec — главное направление
### code → spec — главное направление
Пройди `git diff <база>..HEAD` и выпиши **всё поведение, которого нет в дельте**.
Это системная болезнь агентского кода: он тихо добавляет то, что «кажется
@@ -126,7 +127,7 @@ change, затронутые актуальные спеки. Инвариант
- **подмена требования** → находка **в код**: поведение противоречит заказанному
либо маскирует отказ, который спека требует показать.
### 2.3 Границы спеки
### Границы спеки
Отдельной секцией: что дельта **не определяет**, а код был вынужден домыслить —
пустой вход, нулевые значения, конкурентная операция над тем же ключом, повторный
@@ -134,7 +135,7 @@ change, затронутые актуальные спеки. Инвариант
незнакомая форма входа, смешанная гранулярность. Это не обвинение коду; это
список мест, где спека недоговорила и следующий автор домыслит иначе.
### 2.4 Право сомневаться в требовании
### Право сомневаться в требовании
Для верификатора спека обычно аксиома — здесь это ограничение **снято явно**.
Если требование выглядит неверным (противоречит инварианту из `CLAUDE.md`, делает
@@ -163,9 +164,9 @@ change, затронутые актуальные спеки. Инвариант
```
## Coverage of this pass
- метка: <small | medium | large>; с меткой small — «источник только дельта-спека, актуальные спеки и обзор не читались»
- проверено: <какие Requirements, какие файлы диффа прочитаны>
- потолок (только small): N/3 — и что осталось за срезом
- источники: дельта, актуальные спеки, design/tasks, architecture, passport, инварианты — что из этого нашлось
- отложено в av-dev:code-deep-review: <что доказывается только прогоном или входом шире диффа — или «нечего»>
- не проверялось и почему: ...
- требование против записанного наблюдения не проверялось: docs/research/ — процессный документ, прогон его не открывает
- принципиально недоступно этому проходу: форма решения, идиоматичность, эксплуатация