docs(skill): coordinator-loop — handoff сессии переработки

- Зачем:
  - зафиксировать итог сессии для продолжения: как проверялся пакет,
    повороты после ревью, что осталось незамеренным.
- Что:
  - добавлен handoff 2026-07-04-rework-session-claude-line.md.
  - в пакете правок обновлена строка статуса (внесено и закоммичено).
- Проверка:
  - перекрёстные ссылки между двумя handoff'ами сходятся.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
ddadminandClaude Fable 5 committed 2026-07-04 20:11:37 +03:00
1 parent 2d9fc7eadb
commit 0f8dfa0613
2 files changed
+78 -1

No files matched your search

@@ -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
@@ -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` — коммиты по итогам прогона.