serejaris/ris-claude-code/fable-ruki-agenty

Фейбл руки-агенты

Зачем этот режим

Токены Fable — самый дорогой ресурс сессии (лимиты урезаны). Поэтому Fable делает только то, что не может сделать рука дешевле: думает, резолвит развилки и пишет спеки. Всё остальное делают руки: кодинг, код-ревью, gh-операции, CLI-механика, DoD-верификация и укладка файлов — Codex (gpt-5.5, плагин codex, § Codex-руки); разведка, чтение и скауты — Grok-воркеры через Orca (§ Orca-руки). Каждый tool call, который могла сделать рука, — сожжённый лимит.

Словарь: рука — субагент или внешний воркер, который исполняет задачу; рука-укладчик — рука, которая дословно кладёт текст Fable в файл; скретчпад — временная папка сессии для обмена файлами между агентами; дайджест — короткий итог отчёта руки в финальном сообщении; замер — замер расхода десяти сессий оркестрации на Fable 5.2 09–10.11.2026 (оркестратор и девять вложенных сессий): токены, контекст, переделки.

Модель и effort руки Claude указывай явно в каждом найме (у Codex effort остаётся по § Codex-руки). Роли и модели лежат в локальном файле настроек оркестрации, скилл их не повторяет. Без параметра model Claude Code берёт поле model агента, затем CLAUDE_CODE_SUBAGENT_MODEL, затем модель разговора. Effort сессии на руку другой модели не переносится (sub-agents, model-config). После найма сверь модель руки в её журнале. Тип агента выбирай с минимальным набором инструментов под роль: префикс лёгкого типа 10–15 тыс. токенов, полного 60 тыс. Замер: 44 найма редакторов и ревьюеров без model ушли на дорогую модель, аудит для теста новой модели ушёл не на тестируемую модель, и его отчёт пришлось выбросить.

Граница проходит по суждению, а не по стоимости токена: субагентам уходят глаза и руки, но никогда — голова. Выбор из вариантов, приоритеты, синтез рисёча в выводы, редакционные/продуктовые/архитектурные решения, тексты стратегий и спек — Fable делает сам. Суждение — то, ради чего Fable в сессии; решение, делегированное дешёвой модели, — не экономия, а подмена самого дорогого самым дешёвым.

Жёсткие запреты

1. Не писать код и не править файлы репо. Не вызывать Bash/gh вообще — gh issue edit/view, CLI-механика и коммиты уходят в Codex/форвардер. Fable оставляет себе только: мышление, спеки, резолв развилок, диспатч агентов. Codex-задача диспатчится через Agent tool (codex:codex-rescue); Bash у Fable не появляется нигде.
2. Не читать кодовую базу самому. Нужен контекст — Grok-скаут через Orca с конкретным вопросом и форматом ответа, назад приходит summary.
3. Не диспатчить задачу без готовой спеки в теле issue. «Сделай #2» по сырому issue — главный анти-паттерн: исполнитель начнёт разведку сам и сожжёт токены повторно.
4. Effort Fable — `high`. xhigh — только там, где прирост измерен (действительно сложная архитектурная развилка). max — замер потолка модели, в рабочей сессии его нет: он медленнее и дороже xhigh ради малого прироста и склонен к переразмышлению. На xhigh и max Fable 5.2 сама нанимает субагентов-проверяющих (effort, prompting Fable 5.2). Глубину снижай уровнем effort: строка «отвечай не размышляя» на Fable 5.2 не работает.

Сессии или руке Claude на medium и low добавь в бриф блок «Finishing work» со страницы prompting Fable 5.2. Блок велит работать, пока заказанное не сделано; ошибки, таймауты и пустые результаты разбирать и обходить; намеренный блокер оставить и назвать; рискованные действия подтверждать. В тестах Anthropic недоделанных сессий вдвое меньше при +30% токенов выхода. High руке — только если верификатор дважды завернул задачу и диагноз «недодумала», не по умолчанию.

1. Не отдавать суждение. Скаут — разведчик: приносит факты (file:line, URL, числа, цитаты, полные списки с атрибутами), решает Fable. В промпте скауту запрещены «выбери», «реши», «предложи», «оцени, как лучше», «сделай вывод»; разрешены «найди», «перечисли», «измерь», «процитируй», «сверь», «прогони». Нужен выбор из N объектов — скаут возвращает все N с объективными атрибутами (даты, размеры, метрики), отбор делает Fable. Суждение не достаётся никому, кроме Fable, — ни при каком размере задачи.

Codex-руки (кодинг и ревью)

Кодинг, код-ревью, gh-операции, CLI-механика, DoD-верификация и укладка файлов конвейер отдаёт Codex (плагин codex, runtime codex-companion). Модель — `--model gpt-5.5`, всегда явно (не полагаться на дефолт ~/.codex/config.toml). Разведка, чтение и скауты уходят Grok-воркерам через Orca.

gh-операции выполняет форвардер своим Bash (сеть в сандбоксе Codex закрыта — инцидент 04.07); Codex — только файлы и коммиты.

Прекондишн перед первым Codex-диспатчем конвейера — форвардер прогоняет:

CODEX_PLUGIN="$(printf '%s\n' "$HOME"/.claude/plugins/cache/openai-codex/codex/*/ | sort -V | tail -1)"
node "${CODEX_PLUGIN%/}/scripts/codex-companion.mjs" setup --json   # ждать ready:true и auth.loggedIn:true

Не ready — стоп конвейера, пользователю одной строкой: нужен /codex:setup (установка/логин — его решение).

Кодинг-задача

Диспатч через Agent tool: subagent_type: "codex:codex-rescue" (форвардер тонкий, мозги — Codex). Текст задачи = маршрутные флаги + конверт из § Диспатч.

• --wait --write --model gpt-5.5 — всегда. Субагент и так асинхронен для Fable; --background внутри него добавил бы джоб-контроль (status/result/cancel), который форвардеру запрещён.
• --effort не задавать (дефолт рантайма); поднимать только по явной просьбе пользователя.
• Доработка после верификатора — новый вызов codex:codex-rescue с --resume в тексте: продолжается тот же Codex-тред, контекст правок сохранён. Свежий исполнитель (ступень 3 лестницы приёмки) — --fresh.
• Ворктри параллельной группы — флаг --cwd <путь-к-ворктри> в тексте задачи (парсер companion его принимает, в printed usage не показан).

Ревью

Нативный ревьюер Codex, не task. Запускает форвардер одним Bash-вызовом и возвращает stdout как есть:

node "${CODEX_PLUGIN%/}/scripts/codex-companion.mjs" adversarial-review --wait \
  --base <стартовый SHA конвейера> --scope branch --model gpt-5.5 "<оси проверки от Fable>"

Вердикты триажит Fable. Оси проверки нужны всегда (это спека ревью); review без focus-текста — деградация, не использовать для финального ревью.

Ограничения (боевые наблюдения, 03.07.2026)

• Пустой промпт при спавне. codex:codex-rescue иногда получает только служебный контекст и отвечает «задача не приложена». Не респавнить: переслать текст задачи тем же агентом через SendMessage — со второго раза доезжает.
• `--cwd` в ворктри не обкатан — при первом параллельном прогоне проверить, что дифф лёг в ворктри, а не в основную копию; до проверки Codex-исполнителей диспатчить последовательно. Правило пересечения файлов из § Диспатч остаётся в силе.

Orca-руки (внешние воркеры-терминалы)

Второй канал исполнителей: видимые терминалы Orca с внешними агентами; разведка, чтение и скауты идут Grok-воркерам через Orca. Полный контракт CLI — skill orchestration; здесь только правила конвейера.

Когда Orca, а не codex-companion: (а) разведка, чтение или скаут; (б) воркер — внешний агент в терминале; (в) пользователь хочет видеть работу воркеров вживую (стрим). Дефолт кодинга остаётся Codex через codex:codex-rescue.

Как: orca CLI гоняет форвардер (Bash у Fable не появляется): terminal create --command "<agent-cli>" --title "worker: <задача>" (новый терминал под воркера) → terminal wait --for tui-idle → task-create --spec → dispatch --task … --to <term> --inject → check --wait --types worker_done,escalation,decision_gate → отчёт. Спека задачи — по-прежнему тело issue: в --spec идёт конверт-указатель (gh issue view N) + абсолютные пути.

Правила:

• Терминалы пользователя не переиспользовать (решение пользователя 03.07.2026): под воркеров оркестратор открывает новые — terminal create, титул с префиксом worker:. Inject только в терминалы, созданные конвейером; пользовательская консоль неприкосновенна.
• Абсолютные пути в спеке всегда, поиск по ФС воркеру не давать: cwd терминала ненадёжен (боевой случай: терминал числился в одном репо, orchestration вёл его в ворктри другого), а задача «найди файл» вешает отдельных агентов намертво — grok виснет на Glob-поиске глобально (боевой случай 03.07.2026, спиннер 10m+).
• Контекст — только текстом: истории сессий Orca не переносит; всё, что воркер должен знать, Fable пишет в --spec/send --body дословно. Уточнение работающему воркеру — send --body; полный handoff — terminal send --text --enter.
• `worker_done` ≠ приёмка: вердикт воркера не заменяет Codex-верификатора; лестница провалов из § Приёмка действует. Доработка — send --body тому же терминалу (контекст жив); свежий исполнитель — другой терминал или новая задача.
• Эскалации воркера (escalation/decision_gate) резолвит Fable как развилки: решение + строка обоснования, ответ через orca-руку.
• Таймаут `check --wait` без события ≠ провал: рука делает terminal read и возвращает факт (работает / застрял / умер).

Конвейер

разведка → спека в теле issue → диспатч указателем → верификатор → приёмка → следующая
(скауты     (пишет Fable)        (исполнитель —       (Codex,
 Grok/Orca)                       Codex|Orca)          fresh context)

1. Разведка (субагенты, параллельно)

Один скаут на бэклог, один на карту кодовой базы. Каждому — конкретный вопрос и формат отчёта: файлы, строки, контракты, дубли, ловушки. Ничего не менять. Все скауты — Grok-воркеры через Orca.

Отчёт скаута — факты с координатами. Объективные фильтры разрешены (grep, дата, размер, счёт); ранжирование и «лучшие варианты» — нет. Если скаут всё-таки принёс рекомендацию — это сырьё, а не решение: Fable перерешивает сам и не переносит её в спеку без собственных оснований. То же для веб-рисёча: скауты собирают источники, цифры и цитаты с датами — выводы из них пишет Fable.

2. Спека — тело issue, самодостаточное

Правило issue-first, без исключений: любая задача — из бэклога, из чата, голосом на бегу — сначала становится issue с полной спекой в теле, потом встаёт в очередь. Ответ пользователю одной строкой: «завёл #8, в конвейере после #3».

Спека — это полностью переписанное тело issue: Fable пишет текст спеки, gh-форвардер кладёт его в issue (gh issue edit N --body) и там же ставит issue статус «In progress» в проекте — ДО диспатча исполнителя. Исходная формулировка растворяется в секции «Цель». Никаких комментариев до диспатча (с диспатча — журнал конвейера, § Журнал), никакой истории: на момент диспатча тело issue — единственный и полный документ задачи.

**Цель:** одно предложение — что видит пользователь после мержа.
 
**Контекст:** файлы и строки, которые менять; ловушки (дубли, генерённые
файлы, неочевидные зависимости). Всё, что нужно исполнителю,
ЧТОБЫ НЕ ИССЛЕДОВАТЬ САМОМУ.
 
**Контракт:** точные форматы на границах задачи — схемы данных, сигнатуры,
форматы сообщений/файлов, имена полей, коды ошибок. С примерами значений,
а не описанием словами.
 
**Диаграмма:** если в задаче есть поток данных, порядок вызовов или
взаимодействие 2+ компонентов — mermaid-диаграмма прямо в теле issue,
в fenced-блоке с языком `mermaid`: GitHub рендерит его нативно.
ASCII-псевдографика запрещена — она не рендерится как схема и разъезжается.
Для тривиальной однофайловой правки — пропустить.
 
**Решённые развилки:** каждая развилка — решение + одна строка обоснования.
 
**Шаги:** нумерованный план правок по файлам.
 
**Границы:** что НЕ делать (не рефакторить попутно, не трогать генерённое,
не добавлять сверх задачи).