From bce1ded9c4ad1fd0b31b85471bfd73a71e4adfb8 Mon Sep 17 00:00:00 2001
From: Dmitry Dementiev <ddmitry@gmail.com>
Date: Tue, 9 Jun 2026 18:04:08 +0300
Subject: [PATCH] =?UTF-8?q?docs(handoff):=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2?=
 =?UTF-8?q?=D0=BB=D0=B5=D0=BD=20handoff=20=D0=BF=D0=BE=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=B5=20=D0=B3?=
 =?UTF-8?q?=D0=B5=D0=BD=D0=B5=D1=80=D0=B0=D1=82=D0=BE=D1=80=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Зачем:
  - продолжить работу над генератором в новой сессии без потери контекста.
- Что:
  - .scratch/handoffs/2026-06-09-generator-rework.md: где остановились,
    ссылки на ADR/спеку, следующий шаг, suggested skills, состояние git.
- Проверка:
  - прочитать .scratch/handoffs/2026-06-09-generator-rework.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../handoffs/2026-06-09-generator-rework.md   | 52 +++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 .scratch/handoffs/2026-06-09-generator-rework.md

diff --git a/.scratch/handoffs/2026-06-09-generator-rework.md b/.scratch/handoffs/2026-06-09-generator-rework.md
new file mode 100644
index 0000000..4df6ec5
--- /dev/null
+++ b/.scratch/handoffs/2026-06-09-generator-rework.md
@@ -0,0 +1,52 @@
+# Handoff: переработка генератора (steady-stream, иерархическая модель)
+
+Дата: 2026-06-09
+Ветка: `feature/data-generator`
+Жанр: одноразовые леса́ (ADR-0003) — durable-рассуждение в ADR/спеке, не здесь.
+
+> Место: `.scratch/handoffs/` по [ADR-0003](../../docs/adr/0003-handoffs-in-scratch.md)
+> и `AGENTS.md` (перекрывают generic-дефолт скилла «temp dir» — у владельца
+> мультимашинность + worktrees, где `/tmp` не переживает).
+
+## Где остановились
+
+Брейнсторм-сессия (`brainstorm-with-docs`) завершена **на этапе документов** —
+кода НЕ трогали. Зафиксировано направление переработки генератора и расчищена
+рамка под реализацию. Дальше — отдельная follow-up-спека по математике, затем
+реализация.
+
+## Контекст и решения (ссылки, не пересказ)
+
+- **Решение «почему» (генератор A, не реплей C):**
+  [`docs/adr/0004-steady-stream-synthetic-generator.md`](../../docs/adr/0004-steady-stream-synthetic-generator.md)
+- **Форма доработки «что строим» (требования, без математики), статус Draft:**
+  [`docs/specs/2026-06-09-generator-rework-hierarchical.md`](../../docs/specs/2026-06-09-generator-rework-hierarchical.md)
+  — там же раздел **Open questions** (список вопросов для мат-спеки) и
+  **Validation** (критерии приёмки). Не дублирую сюда.
+- **Глоссарий:** `CONTEXT.md` — добавлены «популяция пользователей» /
+  «возвращающийся пользователь».
+- **Диагноз дефекта текущей реализации:** `generator/KNOWN_ISSUES.md`.
+
+## Следующий шаг
+
+**Написать follow-up-спеку по математике** генеративной модели. Перечень вопросов
+— в разделе *Open questions* спеки доработки (распределения, session-timeout,
+раскладка иерархии по тикам, персистентность популяции, `event_type` diversity).
+
+## Ловушки (одной строкой; детали — в спеке)
+
+- Воронка живёт в **`page_url_path`**, не в `event_type` (в сиде 100% `pageview`).
+- device/geo — **сессионный** контекст уровня `click`, не «свойство пользователя».
+- Модель интенсивности (`_calculate_events_count`, `_hour_factor`) — **сохраняем**;
+  переписываем только модель сущностей (`generate_batch`). Текущую реализацию
+  инкрементально не чиним.
+
+## Suggested skills (для следующей сессии)
+
+- **`conventional-commits`** — закоммитить готовые доки (см. git ниже).
+- **`brainstorm-with-docs`** (или `grill-with-docs`) — для follow-up-спеки по
+  математике: продолжает тот же стиль (durable-доки + правка CONTEXT/ADR inline).
+- **`tdd`** — на этапе реализации rewrite (у генератора уже есть pytest-набор
+  `generator/tests/`).
+- **`adversarial-review`** / **`code-review`** — ревью переписанной модели
+  сущностей перед вливанием ветки.