docs(codex-subagent-playbook): обновлены правила выбора моделей

- Зачем:
  - уточнены роли моделей и подход к их выбору в конвейере субагентов.
- Что:
  - добавлена матрица цены, интеллекта, вкуса и качества текста.
  - Terra назначена отправной точкой для технических задач.
  - дополнены наблюдения о ревью и длительных сессиях Claude.
- Проверка:
  - git diff --cached --check.
This commit is contained in:
ddadmin committed 2026-09-08 11:06:04 -04:00
1 parent 8999027ea6
commit ba9f4736ff
4 files changed
+60 -3

No files matched your search

@@ -52,7 +52,7 @@ claude --permission-mode auto --model opus --effort <level> --bg "<mandate>"
путем. Шумный поток CLI сохрани во временном журнале; координатору верни путем. Шумный поток CLI сохрани во временном журнале; координатору верни
ограниченный индекс и путь к отчету. ограниченный индекс и путь к отчету.
Для внешней линии предпочтительно использовать ту же Luna, что и для механических работ. Для внешней линии предпочтительно использовать ту же Terra, что и для механических работ.
Она запускает ревью, следит за ходом работы, получает отчет и готовит краткие Она запускает ревью, следит за ходом работы, получает отчет и готовит краткие
итоги. Для перепроверок продолжает сохраненную сессию до завершения линии. итоги. Для перепроверок продолжает сохраненную сессию до завершения линии.
Храни у нее идентификатор сессии и пути к промпту, журналу и отчету. Храни у нее идентификатор сессии и пути к промпту, журналу и отчету.
@@ -60,7 +60,7 @@ claude --permission-mode auto --model opus --effort <level> --bg "<mandate>"
Поручай помощнику сопровождение до готового отчета или сбоя, требующего Поручай помощнику сопровождение до готового отчета или сбоя, требующего
решения. Он самостоятельно организует ожидание и продолжает работу после решения. Он самостоятельно организует ожидание и продолжает работу после
обычных промежуточных состояний. Основной канал наблюдения - события среды; обычных промежуточных состояний. Основной канал наблюдения - события среды;
если их нет, повторные проверки примерно раз в минуту выполняются средствами если их нет, повторные проверки примерно раз в 2 минуты выполняются средствами
инструментов, без нового рассуждения модели на каждом интервале. Предел инструментов, без нового рассуждения модели на каждом интервале. Предел
ожидания одного вызова инструмента не задает частоту опроса. Координатор ожидания одного вызова инструмента не задает частоту опроса. Координатор
получает сообщения о существенных изменениях, завершении и вопросах, получает сообщения о существенных изменениях, завершении и вопросах,
@@ -88,3 +88,5 @@ claude --permission-mode auto --model opus --effort <level> --bg "<mandate>"
Если CLI отсутствует или неработоспособен, выбери подходящую свежую линию Если CLI отсутствует или неработоспособен, выбери подходящую свежую линию
Codex и точно назови утраченное преимущество другого семейства моделей. Codex и точно назови утраченное преимущество другого семейства моделей.
Типичная сессия ревью с Claude может длиться ощутимо дольше 10 минут.
@@ -0,0 +1,51 @@
# Три оси выбора исполнителя: цена, интеллект, вкус
Эффорт и модель — ручки силы; вкус ими не выражается (прогон #18: код
технически безупречен и при этом неправильной формы). Ось вкуса задаёт
разрез по подзадачам (этап 1 SKILL.md) и линию уместности ревью
(этап 4).
Матрица — калибровка Тео (@t3dotgg) под его стек, неоднократно актуализирована автором скилла.
Числа — порядок, не измерение. `affordability` — практическая
доступность лимитов у нас, 9 — почти бесплатно (не публичные цены);
`intelligence` — сложность работы, которую можно отдать без надзора;
`taste` — суждение в UI/UX, качестве кода, дизайне API, именах и
тексте, `literacy` - умение писать аккуратный нарратив текста на русском языке,
уместно используюя слова и выражения.
| модель | affordability | intelligence | taste |literacy
| ---------------- | ------------: | -----------: | ----: | ------:
| Terra | 9 | ~5 | 5 |6
| Sol | 4 | ~9 | 5 |8
| Astra | 2 | ~10 | 8 |9
| claude-opus-5 | 3 | ~9 | 8 |7
| claude-fable-5.1 | 1 | 10 | 9 |8
## Правила применения
Оценки — дефолты, не запреты. Разрешение эскалировать без вопроса
действует всегда: слабая модель выдала ниже стандарта — повтори более
сильной; суди результат, не цену модели.
- Цена решает только там, где разница в качестве неважна. Для того, что
уйдёт в продукт, интеллект и вкус важнее цены.
- Всё, что читает человек, пишет модель со вкусом ≥ 7: интерфейсы,
проза и продуктовый текст, публичные API и контракты, имена,
архитектурные решения, задающие форму системы (в учебном репозитории
это почти всё). Дефолт вкусовой части — Опус.
- Дешёвые модели собирают, сильные судят: обследование репозитория,
чтение объёмов, механика, реализация по жёсткой спеке — дешёвым;
результат переносится сильной модели там, где нужно суждение. Токены
Fable и Опуса на объёмную работу без суждения не тратить.
- Fable держи для самого трудного: оркестрация, архитектура, задачи,
где интеллект и вкус нужны одновременно.
- Ступень эффорта выбирают по цене *тихой* ошибки этапа, не по его
сложности: где ошибка уезжает дальше незамеченной (постановка, ревью,
диагноз) — ступень выше; где она падает громко и следующий этап её
ловит (реализация, механика) — ниже. Карты ступеней:
Claude-субагенты — [claude-agents.md](claude-agents.md), Codex —
[codex-exec.md](codex-exec.md).
Механика вызова: Claude-модели — параметром `model` (Agent/Workflow) и
определениями из [claude-agents.md](claude-agents.md); Codex — прямым
`codex exec` ([codex-exec.md](codex-exec.md)).
@@ -172,3 +172,7 @@ minimal verification
Так защита контекста остается ступенчатой: подробности доходят до владельца Так защита контекста остается ступенчатой: подробности доходят до владельца
триажа напрямую, а координатор читает ровно тот уровень, который нужен для триажа напрямую, а координатор читает ровно тот уровень, который нужен для
самостоятельного решения. самостоятельного решения.
# Особенности ревьюеров
Sol склонен требовать несоразмерных исходным целям правок.
@@ -32,7 +32,7 @@
## Модель и глубина ## Модель и глубина
Модель и глубину рассуждения выбирай независимо, если среда открывает обе Модель и глубину рассуждения выбирай независимо, если среда открывает обе
ручки. Для технических поручений Luna обычная отправная точка - `high`. ручки. Для технических поручений Terra обычная отправная точка - `medium`.
Настройку уточняй по сложности, цене ошибки и предпочтениям пользователя. Настройку уточняй по сложности, цене ошибки и предпочтениям пользователя.
Для любой роли существенная неопределенность, необратимое решение или высокая Для любой роли существенная неопределенность, необратимое решение или высокая