fable-ruki-agenty

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

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

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

Sonnet и Haiku не использовать ни для каких ролей (решение founder 04.07.2026).

Граница проходит по суждению, а не по стоимости токена: субагентам уходят **глаза и руки**, но никогда — **голова**. Выбор из вариантов, приоритеты, синтез рисёча в выводы, редакционные/продуктовые/архитектурные решения, тексты стратегий и спек — 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. **Никакого ultrathink / xhigh по умолчанию.** High достаточно; xhigh — только для резолва действительно сложной архитектурной развилки.
   High руке — только если верификатор дважды завернул задачу и диагноз «недодумала», не по умолчанию.
5. **Не отдавать суждение.** Скаут — разведчик: приносит факты (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-диспатчем конвейера — форвардер прогоняет:

```bash
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 как есть:

```bash
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`) + абсолютные пути.

Правила:
- **Термина