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:
1 parent
2d9fc7eadb
commit
0f8dfa0613
2 files changed
+78
-1
No files matched your search
+2
-1
@@ -3,7 +3,8 @@
|
|||||||
Дата: 2026-07-04 MSK
|
Дата: 2026-07-04 MSK
|
||||||
Статус: пакет правок по итогам боевого прогона; прошёл адверсарное ревью свежим
|
Статус: пакет правок по итогам боевого прогона; прошёл адверсарное ревью свежим
|
||||||
субагентом (2 блокера, 7 important, 4 minor — все закрыты правкой этого текста).
|
субагентом (2 блокера, 7 important, 4 minor — все закрыты правкой этого текста).
|
||||||
В `SKILL.md` вносится следом.
|
Внесено в `SKILL.md` и закоммичено той же сессией; итог сессии — в
|
||||||
|
`2026-07-04-rework-session-claude-line.md` (рядом).
|
||||||
|
|
||||||
## Зачем этот handoff
|
## Зачем этот handoff
|
||||||
|
|
||||||
|
|||||||
+76
@@ -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` — коммиты по итогам прогона.
|
||||||
Reference in new issue
Block a user