Commit Graph
19 Commits
Author SHA1 Message Date
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 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 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 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 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
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
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
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
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
Dmitry DementievandClaude Fable 5 15d5515925 docs(skill): экономия контекста оркестратора по ретро прогона 2026-07-10
- Зачем:
  - ретро трёх циклов конвейера показало: находки ревью проходили через
    контекст оркестратора до шести раз, review-промпт дублировался, ~7
    пустых ходов на idle-пингах teammate-ревьюера.
- Что:
  - SKILL.md: механика «индекс у оркестратора, нагрузка файлами» — вердикты
    в файлы обменного temp-каталога, fix-промпт конкатенацией, один
    канонический review-промпт на обоих ревьюеров, idle-пинги как шум;
  - новый references/prompt-templates.md — скелеты четырёх промптов;
  - codex-exec.md: сборка промптов cat'ом, боевая модель gpt-5.5 явно
    (фронтир из конфига не наследовать);
  - codex-sandbox-fix-handover: рабочий AppArmor-фикс (ловушка memfd,
    профиль на бинарь codex), проверен на обоих режимах;
  - lessons.md: датированные записи ретро, казуса Sol и memfd.
- Проверка:
  - чтение SKILL.md и references/, следующий прогон конвейера.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-10 16:55:16 +03:00
Dmitry Dementiev 6e767d13ff docs(skill): двойное слепое ревью постановки и связка с /to-tickets
- Зачем:
  - прогон 2026-07-10 (mws-data-test-t2-presale) дал новую эмпирику
    этапов 1–2, не отражённую в скилле.
- Что:
  - этап 2: для крупной постановки — второе слепое ревью Кодексом с
    рамкой «постановку, не реализацию»; классы находок родословных;
  - этап 1: постановка через /to-tickets, когда репозиторий настроен
    под скиллы Мэтта Покока;
  - lessons.md: запись прогона с цифрами и ретро-оговоркой про
    companion-канал (issue #158).
- Проверка:
  - вычитка диффа свежим взглядом; ссылки ведут на существующие
    файлы references/.
2026-07-10 13:07:08 +03:00
Dmitriy DementievandClaude Fable 5 89ebd1d327 docs(skill): claude-subagent-playbook — write-ревьюер Codex и уборка
- Зачем:
  - read-only-конфайн обеднял ревью Codex (без тестов, поиска,
    первоисточников), а плотность SKILL.md и дефолты модели/усилия
    из config.toml накопили риски по итогам трёх прогонов.
- Что:
  - ветка «ревьюер» в codex-exec.md переведена на запись + авто-аппрув,
    защита — мандат промптом; в рецепты добавлены --strict-config и
    явные -m / model_reasoning_effort.
  - SKILL.md: правило «мандат промптом» для обоих ревьюеров, правило
    моделей субагентов (Опус/Sonnet, не Fable), /tdd и /research +
    Context7 в этапе 1, таймер-подстраховка ScheduleWakeup; уборка
    плотности и инлайн-дат.
  - handoffs 07-06/07-07/07-09 поглощены запиской 2026-07-10; в lessons.md
    добавлены правило дистилляции и блок 2026-07-10; правки прошли слепое
    ревью Опусом, все находки закрыты.
- Проверка:
  - оверрайды -m/-c проверены живым codex exec --strict-config;
    перекрёстные ссылки и команды сверены ревьюером с codex --help.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-10 12:41:09 +03:00
Dmitriy DementievandClaude Fable 5 4e496a1548 docs(skill): claude-subagent-playbook — прямой codex exec, уроки прогона 2026-07-09
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-09 20:05:37 +03:00
Dmitry DementievandClaude Fable 5 138315d496 feat(skill): claude-subagent-playbook — конвейер одной задачи с Codex
- Зачем:
  - выжимка боевого прогона 2026-07-06 (t2-ml-forecast, витрина) в
    переиспользуемый плейбук: постановка → свежий взгляд → реализация
    Codex → слепое двойное ревью разных родословных → синтез.
- Что:
  - SKILL.md: роли, шаги с критериями закрытия, триаж у исполнителя,
    границы применимости; словарь общий с coordinator-loop;
  - references: механика codex-companion с ловушками и раннер-паттерном,
    накопительная эмпирика прогонов, определения deep-reasoner/fast-worker
    для воссоздания в новом репозитории;
  - handoffs: записка о рождении скилла и списке непроверенного боем.
- Проверка:
  - зеркало ~/.claude/skills синхронно (diff -rq чисто); боевой тест —
    следующий прогон конвейера по тексту скилла.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-06 18:22:00 +03:00