From 10d0003e10145aec3cf6912744de60ae5459755f Mon Sep 17 00:00:00 2001 From: Dmitry Dementiev Date: Fri, 31 Jul 2026 17:18:30 +0300 Subject: [PATCH] =?UTF-8?q?docs(skills):=20=D0=BF=D0=BB=D0=B5=D0=B9=D0=B1?= =?UTF-8?q?=D1=83=D0=BA=20=E2=80=94=20=D0=BE=D0=B4=D1=91=D1=80=D0=B3=D0=B8?= =?UTF-8?q?=D0=B2=D0=B0=D0=BD=D0=B8=D1=8F=20=D0=B4=D0=BD=D1=8F=20=D0=BF?= =?UTF-8?q?=D1=80=D0=BE=D0=B3=D0=BE=D0=BD=D0=BE=D0=B2=20=D0=B2=20lessons:?= =?UTF-8?q?=20=D0=BF=D0=B5=D1=80=D0=B5=D1=87=D0=B5=D0=BD=D1=8C=20=D0=BC?= =?UTF-8?q?=D0=B5=D1=81=D1=82=20=D1=80=D1=83=D1=87=D0=BD=D0=BE=D0=B9=20?= =?UTF-8?q?=D0=BE=D1=81=D1=82=D0=B0=D0=BD=D0=BE=D0=B2=D0=BA=D0=B8=20=D0=BA?= =?UTF-8?q?=D0=BE=D0=BE=D1=80=D0=B4=D0=B8=D0=BD=D0=B0=D1=82=D0=BE=D1=80?= =?UTF-8?q?=D0=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Зачем. Фидбек пользователя после дня работы старой редакции с Opus 5-координатором — готовый список для следующего структурного захода, чтобы не потерялся. Что. Запись 2026-07-31 с четырьмя наблюдениями: повторное ревью отревьюенной постановки и переоценка сложности (правила есть — не держат; кандидат: перевернуть дефолт на opt-in), код Кодекса не для учеников (боевое подтверждение оси вкуса), вызов скилла ради механики субагентов вне конвейера (кандидат: отдельная лёгкая точка входа). Помечено открытым вопросом следующего захода. Проверка. Правка журнала, прогонять нечего. Co-Authored-By: Claude Fable 5 --- .../references/lessons.md | 38 +++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/agents/.agents/skills/claude-subagent-playbook/references/lessons.md b/agents/.agents/skills/claude-subagent-playbook/references/lessons.md index 157ee7e..38d90e8 100644 --- a/agents/.agents/skills/claude-subagent-playbook/references/lessons.md +++ b/agents/.agents/skills/claude-subagent-playbook/references/lessons.md @@ -542,3 +542,41 @@ compose down`); отдельных событий эскалации в `--json` `adversarial-reviewer` слит в `craftsman` (opus, medium — исполнение брифов: вкусовая реализация, слепое ревью, перепроверки); упоминание заготовки adversarial-reviewer в записях выше — история того дня. + +## 2026-07-31: одёргивания за день прогонов (Opus 5-координатор, старая редакция) + +Фидбек пользователя после дня работы со скиллом; ценно тем, что это +перечень мест, где координатора приходилось останавливать руками. + +1. **Повторное ревью отревьюенной постановки.** Координатор ревьюит + готовый тикет, уже прошедший ревью на этапе постановки. Правило + «одно ревью на версию артефакта» в этапе 2 ЕСТЬ (записано + 2026-07-21) — и не держит. Класс отказа тот же, что с вкусовой + линзой (запись выше): правило в прозе не исполняется, нужен + механизм — например, перед этапом 2 координатор обязан назвать, + какая версия тикета когда ревьюилась, и пропустить этап, если + версия не менялась. +2. **Переоценка сложности.** Полный цикл ревью там, где хватило бы + саморевью. Шкала риска этапа 4 есть — и тоже не держит: дефолт + скилла «полный состав минус пропуски» (opt-out), координатор + склонен к максимальной церемонии. Кандидат на следующий заход: + перевернуть дефолт — минимальный хребет (постановка → исполнитель → + саморевью → приёмка) + явные триггеры эскалации (opt-in); добавить + слой дешевле, чем отменить запущенный. +3. **Код Кодекса нельзя показывать ученикам.** Формально задачу решает + хорошо, но «не хочу их учить так писать» — это не дефект кода, это + дефект назначения исполнителя. Боевое подтверждение оси вкуса, + принятой этим же днём: в учебном репозитории почти всё читает + человек → почти вся реализация уходит `craftsman`'у, Codex — на + обвязку и инфраструктуру. Проверить следующим прогоном, снимает ли + новый разрез эту боль. +4. **Скилл зовут ради механики субагентов, не ради конвейера.** + Регулярный сценарий: дать агенту знание «субагенты существуют, вот + как их звать» для специальной задачи — а вызов тянет весь конвейер. + Это отдельная ветка использования: дисциплина делегирования (Роли, + определения, файлы-вместо-пересказов) полезна вне цикла разработки. + Кандидат: выделить её в лёгкий скилл или отдельную точку входа, + чтобы «субагентная грамотность» не стоила 300 строк процесса. + +Пункты 1–2 и 4 — открытый вопрос следующего структурного захода (сегодняшний +рефакторинг закрыт коммитом 3e0498e, не расширять задним числом).