From 0f8dfa06136a7614fb159fd3a76f578b23639636 Mon Sep 17 00:00:00 2001 From: Dmitry Dementev Date: Sat, 4 Jul 2026 20:11:37 +0300 Subject: [PATCH] =?UTF-8?q?docs(skill):=20coordinator-loop=20=E2=80=94=20h?= =?UTF-8?q?andoff=20=D1=81=D0=B5=D1=81=D1=81=D0=B8=D0=B8=20=D0=BF=D0=B5?= =?UTF-8?q?=D1=80=D0=B5=D1=80=D0=B0=D0=B1=D0=BE=D1=82=D0=BA=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - зафиксировать итог сессии для продолжения: как проверялся пакет, повороты после ревью, что осталось незамеренным. - Что: - добавлен handoff 2026-07-04-rework-session-claude-line.md. - в пакете правок обновлена строка статуса (внесено и закоммичено). - Проверка: - перекрёстные ссылки между двумя handoff'ами сходятся. Co-Authored-By: Claude Fable 5 --- ...026-07-04-codex-topology-and-escalation.md | 3 +- .../2026-07-04-rework-session-claude-line.md | 76 +++++++++++++++++++ 2 files changed, 78 insertions(+), 1 deletion(-) create mode 100644 agents/.agents/skills/coordinator-loop/handoffs/2026-07-04-rework-session-claude-line.md diff --git a/agents/.agents/skills/coordinator-loop/handoffs/2026-07-04-codex-topology-and-escalation.md b/agents/.agents/skills/coordinator-loop/handoffs/2026-07-04-codex-topology-and-escalation.md index 43d8bbf..8e0b8e3 100644 --- a/agents/.agents/skills/coordinator-loop/handoffs/2026-07-04-codex-topology-and-escalation.md +++ b/agents/.agents/skills/coordinator-loop/handoffs/2026-07-04-codex-topology-and-escalation.md @@ -3,7 +3,8 @@ Дата: 2026-07-04 MSK Статус: пакет правок по итогам боевого прогона; прошёл адверсарное ревью свежим субагентом (2 блокера, 7 important, 4 minor — все закрыты правкой этого текста). -В `SKILL.md` вносится следом. +Внесено в `SKILL.md` и закоммичено той же сессией; итог сессии — в +`2026-07-04-rework-session-claude-line.md` (рядом). ## Зачем этот handoff diff --git a/agents/.agents/skills/coordinator-loop/handoffs/2026-07-04-rework-session-claude-line.md b/agents/.agents/skills/coordinator-loop/handoffs/2026-07-04-rework-session-claude-line.md new file mode 100644 index 0000000..c9dd26b --- /dev/null +++ b/agents/.agents/skills/coordinator-loop/handoffs/2026-07-04-rework-session-claude-line.md @@ -0,0 +1,76 @@ +# Handoff: сессия переработки скилла по итогам боевого прогона + +Дата: 2026-07-04 MSK (вечер, после прогона 07 → 11) +Статус: сделано и закоммичено (`2d9fc7e` в dotfiles). Сессия Claude Code — +правки вносила модель другой родословной, чем та, что гоняла прогон. + +## Зачем этот handoff + +Продолжение в новой сессии: что решено, как проверено, что осталось. Сами +решения и их обоснования — в пакете правок рядом +(`2026-07-04-codex-topology-and-escalation.md`), сюда их не дублирую. + +Отдельно стоит зафиксировать форму: разбор прогона Codex и переработку скилла +делал Claude — по сути это был кросс-линейный проход по **процессу** (не по +коду фичи). Он же дал главный улов сессии — см. ниже. Рабочее разделение +пользователя (Claude — документы и планы, Codex — исполнение) на скиллах +работает так же, как на коде. + +## Как проверялось (сам процесс — рабочий приём, повторить) + +1. Черновик пакета → **адверсарное ревью свежим субагентом** с проверкой + каждого утверждения по первоисточникам (журнал прогона, SKILL.md, старые + handoff'ы). Улов: 2 blocker, 7 important, 4 minor — все закрыты правкой + пакета до внесения в SKILL.md. +2. Внесение → **лёгкое саморевью свежим взглядом** (без субагентов): 4 находки, + 3 исправлены. +3. Досоздание `reviewer-prompt.md` → ещё одно лёгкое саморевью: 2 находки + (обе реальные — untracked-файлы невидимы в diff; предусловие ревью-гейта), + исправлены амендом. + +Блокеры адверсарного ревью били по ядру пакета (неисполнимый критерий «та же +находка» в политике кругов; team-review из-под координатора = второй писатель) — +без этого шага они уехали бы в SKILL.md. + +## Повороты после ревью (чего не было в исходном замысле) + +- **Наблюдатель, не read-only** — поправка пользователя: ревьюеру нужны + инструменты (тесты, воспроизведение, поиск), ограничение «не менять + репозиторий и среду» держится промптом, как в `claude-team-review`. +- **Скилл сделан цельным**: `references/reviewer-prompt.md` — адаптация + шаблона из `claude-team-review` под нашу топологию (чинящего лида нет, + вердикты наши, четыре фокуса, блок rerun учитывает отклонения worker-а). + Зависимость от файлов чужого скилла снята. +- **Тождество находок судит worker** (флаг «спор»), координатор считает + только круги — ответ на блокер ревью. +- Определение круга, критерий закрытия гейта, предусловие ревью-гейта + (`DONE`/`DONE_WITH_CONCERNS`) — из саморевью. + +## Что не сделано / открытые вопросы + +- **Числа-ориентиры июня не замерены** (пик контекста, трафик через + координатора, тест-прогоны): «контекст не пострадал» в прогоне 07 → 11 — + впечатление пользователя, не замер. Снять на следующем прогоне по горячему: + сырьё в `~/.codex` (logs/sessions) ротируется. +- **Политика кругов не проверена вживую** — потолок четыре круга и флаг + «спор» появились после прогона; первый боевой тест — следующая цепочка + (12 «DAG-пульт» или 08 «миграция курса» в clickstream-репозитории). +- **`references/effort-levels.md` — первый черновик**: соответствия уровней + подобраны по одному прогону, калибровать по журналам (уровень пишется в + происхождение ревью — данные будут копиться сами). +- **Кросс-хост не гонялся**: ветка Claude Code в effort-levels — умозрительная. + +## Где что лежит + +- Пакет правок с обоснованиями: `2026-07-04-codex-topology-and-escalation.md` + (рядом). +- Изменённые файлы: `SKILL.md`, `README.md`, `references/rationale.md` + (поправка 2026-07-04), новые `references/effort-levels.md` и + `references/reviewer-prompt.md`. +- Журнал боевого прогона-источника: + `~/sources/clickstream-ch-kafka-superset-demo/.scratch/generator-model-time-startup-history/coordinator-journal.md`. + +## Suggested skills + +- `coordinator-loop` — следующий боевой прогон = замер и проверка политики кругов. +- `conventional-commits` — коммиты по итогам прогона.