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 сохрани во временном журнале; координатору верни
ограниченный индекс и путь к отчету.
Для внешней линии предпочтительно использовать ту же 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 отсутствует или неработоспособен, выбери подходящую свежую линию
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`.
Настройку уточняй по сложности, цене ошибки и предпочтениям пользователя.
Для любой роли существенная неопределенность, необратимое решение или высокая