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
|
||||
Статус: пакет правок по итогам боевого прогона; прошёл адверсарное ревью свежим
|
||||
субагентом (2 блокера, 7 important, 4 minor — все закрыты правкой этого текста).
|
||||
В `SKILL.md` вносится следом.
|
||||
Внесено в `SKILL.md` и закоммичено той же сессией; итог сессии — в
|
||||
`2026-07-04-rework-session-claude-line.md` (рядом).
|
||||
|
||||
## Зачем этот 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