chore(scratch): уборка одноразовых материалов и handoff новой фичи

- Зачем:
  - после слияния feature/data-generator одноразовые материалы .scratch
    (задачи 01-21, PRD, журналы, старые handoff'ы) больше не нужны:
    долговечное живёт в docs/, история — в git (срез 0e312b3).
- Что:
  - удалено всё содержимое .scratch (50 файлов).
  - добавлен handoff 20260719-2229-mentee-path-start.md: направление
    редизайна пути менти (4 задачи) и пилот GitHub Issues.
- Проверка:
  - git show --stat; в .scratch остался только новый handoff.
This commit is contained in:
2026-07-19 22:29:44 +03:00
parent 0e312b3c6c
commit de7f62cbab
48 changed files with 89 additions and 5114 deletions
@@ -0,0 +1,89 @@
# 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 00040006, спеки, 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`).