From ba9f4736ff1cd019cc9b599eaa34e246b36e9ed8 Mon Sep 17 00:00:00 2001 From: Dmitry Dementev Date: Tue, 8 Sep 2026 11:06:04 -0400 Subject: [PATCH] =?UTF-8?q?docs(codex-subagent-playbook):=20=D0=BE=D0=B1?= =?UTF-8?q?=D0=BD=D0=BE=D0=B2=D0=BB=D0=B5=D0=BD=D1=8B=20=D0=BF=D1=80=D0=B0?= =?UTF-8?q?=D0=B2=D0=B8=D0=BB=D0=B0=20=D0=B2=D1=8B=D0=B1=D0=BE=D1=80=D0=B0?= =?UTF-8?q?=20=D0=BC=D0=BE=D0=B4=D0=B5=D0=BB=D0=B5=D0=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - уточнены роли моделей и подход к их выбору в конвейере субагентов. - Что: - добавлена матрица цены, интеллекта, вкуса и качества текста. - Terra назначена отправной точкой для технических задач. - дополнены наблюдения о ревью и длительных сессиях Claude. - Проверка: - git diff --cached --check. --- .../references/claude.md | 6 ++- .../references/model-matrix.md | 51 +++++++++++++++++++ .../references/review-and-triage.md | 4 ++ .../references/roles.md | 2 +- 4 files changed, 60 insertions(+), 3 deletions(-) create mode 100644 agents/.agents/skills/codex-subagent-playbook/references/model-matrix.md diff --git a/agents/.agents/skills/codex-subagent-playbook/references/claude.md b/agents/.agents/skills/codex-subagent-playbook/references/claude.md index e2a5dd2..4f96c42 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/claude.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/claude.md @@ -52,7 +52,7 @@ claude --permission-mode auto --model opus --effort --bg "" путем. Шумный поток CLI сохрани во временном журнале; координатору верни ограниченный индекс и путь к отчету. -Для внешней линии предпочтительно использовать ту же Luna, что и для механических работ. +Для внешней линии предпочтительно использовать ту же Terra, что и для механических работ. Она запускает ревью, следит за ходом работы, получает отчет и готовит краткие итоги. Для перепроверок продолжает сохраненную сессию до завершения линии. Храни у нее идентификатор сессии и пути к промпту, журналу и отчету. @@ -60,7 +60,7 @@ claude --permission-mode auto --model opus --effort --bg "" Поручай помощнику сопровождение до готового отчета или сбоя, требующего решения. Он самостоятельно организует ожидание и продолжает работу после обычных промежуточных состояний. Основной канал наблюдения - события среды; -если их нет, повторные проверки примерно раз в минуту выполняются средствами +если их нет, повторные проверки примерно раз в 2 минуты выполняются средствами инструментов, без нового рассуждения модели на каждом интервале. Предел ожидания одного вызова инструмента не задает частоту опроса. Координатор получает сообщения о существенных изменениях, завершении и вопросах, @@ -88,3 +88,5 @@ claude --permission-mode auto --model opus --effort --bg "" Если CLI отсутствует или неработоспособен, выбери подходящую свежую линию Codex и точно назови утраченное преимущество другого семейства моделей. + +Типичная сессия ревью с Claude может длиться ощутимо дольше 10 минут. diff --git a/agents/.agents/skills/codex-subagent-playbook/references/model-matrix.md b/agents/.agents/skills/codex-subagent-playbook/references/model-matrix.md new file mode 100644 index 0000000..04b616b --- /dev/null +++ b/agents/.agents/skills/codex-subagent-playbook/references/model-matrix.md @@ -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)). diff --git a/agents/.agents/skills/codex-subagent-playbook/references/review-and-triage.md b/agents/.agents/skills/codex-subagent-playbook/references/review-and-triage.md index 2beb493..95b81db 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/review-and-triage.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/review-and-triage.md @@ -172,3 +172,7 @@ minimal verification Так защита контекста остается ступенчатой: подробности доходят до владельца триажа напрямую, а координатор читает ровно тот уровень, который нужен для самостоятельного решения. + +# Особенности ревьюеров + +Sol склонен требовать несоразмерных исходным целям правок. diff --git a/agents/.agents/skills/codex-subagent-playbook/references/roles.md b/agents/.agents/skills/codex-subagent-playbook/references/roles.md index a344479..598ba63 100644 --- a/agents/.agents/skills/codex-subagent-playbook/references/roles.md +++ b/agents/.agents/skills/codex-subagent-playbook/references/roles.md @@ -32,7 +32,7 @@ ## Модель и глубина Модель и глубину рассуждения выбирай независимо, если среда открывает обе -ручки. Для технических поручений Luna обычная отправная точка - `high`. +ручки. Для технических поручений Terra обычная отправная точка - `medium`. Настройку уточняй по сложности, цене ошибки и предпочтениям пользователя. Для любой роли существенная неопределенность, необратимое решение или высокая