refactor(codex-playbook): согласована оптика тонкого мастера

- Зачем: - нужно сохранить контекст координатора и устранить расхождения с зеркальным playbook. - Что: - закреплены делегирование, маршрутизация моделей и ограничение кругов ревью. - добавлены файловый договор ревью и согласованная эмпирика прогонов. - исправлены сборка слепых линий и компактные статусы находок. - Проверка: - quick_validate.py, git diff --check и проверка локальных Markdown-ссылок.
2026-07-13 13:07:52 +03:00
1 parent a4985b365d
commit 6cc1b26ce4
@@ -1,5 +1,8 @@
 # Уровни и роли

+Маршрутизация моделей обновлена 2026-07-13. Имена и уровни здесь — датированная
+настройка среды; логика [основной оптики](../SKILL.md) остаётся относительной.
+
 Читай этот файл только при настройке ролей или когда нужная роль недоступна.
 [Основная оптика](../SKILL.md) описывает, когда отдельный агент вообще нужен.
 Этот файл — условные настройки мандата, а не список обязательных участников.
@@ -7,6 +10,7 @@

 - [Возможности хоста](#возможности-хоста)
 - [Выбор уровня](#выбор-уровня)
+- [Текущая маршрутизация](#текущая-маршрутизация)
 - [Роли](#роли)
 - [Файл пользовательского агента](#файл-пользовательского-агента)
 - [Пределы параллельности](#пределы-параллельности)
@@ -23,7 +27,7 @@
  `reasoning_effort` без пользовательской роли с закреплённой моделью.
  Плейбук использует `fork_turns="none"` ради чистого контекста. Технически
  ограниченный fork числом тоже допускает переопределения; только полный
-  fork `all` наследует модель мастера и отклоняет их.
+  fork `all` наследует модель координатора и отклоняет их.
 - **Неуправляемая стоимость.** Интерфейс запуска принимает только задачу и
  имя треда. Передавай роль мандатом в промпте, но не утверждай, что выбрана
  дешёвая или сильная модель. `task_name` — идентификатор треда, а не выбор
@@ -69,25 +73,40 @@

 | Уровень | Для чего | Настройка |
 |---|---|---|
-| Быстрый | Поиск, чтение журналов, тесты, пакетная механика | Быстрая дешёвая модель, `low` или `medium` |
-| Рабочий | Обычная реализация по ясной постановке | Сильная модель для кода, `medium` или `high` |
-| Глубокий | Архитектура, сложная диагностика, ревью высокого риска | Самая сильная доступная модель, `high` или выше |
+| Быстрый | Поиск, журналы, известные проверки, ограниченная механика | Дешёвая подходящая модель, обычно `medium` |
+| Рабочий | Обычная реализация и проверка по задаче | Подходящая ролевая модель, `medium` |
+| Глубокий | Архитектура, сложная реализация, ревью кода | Сильная модель, `high` |
+| Исключительный | Необратимое решение или несходимость сильных агентов | Самая сильная модель, `max` |

-Начинай с самого дешёвого подходящего уровня. Повышай уровень, когда агент
-не может проверить предположение, дважды возвращает слабый результат или
-задача требует решения с высокой ценой ошибки. Не повышай уровень ради
-объёма механической работы: дели её на независимые части.
+Модель задаёт потолок способности, effort — глубину работы этой модели.
+Повышай effort, когда подходящей модели не хватило поиска или рассуждения.
+Повышай модель, когда не хватает качества решения. После двух слабых
+результатов замени исполнителя свежим более сильным агентом вместо переноса
+его неудачного контекста.

- `low`/`medium`: детерминированная механика, поиск и известные проверки.
- `medium`/`high`: реализация по ясному контракту, несколько связанных
-  файлов, нет необратимых решений.
- `high`: публичный контракт, безопасность, целостность данных, конкуренция,
-  миграция или неоднозначная архитектура.
- `xhigh` и выше: необратимый дорогой выбор либо повторное противоречие
-  сильных агентов. Это исключение, а не обычный режим ревью.
+`xhigh` не является автоматической ступенью: текущая эмпирика показывает
+малый прирост относительно `high` при заметной цене. Выбирай его вручную для
+узкой задачи. `max` заметно сильнее и дороже; используй по явному триггеру и
+объясняй партнёру причину.

-Конкретные названия моделей держи в конфигурации агентов, а не в `SKILL.md`.
-Так замена модельной линейки не меняет процесс.
+## Текущая маршрутизация
+
+Это начальная рабочая таблица, а не рейтинг моделей. Проверяй её на прогонах и
+меняй после согласования эмпирики с партнёром.
+
+| Роль | Модель и effort |
+|---|---|
+| Простая ограниченная реализация, `fast-worker`, известная проверка | Luna `medium` |
+| Узкий обзор постановки, проверка реализации по задаче | Terra `medium` |
+| Обычная нетривиальная реализация | Sol `medium` |
+| Сложная или рискованная реализация | Sol `high` |
+| `deep-reasoner`: архитектурное предложение, декомпозиция, компромиссы | Sol `high` |
+| Ревью кода | Sol `high` |
+| Необратимое решение, спор сильных агентов, повторная несходимость | Sol `max` |
+
+Официальное назначение текущих уровней семейства — в
+[каталоге моделей OpenAI](https://developers.openai.com/api/docs/models).
+Конкретные имена держи здесь и в конфигурации агентов, а не в `SKILL.md`.

 ## Возможные мандаты

@@ -104,7 +123,7 @@

 Уровень: быстрый. Строит карту кода, находит точки входа, контракты и команды
 проверки. Не запускает полный набор тестов и не проектирует решение, пока
-мастер прямо не попросит. Узкую команду запускает только для проверки факта,
+координатор прямо не попросит. Узкую команду запускает только для проверки факта,
 без которого карта ненадёжна.

 Обычно: `sandbox_mode = "read-only"`.
@@ -120,8 +139,8 @@
 ### `deep-reasoner`

 Уровень: глубокий. Принимает одно сложное решение: архитектура, алгоритм,
-диагноз, противоречие требований. Возвращает рекомендацию, ключевые доводы и
-непроверенные предположения.
+диагноз, противоречие требований. Возвращает предложение, ключевые доводы и
+непроверенные предположения; итоговое решение принимает координатор.

 Обычно: `sandbox_mode = "read-only"`.

@@ -136,7 +155,9 @@
 правок. Исходники и постоянное окружение защищает явный мандат, Git сверяется
 до и после. Доступ к сети проверять отдельно: право записи не гарантирует
 поиск и документацию. Непроверенную внешнюю механику отмечать как гипотезу.
-Канал результата от песочницы не зависит.
+Канал результата от песочницы не зависит. При выбранном ревью используй
+[единый договор](review-and-triage.md): назначенный файл отчёта — единственный
+результат наблюдателя; временные кэши допустимы, исходники и Git неизменны.

 ### `verifier`

@@ -169,7 +190,7 @@ developer_instructions = """
 ## Пределы параллельности

 - Держи глубину `1`: субагенты не создают собственное дерево исполнителей.
- Оставляй один слот мастеру.
+- Оставляй один слот координатору.
 - Параллельно запускай только работу без конфликтующих входов, команд и
  изменяемого состояния. Второй слепой обзор добавляй ради отдельной линии, а
  не ради заполнения свободного слота.