Commit Graph
176 Commits
Author SHA1 Message Date
Dmitry DementievandClaude Opus 5 345caa01ba docs(skills): handoff сессии холодного ревью плейбука
- Зачем:
  - индексы находок и промпты обеих слепых линий жили в скретчпаде
    сессии и её не переживут; открытые вопросы и неотработанные боем
    механики надо было вынести в долговечное место рядом с прежними
    handoff'ами скилла.
- Что:
  - добавлен handoffs/20260803-kholodnoe-revyu-skilla-i-pravki.md:
    устройство холодного ревью, три вопроса к владельцу, находки
    оставленные сознательно (с доводами), пять пунктов «не обкатано
    боем» и список подсказанных скиллов.
  - содержимое коммитов не дублируется — диапазон назван ссылкой
    c18472e..HEAD.
- Проверка:
  - строки ≤80 символов, объём сопоставим с соседними handoff'ами.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-04 00:22:43 +03:00
Dmitry DementievandClaude Opus 5 a794d240d7 fix(skills): три хвоста холодного ревью — эффорт, архив, висячий указатель
- Зачем:
  - в буллете про эффорт одна и та же ситуация предписывалась дважды:
    `high` за нетривиальную реализацию и тут же `medium` за неё же по
    отревьюированному тикету. При вчерашнем сжатии разрешение 07-21
    превратилось в правило равного ранга.
  - архив уроков оставался связан ссылкой прямо из живого этапа 3, хотя
    его шапка объявляет файл вне пути прогона: 549 строк устаревших
    правил в одном клике от исполняющего агента.
  - после разреза уроков в записи 07-31 осталось «запись выше» про
    вкусовую линзу — сама запись уехала в архив.
- Что:
  - разрешение 07-21 помечено исключением и вернуло слово «допустима».
  - ссылка на архив в SKILL.md заменена ссылкой-цитатой (запись
    2026-07-06); живых markdown-ссылок на архив вне уроков не осталось.
  - висячий указатель в lessons.md получил адрес: запись 2026-07-31 в
    архиве.
- Проверка:
  - grep по markdown-ссылкам архива: остались только шапка lessons.md и
    библиография codex-sandbox-apparmor.md; все ссылки скилла резолвятся.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-04 00:18:20 +03:00
Dmitry DementievandClaude Opus 5 f481831777 fix(skills): песочница ревьюера задана значением, а не запретом
- Зачем:
  - запрет «read-only ревьюеру не режь» стоял в двух местах и всё равно
    был нарушен при сборке команды для холодного ревью этой же сессии:
    отступление обосновали тем, что у ревью документа руки не нужны.
    Третья копия запрета делу не помогла бы — нужен не запрет, а
    отсутствие выбора.
- Что:
  - правило переписано значением: песочница ревьюера — workspace-write,
    как у исполнителя; линии различает свежесть треда и мандат, а не
    привилегия. Оговорка про руки ушла внутрь обоснования, и там же
    сказано, что ревью документа не исключение.
  - добавлена строка, что ветка та же для любого слепого ревью — кода,
    постановки, документа, самого скилла: рецепт копируют целиком, линзу
    задают файлом линии. Повод собирать команду руками снят.
- Проверка:
  - рецепт ветки ревьюера содержит -s workspace-write и штатную связку
    approval_policy/approvals_reviewer; прочитан целиком после правки.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-04 00:16:02 +03:00
Dmitry DementievandClaude Opus 5 78ee8bfa48 fix(skills): сторож зависшего треда развязан с веткой исполнителя
- Зачем:
  - сторож был зашит на task-result.md и task-stdout.jsonl, то есть на
    артефакты этапа 3. На ревью и на починке отчёт исполнителя уже лежит
    рядом, цикл не делал ни одного тика и выходил молча — страховка
    отсутствовала ровно там, где прогон длиннее всего.
  - отсутствующий лог был неотличим от неростущего: `|| echo 0` выдавал
    ноль два тика подряд, и неверный путь читался как застой.
- Что:
  - пара файлов вынесена в переменные REPORT и LOG первой строкой, с
    указанием подставлять их от страхуемой ветки.
  - отсутствие лога стало отдельным сигналом NOLOG (редирект создаёт лог
    сразу, так что через тик его не быть не может).
  - дописано, что выход из цикла снимает страховку: после STALLED сторож
    перезапускают руками.
  - поправлено описание ловушки bfs: он ругается в stderr, а пустым
    отдаёт только stdout — «молча» было неверно.
- Проверка:
  - симуляция четырёх исходов: штатное завершение, зависание, неверный
    путь к логу (NOLOG) и ветка ревью при лежащем рядом отчёте этапа 3 —
    последняя как раз и не работала до правки.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-04 00:14:23 +03:00
Dmitry DementievandClaude Opus 5 05336325db fix(skills): вердикт перепроверки о лечении получил ячейку в формате
- Зачем:
  - вчера в шапку перепроверки дописано требование судить лечение, а
    места под ответ в формате строки нет: перетянувшая правка, которая
    находку закрывает, не ложится ни в CLOSED, ни в NOT_CLOSED, ни в
    статусы отклонения. Обе линии холодного ревью нашли это независимо,
    и тот же долг записан в lessons.md:99-102 («статус вешается на
    находку, не на лечение; механизма по-прежнему нет»).
  - оговорка про «размен свойства на защиту от умысла» обобщила один
    случай на весь класс безопасности — защита от умысла и есть этот
    класс.
- Что:
  - в спецификацию строки добавлен второй вердикт для ID со статусом
    FIXED: PROPORTIONATE или OVERREACH с указанием, что вышло за
    находку; OVERREACH не переводит прогон в ISSUES_REMAIN.
  - оговорка про NOT_CLOSED вернулась к взвешиванию цены и получила
    границу: так закрываются инварианты своего кода, но не находки про
    доступ, данные и деньги.
  - OVERREACH выносится в финальную строку, а prompt-templates.md
    разрешает читать файл перепроверки и по нему — иначе сообщение
    наверх не дошло бы: файл читается только при ISSUES_REMAIN.
- Проверка:
  - FIXED сверен с вокабуляром triage-header.md; статусы перепроверки
    и условие чтения файла согласованы между тремя файлами.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-04 00:04:57 +03:00
Dmitry DementievandClaude Opus 5 5fa98d4d0b fix(skills): имена вердиктов переименованы на ось этапа, не линии
- Зачем:
  - вчерашнее переименование `review-<task|code>-*` встало на неверную
    ось: `task` и `code` — это две линии этапа 4 (уместность и дефекты),
    а не этапы. Межэтапная коллизия, ради которой всё делалось, осталась
    открытой: у ревью постановки имени вердикта не было вовсе.
  - сборка триажа при этом называла оба вердикта «линия code», хотя один
    из них — вердикт линии уместности.
- Что:
  - вердикты и параметрический блок этапа 4 — `review-impl-*`, этапа 2 —
    `review-spec-*`; общий блок снова один на обе линии этапа.
  - логи ревьюера тоже несут этап (`review-impl-stdout.jsonl`) — раньше
    этап 4 молча затирал лог этапа 2, единственное доказательство для
    проверки «вердикт без находок: работа или отписка».
  - в prompt-templates.md названы имена файлов этапа 2 и добавлено
    предупреждение, что `task` — линия уместности, а не постановка.
  - SKILL.md этапа 5 показывал `вердикт-A.md вердикт-B.md`; заменено на
    реальные имена, комментарий в рецепте ревьюера исправлен.
- Проверка:
  - grep по обменным именам: старых не осталось вне уроков, новые
    согласованы между SKILL.md, prompt-templates.md и codex-exec.md.
  - все markdown-ссылки скилла резолвятся.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-03 23:52:49 +03:00
Dmitry DementievandClaude Opus 5 abc00a06be refactor(skills): codex-exec переразобран, имена вердиктов по этапам
- Зачем:
  - рецепт Кодекса читают в момент сборки команды; пересказы, хеджи и
    копии уроков внутри него дают место для импровизации — прогон
    2026-07-30 взял `danger-full-access` «на всякий случай» при верном
    рецепте.
  - вердикты звались по семейству (`review-codex.md`), а Codex ревьюирует
    и постановку, и код в одном `$D` — упавший этап 4 оставлял файл этапа
    2, и триаж молча чинил по чужому вердикту.
- Что:
  - codex-exec.md: удалены копия урока про эффорт (экономика xray, казус
    `.dgst`), причинная механика bwrap, повтор про companion и битая
    ссылка «в уроках ниже»; три пересказа эскалации сведены в один;
    ветка ревьюера стала полноценным рецептом; правила одной ветки
    переехали в свои ветки.
  - codex-exec.md: сторож зависшего треда — признак жизни это рост
    stdout.jsonl, а не статус (урок 2026-07-07 в рецепт не доезжал).
  - prompt-templates.md: имена вердиктов и параметров несут этап —
    `review-<task|code>-<codex|claude>.md`, `review-<этап>-params.md`.
  - model-matrix.md: критерий «цена тихой ошибки этапа» стал единым
    источником, claude-agents.md и codex-exec.md на него ссылаются.
  - lessons-archive.md: датированное уточнение — ключи `resume` сверены
    на 0.145.0, `-m`/`-o`/`--json` доступны вопреки записи 2026-07-21.
- Проверка:
  - сверка 51 клаузы по инвентарю (scratchpad), 24 ключевые — grep'ом;
    все markdown-ссылки скилла резолвятся.
  - сторож прогнан на симуляции трёх исходов: штатное завершение,
    зависание на середине, смерть без отчёта.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-03 23:15:31 +03:00
Dmitry Dementiev 8218a211b4 refactor(skills): claude-subagent-playbook — старые уроки вынесены в архив
- Зачем:
  - lessons.md вырос до 830 строк, и записи до рефакторинга 31 июля
    описывают другую редакцию скилла — прежнюю эффорт-карту, другой
    состав ролей, заготовку adversarial-reviewer, которой больше нет.
- Что:
  - записи с 2026-07-06 по «казусы координации» 2026-07-31 перенесены в
    references/lessons-archive.md без изменений; живой файл сократился с
    830 до 300 строк.
  - шапка lessons.md объясняет разрез и как двигать границу дальше;
    архив вне пути чтения прогона, ссылка на него только из lessons.md.
  - три указателя на переехавшие записи переведены на архив: казус
    форвардера в SKILL.md и codex-exec.md, sandbox-инцидент в
    codex-sandbox-apparmor.md.
- Проверка:
  - все markdown-ссылки скилла разрешаются в существующие файлы.
2026-08-03 22:08:08 +03:00
Dmitry Dementiev 9642910194 fix(skills): claude-subagent-playbook — правила запуска Кодекса по месту
- Зачем:
  - два отказа вызова из прогона #39 повторялись оттого, что правило
    лежало не там, где собирают команду: -s дописывали в resume по
    образцу exec, а < /dev/null закрывал вход у вызова, который сам
    получает промпт через stdin.
- Что:
  - в codex-exec рецепт resume снабжён строкой о том, что среда треда
    задана при создании, а перечень ручек хода уточнён по проверке на
    codex-cli 0.145.0.
  - к правилу «промпт через stdin» добавлено, что вход этого вызова
    должен оставаться открытым.
  - в SKILL.md этап 6 правило < /dev/null сужено условием «фоновой
    команде, которой нечего читать со входа».
  - в lessons исправлен неверный хвост записи #39 про смену песочницы
    ключом -c sandbox_mode.
- Проверка:
  - codex exec resume <любой-id> -s workspace-write → exit 2.
  - echo "say hi" | codex exec - < /dev/null → No prompt provided via stdin.
2026-08-03 21:48:29 +03:00
Dmitry Dementiev 36fc76ff90 feat(skills): claude-subagent-playbook — исполнитель не берёт ревью на веру
- Зачем:
  - после разворота ролей (реализация Опусом, ревью Кодексом) ревьюер
    продавливает исполнителя формальными решениями: за прогоны #39, #40 и
    #50 около 28 находок и ноль отклонений.
- Что:
  - в triage-header добавлен блок «ревью — свидетельство, а не приказ»:
    отклонение равноправно починке, маршрут ревьюера — предложение.
  - определение NEEDS_DECISION расширено случаем, когда выбор делает сама
    починка, независимо от объёма правки.
  - в recheck-header добавлен суд над лечением: перебор — тоже дефект, а
    NOT_CLOSED требует существующего закрывающего состояния и цены
    альтернативы.
  - в lessons закрыт долг четырёх прогонов и сведена очередь на механизм.
- Проверка:
  - следующий полный прогон плейбука: в триаже должны появиться
    отклонения или закрытия своим маршрутом с доводом.
2026-08-03 21:38:37 +03:00
Dmitry Dementiev c18472e360 docs(skills): claude-subagent-playbook — эмпирика #40 и #50
- Зачем:
  - две записи прогонов остались незакоммиченными; без них теряется фактура,
    ради которой журнал и ведётся, — и повторяющийся долг скилла нечем
    подтвердить.
- Что:
  - запись по #40: шапки соразмерности лечения сработали в третий раз;
    пересечение слепых линий — одно явление, описанное двумя способами.
  - запись по #50: сломанный прибор доезжает до коммита — ошибка измерения
    всплыла трижды на трёх уровнях, и ни разу её не поймал тот, кто мерил.
  - там же уточнение наблюдения владельца про дрейф Кодекса к букве и
    кандидат в механизм; долг с шапками отмечен четвёртым прогоном подряд.
- Проверка:
  - git show --stat; записи читаются как фактура для доработки скилла.
2026-08-02 23:02:32 +03:00
Dmitry DementievandClaude Opus 5 f758e1f802 docs(skills): claude-subagent-playbook — эмпирика #39: суд над лечением
Зачем: два прошлых прогона оставили долг — статус вешался на находку, а
лечение проезжало без суда. В прогоне #39 долг закрыт шапками триажа и
перепроверки, и это стоит помнить вместе с ценой: ручку пришлось собирать
руками в каталоге прогона.

Что: секция от 2026-08-02 про тикет #39 — как сработала ручка соразмерности
(трижды за прогон), почему «10 FIXED, 0 REJECTED» не доказательство, зачем
проверять единственный MAJOR своим зондом при тонком логе перепроверки, и два
отказа вызова Кодекса: закрытый stdin убивает промпт, а `codex exec resume`
не принимает `-s`.

Проверка: чтением; правка только в lessons.md, поведение скилла не менялось.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-02 15:52:29 +03:00
Dmitry Dementiev 7377ee94c5 docs(skills): claude-subagent-playbook — эмпирика #38: перепроверка и прибор
- Зачем:
  - прогон тикета #38 повторил конфигурацию 08-01 (оркестратор он же
    исполнитель, Кодекс третьей линией) и показал у той же дыры вторую
    сторону, а заодно класс сбоя, которого в файле не было.
- Что:
  - перепроверка тем же ревьюером не судит соразмерность лечения ни в
    одну сторону: после ALL_CLOSED на своё предписание — NOT_CLOSED с
    требованием недостижимого; приём — проверять существование
    закрывающего состояния и мерить цену альтернативы.
  - долг 08-01 назван неисправленным: статус вешается на находку, не на
    лечение; здесь лечение судилось только по требованию владельца.
  - новый класс: сломан не код, а измерительный прибор — устаревший .pyc
    в цикле мутаций; линии ревью такого не ловят.
- Проверка:
  - запись прочитана целиком, повторов предыдущих записей нет.
2026-08-02 13:29:46 +03:00
Dmitry DementievandClaude Opus 5 95c13211cb docs(skills): claude-subagent-playbook — эмпирика прогона: триаж и лечение
Прогон 2026-08-01 (clickstream v2, тикет #36) дал редкую конфигурацию:
оркестратор и есть исполнитель, плейбук позвали третьей линией поверх
готовой работы. Отсюда три факта для будущих доработок: триаж судит
находку, но не лечение; NEEDS_DECISION не сработал, потому что дешевизна
починки замаскировала, что это решение чужого слоя; перепроверка тем же
ревьюером перебор в лечении не ловит структурно. Записано фактами, правки
самого скилла не делались.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-01 23:30:08 +03:00
Dmitry DementievandClaude Opus 5 202cbdb0d7 docs(skills): brainstorm-with-docs — hot и cold review названы в самом скилле
Скиллом пользуются не только на машинах с глобальным словарём — он должен
быть самодостаточным. Шаг 7 называет перечитывание hot review с глоссой
оси (полный контекст автора: дёшево, но слепота общая), stop_condition
предлагает cold review свежей сессией как следующий шаг при высоких
ставках. Тёплое ревью не внесено: скилл им не пользуется.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-01 19:16:03 +03:00
Dmitry DementievandClaude Opus 5 9ce4c6f769 docs(skills): brainstorm-with-docs — перечитывание реагирует по уровню находки
Текстовые огрехи горячее ревью правит молча по месту; находку уровня
решений (противоречие, дыра в охвате) предъявляет владельцу, не исправляя
и не замалчивая. Довод владельца: текстовые находки видны и неопасны, а
противоречия при перечитывании не раз оказывались важными — плоский запрет
переоткрывать решения заставлял бы молчать или чинить мимо владельца.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-01 19:12:59 +03:00
Dmitry DementievandClaude Opus 5 a95dc7988e docs(skills): brainstorm-with-docs — шов self_review развязан двумя ярусами
Самопроверка уехала до записи и работает по плану артефакта (уровень
решений; может вернуть в интервью, пока файла нет) — сверено с апстримом
Мэтта: валидация до записи, запись линейна. После записи — дешёвое
перечитывание готового файла глазами читателя, правки по месту, решения
не переоткрываются. Критерий конца интервью оставлен мягким (решение
владельца, в Rejected), версионный хвост в шаблоне context.md вычищен.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-01 18:59:42 +03:00
Dmitry DementievandClaude Opus 5 d10ad6981c docs(skills): brainstorm-with-docs — правки по холодному ревью
README перестал объявлять скилл ручным: model-invocation — намеренное
текущее состояние (триггер — форма задачи, не область). Жёсткий гейт
получил исключение для глоссария (спорил с шагом 4) и стал единственным
владельцем запрета на реализацию; дубли правил схлопнуты к владельцам.
Отложенные находки (шов self_review, критерий конца интервью, версионные
пометки в шаблонах) — в Pending decisions ROADMAP.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-01 18:40:38 +03:00
Dmitry DementievandClaude Opus 5 e3021ce372 docs(skills): brainstorm-with-docs — дивергенция v2: веер, развилки, маршрутизация
Приземлён блок дивергенции из ROADMAP по итогам второго живого теста
(wayfinder-карта #26 стенда): шаг 5 разделён на веер и конвергенцию,
ширина веера — по весу решения, развилки решаются по месту в интервью.
Триггер «развилка» в description; описание и правила подрезаны по ревью
writing-great-skills. Свидетельства и доводы — в ROADMAP.md.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-01 18:30:32 +03:00
Dmitry DementievandClaude Fable 5 10d0003e10 docs(skills): плейбук — одёргивания дня прогонов в lessons: перечень мест ручной остановки координатора
Зачем.
Фидбек пользователя после дня работы старой редакции с Opus 5-координатором —
готовый список для следующего структурного захода, чтобы не потерялся.

Что.
Запись 2026-07-31 с четырьмя наблюдениями: повторное ревью отревьюенной
постановки и переоценка сложности (правила есть — не держат; кандидат:
перевернуть дефолт на opt-in), код Кодекса не для учеников (боевое
подтверждение оси вкуса), вызов скилла ради механики субагентов вне
конвейера (кандидат: отдельная лёгкая точка входа). Помечено открытым
вопросом следующего захода.

Проверка.
Правка журнала, прогонять нечего.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-31 17:18:30 +03:00
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
Dmitry DementievandClaude Opus 5 6070810c2d docs(skills): плейбук — под «родословной» ехали два механизма
Зачем.
Разговор о том, кому отдавать вкусовую линию ревью, упирался в ложный
выбор между независимостью и компетентностью. Причина — склейка: различие
семейств нужно для покрытия классов ошибок, свежая сессия для
независимости от рассуждений автора, а называлось это одним словом.

Что.
Заметка в открытый вопрос о рефакторинге: два основания назначения линий,
названная плата и указание решить при рефакторинге, переносить ли это в
этап 4 и эффорт-карту. В репозитории стенда решение уже принято.

Проверка.
Правка документации, прогонять нечего.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-31 15:37:40 +03:00
Dmitry DementievandClaude Opus 5 59e9c0787e docs(skills): плейбук — заметки к рефакторингу: ось вкуса и набор запахов
Зачем.
Прогон #18 показал, чего не хватает: обе наши ручки выбора (эффорт,
модель) про силу, вкус ими не выражается. Решения приняты, но структурные
правки скилла отложены — чтобы не потерялись, они записаны в открытый
вопрос, который читается при следующем заходе.

Что.
- Третья ось выбора: разрез по подзадачам на этапе планирования, вкусовое
  Опусу, руки Кодексу, ось ревью переворачивается. С требованием спросить
  у пользователя матрицу и примеры.
- Набор запахов Фаулера из /code-review Мэтта Покока — сильнее самодельных
  примеров в блоке Taste; оттуда же правило не сливать находки двух осей.
- Разбор журнала Codex-ревьюера: восстановление стенда ловушкой без
  проверки, самовольные subagent-ы вопреки правилу «глубина один».

Проверка.
Правка документации, прогонять нечего.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-31 15:21:10 +03:00
Dmitry DementievandClaude Opus 5 4f19cce325 docs(skills): плейбук — цифры и урок прогона #18 в lessons
Зачем.
Запись о прогоне была без раздела «Цифры», которого требует конвенция
файла, и без урока, ради которого прогон и запомнился.

Что.
- Цифры прогона #18: находки по линиям, приёмка на чистых томах.
- Урок: проверка, зелёная из терминала, может виснуть навсегда под
  фоновым запуском — приёмка оркестратора нашла то, чего не нашли обе
  линии ревью.

Проверка.
Правка документации, прогонять нечего.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-31 14:11:40 +03:00
Dmitry DementievandClaude Opus 5 6e67ccc1df docs(skills): плейбук — вкусовая линза ревьюера доведена до механизма
- Зачем:
  - решение 2026-07-23 «в линзу Клод-ревьюера — осмысленность кода» жило только в уроках и в памяти другого проекта, в заготовки промптов не попало: прогон #18 собрал старую линзу, и ревьюер не был обязан спрашивать, не дичь ли решение.
  - общий вывод прогона: решение, записанное только в уроки, следующим прогоном не исполняется — ехать может лишь механизм, который подшивается в промпт.
- Что:
  - prompt-templates.md: в заготовку line-task.md добавлен блок Taste — формально верное, но по сути неправильное считается находкой, три примера и правило оценки серьёзности по цене жизни с кодом; разрез по родословной переведён с цитаты фразы на именованный блок.
  - SKILL.md: описание линии «по задаче» больше не расходится с заготовкой — названа уместность решения и дана отсылка за точными словами.
  - lessons.md: две датированные записи (вкусовая линза; казусы координации прогона #18) и открытый вопрос о рефакторинге заготовок линий.
- Проверка:
  - слепое ревью правок Опусом по критериям /writing-great-skills: CHANGES_REQUIRED, 5 MAJOR — сокращение списка примеров, ведущее слово, разрез блоком, устаревшая копия в SKILL.md; все замечания по своим правкам закрыты, структурные вынесены в открытый вопрос по решению пользователя.
  - подтверждено ревью: расширение линзы не пустышка — прежний текст был целиком про соответствие постановке.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-31 13:36:33 +03:00
Dmitry DementievandClaude Fable 5 ef09a7832b docs(skills): плейбук — уроки боевого прогона тикета #12 по песочнице Codex
- Зачем:
  - боевой прогон 2026-07-30 (тикет #12 v2) закрыл открытый вопрос: расширенный доступ Codex не нужен, штатной связки достаточно.
- Что:
  - codex-exec.md: пункт про блок классификатора начинается с проверки песочницы; в рецепт исполнителя добавлено «шире не бери»; снят кавеат «боем не обкатано» — сеть и docker-сокет работают при штатной связке on-request + auto_review.
  - lessons.md: датированный урок 2026-07-30 с дополнением по итогам прогона.
- Проверка:
  - чтение обновлённых разделов; факты — из JSONL-логов прогона тикета #12 (docker manifest inspect и make up завершились completed под workspace-write).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-30 20:54:36 +03:00
ddadminandClaude Opus 5 357896faaa docs(skills): эффорт-карта субагентов пересчитана под Opus 5
- Зачем:
  - скилл писался под Opus 4.8; у Opus 5 усилия распределены иначе, high —
    верхняя рабочая ступень, xhigh дефолтить смысла нет.
- Что:
  - карта в SKILL.md сдвинута на ступень вниз (high — ревью постановок,
    medium — слепое ревью и узкие перепроверки, default — механика),
    нижняя граница ревью опущена с high до medium.
  - добавлены оговорки: неравномерность сдвига, deep-reasoner остаётся на
    high, механика едет на Sonnet и эффорт там не крутится.
  - в lessons.md записано решение 2026-07-26, помечена как пересмотренная
    запись 2026-07-21 и заведён открытый вопрос: чем координатор вообще
    выставляет effort (у Agent-тула такого параметра нет).
  - пункт про вспомогательных субагентов переписан активно: нет в репо —
    предложить создать по заготовке и работать ими.
- Проверка:
  - git diff HEAD~1 -- agents/.agents/skills/claude-subagent-playbook/;
    сверить, что xhigh в SKILL.md больше не упоминается.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-26 19:06:01 +03:00
ddadmin 051801efbe docs(skills): добавлен урок о taste-слепоте триажа в claude-subagent-playbook
- Зачем:
  - зафиксировать наблюдение: codex на триаже закрывает находки контрактными тестами с цитатами прозы, что формально корректно, но создаёт хрупкий мусор.
- Что:
  - записано решение пользователя: добавлять осмысленность кода в линзу Claude-ревьюера, срезание бессмысленного кода поручать Опусу, перепроверку после триажа давать линзе, видящей дифф целиком.
  - отмечен попутный эффект: образец заражает — легаси-жанр «тест на фразу README» подлежит чистке отдельным issue.
- Проверка:
  - git log --oneline -1
2026-07-23 15:02:42 +03:00
ddadmin 9d825cfca3 fix(skills): отключена блокировка auto-invoke для brainstorm-with-docs
- Зачем:
  - навык должен автоматически вызываться по описанию, а не только вручную.
- Что:
  - удалена опция disable-model-invocation: true из frontmatter.
- Проверка:
  - git diff — изменения только в SKILL.md.
2026-07-23 12:23:09 +03:00
ddadmin 3923894c06 chore(skills): обновлён .gitignore для навыков
- Зачем:
  - привести игнор-список в соответствие с текущим набором навыков.
- Что:
  - добавлен игнор для find-skills/.
  - исправлены записи claude-team-review и adversarial-review (убраны лишние слеши).
- Проверка:
  - git status — изменён только .gitignore.
2026-07-23 12:22:21 +03:00
ddadminandClaude Fable 5 c4c37d37b0 docs(skills): указатель на кавеат effort в возможностях хоста
- Зачем:
  - раздел «Возможности хоста» обещает reasoning_effort в схеме
    spawn_agent, а кавеат о его неприменении жил двумя разделами ниже —
    координатор поверил бы в ручку, которой сейчас нет.
- Что:
  - в пункт «Управляемая стоимость» добавлена ссылка на кавеат в
    «Выборе уровня».
- Проверка:
  - перечитка roles.md свежим взглядом после сверки близнецов.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-23 10:55:13 +03:00
ddadminandClaude Fable 5 eb0d52ef57 docs(skills): взаимообогащение близнецов-плейбуков после сверки
- Зачем:
  - близнецы развивались порознь и разошлись: проверенные боем правила
    клодовского плейбука отсутствовали в кодексовом, и наоборот; промах
    скиллом 2026-07-22 показал цену дрейфа.
- Что:
  - в кодексовый: одно ревью на версию артефакта, саморевью исполнителя и
    сквозная проверка до внешних линий, «Партнёр в петле», цена тихой
    ошибки как критерий уровня (заменой, класс задачи — иллюстрация),
    проверка внешних фактов первоисточником, кавеат про неработающий
    reasoning_effort субагентов;
  - в клодовский: «Пределы параллельности» (обратная пара), карта
    прогресса поглощена в «Пользователь в петле», автовызов моделью
    (описание с триггерами вместо disable-model-invocation);
  - lessons обоих: датированные записи сверки, урок 07-13 сжат до
    указателя.
- Проверка:
  - перечитка диффа свежим взглядом; следующий прогон конвейера — по
    автовызванному claude-subagent-playbook.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-23 10:51:58 +03:00
ddadminandClaude Fable 5 8312ef071e fix(skills): уроки прогона 2026-07-22 перенесены в клодовский плейбук
- Зачем:
  - вчерашний патч 43a93cd лёг не в тот скилл: уроки клодовского
    координатора попали в codex-subagent-playbook — близнец для
    координатора на стороне Codex; там «канал codex exec» — бессмыслица,
    а правила канала давно живут в claude-subagent-playbook/codex-exec.md.
- Что:
  - codex-subagent-playbook: три файла возвращены к состоянию до 43a93cd;
    во фронтматтер добавлен disable-model-invocation и адресное описание
    против повторного промаха;
  - claude-subagent-playbook: запись прогона issue #5 в lessons.md (чужой
    скилл, плагин вместо CLI, два писателя, приёмочный сценарий);
    в SKILL.md — владение деревом после остановки прежнего владельца и
    проверка команд приёмки на живом объекте.
- Проверка:
  - git diff 43a93cd^ по трём файлам codex-плейбука — только фронтматтер;
    перечитка lessons.md на связность.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-23 10:43:14 +03:00
ddadminandClaude Fable 5 43a93cd3c3 docs(skills): codex-playbook — канал командной строки и уроки прогона
- Зачем:
  - боевой прогон 2026-07-22 (конвейер issue #5 в демо-стенде) прошёл
    через плагин-обёртку Codex и воспроизвёл её известные баги; ресёрч
    2026-07-07 давно рекомендовал прямой CLI, но в скилл не был поглощён.
- Что:
  - roles.md: третий режим «Канал командной строки» — codex exec фоном
    у координатора, resume треда, плагин только для интерактива;
  - SKILL.md: передача владения только после остановки прежнего
    владельца; проверка команд сценария на живом объекте до прогона;
  - lessons.md: два датированных наблюдения 2026-07-22, вопрос №9
    переориентирован на проверку CLI-канала боем.
- Проверка:
  - перечитка трёх файлов на связность и отсутствие дублей;
    следующий прогон конвейера — по CLI-каналу.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-23 00:06:57 +03:00
ddadmin db0c3aff09 chore(agents): перенесены правила .gitignore для внешних плагинов skills
- Зачем:
  - правила для внешних плагинов теперь хранятся локально, в самой директории skills.
- Что:
  - в корневом .gitignore правила claude-team-review/adversarial-review заменены на .skill-lock.json.
  - в agents/.agents/skills/.gitignore добавлены claude-team-review/ и adversarial-review/.
- Проверка:
  - git status не показывает untracked файлы skills-плагинов.
2026-07-22 04:10:08 -04:00
ddadmin fd8210db71 test(xray-proxy): добавлена полная проверка Python 3.8
- Зачем:
  - требовалось подтвердить нижнюю версию Python и исключить переполнение /tmp тестовыми данными.
- Что:
  - добавлен полный прогон под системным Python и CPython 3.8 через uv.
  - исправлены переносимость тестового Xray, уборка временных файлов и документация задачи 05.
  - добавлен список локальных навыков, исключаемых из Git.
- Проверка:
  - bash tests/test_xray_proxy_full.sh.
2026-07-21 07:52:58 -04:00
ddadmin 92cf3397da chore(sync): слиты изменения плейбука из origin/master
- Зачем:
  - в origin/master опубликованы правила разбиения задач и ревью постановки.
- Что:
  - объединены правила /to-tickets и шкала ревью с локальной картой effort.
  - сохранены уроки headless-xray-proxy и yantar-dags.
- Проверка:
  - выполнены трёхсторонняя сверка SKILL.md и git diff --cached --check.
2026-07-21 07:12:58 -04:00
Dmitry Dementiev 6fbe8f6be1 docs(skills): в плейбук субагентов встроено разбиение /to-tickets и шкала ревью постановки
- Зачем:
  - прогон предразметки показал два сбоя: тикеты созданы мимо критериев /to-tickets, а текст тикета трижды проходил через контекст оркестратора.
- Что:
  - этап 1: разбиение по критериям /to-tickets, мерка «тикет берётся в отдельной сессии без общего контекста».
  - этап 2: правило «одно ревью на версию артефакта» и шкала риска вместо безусловного ревью постановки.
  - согласованы шапка скилла, роли, критерии закрытия этапов и список соседних скиллов; урок записан в references/lessons.md.
- Проверка:
  - вычитка SKILL.md: новые правила не противоречат этапам 3-6.
2026-07-21 11:43:49 +03:00
ddadmin 811fc28b7c docs(claude-subagent-playbook): добавлены итоги эксперимента xray-proxy 03/04
- Зачем:
  - зафиксировать решения пользователя 2026-07-21 и эмпирику effort/кэша после двух боевых прогонов.
- Что:
  - явная карта effort для Claude-субагентов: xhigh — постановки/планы, high — слепое ревью, medium — перепроверки (SKILL.md);
  - уточнение критерия выбора effort по цене тихой ошибки этапа и эмпирика смены effort при resume (codex-exec.md);
  - сводка прогонов 03–04 с казусами: гонки конкурентности, выдумка формата .dgst, экономика конвейера (lessons.md).
- Проверка:
  - git diff HEAD~1 --stat.
2026-07-21 03:47:02 -04:00
ddadminandClaude Fable 5 fdf744e578 docs(claude-playbook): перенесены находки зеркального codex-плейбука
- Зачем:
  - зеркальный codex-subagent-playbook ушёл вперёд по договорам ревью и
    экономии контекста координатора; согласованный с пользователем список
    находок перенесён в этот скилл.
- Что:
  - SKILL.md: установка «оптика, не конвейер», гейт и ручки эскалации для
    субагентов, саморевью исполнителя, шкала риска ревью с линзами
    TASK/CODE, статусы триажа с предохранителем кругов, постепенная
    приёмка с саморефлексией, раздел «Сбои координации».
  - prompts/: устойчивые ID находок, четыре статуса триажа, резолюции — в
    файл отчёта вместо тикета (лечит эхо файла задачи); новые
    result-contract.md и runtime-language.md.
  - prompt-templates.md: файлы линий ревью, сборка промптов с хвостом
    языка, вердикт перепроверки из task-notification; lessons.md — гейт
    на дистилляцию и датированная отмена урока про доводы в файле задачи.
- Проверка:
  - проверка относительных ссылок и git diff --check — чисто.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-19 19:37:32 +03:00
ddadminandClaude Fable 5 5b2db5bd7f docs(claude-playbook): уточнён дефолт эффорта Codex до medium
- Зачем:
  - решение пользователя 2026-07-19: sol на medium закрывает обычные
    задачи, прежнее правило дефолтило high почти всюду.
- Что:
  - в codex-exec.md переписано сквозное правило эффорта: medium — обычные
    задачи, high — нетривиальная реализация, ревью кода, диагноз.
  - к примеру запуска исполнителя добавлена пометка о выборе эффорта.
- Проверка:
  - вычитка references/codex-exec.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-19 19:37:18 +03:00
Dmitriy Dementiev 3b7ebd29c8 chore(sync): слиты изменения origin/master
- Зачем:
  - origin/master обновился во время отправки локальных коммитов.
- Что:
  - добавлена удалённая эмпирика Claude-плейбука.
  - сохранены локальные изменения Codex-плейбука и handoff.
- Проверка:
  - отсутствие конфликтов и последующая проверка состояния ветки.
2026-07-13 14:13:29 +03:00
Dmitriy Dementiev baac159189 docs(codex-playbook): добавлен handoff по оптике ревью
- Зачем:
  - следующей сессии нужен компактный контекст решений и незавершённой синхронизации.
- Что:
  - сохранены ссылки на действующие договоры скилла и триаж ревью.
  - описана гонка удалённой ветки и безопасный порядок последующего merge.
- Проверка:
  - git diff --check и проверка локальных ссылок handoff.
2026-07-13 14:12:43 +03:00
Dmitriy Dementiev 02a98df8c3 fix(codex-playbook): уточнён вердикт ревью планов
- Зачем:
  - ревью высокоуровневых документов могло требовать преждевременных деталей и постоянно блокировать одобрение.
- Что:
  - находки ограничены дефектами на уровне самого документа.
  - существенные отложенные риски отделены от блокирующих замечаний.
  - уточнено, что APPROVED допускает открытые вопросы будущей реализации.
- Проверка:
  - quick_validate.py, git diff --check и проверка локальных Markdown-путей.
2026-07-13 14:09:25 +03:00
Dmitriy Dementiev 70b18b9e9a fix(codex-playbook): устранены жёсткие допущения в шаблонах
- Зачем:
  - shell-зависимые примеры и конвейерные формулировки сужали применимость оптики.
- Что:
  - сборка подсказок описана платформенно-нейтральным порядком файлов.
  - граница ревью и маршрут актуальных отчётов оставлены гибкими.
  - исправлены входная формулировка и локальная навигация по ролям.
- Проверка:
  - quick_validate.py, git diff --check, Markdown-ссылки и узкая перепроверка агентом.
2026-07-13 13:25:33 +03:00
Dmitriy Dementiev 6cc1b26ce4 refactor(codex-playbook): согласована оптика тонкого мастера
- Зачем:
  - нужно сохранить контекст координатора и устранить расхождения с зеркальным playbook.
- Что:
  - закреплены делегирование, маршрутизация моделей и ограничение кругов ревью.
  - добавлены файловый договор ревью и согласованная эмпирика прогонов.
  - исправлены сборка слепых линий и компактные статусы находок.
- Проверка:
  - quick_validate.py, git diff --check и проверка локальных Markdown-ссылок.
2026-07-13 13:07:52 +03:00
Dmitry DementievandClaude Fable 5 9c047f9d1e docs(skills): эмпирика прогона 2026-07-13 в lessons субагентного плейбука
- Зачем:
  - зафиксировать уроки прогона тикета 06 (t2-presale) до их поглощения
    в SKILL.md.
- Что:
  - главный урок: карта прогресса для пользователя на границах этапов.
  - блок «Модели»: переоценка Sol, боевое подтверждение medium,
    роли Опус/Codex, наводка gpt-5.6-terra с пометкой «не обкатано».
- Проверка:
  - чтение references/lessons.md, запись «Прогон 2026-07-13».

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-13 11:31:02 +03:00
ddadminandClaude Fable 5 a4985b365d docs(skill): уроки прогона задачи 13 — эхо файла задачи и формат индекса
- Зачем:
  - третий боевой прогон подтвердил рефакторинг «тонкого мастера»;
    новые пожиратели контекста и слабое место Клод-ревьюера должны
    остаться в эмпирике скилла.
- Что:
  - lessons.md: запись прогона 2026-07-12/13 (находки этапов, три новых
    пожирателя, цифры конвейера).
  - prompt-templates.md: обёртка Клод-ревьюера требует однострочность
    индекса (Клод-родословная держит формат хуже Codex).
  - handoffs/: handoff разработки с открытыми вопросами (эхо файла
    задачи, приём вердикта из уведомления, эксперимент medium).
- Проверка:
  - вычитка; факты сверены с транскриптом прогона задачи 13.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-13 00:09:24 +03:00
ddadmin f9ea5b8c44 refactor(skill): плейбук возвращён к оптике тонкого мастера
- Зачем:
  - субагенты должны сохранять внимание мастера и помогать результату, а не обслуживать обязательный конвейер.
- Что:
  - семиступенчатый процесс заменён эвристиками выбора исполнителя, проверяющего и независимого ревьюера.
  - права агентов отделены от канала результата, а полная полезная нагрузка выведена из контекста мастера.
  - добавлены авторитетные договоры промптов, полевые заметки и handoff следующей сессии.
- Проверка:
  - git diff --cached --check.
  - свежий обзор через writing-great-skills, все принятые находки закрыты.
2026-07-12 23:50:37 +03:00
ddadmin 7110a075ea docs(skill): принцип «мастер решает», готовые boilerplate-промпты, ревизия
- Зачем:
  - ретро прогона 2026-07-12 (задача 20, clickstream-demo): контекст
    оркестратора съедали инлайн-диагнозы, переписывание boilerplate и
    кириллица в обменных файлах.
- Что:
  - SKILL.md: принцип «мастер решает — субагенты выясняют» со стоп-краном
    «сам — максимум один заход», обменные файлы на английском, сквозная
    проверка до ревьюеров, будильник одной строкой.
  - references/prompts/: готовые английские boilerplate-файлы (мандат
    ревью, триаж, перепроверка) — подшиваются cat'ом, контекст мастера
    не проходят; prompt-templates перестроен под сборку.
  - codex-exec: модель gpt-5.6-sol, лестница эффорта, ловушка «&»;
    sandbox-справочник переименован в codex-sandbox-apparmor.md;
    lessons дистиллирован, добавлена запись прогона 2026-07-12.
  - закрыты 14 находок слепого Fable-ревью скилла (согласованность,
    единый источник $SCRATCH, скелет ревью постановки).
- Проверка:
  - все внутренние ссылки резолвятся; слепое ревью: APPROVED_WITH_MINORS,
    восстановление структуры подтверждено без потерь.
2026-07-12 22:17:59 +03:00