проходам ревью назначены модели по типу работы

- sonnet на gate/code/ops (вход структурный, критерий записан), opus на specs/idiom/negative/adversary, fable на rubric/reimpl/architecture/triage — там, где качество порождённого и есть вся ценность прохода - haiku не используется нигде: механизируемое вынесено ниже модели в скрипты, а дешёвый опиниативный проход дороже в триаже, чем экономит - frontmatter агентов приведён к валидному YAML: описания с двоеточиями закавычены, иначе строгий парсер молча потеряет агента
2026-08-01 14:38:12 +03:00
parent 7998c6b86e
commit 768878e23e
12 changed files with 50 additions and 11 deletions
@@ -1,7 +1,8 @@
 ---
 name: healthlog-review-adversary
-description: Враждебный проход ревью healthlog — не проверяет свойства, а строит путь: «ты контролируешь тело доставки целиком — выведи запись за пределы storage.archive_dir»; «ты шлёшь пакет и хочешь, чтобы точка не доехала до объекта — построй такой вход»; «ты можешь повторить и переставить любую доставку — что ломается»; «доведи значение точки до лога». Находка — построенный путь с шагами, а не наблюдение. Свойства без пути идут в отдельную секцию и не получают critical. Только чтение.
+description: "Враждебный проход ревью healthlog — не проверяет свойства, а строит путь: «ты контролируешь тело доставки целиком — выведи запись за пределы storage.archive_dir»; «ты шлёшь пакет и хочешь, чтобы точка не доехала до объекта — построй такой вход»; «ты можешь повторить и переставить любую доставку — что ломается»; «доведи значение точки до лога». Находка — построенный путь с шагами, а не наблюдение. Свойства без пути идут в отдельную секцию и не получают critical. Только чтение."
 tools: Read, Grep, Glob, Bash
+model: opus
 color: red
 ---

@@ -1,7 +1,8 @@
 ---
 name: healthlog-review-architecture
-description: Архитектурный проход ревью healthlog — получает вход шире диффа (дерево пакетов, граф внутренних зависимостей, инвентарь существующих концепций через task review:context). Главный вопрос — концептуальная целостность: вводит ли изменение новое понятие, можно ли выразить существующими, не появился ли второй способ делать то, что уже делается, не размывается ли граница «хранилище, а не аналитика». Потолок 3 находки + секция «дешевле переделать до мерджа». Работает и на OpenSpec-предложении до кода (профиль design). Только чтение.
+description: "Архитектурный проход ревью healthlog — получает вход шире диффа (дерево пакетов, граф внутренних зависимостей, инвентарь существующих концепций через task review:context). Главный вопрос — концептуальная целостность: вводит ли изменение новое понятие, можно ли выразить существующими, не появился ли второй способ делать то, что уже делается, не размывается ли граница «хранилище, а не аналитика». Потолок 3 находки + секция «дешевле переделать до мерджа». Работает и на OpenSpec-предложении до кода (профиль design). Только чтение."
 tools: Read, Grep, Glob, Bash
+model: fable
 color: yellow
 ---

@@ -1,7 +1,8 @@
 ---
 name: healthlog-review-code
-description: Стадия 1 конвейера review-pipeline (во всех профилях, параллельно с healthlog-review-specs) — дешёвый applicative-проход по конвенциям healthlog, которые НЕ выражаются правилом линтера: уровень лога по адресату, единственный логирующий чекпоинт на доменной границе, трансляция доменной ошибки на внешней границе, «сохранили — значит приняли», тела запросов и секреты в логах, конфиг и его образцы, время в БД в UTC RFC 3339 через store.Now(), ULID через internal/ident и ident.Parse на границе. Механизируемое проверяет task gate, архитектуру — healthlog-review-architecture, стиль и лишнее — generative-проходы. Только чтение.
+description: "Стадия 1 конвейера review-pipeline (во всех профилях, параллельно с healthlog-review-specs) — дешёвый applicative-проход по конвенциям healthlog, которые НЕ выражаются правилом линтера: уровень лога по адресату, единственный логирующий чекпоинт на доменной границе, трансляция доменной ошибки на внешней границе, «сохранили — значит приняли», тела запросов и секреты в логах, конфиг и его образцы, время в БД в UTC RFC 3339 через store.Now(), ULID через internal/ident и ident.Parse на границе. Механизируемое проверяет task gate, архитектуру — healthlog-review-architecture, стиль и лишнее — generative-проходы. Только чтение."
 tools: Read, Grep, Glob, Bash
+model: sonnet
 color: blue
 ---

@@ -1,7 +1,8 @@
 ---
 name: healthlog-review-gate
-description: Детерминированный гейт ревью healthlog — запускает task gate (build/vet/lint/gofmt/test/флаки/race/покрытие изменённых строк/миграции/образцы конфига/секреты/данные о здоровье в индексе/уязвимости) и интерпретирует вывод. Отличает новые отказы от унаследованных, находит отсутствующую верификацию (изменённые строки без покрытия, конкурентность без теста, флаки). Пока гейт красный, опиниативные проходы не запускаются. Первый проход конвейера review-pipeline, обязателен во всех профилях.
+description: "Детерминированный гейт ревью healthlog — запускает task gate (build/vet/lint/gofmt/test/флаки/race/покрытие изменённых строк/миграции/образцы конфига/секреты/данные о здоровье в индексе/уязвимости) и интерпретирует вывод. Отличает новые отказы от унаследованных, находит отсутствующую верификацию (изменённые строки без покрытия, конкурентность без теста, флаки). Пока гейт красный, опиниативные проходы не запускаются. Первый проход конвейера review-pipeline, обязателен во всех профилях."
 tools: Bash, Read, Grep, Glob
+model: sonnet
 color: red
 ---

@@ -1,7 +1,8 @@
 ---
 name: healthlog-review-idiom
-description: Generative-проход ревью healthlog — заземляет «идиоматичность» на конкретику: какая конструкция stdlib ближе всего по форме к решаемой задаче (http.Server, encoding/json, io.Reader и io.LimitReader, compress/gzip, sql.DB/Rows, bufio.Scanner, context, errors.Is/As/Join, sync.Once, time.Parse) и какое ПОИМЁННОЕ положение Effective Go / Go Code Review Comments / Go Proverbs / стайлгайдов Uber и Google нарушено. Ссылка обязана быть на конкретное положение, а не на источник целиком. Различает «идиоматично» и «распространено». Только чтение.
+description: "Generative-проход ревью healthlog — заземляет «идиоматичность» на конкретику: какая конструкция stdlib ближе всего по форме к решаемой задаче (http.Server, encoding/json, io.Reader и io.LimitReader, compress/gzip, sql.DB/Rows, bufio.Scanner, context, errors.Is/As/Join, sync.Once, time.Parse) и какое ПОИМЁННОЕ положение Effective Go / Go Code Review Comments / Go Proverbs / стайлгайдов Uber и Google нарушено. Ссылка обязана быть на конкретное положение, а не на источник целиком. Различает «идиоматично» и «распространено». Только чтение."
 tools: Read, Grep, Glob, Bash
+model: opus
 color: purple
 ---

@@ -1,7 +1,8 @@
 ---
 name: healthlog-review-negative
-description: Generative-проход ревью healthlog о негативном пространстве — не «что не так», а чего НЕТ и что ЛИШНЕЕ: что есть в зрелой реализации такого узла и отсутствует здесь; хватит ли сигналов владельцу, когда поток молча оборвётся ночью; что опытный человек удалил бы (слои с единственной реализацией, интерфейсы ради моков, незапрошенная конфигурируемость, подстраховка поверх подстраховки); пять вопросов второго инженера, ответ на которые не следует из кода. Только чтение.
+description: "Generative-проход ревью healthlog о негативном пространстве — не «что не так», а чего НЕТ и что ЛИШНЕЕ: что есть в зрелой реализации такого узла и отсутствует здесь; хватит ли сигналов владельцу, когда поток молча оборвётся ночью; что опытный человек удалил бы (слои с единственной реализацией, интерфейсы ради моков, незапрошенная конфигурируемость, подстраховка поверх подстраховки); пять вопросов второго инженера, ответ на которые не следует из кода. Только чтение."
 tools: Read, Grep, Glob, Bash
+model: opus
 color: purple
 ---

@@ -1,7 +1,8 @@
 ---
 name: healthlog-review-ops
-description: Эксплуатационный проход ревью healthlog — пишет постмортем «это упало через неделю на rivendell» от симптома у владельца к строке кода. Обязательные вопросы: рост объёма, деградация окружения (диск, SQLite, Caddy, клиент HAE), повторная и одновременная доставка, частичный откат при двух версиях, миграция под непрерывным потоком, отмена контекста на середине, наблюдаемость и тишина в потоке. Формулирует условиями («если объект за час больше N точек»), а не утверждениями — реального профиля нагрузки не знает. Только чтение.
+description: "Эксплуатационный проход ревью healthlog — пишет постмортем «это упало через неделю на rivendell» от симптома у владельца к строке кода. Обязательные вопросы: рост объёма, деградация окружения (диск, SQLite, Caddy, клиент HAE), повторная и одновременная доставка, частичный откат при двух версиях, миграция под непрерывным потоком, отмена контекста на середине, наблюдаемость и тишина в потоке. Формулирует условиями («если объект за час больше N точек»), а не утверждениями — реального профиля нагрузки не знает. Только чтение."
 tools: Read, Grep, Glob, Bash
+model: sonnet
 color: yellow
 ---

@@ -1,7 +1,8 @@
 ---
 name: healthlog-review-reimpl
-description: Самый дорогой и самый ценный generative-проход ревью healthlog — получает спеку и контракты, пишет собственную реализацию в tmp/, НЕ ОТКРЫВАЯ существующую, и только потом диффит по решениям (декомпозиция, где обрабатываются ошибки, что вынесено в интерфейс, владение данными точки, протяжка context, модель конкурентности). Единственный проход, который системно достаёт «не знаю, чего не знаю». Существующий код не меняет.
+description: "Самый дорогой и самый ценный generative-проход ревью healthlog — получает спеку и контракты, пишет собственную реализацию в tmp/, НЕ ОТКРЫВАЯ существующую, и только потом диффит по решениям (декомпозиция, где обрабатываются ошибки, что вынесено в интерфейс, владение данными точки, протяжка context, модель конкурентности). Единственный проход, который системно достаёт «не знаю, чего не знаю». Существующий код не меняет."
 tools: Read, Grep, Glob, Bash, Write
+model: fable
 color: purple
 ---

@@ -1,7 +1,8 @@
 ---
 name: healthlog-review-rubric
-description: Generative-проход ревью healthlog — сперва, НЕ ВИДЯ КОДА, порождает 8–12 проверяемых свойств, по которым сильный Go-инженер судит узел такого назначения (разбор пакета HAE, HTTP-хендлер приёма, обработчик Read API, репозиторий часовых объектов, файловый архив с ретеншеном, CLI-команда import/reindex, адаптер MCP), и только потом читает код и оценивает по этой рубрике. Достаёт слой, которого нет ни в одной конвенции. Годится и до кода (профиль design) — тогда рубрика становится приёмочными критериями. Только чтение.
+description: "Generative-проход ревью healthlog — сперва, НЕ ВИДЯ КОДА, порождает 8–12 проверяемых свойств, по которым сильный Go-инженер судит узел такого назначения (разбор пакета HAE, HTTP-хендлер приёма, обработчик Read API, репозиторий часовых объектов, файловый архив с ретеншеном, CLI-команда import/reindex, адаптер MCP), и только потом читает код и оценивает по этой рубрике. Достаёт слой, которого нет ни в одной конвенции. Годится и до кода (профиль design) — тогда рубрика становится приёмочными критериями. Только чтение."
 tools: Read, Grep, Glob, Bash
+model: fable
 color: purple
 ---

@@ -1,7 +1,8 @@
 ---
 name: healthlog-review-specs
-description: Сверка изменения healthlog с дельта-спеками OpenSpec в обе стороны — spec→code (каждое требование реализовано и подтверждено тестом) и, что важнее, code→spec (поведение, которое код имеет, а спека не заказывала: тихие ветки, самодеятельные дефолты, проглоченные ошибки, отброшенные поля точки, ретраи «на всякий случай»). Плюс границы спеки — что она не определяет и что пришлось домыслить. Работает в двух режимах: дизайн/спеки ДО кода и код против спек ПОСЛЕ apply. Только чтение.
+description: "Сверка изменения healthlog с дельта-спеками OpenSpec в обе стороны — spec→code (каждое требование реализовано и подтверждено тестом) и, что важнее, code→spec (поведение, которое код имеет, а спека не заказывала: тихие ветки, самодеятельные дефолты, проглоченные ошибки, отброшенные поля точки, ретраи «на всякий случай»). Плюс границы спеки — что она не определяет и что пришлось домыслить. Работает в двух режимах: дизайн/спеки ДО кода и код против спек ПОСЛЕ apply. Только чтение."
 tools: Read, Grep, Glob, Bash
+model: opus
 color: cyan
 ---

@@ -1,7 +1,8 @@
 ---
 name: healthlog-review-triage
-description: Обязательный финальный проход конвейера ревью healthlog — единственный, кто агрегирует. Дедуплицирует находки по причине, добывает оракул для critical/major (пишет падающий тест, гоняет разбор на реальном пакете из testdata, выполняет команду), понижает неподтверждённое до гипотез, отсеивает вкусовщину, ранжирует по ущербу × вероятности и режет до 7 пунктов. Помечает каждую находку «инлайн» или «развилка» для оркестратора. Формирует итоговый отчёт с обязательной секцией границ покрытия.
+description: "Обязательный финальный проход конвейера ревью healthlog — единственный, кто агрегирует. Дедуплицирует находки по причине, добывает оракул для critical/major (пишет падающий тест, гоняет разбор на реальном пакете из testdata, выполняет команду), понижает неподтверждённое до гипотез, отсеивает вкусовщину, ранжирует по ущербу × вероятности и режет до 7 пунктов. Помечает каждую находку «инлайн» или «развилка» для оркестратора. Формирует итоговый отчёт с обязательной секцией границ покрытия."
 tools: Read, Grep, Glob, Bash, Write
+model: fable
 color: green
 ---

@@ -48,6 +48,34 @@ description: Конвейер ревью изменений healthlog — дет
 - **Приём не теряет доставку.** Код ответа отражает доставку, а не разбор;
  тело ложится на диск до разбора.

+## Модель по проходу
+
+Следует из правила 2: чем больше работы делает детерминированный инструмент,
+тем дешевле может быть модель; чем больше проход **порождает** критерий, тем
+дороже. Модель задана во frontmatter каждого агента, менять её здесь не нужно.
+
+| Модель | Проходы | Почему |
+|---|---|---|
+| `sonnet` | gate, code, ops | вход структурный, критерий записан заранее |
+| `opus` | specs, idiom, negative, adversary | суждение без опоры на инструмент |
+| `fable` | rubric, reimpl, architecture, triage | качество порождённого и есть вся ценность |
+
+**Haiku не используется ни на одном проходе, и это не экономия наоборот.**
+Дешёвая модель на опиниативном проходе даёт правдоподобные находки, которые
+триаж обязан опровергать оракулом, — а это самая дорогая операция конвейера.
+Механизируемая же работа здесь давно вынесена **ниже** модели: `gate.py`,
+`diff-coverage.py`, `review-context.py`, `backlog.py` стоят ноль токенов.
+Дешёвому проходу просто не осталось работы.
+
+Сюда же — почему `triage` на самой сильной модели, хотя он «всего лишь
+агрегирует». Через него проходит всё, что оркестратор потом **реализует
+молча**: ложноположительная находка становится кодом, потерянный `critical` —
+дефектом. Ошибка триажа дороже ошибки любого отдельного прохода.
+
+Экономия при этом достигается не понижением модели, а **непуском прохода**:
+`quick` — три стадии, `deep` — одиннадцать. Правило выбора профиля ниже и есть
+главный рычаг стоимости.
+
 ## Профили

 | Профиль | Когда | Стадии |