# Handoff разработки скилла: структурный рефакторинг — ось вкуса, брифы, два Опус-агента

Дата: 2026-07-31. Контекст: не боевой прогон, а отдельный осознанный
заход на рефакторинг (решение пользователя от 2026-07-31 в lessons) —
закрыты все открытые вопросы, накопленные с 2026-07-26. Сессия шла под
`/writing-great-skills`; правки прошли слепое ревью Опусом по тому же
фреймворку (CHANGES_REQUIRED: 7 MAJOR, 17 MINOR, 3 NIT — закрыто, два
отклонения с доводами). Полный список решений и отклонений — в
`references/lessons.md`, записи «Открытый вопрос 2026-07-26 — закрыт» и
«Открытый вопрос 2026-07-31 — закрыт», здесь не дублируются.

## Что изменилось радикально (карта для свежего агента)

1. **Третья ось выбора исполнителя — вкус** (`references/model-matrix.md`,
   матрица Тео с поправкой пользователя под gpt-5.6-sol/Opus 5). Разрез
   по подзадачам на этапе 1: что читает человек — Опусу, руки — Кодексу;
   сначала вкусовая часть.
2. **«Родословная» разведена на два механизма**: свежесть (независимость
   от автора, обязательна каждой линии) и семейство (классы находок).
   Линия дефектов — по различию семейства, линия уместности — по умению.
3. **Ступень эффорта выбирается выбором агента** (у Agent-тула ручки
   effort нет — проверено по схеме). Определений ровно столько, сколько
   пар (модель, ступень) в карте: `deep-reasoner` (opus/high — рассуждения
   и ревью постановок, штатно), `craftsman` (opus/medium — исполнение
   брифов: вкусовая реализация, слепое ревью, перепроверки),
   `fast-worker` (sonnet — механика). `adversarial-reviewer` слит в
   `craftsman`; роли живут в бриф-файлах, не в определениях.
4. **Константы — файлами в `prompts/`**: line-task / line-code / line-rev /
   line-taste (вкусовая линза + 12 запахов Фаулера из `/code-review`
   Мэтта Покока) / self-review. Разрез линз — выбором файла в `cat`.
5. **Правила координации прогона #18 поглощены в механизм**: обёртка
   ревьюера (инкрементальная запись), мандат (глубина один, проверка
   восстановления среды), «Сбои координации» (признак жизни —
   уведомление; замене — другой путь вердикта; среда — своими глазами),
   этап 4 (стенд одной линии), этап 6 (stdin фона `< /dev/null`).

## Что проверить следующим боевым прогоном (не обкатано)

1. **`craftsman` как единый агент** для вкусовой реализации и слепого
   ревью: держит ли обобщённое определение обе стойки, не путает ли
   режимы. Определений в боевых репозиториях ещё нет — создавать по
   свежей заготовке из `references/claude-agents.md` (старые копии
   deep-reasoner/fast-worker в репозиториях живы, craftsman — новый).
2. **Разрез по вкусу на этапе 1**: первый прогон с Опус-исполнителем;
   порядок «сначала вкусовая часть», шов по файлам, ревью-оси при
   Опусе-авторе (линия уместности по умению — та же родословная).
3. **`$D/access-<line>.md`** — новый механизм ограничения второй линии
   при общем стенде (prompt-templates, раздел 2): синтаксис есть, боем
   не проверен.
4. **Инкрементальная запись индекса** Клод-ревьюером: реально ли пишет
   по ходу (правка обёртки после казуса «молчание 59 минут»).
5. Сверить близнеца `codex-subagent-playbook` после этих правок —
   перенос туда ещё не делался (прошлая сверка — 2026-07-23).

## Ориентиры

- Вся эмпирика и датированные решения — `references/lessons.md` (хвост:
  записи 2026-07-31).
- Вердикт слепого ревью правок жил в скретчпаде сессии — не сохраняйте,
  всё принятое уже в файлах, отклонения задокументированы в lessons.
- Коммит этого захода — в истории dotfiles рядом с датой handoff'а.

## Suggested skills

- `claude-subagent-playbook` — следующий боевой прогон с чек-листом
  «что проверить» выше; после прогона — дописать lessons.
- `writing-great-skills` — если прогон потребует новых структурных
  правок скилла.
- `conventional-commits` — коммиты правок в dotfiles.