docs(skills): плейбук — структурный рефакторинг: ось вкуса, брифы, два Опус-агента

Зачем.
Отдельный осознанный заход, закрывающий открытые вопросы 2026-07-26 и
2026-07-31: две ручки выбора (модель, эффорт) были про силу, вкус ими не
выражался; константы линий дрейфовали через перепечатку; правила
координации прогона #18 жили только в журнале; у Agent-тула нет ручки
effort — карта была нереализуема разовым вызовом.

Что.
- Третья ось выбора — вкус: references/model-matrix.md (матрица Тео с
  поправкой пользователя под gpt-5.6-sol/Opus 5); разрез по подзадачам
  на этапе 1, сначала вкусовая часть.
- «Родословная» разведена на семейство (классы находок) и свежесть
  (независимость); линия дефектов — по различию, уместности — по умению.
- Ступень эффорта выбирается выбором агента: определений столько,
  сколько пар (модель, ступень) — deep-reasoner (high), craftsman
  (medium, исполнение брифов: реализация/ревью/перепроверки; поглотил
  adversarial-reviewer), fast-worker; карта с обоснованиями — SSOT в
  claude-agents.md.
- Константы — файлами в prompts/: line-task/code/rev, self-review;
  line-taste — вкусовая линза с 12 запахами Фаулера из /code-review.
- Правила #18 — в механизм: инкрементальная запись индекса, глубина
  один и проверка среды в мандате, признак жизни / другой путь вердикта
  замене / среда своими глазами в «Сбоях», стенд одной линии, stdin фона.
- lessons дистиллирован (586→533), handoff захода — в handoffs/.

Проверка.
Слепое ревью Опусом по writing-great-skills: CHANGES_REQUIRED
(7 MAJOR, 17 MINOR, 3 NIT) — все закрыты или отклонены с доводом в
lessons; ссылки пакета проверены скриптом, битых нет. Боевой прогон
новой структуры — следующим заходом (чек-лист в handoff).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Dmitry DementievandClaude Fable 5 committed 2026-07-31 17:03:23 +03:00
1 parent 6070810c2d
commit 3e0498e242
12 files changed
+466 -259

No files matched your search

@@ -0,0 +1,69 @@
# 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.