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:
1 parent
6070810c2d
commit
3e0498e242
12 files changed
+466
-259
No files matched your search
+69
@@ -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.
|
||||
Reference in new issue
Block a user