clickstream-ch-kafka-superset-demo/.scratch/handoffs/20260719-2229-mentee-path-start.md

Handoff: старт редизайна пути менти — спека и пилот GitHub Issues

Дата: 2026-07-19 22:29. Жанр: handoff по ADR-0003 — точка входа в новую фичу на чистой ветке.

Контекст

• feature/data-generator (146 коммитов) влита в main (0e312b3) и запушена. Перед слиянием закрыта задача 21: баг F1 (необязательные поля формы generator_control требовались как обязательные) починен через Param(None, type=["null", "string"]), .gitignore покрыл артефакты data/*.json, доки (ARCHITECTURE.md, REPO_MAP.md) догнали код. make test (205 + 31) и make lint зелёные.
• .scratch очищен целиком (решение пользователя 2026-07-19): задачи 01–21, PRD, журналы и старые handoff'ы — одноразовые материалы, всё долговечное перенесено в docs/ (ADR 0004–0006, спеки, runbook startup-history). История доступна в git: см. состояние на 0e312b3, ключевой файл находок — .scratch/generator-model-time-startup-history/hitl-findings.md@0e312b3.

Направление работ: редизайн пути менти

Рамочная модель (из ручного HITL 2026-07-19, подтверждена по launch.py): основной режим менти — import готового артефакта (база), от одного восстановленного состояния две ветки-лабы: next-day (пакетно добавить сутки) и continue (живой поток, оправдывает скорость ×60). backfill в целевой модели — инструмент мейнтейнера для сборки артефакта, не первый шаг менти.

Ориентировочно 4 задачи:

1. Ядро: эталонный 3-дневный артефакт на профиле daily-wave как база менти через import. Факты: артефакт 6h = 49 МБ raw; xz -9e жмёт 48× (1,1 МБ за 13,5 с); 3 дня ≈ 13 МБ сжатого — кладётся в обычный git. Паттерн-образец: airflow-greenplum-solution (bookings/seed/demo.sql.xz). Открыто: нужен ли артефакту raw_topics или хватит компактного state.
2. Один учебный профиль: daily-wave (волна, ×60) — учебный, ci (×1, плоский) — служебный для тестов; форма не должна подсовывать ci первым. Перед слиянием проверить, не зависит ли runtime-seam-тест от скорости ×1.
3. Расписание + инкремент: беспараметрный DAG next-day (удобство менти и пригодность к schedule) + инкрементальные счётчики manifest: сейчас next-day перечитывает всю Kafka-историю с нуля — O(N²) по дням и рост RAM (риск OOM); замер: день 2 = 638 с, узкое место — генерация+пересчёт, не ETL (30 с). Параллелить нельзя (детерминизм), правильный рычаг — накопленное состояние счётчиков в manifest/state.
4. Баг-фиксы: F5 — быстрый разлогин Airflow и Superset (ротация секрета исключена; копать время жизни сессии/cookie); F4 — JS-ошибка авто-refresh в Airflow Grid (косметика, низкий приоритет).

Отдельная линия (после инфраструктуры): три режима → свои лабы в docs/course/ (import — общая база; next-day — пакетная инкрементальная обработка; continue — потоковый приём).

Пилот GitHub Issues (решение пользователя 2026-07-19)

Новый процесс для этой фичи:

• Спека редизайна — файлом в репозитории (материал — hitl-findings из истории git, см. выше).
• Тонкий корневой issue на GitHub со ссылкой на спеку и чекбоксами на дочерние issues; дочерние — полноценные самодостаточные постановки.
• Triage-метки — пять канонических ролей из docs/agents/triage-labels.md как настоящие метки GitHub.
• В том же заходе поправить контракт: AGENTS.md и docs/agents/issue-tracker.md сейчас говорят «GitHub Issues не используются» — заменить на правила пилота. Старые задачи не мигрировать (архив в истории git).

Что дальше (порядок)

1. Спека редизайна пути менти в docs/specs/ (из hitl-findings).
2. Обновить контракт трекера (AGENTS.md, docs/agents/issue-tracker.md).
3. Корневой issue + 4 дочерних на GitHub, метки.
4. Работа по задачам конвейером claude-subagent-playbook.

Состояние стенда

Стенд поднят: мир 1,25 суток на профиле ci, model_t_end = 2026-01-02 06:00, live-генератор не запущен, дашборд — Superset id 1. Для новой работы, скорее всего, понадобится чистый прогон (make clean).

Suggested skills

• claude-subagent-playbook — конвейер задач.
• conventional-commits — коммиты.
• research / Context7 — фактура для спеки (формат артефакта, Airflow schedule).