Files
clickstream-ch-kafka-supers…/.scratch/handoffs/2026-07-04-generator-backlog-triage.md
T
ddadminandClaude Fable 5 95f9b5cbc8 docs(handoff): зафиксирован триаж бэклога и следующий шаг по 09 и 10
- Зачем:
  - продолжение работы планируется в новой сессии; нужен одноразовый
    handoff по ADR-0003 с решениями дня и точкой входа.
- Что:
  - записан handoff: рабочая форма Claude/Codex, решения по целеполаганию
    и бэклогу, очередь задач, следующий шаг — дооформить 09 и 10 до
    ready-for-agent, затем передача Codex.
- Проверка:
  - просмотр .scratch/handoffs/2026-07-04-generator-backlog-triage.md.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-04 16:39:40 +03:00

74 lines
5.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Handoff: триаж бэклога генератора и целеполагание стенда
Дата: 2026-07-04
Жанр: одноразовый handoff по ADR-0003.
## Рабочая форма (зафиксирована сегодня)
С Claude — обсуждение проекта, планы, проектные документы и независимые ревью.
Исполнение кода — Codex, предпочтительно через `/goal` или `/coordinator-loop`.
Сохранено в памяти Claude (memory), новая сессия подхватит автоматически.
## Что решено и зафиксировано
- **Целеполагание сверено** и записано в `docs/course/PRD.md` §1 (поправка
2026-07-04): три части трека ClickHouse (теория — внешние курсы, лабы —
clickhouse-learning-cluster, этот стенд — интеграции «как в жизни»); иерархия
целей: курс -> стенд-носитель -> генератор как скрытая инфраструктура.
- **Развилка «урок про генератор» закрыта**: урока не будет, генератор — скрытая
инфраструктура (PRD §7).
- **Демо-употребление устарело**: `docs/DEMO_CHEATSHEET_5MIN.md` и
`docs/DEMO_SCRIPT_10_15MIN.md` удалены, демо выросло в отдельный проект.
- **Новая открытая развилка** в PRD §7: кластерная конфигурация ClickHouse
(пользователь склоняется к «всё в одном», решение не принято).
- **Конвенция трекера**: завершённая задача — `Status: done`
(`docs/agents/issue-tracker.md`); задачи 01–06 фичи переведены в `done`
(стояли ошибочные `ready-for-human` от глючившего координатора).
## Бэклог фичи `generator-model-time-startup-history`
Список задач и порядок — в PRD фичи (раздел «Задачи», дополнен сегодня):
- **07** (артефакт + runbook, `ready-for-agent`) — импорт строго через Kafka
(напрямую в ClickHouse не пишет — решение пользователя), громкий отказ при
несовместимом state (пересмотр правила спеки), граница runbook «использование,
не устройство». Режим ревью — гейт.
- **08** (миграция курса, `ready-for-agent`) — после 07; `make data` вплетён во
все уроки 00–05, объём больше, чем кажется; тонкое место — урок 00.
- **11** (глаголы/длительность/профили, `ready-for-agent`) — после 07, до 12.
- **12** (DAG-пульт, `needs-triage`) — дооформить после 07 и 11; приоритет
поднят пользователем: будущий основной человеческий интерфейс стенда.
- **13** (доливка, `needs-triage`) — без приоритета, после фикса 09.
- Перестановка: бывший 07 (миграция) и 08 (артефакт) поменяны местами.
## Следующий шаг
Дооформить до `ready-for-agent` два независимых issue (можно параллельно с
остальной очередью):
1. **09 — баг браузерной фактуры на стыке.** Нет секции Acceptance criteria;
зафиксировать выбор направления фикса (сериализация фактуры в state против
выбора по абсолютному `event_index`; второе не трогает схему state) и
требование теста по per-event полям `dds.event`, включая crash-recovery
(гипотеза: тот же restore-механизм). Режим ревью — гейт (state).
2. **10 — гео-карта.** Прописать способ приёмки (Playwright-скриншоты, что
считать «читаемо»); учесть, что стенд с 14 июня мог умереть, а полная
пересборка регенерирует backfill.
После этого весь бэклог готов к передаче Codex (`/goal` на задачу или
`/coordinator-loop` на цепочку 07 -> 08 / 07 -> 11 -> 12).
## Не забыть (вне бэклога)
Открытые пробелы независимого ревью от 2026-06-14 (см. handoff
`2026-06-14-generator-model-time-verification-review.md`): ×K не гоняли,
live-crash recovery не воспроизводили, распределения не сверяли с коридорами
мат-спеки, воспроизводимость checksum не перепроверяли.
## Suggested skills
- `conventional-commits` — перед коммитами.
- `tdd` — для фикса issue 09 (тест на однородность браузера через стык, затем
минимальная правка).
- `coordinator-loop` — на цепочки 07 -> 08 и 07 -> 11 -> 12.