Commit Graph
7 Commits
Author SHA1 Message Date
ddadminandClaude Fable 5 3780ae0293 feat(skills): линия уместности начата shape-проходом до чтения диффа
- Зачем:
  - на прогоне #158 (clickstream v2) три линии ревью дали ноль находок
    на реальной ошибке формы: агрегация ключевого зерна в Python,
    57 567 ключей через границу ClickHouse -> Airflow. Линза из одних
    запахов читает исполнение и не видит решений, а ревью от диффа
    принимает раскладку исполнителя как оглавление.
- Что:
  - в line-taste.md добавлен блок Shape: набросок ожидаемой формы из
    одной постановки до открытия диффа, список недиктованных решений,
    вердикт каждому; набросок и список предъявляются как checks run
    даже при нуле находок.
  - правило оценки распространено на shape-находки; указатели в
    prompt-templates.md называют линзу формой и вкусом.
  - в lessons.md записана эмпирика прогона #158.
- Проверка:
  - вычитка diff линзой writing-for-agents; боевая — следующий прогон
    конвейера: shape-артефакты видны в отчете линии уместности.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-27 15:47:41 -04:00
Dmitry Dementiev 10f55f35f2 fix(skills): решение координатору идёт с вариантами и ценой
- Зачем:
  - находка FIT-5 холодного ревью: развилка, сжатая до открытого вопроса,
    не даёт принять решение — кода нет в контексте ни у координатора, ни у
    владельца, а исполнитель в этот момент единственный держит картину.
- Что:
  - NEEDS_DECISION в triage-header.md требует варианты и рекомендацию
    исполнителя, а не только формулировку вопроса.
  - требование «понятно без чтения кода» адресовано обеим меткам
    координатора сразу — вместе с OUT_OF_SCOPE.
  - раздел «Пользователь в петле» SKILL.md обязывает координатора нести
    решение владельцу тем же составом.
- Проверка:
  - первым боевым прогоном конвейера: у NEEDS_DECISION в отчёте
    исполнителя есть варианты, их цена и рекомендация.
2026-08-04 21:44:49 +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 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 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
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