# Handoff: рождение скилла claude-subagent-playbook и что в нём не проверено

Дата: 2026-07-06. Для сессии, которая будет развивать сам скилл (не МЛ-задачу).

## Состояние

- Скилл собран и готов к вызову: источник —
  `~/dotfiles/agents/.agents/skills/claude-subagent-playbook/` (в git dotfiles
  ещё не закоммичен), зеркало — `~/.claude/skills/claude-subagent-playbook/`.
  Состав: SKILL.md + references/{codex-companion,lessons,claude-agents}.md.
- Собран по итогам одного боевого прогона (задача 05 «полировка витрины» в
  `~/sources/t2-ml-forecast`, коммит 880d506) — но сам прогон шёл ДО оформления
  скилла. **Скилл ни разу не исполнялся по своему письменному тексту.**
- Эмпирика прогона — в references/lessons.md (файл накопительный, дописывать
  после каждого прогона). Память проекта t2-ml-forecast тоже знает о скилле:
  `~/.claude/projects/-home-ddmitry-sources-t2-ml-forecast/memory/`.

## Дизайн-решения и их источники (не пересказ — только происхождение)

- Форма «набор знаний, не жёсткий каркас» — явное требование пользователя;
  жёсткий каркас уже есть у `/coordinator-loop` (очередь issue, сторона Codex).
- Структура и словарь выверены по `/writing-great-skills`: user-invoked,
  короткий description, completion criteria на шагах, ведущие слова общие с
  coordinator-loop (индекс, родословная, свежесть).
- Раннер-паттерн для вызова Codex — из `/adversarial-review`
  (references/runner.md там — самый проработанный образец: двухканальный
  протокол, результат файлом, ретраи). Добавлен по предложению пользователя.
- Триаж находок исполнителем — из `/claude-team-review` и coordinator-loop
  («судит тот, у кого контекст кода»). Тоже добавлен по замечанию пользователя.

## Не проверено боем — проверять в следующих прогонах

1. **Раннер с `task --wait`** — в прогоне 05 использовался `--background` +
   bash-монитор, раннер не пробовали. Открытый риск: у Bash-вызова внутри
   субагента потолок 10 минут (timeout max 600000 мс), а реализация у Codex
   шла ~15 минут. Раннеру, видимо, нужна инструкция «по таймауту не падать, а
   опрашивать `$CC status`/`result` до завершения». Обкатать и вписать в
   references/codex-companion.md то, что реально сработало.
2. **Триаж исполнителем** — в прогоне 05 триаж делал оркестратор (обе находки
   принял сам). Формулировка «перешли индекс дословно, Codex чинит или
   аргументированно отклоняет» — теория из соседних скиллов, не наша эмпирика.
3. **Фолбэк ревьюера** (general-purpose со скептическим промптом при
   отсутствии adversarial-reviewer) — не обкатан.
4. **Порог «мелочь vs конвейер»** откалиброван по одному случаю — уточнять.
5. **Чего в скилле осознанно нет** (кандидаты при развитии, не тащить без
   нужды): журнала прогона (след живёт в задаче-файле — хватит ли на длинной
   задаче?); узкого rerun-а ревьюера продолжением той же сессии (SendMessage —
   в 05 не понадобился); ролей deep-reasoner в синтезе.

## Ближайший боевой тест

Регламент переобучения («выживаемость») в t2-ml-forecast — единственный
незакрытый пункт Этапа 1 пилота, калибр подходящий. Вызвать
`/claude-subagent-playbook` в свежей сессии и смотреть, где текст скилла
расходится с практикой; расхождения — в lessons.md и правки SKILL.md.

## Suggested skills

- `/claude-subagent-playbook` — предмет работы; прогнать как написано.
- `/writing-great-skills` — перед любыми правками структуры скилла.
- `/adversarial-review` — образец раннера (references/runner.md) при обкатке
  пункта 1.
- `/handoff` — по завершении сессии развития обновить эту записку (или
  положить рядом новую; старую можно удалить, если полностью поглощена).