0 Fork 0

Files

T

Dmitry DementievandClaude Fable 5 3e0498e242 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>

2026-07-31 17:03:23 +03:00

6.0 KiB

Raw Blame History

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 — закрыт», здесь не дублируются.

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

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

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

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

6.0 KiB Raw Blame History Unescape Escape