348 Commits
Author SHA1 Message Date
Dmitry Dementiev 0d2fc9af65 Merge branch 'skill/claude-playbook-context-retro': экономия контекста оркестратора 2026-07-10 16:58:10 +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 4d074adda6 feat(agents): добавлен плейбук оркестрации субагентов
- Зачем:
  - нужен повторяемый процесс делегирования без засорения контекста мастер-модели.
- Что:
  - добавлен явно вызываемый скилл с этапами, договорами возврата и защитой рабочего дерева.
  - описаны роли, уровни стоимости, полевые заметки и handoff для следующей версии.
- Проверка:
  - quick_validate.py agents/.agents/skills/codex-subagent-playbook.
  - git diff --cached --check.
2026-07-10 16:46:57 +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 db6271f0f7 docs(skill): агенту предписаны инициатива и sudo-эскалация по sandbox-фиксу
- Зачем:
  - рецепт AppArmor-фикса требует sudo, а инициатива агента (диагностика
    до прогона, передача команд пользователю) держалась на здравом смысле,
    не на тексте скилла.
- Что:
  - в правило про линукс-ловушку codex-exec.md дописано: фикс сам не
    применяй — дай пользователю готовые команды с `!`-префиксом; после
    профиля напомни убрать use_legacy_landlock; перед первым прогоном на
    новой Linux-машине прогони диагностику превентивно.
- Проверка:
  - чтение правила в references/codex-exec.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-10 12:47:29 +03:00
Dmitriy DementievandClaude Fable 5 7607ce2b84 docs(skill): влиты линукс-уроки sandbox из ветки codex-sandbox-fix-20260710
- Зачем:
  - другая сессия на Ubuntu 24.04 задиагностировала молчаливую поломку
    песочницы Codex CLI 0.144.1 (bwrap+userns против AppArmor); знание
    нужно основной линии скилла — Linux-прогон конвейера впереди.
- Что:
  - перенесён references/codex-sandbox-fix-handover-2026-07-10.md
    (диагностика, обход use_legacy_landlock, AppArmor-профиль);
    раздел «Связанные записи» перенацелен с удалённого codex-companion.md
    на codex-exec.md.
  - в codex-exec.md добавлено сквозное правило про линукс-ловушку
    (сигнатура «гуглит, но не может ls»), в lessons.md — датированная
    запись, в handoff — кавеат к пункту про Linux-прогон.
- Проверка:
  - git show origin/codex-sandbox-fix-20260710 — содержимое перенесено
    полностью; перекрёстные ссылки codex-exec.md ↔ handover резолвятся.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-10 12:43:42 +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
Dmitriy Dementiev 35d4114ba3 feat(wezterm): добавлен Windows-конфиг через chezmoi
- Зачем:
  - нужен живой WezTerm-конфиг, который тиражируется через dotfiles на Windows.
- Что:
  - добавлен репозиторный `wezterm/.wezterm.lua`.
  - добавлен chezmoi-шаблон для symlink `~/.wezterm.lua`.
  - README описывает Windows-настройку WezTerm.
- Проверка:
  - git diff --check -- README.md chezmoi/.chezmoiignore chezmoi/symlink_dot_wezterm.lua.tmpl wezterm/.wezterm.lua.
  - проверено, что `~/.wezterm.lua` является SymbolicLink на `dotfiles\wezterm\.wezterm.lua`.
2026-07-08 18:59:25 +03:00
ddadminandClaude Fable 5 39ef49dfcb docs(skill): claude-subagent-playbook — handoff прогона 2026-07-07
- Зачем:
  - зафиксировать уроки боевого прогона для сессии доработки скилла.
- Что:
  - handoff с шестью уроками: таймер-подстраховка и её экономика, прямой
    codex exec вместо плагина (с номерами issues), поправки пользователя
    к флагам CLI, идея читающего форвардера, вердикт из логов умершего
    агента, паттерн ожидания через отслеживаемый фоновый Bash.
- Проверка:
  - чтение handoff; коммит только одного файла, чужие untracked не задеты.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-07 22:40:02 +03:00
Dmitry DementievandClaude Fable 5 ba587293c9 docs(skill): claude-subagent-playbook — уроки боевого прогона 2026-07-07
- Зачем:
  - первый полный боевой прогон конвейера (наглядность витрины t2-ml-forecast)
    дал систематические уроки по ожиданию фоновых job и resume Codex-тредов.
- Что:
  - в references/lessons.md добавлен разбор прогона: idle-уведомление ≠ отчёт,
    bash-поллер умирает на смене хода (нужен persistent Monitor), зомби-job
    со статусом «running» у мёртвого воркера и его диагностика.
  - урок про resume уточнён по опыту пользователя из /adversarial-review:
    resume — только по явному id треда; безадресный resumeLast подхватывает
    чужой тред; запасной путь — свежий write-тред с контекстом из файла задачи.
  - зафиксировано: ранжировать правила постановки (что главнее) и требовать
    вписывать доводы отклонений в файл задачи; цифры прогона (18 мин
    реализация, тесты 147 → 154, ноль пересечений находок двух ревью).
- Проверка:
  - вычитка references/lessons.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-07 19:03:41 +03:00
Dmitry Dementiev 145ac75a09 docs(skill): claude-subagent-playbook — урок о смерти фонового ревьюера
- Зачем:
  - ревью скилла Опус-ревьюером не состоялось: субагент дважды ушёл в
    idle без отчёта и исчез; урок должен остаться в эмпирике.
- Что:
  - в references/lessons.md добавлен инцидент и вывод: критичный отчёт
    ревьюера писать в файл (двухканальный протокол), сообщение — указатель.
- Проверка:
  - зеркало ~/.claude/skills синхронно (rsync + diff).
2026-07-06 18:35:53 +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
ddadminandClaude Fable 5 ca30ac5272 docs(skill): coordinator-loop — handoff дополнен второй волной 2026-07-05
Два круга кросс-ревью правок (находки по убыванию: конфликт уровней,
затем стенд/человек), раздел «Контракт автономного прогона» и открытый
пункт: контракт не проверен вживую до следующей цепочки.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-05 23:37:48 +03:00
ddadminandClaude Fable 5 c959911184 fix(skill): coordinator-loop — стенд и человек разведены в стоп-условиях
По ревью Codex: «живой стенд» ошибочно попал в класс «может проверить
только человек». Теперь как в статус-контракте: недоступную worker-у
проверку прогоняет координатор (часть коммит-гейта), открытым риском в
handoff уходит лишь то, что недоступно и ему — ручная приёмка, внешняя
среда.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-05 23:36:19 +03:00
ddadminandClaude Fable 5 f6b9b3b8e3 feat(skill): coordinator-loop — контракт автономного прогона
По предложению Codex из ретро: скилл проектировался под сценарий «передал
очередь issue и ушёл», но входной контракт и мандат были неявными. Новый
раздел фиксирует вход (issue, порядок, «зачем»), мандат (весь цикл без
уточняющих вопросов; за пределы локального репозитория — только по
поручению) и сводку стоп-условий со ссылками на их разделы — без
пересказа правил, чтобы не разъезжались. Предупреждение о третьем круге
уточнено: это не вопрос, ответа не ждать.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-05 23:33:26 +03:00
ddadminandClaude Fable 5 1d67a3ffe9 fix(skill): coordinator-loop — уровень по таблице, инварианты без привязки к домену
По ревью Codex: фраза «дефолт — рабочий уровень» противоречила таблице
effort-levels.md (worker обычного issue — экономный) и толкала запускать
всех worker-ов на high; заменена на выбор уровня по роли и классу issue.
Заодно «форма распределений» расширена до доменных инвариантов данных —
скилл общий, а не только для генератора.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-05 23:25:25 +03:00
ddadminandClaude Fable 5 4504410569 docs(skill): coordinator-loop — handoff дополнен ретро прогона 15→19
Итоги эксперимента medium-worker (критерий выхода не сработал), ссылка на
правки b8f1fe0, закрытые и оставшиеся пункты из «не сделано».

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-05 23:21:57 +03:00
ddadminandClaude Fable 5 b8f1fe017b docs(skill): coordinator-loop — правки по ретро прогона 15→19
Три уточнения по отзыву Codex, сверенному с журналом координатора:
- предусловие входа: качественно подготовленные issue (выход /to-issues),
  мутные — сначала прояснение замысла;
- точная граница чтения координатора: запрет только на код ради
  верификации, процессные артефакты — его зона;
- классификатор риска расширен маркерами из прогона (версионирование
  state, разрушающие пути, fail-open проверки); в effort-levels.md —
  итог калибровки: уровни не менять, точность даёт классификация issue.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-05 23:20:15 +03:00
ddadmin 03030d4f24 fix(skill): coordinator-loop — шумные команды гейта через файл-лог
- Зачем:
  - на прогоне 2026-07-05 make generator-test с зашитым pytest -v высыпал
    в контекст координатора полный список из 181 теста: правило «только
    сводка» было, а механики не было.
- Что:
  - шаг 7: гейт координатор гоняет сам (не через субагента), шумные
    команды — в файл-лог, в контекст только код возврата и итоговые
    строки; интерпретация объёмного вывода — разборщику логов
    экономного уровня.
  - ведущее правило и чек-лист дополнены той же механикой.
  - effort-levels: «разбор логов» добавлен в экономный ярус Claude Code.
- Проверка:
  - вычитка SKILL.md; grep по pytest/сводка/файл-лог — противоречий нет.
2026-07-05 20:32:27 +03:00
ddadminandClaude Fable 5 16da5fe499 docs(skill): coordinator-loop — итоги живого прогона и третий случай родословной
- Зачем:
  - session-handoff писался до живого прогона; вторая волна правок и
    результат кросс-прохода не были зафиксированы.
- Что:
  - дополнение к handoff сессии: шесть находок прогона, вторая волна правок,
    урок «живой прогон под наблюдением — самый дешёвый источник находок».
  - rationale: поправка 2026-07-05 — третий случай подтверждения находки
    о родословной (1 critical, 5 high после APPROVED той же линии).
- Проверка:
  - перекрёстные ссылки на отчёт кросс-ревью и коммиты правок сходятся.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-05 00:35:40 +03:00
ddadminandClaude Fable 5 12a4783168 feat(skill): coordinator-loop — триаж финала у fixer-а и ретро координатора
- Зачем:
  - триаж находок финального ревью не был назначен никому (worker-ы уже
    закрыты); ретроспектива координатора после цепочки 12-08 дала
    проверенные боевые предложения.
- Что:
  - триаж находок финала — у fixer-а тем же механизмом, что у worker-а.
  - словарь статусов отчётов и правило «APPROVED != завершение цепочки».
  - предупреждение пользователю на третьем круге ревью, до потолка.
  - шаг 3: уровень worker-а явно по effort-levels.md и в журнал.
- Проверка:
  - перечитывание разделов «Цикл» и «Финал цепочки» после правок.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 23:29:10 +03:00
ddadminandClaude Fable 5 359def54d7 fix(skill): coordinator-loop — находки финала по классу файла
- Зачем:
  - правило «всё чинит fixer» было слишком грубым: процессные файлы
    (PRD фичи, чекбоксы issue, журнал) — прямая зона координатора по
    построению скилла, отдавать их fixer-у бессмысленно.
- Что:
  - граница по классу файла: процессные — координатор сам (симптом
    пропущенного п.1), файлы проекта — fixer-субагент, кодовая находка —
    мини-issue с rerun ревью.
- Проверка:
  - сверка с живым прогоном: находки Bernoulli (PRD, чекбоксы) — класс 1,
    World Map в пользовательских доках — класс 2.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 23:00:16 +03:00
ddadminandClaude Fable 5 f5395ec2f1 fix(skill): coordinator-loop — fixer на финале и честный статус цепочки
- Зачем:
  - живой прогон: координатор сам правил доки по находкам финального ревью
    (полные тексты в контексте, второй писатель) и дал промежуточный статус,
    прочитанный пользователем как завершение.
- Что:
  - находки финального ревью чинит fixer-субагент с worker-контрактом,
    не координатор.
  - до выполнения финала каждый отчёт пользователю явно называет статус
    цепочки и остаток.
- Проверка:
  - перечитывание раздела «Финал цепочки».

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 22:57:12 +03:00
ddadminandClaude Fable 5 8eec4f1d86 fix(skill): coordinator-loop — rerun ревью продолжением, не свежей сессией
- Зачем:
  - координатор прочитал «свежие сессии» как запрет продолжать субагента:
    пять полных xhigh-обходов финального ревью вместо узких rerun-ов.
- Что:
  - правило уточнено: свежая сессия — про запуск без форка истории;
    узкий rerun — продолжение того же ревьюера через send_input.
  - свежий ревьюер обязателен по триггерам: спор, эскалация, широкая
    переработка, слабый индекс; правило продублировано в шаге 5 и финале.
  - reviewer-prompt.md: PREVIOUS_FINDINGS_BLOCK — только для свежего
    субагента.
- Проверка:
  - сверка с механикой rerun в claude-team-review (продолжение — штатный
    путь, блок прошлых находок — для свежего).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 22:52:03 +03:00
ddadminandClaude Fable 5 af9f5df672 docs(skill): coordinator-loop — уровень worker-а фиксируется в журнале
- Зачем:
  - эксперимент «worker на medium» должен быть измерим: круги ревью против
    уровня worker-а видны только если уровень записан.
- Что:
  - точка записи «старт issue» дополнена уровнем мышления worker-а.
- Проверка:
  - перечитывание раздела «Журнал прогона».

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 21:06:37 +03:00
ddadminandClaude Fable 5 5be83cb14a feat(skill): coordinator-loop — worker на medium, ревью глубже worker-а
- Зачем:
  - у worker-а есть страховочная сетка ниже по течению, у ревьюера нет:
    глубина мышления важнее на ревью, а worker — самая дорогая петля.
- Что:
  - таблицы уровней: worker на обычном issue — экономный (medium), любое
    code review и worker на гейтовом issue — рабочий (high).
  - в SKILL.md ярусы получили обоснование членства ролей.
- Проверка:
  - согласованность ярусов SKILL.md с обеими таблицами effort-levels.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 21:04:36 +03:00
ddadminandClaude Fable 5 61418a9708 fix(skill): coordinator-loop — уровень мышления субагентам задавать явно
- Зачем:
  - живой прогон issue 12 показал: субагенты не наследуют уровень сессии,
    дефолт spawn_agent — medium, worker и ревьюер молча ушли ступень ниже.
- Что:
  - effort-levels.md: явные значения уровней (medium/high/xhigh) и
    предупреждение про дефолт spawn_agent.
  - журнал: фиксировать фактический уровень хоста, не название яруса.
- Проверка:
  - сверка с конфигом сессии (model_reasoning_effort = high) и экраном
    прогона (spawn gpt-5.5 medium).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 20:58:46 +03:00
ddadminandClaude Fable 5 9fda85f012 fix(skill): coordinator-loop — субагенты только свежими сессиями
- Зачем:
  - живой прогон issue 12 показал: координатор тратит циклы на попытки
    передать worker-у полный контекст форком своей истории.
- Что:
  - явное правило в раздел ролей: worker, ревьюеры и диагносты запускаются
    свежими сессиями; форк тащит контекст координатора и убивает
    независимость ревьюера.
- Проверка:
  - перечитывание раздела «Роли» после правки.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 20:48:53 +03:00
ddadminandClaude Fable 5 0f8dfa0613 docs(skill): coordinator-loop — handoff сессии переработки
- Зачем:
  - зафиксировать итог сессии для продолжения: как проверялся пакет,
    повороты после ревью, что осталось незамеренным.
- Что:
  - добавлен handoff 2026-07-04-rework-session-claude-line.md.
  - в пакете правок обновлена строка статуса (внесено и закоммичено).
- Проверка:
  - перекрёстные ссылки между двумя handoff'ами сходятся.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 20:11:37 +03:00
ddadminandClaude Fable 5 2d9fc7eadb feat(skill): coordinator-loop — топология ревью под Codex и эскалация
- Зачем:
  - боевой прогон цепочки 07-11 показал: worker в Codex не может запускать
    субагентов, ревью шло пятью кругами без ограничителя, финальный handoff
    и закрытие issue выпадали из цикла.
- Что:
  - ревьюеров запускает координатор (наблюдатели, ограничение промптом),
    триаж находок и флаг «спор» — в worker-е; политика кругов с потолком.
  - две ручки стоимости: модель по роли и уровень мышления, таблица
    references/effort-levels.md; шаблон references/reviewer-prompt.md —
    скилл самодостаточен, без файлов claude-team-review.
  - журнал с метками времени; финал: PRD до ревью, Status: done
    docs-коммитом, handoff — условие выхода; handoff пакета правок.
- Проверка:
  - адверсарное ревью пакета свежим субагентом (2 блокера и 7 important
    закрыты) плюс саморевью; следующий боевой прогон цепочки — замер.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 20:09:35 +03:00
Dmitry DementievandClaude Fable 5 2ed3fd81ea feat(skill): coordinator-loop — происхождение ревью и журнал прогона
- Зачем:
  - инцидент 2026-07-03: координатор молча подменил ревью и записал
    недоказанную причину, а кросс-линейный проход нашёл серьёзные дефекты
    после APPROVED ревьюера той же линии — процессу нужны след и честность.
- Что:
  - контракт worker-а: строка происхождения ревью в индексе (режим,
    механизм, ревьюер, вердикт), сверка на коммит-гейте.
  - append-only журнал прогона coordinator-journal.md: запись в момент
    события, handoff собирается по журналу, отклонения фиксируются фактами,
    причины-предположения запрещены; честная граница защиты названа явно.
  - кросс-линейный проход поднят до рекомендованного по умолчанию для
    нетривиальной цепочки; дубли свёрнуты (саморевью, раздел «Родословная»);
    датированная поправка с эмпирикой в references/rationale.md.
- Проверка:
  - /claude-team-review code (adversarial-reviewer, Opus, read-only):
    APPROVED после 2 раундов, неблокирующие заметки применены.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-03 19:13:31 +03:00
Dmitry DementievandClaude Opus 4.8 b0998780d3 refactor(skill): coordinator-loop вокруг «индекс, не полный текст»
Переписан SKILL.md (194→159): user-invoked, ведущее правило «работай по
индексу», per-finding триаж делегирован claude-team-review, режимы ревью
по риску (два лена разными субагентами на риске), коммит-гейт берёт только
сводку тестов, финал = ревью на соответствие замыслу + handoff под ручную
кросс-линию. README, rationale и июньский context-economy handoff подровнены;
добавлен handoff по сессии. Прошёл /claude-team-review — 2 раунда, APPROVED.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-02 18:38:53 +03:00
Dmitriy Dementiev 9ceeb0ca4e docs(agents): добавлено правило понятности документов и комментариев
- Зачем:
  - код и конфигурации читают люди с разным уровнем экспертизы, текст должен быть доступен без дополнительных пояснений.
- Что:
  - добавлен абзац про простые слова, короткие фразы и пояснение сложных мыслей при первом упоминании.
- Проверка:
  - cat AGENTS.md — новый абзац присутствует в разделе «Язык и рассуждения».
2026-06-17 10:42:37 +03:00
Dmitriy Dementiev 3c0173647c docs(ai-text-lint): уточнён путь к базе паттернов
- Зачем:
  - `{baseDir}` не является стандартным placeholder и может сбить с толку.
- Что:
  - путь заменён на `references/patterns.md` с пояснением «в папке этого скилла».
- Проверка:
  - cat agents/.agents/skills/ai-text-lint/SKILL.md | grep patterns
2026-06-15 15:44:32 +03:00
Dmitriy Dementiev aece3bfcc6 feat(chezmoi): добавлен шаблон env.secrets для Windows
- Зачем:
  - автоматизировано создание ~/.env.secrets при chezmoi apply на Windows.
- Что:
  - добавлен chezmoi/create_dot_env.secrets с заглушками для CONTEXT7_API_KEY и ZAI_API_KEY.
- Проверка:
  - chezmoi apply и проверка наличия ~/.env.secrets
2026-06-15 15:37:37 +03:00
Dmitriy Dementiev ee474c9825 refactor(ai-text-lint): переработана структура patterns.md
- Зачем:
  - устранена дублирующая сводная матрица severity, которая устаревала при изменении паттернов.
  - улучшена навигация по документу за счёт группировки паттернов в категории.
- Что:
  - добавлены разделы категорий: Структура и форматирование, Тон и авторская позиция, Резюме-специфичные паттерны.
  - переупорядочены паттерны S05 и S06 внутри категории Структура.
  - обновлена ссылка на severity в SKILL.md с указанием inline-таблиц.
- Проверка:
  - git diff agents/.agents/skills/ai-text-lint/
2026-06-15 15:30:22 +03:00
ddadminandClaude Opus 4.8 27370b92ba docs(skill): добавлен handoff по экономии контекста coordinator-loop
- Зачем:
  - сохранить выводы сессии проектирования у самого навыка, чтобы будущая сессия по доработке нашла их рядом с handoff про наблюдаемость.
- Что:
  - добавлена расширенная версия handoff: диагностика двух «пожаров» по логам Codex, prior art (obra:superpowers), два принятых правила с адресами правок в SKILL.md, кандидаты-фиксы и открытые вопросы.
- Проверка:
  - открыть handoffs/2026-06-14-coordinator-loop-context-economy.md

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 21:39:40 +03:00
ddadmin cf4056fe66 docs(skill): добавлен handoff по наблюдаемости
- Зачем:
  - нужно передать на другую машину договорённости по наблюдаемости coordinator-loop.
- Что:
  - добавлен handoff с форматом live-логов, summary и правилами gitignore.
  - зафиксированы отказ от state.md и run-id, а также best-effort heartbeat.
- Проверка:
  - просмотрен staged diff нового handoff-файла.
2026-06-14 20:10:47 +03:00
ddadmin 8f6d9de9d5 docs(skill): уточнено назначение README coordinator-loop
- Зачем:
  - README должен описывать границы скилла без ложных ожиданий от runtime-поведения.
- Что:
  - уточнена приёмка через агент другой модельной линии, если он доступен.
  - разделены проектная документация и документационные правки внутри issue.
  - проверяемость описана как свойство конечного результата цепочки.
- Проверка:
  - просмотрен staged diff README coordinator-loop.
2026-06-14 18:57:48 +03:00
ddadminandClaude Opus 4.8 2c70c97db3 docs(skills): добавлен README для coordinator-loop
- Зачем:
  - дать человеку и будущей сессии быстрый вход: зачем навык, где в конвейере, что на выходе.
- Что:
  - описаны место в потоке (brainstorm/grill -> to-issues -> coordinator-loop -> приёмка) и границы навыка.
  - зафиксировано, что проверяемость результата закладывается при проектировании, а не в этом скилле.
  - якоря контекста самодостаточны: ссылки только на SKILL.md и references/rationale.md.
- Проверка:
  - открыть agents/.agents/skills/coordinator-loop/README.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 18:48:58 +03:00
ddadmin aa3e362e4f fix(skill): уточнена обработка чужих правок координатором
- Зачем:
  - координатор должен обнаруживать чужие изменения до запуска worker-а.
- Что:
  - в цикле скилла добавлена остановка при чужих правках.
  - чек-лист обновлён проверкой раннего согласования с пользователем.
- Проверка:
  - просмотрен diff файла coordinator-loop/SKILL.md.
2026-06-14 18:15:46 +03:00
ddadminandClaude Opus 4.8 33a551d305 docs(agents): добавлены правила про русский язык и рассуждения
- Зачем:
  - распространить языковую политику стенда на личный репозиторий dotfiles.
- Что:
  - добавлен раздел «Язык и рассуждения»: ясный русский и рассуждения на английском.
  - фразы перенесены дословно из AGENTS.md учебного стенда.
- Проверка:
  - git show HEAD -- AGENTS.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 17:50:27 +03:00
ddadminandClaude Opus 4.8 7b95e0f5cb feat(skills): добавлен координаторский цикл coordinator-loop для Codex
- Зачем:
  - закрепить эксперимент с координатором субагентов как переиспользуемый навык для Codex.
- Что:
  - добавлен SKILL.md с циклом worker -> саморевью -> классификация -> ревью -> коммит.
  - эмпирика эксперимента вынесена в references/rationale.md.
  - добавлен мост codex/.codex/skills/coordinator-loop для подхвата навыка в Codex.
  - навык только по явному вызову (/coordinator-loop), без автосрабатывания.
- Проверка:
  - ls ~/.agents/skills/coordinator-loop/SKILL.md; вызов /coordinator-loop в Codex.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 17:50:11 +03:00
Dmitry Dementiev 41a7c042a2 refactor(conventional-commits): обновлена структура навыка
- Зачем:
  - убраны избыточные инструкции по выполнению коммитов, которые дублируются в AGENTS.md.
- Что:
  - удалены разделы "Алгоритм действий" и "Правила выполнения команд" со способами A, B, C.
  - добавлен раздел "Примеры" с актуальными примерами оформления.
  - обновлено поле description в YAML-заголовке.
- Проверка:
  - git diff HEAD~1 -- agents/.agents/skills/conventional-commits/SKILL.md
2026-06-12 21:32:57 +03:00
Dmitry DementievandClaude Opus 4.8 6f9de57b0c refactor(brainstorm-with-docs): понимание ведёт, артефакт — запись
- Зачем:
  - гравитация скилла тянула к «выдать артефакт»; управляющие документы
    раздувались деталями реализации (диагностировано на живом тесте — ADR
    с инлайном SQL).
- Что:
  - gate/stop: «готово» = общее понимание + рекомендованное направление,
    записанное минимально-достаточно, а не «артефакт произведён»; определение
    в одном месте (stop_condition), gate на него ссылается.
  - core_rules: минимально-достаточный артефакт + барьер высоты (без инлайна
    исполняемых артефактов) + single source of truth; приоритет над
    конвенциями репозитория.
  - шаг 2: артефакт(ы) выбираются ПОСЛЕ понимания, набором по жанрам.
  - adr.md/spec.md: Lifetime test → Scope test (ADR↔spec по охвату, не сроку);
    detailed plan — transient и вне scope скилла.
  - description + README: формулировки-цели ведут пониманием, не артефактом.
- Проверка:
  - grep: старый framing (lifetime/transient) убран; cross-ref Scope test
    сходится; определение «готово» не дублируется; витрина не artifact-first.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 18:56:30 +03:00
Dmitry Dementiev 14adf77424 docs(brainstorm-with-docs): обновлена документация скилла
- Зачем:
  - README и ROADMAP должны отражать текущую модель скилла без устаревшего handoff.
- Что:
  - удален временный DEV-HANDOFF.md.
  - README уточняет отличие от grill-me и роль grill-with-docs как upstream influence.
  - ROADMAP фиксирует R2/F4 как landed и описывает F1 как cheap frame-challenger.
- Проверка:
  - git diff --check -- agents/.agents/skills/brainstorm-with-docs.
2026-06-06 17:26:57 +03:00
ddadmin a1fe4ce319 docs(brainstorm-with-docs): итоги первого живого теста — R1/F1/SEAM + план v2
- Зачем:
  - первый живой тест скилла вскрыл правки, которые надо закрепить, и идеи для v2.
- Что:
  - SKILL.md: R1 (рекомендация к вопросам-решениям), F1 (2-3 внутри рамки + ≥1
    дивергентный сверх, без филлера), inline/confirm для терминов, read-only
    инспекция данных в шаге 1, нейтральная SEAM-метка.
  - ROADMAP.md: статус первого теста, Landed R1/F1/SEAM, вердикты R2/F4/F5a, план v2.
- Проверка:
  - прочитать SKILL.md (core_rules, шаги 1/4/5) и ROADMAP.md.
2026-06-06 16:55:21 +03:00
ddadmin f3a41e2790 docs(understand): унифицирован пропуск, возвращён рационал согласия, добавлен различитель развилки
- Зачем:
  - убрать неоднозначности после ревью: два имени у пропуска сбивали агента, потеряна мотивация жёсткости, у самого судьбоносного решения «развилка или нет» не было опоры.
- Что:
  - пропуск чекпоинта везде назван «пропустить», явно отделён от выключения режима («stop»/«обычный режим»).
  - возвращена мотивация: ручное включение = согласие поджимать, не смягчать из вежливости.
  - в «Что считается развилкой» добавлен доменно-нейтральный различитель по распространению непонимания и цене отката.
- Проверка:
  - /reload-skills и вызов /understand на реальной развилке.
2026-06-06 13:27:24 +03:00
ddadmin e8c68ad398 docs(understand): уточнён режим проверки понимания
- Зачем:
  - нужен ручной режим, который проверяет понимание без лишнего торможения обычной работы.
- Что:
  - уточнены условия opt-in и работа режима в пределах текущей сессии.
  - добавлены правила языка сессии, явного пропуска и обхода проверки как отсутствия сигнала.
  - описана соразмерная проверка и варианты форматов ответа.
- Проверка:
  - просмотрен staged diff: git diff --cached -- agents/.agents/skills/understand/SKILL.md.
2026-06-06 12:58:08 +03:00