0 Fork 0

Files

T

Dmitry Dementiev 28f9e6fdd9 docs(skills): урок про запрет-значение и подъём скретчпада

- Зачем:
  - три случая одной формы за месяц: правило стоит на месте, а
    рассуждение берёт себе исключение — отказ стоит описать до того, как
    он повторится в четвёртый раз.
- Что:
  - запись 2026-08-04 в lessons.md: песочница ревьюера и лечение
    значением, восстановление скретчпада из транскрипта сессии с ценой
    и границами приёма, диагноз владельца про краткость исполнителя.
  - третий открытый вопрос handoff'а закрыт решением владельца и заменён
    ссылкой на журнал.
- Проверка:
  - git log --oneline c18472e.. ; новых строк длиннее 80 символов нет.

2026-08-04 21:53:40 +03:00

6.9 KiB

Raw Blame History

Handoff разработки скилла: холодное ревью правок и лечение находок

Дата: 2026-08-03/04. Контекст: не боевой прогон, а заход на сам скилл. Начали под /writing-great-skills (разбор references/lessons.md), закончили под /brainstorm-with-docs (холодное ревью и триаж находок). Диапазон коммитов — от c18472e; список даёт git log --oneline c18472e... Здесь только то, чего в них нет.

Холодное ревью: как было устроено и что от него осталось

Две слепые линии по доктрине самого плейбука: Codex gpt-5.6-sol (high, свежий тред) — исполнимость механик; свежий craftsman — уместность инструкций. Обе получили один параметрический блок с порядком риска, мандат из prompts/review-boilerplate.md, и не знали ни друг о друге, ни о рассуждениях автора правок. Итог: 19 находок, пересечение — 3 темы; обе линии CHANGES_REQUIRED. Codex — 90 выполненных команд, дерево после ревью чистое.

Промпты и индексы находок лежали в скретчпаде сессии и не переживут её. Всё, что не закрыто, перенесено сюда.

Открытые вопросы к владельцу (не правки)

Две копии определений субагентов (FIT-3). references/claude-agents.md (заготовки) и .claude/agents/*.md (созданы коммитом f650451). Сегодня совпадают, главная не названа. Расхождение будет тихим: ступень оркестратор читает из первого, харнесс — из второго.
Вкусовую линию нечем эскалировать (FIT-10). craftsman пришит к medium, единственный более сильный Опус (deep-reasoner) описан только как временный фолбэк при отсутствии craftsman. Разрыв рангов «Опус medium против Кодекса high» назван в lessons.md причиной, ради которой правились шапки триажа. Вопрос: заводить ли craftsman ступенью выше. Третий вопрос — про случай с песочницей — решён 2026-08-04: записан в lessons.md вместе с двумя прежними случаями той же формы.

Находки, оставленные сознательно

Всего было 19: 12 по линии уместности (FIT-*) и 7 по технической (TECH-*). Закрытые читаются по коммитам диапазона; ниже — открытые, с номером и доводом, потому что сами индексы живут в скретчпаде и умирают вместе с сессией.

TECH-3, отклонена с доводом: гонка между проверкой отчёта и wc в стороже — микросекунды, а STALLED по тексту и так повод посмотреть, а не вердикт.
FIT-4, решение владельца: prompts/triage-header.md, «прогон без единого отклонения — повод перечитать принятое на веру». Довод линии: базовая статистика отдана тому, кто видит ровно один прогон, и даёт постоянный повод переоткрывать уже принятое; предлагалось оставить целевое поведение без статистического обоснования. Текст согласован с владельцем 2026-08-03, линия этого не знала.
FIT-11, оставлена после спора: девять строк обоснования переименования встали между сборочным блоком и обёрткой вызова в prompt-templates.md. Оставлено намеренно: именно это обоснование удерживает следующего от «упрощения» имён обратно.
FIT-12, оставлена после спора: craftsman.md открывается стойкой исполнителя («follow it exactly»), тогда как агента зовут и на слепое ревью. Территория пользователя.

Не обкатано боем — проверить первым же прогоном

Новые имена обменных файлов: review-spec-* (этап 2), review-impl-* (этап 4), логи ревьюера тоже несут этап. Осторожно: task/code — это линии этапа 4, а не этапы; на этом уже ошиблись один раз, предупреждение стоит в prompt-templates.md.
Второй вердикт перепроверки PROPORTIONATE | OVERREACH и его вынос в финальную строку RECHECK:.
Сторож зависшего треда: пара REPORT/LOG подставляется от страхуемой ветки. Проверен только симуляцией четырёх исходов.
Рецепт ветки ревьюера целиком (появился 2026-08-03) с пином high и --strict-config на resume.
Шапки триажа и перепроверки в целом: правились ради того, чтобы исполнитель не брал ревью на веру. Мерка простая — за три прогона до правки было ноль отклонений находок.

Suggested skills

claude-subagent-playbook — если завтра боевой прогон по тикету.
writing-great-skills — если продолжаем править сам скилл: оптика этой сессии (дублирование, осадок, разрастание, запрет против значения) вся оттуда.
conventional-commits — обязателен перед любым коммитом.
brainstorm-with-docs — для открытых вопросов выше: они решения, а не правки.

6.9 KiB Raw Blame History