feat(agents): добавлен плейбук оркестрации субагентов

- Зачем:
  - нужен повторяемый процесс делегирования без засорения контекста мастер-модели.
- Что:
  - добавлен явно вызываемый скилл с этапами, договорами возврата и защитой рабочего дерева.
  - описаны роли, уровни стоимости, полевые заметки и handoff для следующей версии.
- Проверка:
  - quick_validate.py agents/.agents/skills/codex-subagent-playbook.
  - git diff --cached --check.

agents/.agents/skills/codex-subagent-playbook/handoffs/20260710-1643-first-version.md

@@ -0,0 +1,83 @@
+# Handoff: первая версия Codex Subagent Playbook
+
+Дата: 2026-07-10. Для следующей сессии, которая добавит настоящие роли
+Codex и проверит полный конвейер на боевой задаче.
+
+## Состояние
+
+Первая версия скилла готова и формально валидна:
+
+- процесс тонкого мастера — [`../SKILL.md`](../SKILL.md);
+- выбор ролей и уровней — [`../references/roles.md`](../references/roles.md);
+- перенесённые уроки и открытые проверки —
+  [`../references/field-notes.md`](../references/field-notes.md);
+- явный вызов скилла — [`../agents/openai.yaml`](../agents/openai.yaml).
+
+Нативные TOML-роли ещё не созданы. В текущем интерфейсе `spawn_agent` роль,
+модель и глубина рассуждений не выбираются явно, поэтому первый пробный
+прогон использовал роли только как мандаты в промпте и честно пометил
+стоимость как неуправляемую.
+
+## Принятые решения
+
+- Главная цель — сохранить контекст мастер-модели для требований, решений и
+  синтеза. Внешняя модель остаётся необязательной дополнительной линией.
+- Скилл запускается только явно. Текущий валидатор не принимает
+  `disable-model-invocation`; используется
+  `policy.allow_implicit_invocation: false` в `openai.yaml`.
+- Модели закрепляются в файлах ролей, а не в `SKILL.md`, чтобы процесс не
+  зависел от смены модельной линейки.
+- Один агент владеет рабочим деревом. До записи сохраняется точка отсчёта,
+  включая хэши неотслеживаемых файлов.
+- Критичный отчёт ревьюера возвращается сообщением и сохраняется в `/tmp`.
+- Нативный конвейер не зависит от вложенного запуска `codex exec`.
+
+## Что проверено
+
+- `quick_validate.py` завершился с `Skill is valid!`.
+- Независимое ревью закрыло договор ревьюера, точку отсчёта, выбор стоимости
+  и устранение лишних повторных прогонов.
+- Безопасный пробный прогон этапов 1–2 поднял исследователя и ревьюера,
+  сформировал самодостаточную постановку и не вынес сырые журналы в итог
+  мастера. Файлы проекта не менялись.
+- Прогон выявил лишний полный запуск тестов исследователем; ограничение роли
+  уже внесено в процесс и справочник.
+
+## Следующая сессия
+
+1. Решить, входят ли Windows/chezmoi в первую поставку ролей. Пробная
+   постановка ограничила первую поставку Linux/WSL.
+2. Выбрать модели для быстрого, рабочего и глубокого уровней. Локально
+   подтверждена только `gpt-5.6-sol`; не считать это готовой таблицей ролей.
+3. Создать шесть ролей: `fast-worker`, `explorer`, `worker`,
+   `deep-reasoner`, `reviewer`, `verifier`.
+4. Разместить Linux/WSL-источник в `codex/.codex/agents/` и узко открыть
+   нужные TOML в `.gitignore`. Сейчас родительское правило игнорирует весь
+   каталог.
+5. Расширить `tests/test_install.sh`: разобрать TOML через `tomllib`,
+   проверить смысловые договоры ролей, повторную установку, стороннюю роль и
+   конфликт совпадающего имени.
+6. Проверить обнаружение ролей установленным Codex CLI в отдельном
+   `CODEX_HOME`. Синтаксический разбор TOML не доказывает поддержку схемы.
+7. Прогнать этапы 3–7 на подходящей задаче, обновить полевые заметки только
+   подтверждёнными фактами и убрать поглощённый осадок.
+
+## Известные ловушки
+
+- Простое исключение `!codex/.codex/agents/*.toml` может не сработать, пока
+  не раскрыты игнорируемые родительские каталоги. Нужны положительные и
+  отрицательные проверки `git check-ignore`.
+- Текущее рабочее дерево dotfiles содержит посторонние изменения. Работать
+  от сохранённой точки отсчёта, не очищать и не включать их в коммиты.
+- `task_name` нативного `spawn_agent` — имя треда, а не доказанный выбор
+  пользовательской конфигурации агента.
+- Права `workspace-write` не гарантируют сеть. Проверку документации и поиск
+  отмечать как непроверенные, если сеть недоступна.
+
+## Suggested skills
+
+- `$writing-great-skills` — удерживать плотность и предсказуемость скилла.
+- `$skill-creator` — валидировать структуру и проводить пробные прогоны.
+- `$tdd` — сначала закрепить установку и договоры ролей тестами.
+- `$claude-team-review` — независимое ревью после появления TOML и тестов.
+- `$conventional-commits` — зафиксировать следующую завершённую поставку.