# Handoff: ADR про модельное время генератора + отложенное ревью петли

Дата: 2026-06-11
Ветка: `feature/data-generator`
Жанр: одноразовый handoff по [ADR-0003](../../docs/adr/0003-handoffs-in-scratch.md).

## Зачем этот handoff

Сессия с Fable шла в стиле brainstorm-with-docs про **модельное время
генератора**. Параллельно идёт эксперимент: автономная петля субагентов Кодекс
(координатор + worker + reviewer) доделывает срез генератора (задачи 06→07).
Эти две линии **намеренно разделены** — пересмотр времени не правит то, что петля
строит на реал-тайм-модели. Handoff фиксирует, что уже сделано и что осталось,
чтобы не потерять контекст в новой сессии.

## Что сделано в этой сессии (durable, не дублирую — см. файлы)

- Создан **[ADR-0005](../../docs/adr/0005-generator-model-clock.md)** «Модельные
  часы генератора, отвязанные от настенного времени». Все решения там; кратко:
  модельное время расцеплено с `now()`; режимы (живой ×1 / ускоренный ×K /
  заливка `K → ∞`) — драйверы поверх одного шва; живой стенд масштабируется ×K
  (дефолт ×1); правило 30 минут переопределяется в **модельном** времени с
  параметрическим origin возобновления; «стартовая история стенда»
  (сгенерированное прошлое + заморозка state v2) — **будущее направление, ещё не
  строим**.
- Правки **[`CONTEXT.md`](../../CONTEXT.md)** (глоссарий): разведены три значения
  слова «сид» (`GEN_SEED` / статический сид / стартовая история стенда) и добавлен
  термин «модельное время и масштаб ×K».

**Эти изменения (ADR-0005 + CONTEXT.md) ещё НЕ закоммичены.** Их коммит — выход
брейншторма пользователя, его нельзя мешать с коммитами кода от петли (06/07).
Отдельный docs-коммит.

## Открытые線 для следующей сессии

### 1. Отложенное ревью результата автономной петли (приоритет)

Делать **после** того, как петля закоммитит задачу 07. Это read-only ревью.
Измерительный лист — в памяти проекта
`memory/ralph-loop-experiment-generator.md`. Главное:

- **A (главный индикатор эксперимента):** ссылочная целостность при
  `restore_state`. `_validate_v2_payload` проверяет только форму, не ссылки.
  Структурно-валидный state v2 с висячей ссылкой визит→пользователь
  (`generator/src/clickstream_generator/runtime.py:283`) или пользователь→словарь
  (`runtime.py:253/255`) проходит `from_dict_safe` и роняет `restore_state` без
  обёртки try→fresh. Прогноз: петля это **пропустит** (слепые зоны внутри одной
  линии Кодекс скоррелированы). Проверить гипотезу локально структурой с висячей
  ссылкой (как пользователь проверял оценку снимка 4.7 MB и падение на битой
  вложенности).
- **B/D (проверено OK ранее):** кулдауны по меткам, не тикам (`runtime.py:104`);
  детерминизм компактного снимка (`_stable_event_id`, restore не жжёт ГПСЧ).
  Подтвердить, что 06→07 их не сломали.
- **C (риск, вне скоупа 06):** всплеск досылки созревших событий с прошлыми
  метками на первом тике после рестарта — всплыл ли хоть как риск в саморевью.
- Верхнеуровневое для 07: границы задачи, честность отметок acceptance, не
  смешаны ли 06/07, `git status`.

Цель ревью двойная: (1) корректность 06/07; (2) мета-вывод — **какой класс
дефектов автономная петля систематически не видит без внешнего взгляда другой
модели**.

### 2. Реконсиляция мат-спеки с ADR-0005

После ревью петли. Разделы «Персистентность» и «Воспроизводимость» в
`docs/specs/2026-06-10-generator-math-model.md` написаны от настенных часов;
привести в соответствие с ADR-0005 (модельное время, правило 30 минут в
модельном времени). Не делать сейчас — файл смежен с тем, что петля трогала.

## Фон (память проекта, не дублирую)

- `memory/ralph-loop-experiment-generator.md` — схема Ральф-цикла + измерительный
  лист.
- `memory/generator-full-rework.md`, `memory/fable-design-codex-implementation.md`
  — направление переработки генератора и разделение ролей Fable(дизайн)/Codex(код).
- `.scratch/handoffs/2026-06-11-subagent-coordinator-experiment.md` — детальная
  схема эксперимента с координатором и наблюдения по циклам 05/06.

## Suggested skills

- `conventional-commits` — для отдельного docs-коммита ADR-0005 + `CONTEXT.md`
  (не мешать с кодом петли).
- `brainstorm-with-docs` — когда вернёмся к реконсиляции спеки или к проектированию
  «стартовой истории стенда» (будущее направление из ADR-0005).
- `handoff` — после ревью петли зафиксировать рефлексию эксперимента (что петля
  поймала/пропустила, особенно по находке A).