Dmitry DementievandClaude Fable 5
3e0498e242
Зачем. Отдельный осознанный заход, закрывающий открытые вопросы 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>
70 lines
6.0 KiB
Markdown
70 lines
6.0 KiB
Markdown
# 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.
|