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

@@ -1,11 +1,37 @@
# Репо-локальные Claude-субагенты и конструкция оркестрации
`deep-reasoner` и `fast-worker` — субагенты уровня репозитория
(`.claude/agents/*.md`), не глобальные. В новом репозитории их нет — проверь
`ls .claude/agents/` и при отсутствии создай файлы ниже как есть.
У ревьюера `adversarial-reviewer` репо-локального определения намеренно
нет: рабочие фолбэки — `deep-reasoner` (обкатан ревью 2026-07-12) или
`general-purpose` со скептическим промптом (см. «Роли» в SKILL.md).
`deep-reasoner`, `craftsman` и `fast-worker` — субагенты уровня
репозитория (`.claude/agents/*.md`), не глобальные. Определений ровно
столько, сколько различных пар (модель, ступень) в карте ниже: роль
задаёт бриф-файл, определение — только ступень и модель. В
новом репозитории их нет — проверь `ls .claude/agents/` и при отсутствии
предложи пользователю создать файлы ниже как есть. Определение — не
только удобство: `effort:` во фронтматтере — единственный канал, которым
оркестратор задаёт ступень эффорта субагенту (у Agent-тула ручки effort
нет — проверено по схеме 2026-07-31; в Workflow-скриптах ступень
задаётся на вызов через `opts.effort`, но конвейер ходит субагентами);
без определения агент приедет на эффорте сессии. Поэтому роль с другой
ступенью — это другой агент, а не другой вызов.
## Карта «роль → модель и ступень»
По цене *тихой* ошибки этапа, не по сложности (решение пользователя
2026-07-26 под Opus 5; `xhigh` не дефолтить):
- `high` — ревью постановок и планов: `deep-reasoner`. Дефект
каскадирует — отравляет реализацию, оба ревью и триаж.
- `medium` — слепое ревью, узкие перепроверки и вкусовая реализация:
`craftsman`. Ревью — последняя линия обороны своей линзы, пропуск
тихий, ниже не опускать даже при двух ревьюерах (линзы разные,
избыточность не дублирование); ошибка реализации громкая — за ней
саморевью, оба ревью и приёмка; вкус едет с моделью, не с эффортом.
- default — механика: `fast-worker` (Sonnet). Ошибка громкая, эффорт не
крутить вовсе.
Карта задаёт минимум для роли, не ограничение для агента: на линии
постановок `deep-reasoner` — штатный ход, а на линии слепого ревью —
временный фолбэк при отсутствии `craftsman` (обкатан ревью 2026-07-12),
там он приедет ступенью выше карты.
## Конструкция оркестрации (фрагмент CLAUDE.md репозитория)
@@ -13,9 +39,11 @@
## Orchestration workflow
You (Fable) are the orchestrator. Plan, decompose, synthesize.
Reasoning-heavy phases → deep-reasoner
Human-facing work (prose, interfaces, names) → craftsman
Mechanical work → fast-worker
Codex (/codex:rescue --background) is a cracked engineer on par with
deep-reasoner, from a different perspective. Treat as a peer, not a reviewer.
Codex (direct `codex exec`, see claude-subagent-playbook) is a cracked
engineer from a different model family: implementer for technical work
and an independent blind review line.
High-stakes decisions: task Opus + Codex on the same problem in parallel,
synthesize the best of both, without showing either the other's answer.
Keep your own context lean.
@@ -62,6 +90,41 @@ Lead with the conclusion. Then, only if it adds value:
Keep it tight. Your value is the quality of the conclusion, not its length.
```
## `.claude/agents/craftsman.md`
```markdown
---
name: craftsman
description: >
Opus at medium effort for prepared briefs: tasteful implementation of
a self-contained task file, a blind review line, a narrow re-check.
The brief carries the mandate; taste — form, proportion, naming — is
why this agent and not a mechanical one.
model: opus
effort: medium
color: blue
---
# Craftsman
You execute the prepared brief the orchestrator names — a self-contained
task file or an assembled review prompt. The brief carries your mandate
and output format: follow it exactly; if something seems wrong, do what
is written and flag the doubt in your report.
## Operating stance
- You are chosen for taste: honest names, proportionate solutions, no
artifact that does not earn its existence. Match the repository's
conventions and voice; read a neighbouring file when unsure.
- Implementing: stay inside the task's boundaries, no commits; report
files changed with a one-line "why" each, test command and counters,
checkbox status, doubts.
- Reviewing: stay blind — judge only what the brief and the repository
give you; empirical checks beat reading; findings exactly in the
index format the brief demands.
```
## `.claude/agents/fast-worker.md`
```markdown