ddmitry/clickstream-ch-kafka-superset-demo

Files

T

Dmitry Dementiev f0370cdb90 docs(generator): добавлены задачи реализации и handoff

- Зачем:
  - переработку steady-stream генератора нужно передать агентам как набор
    проверяемых вертикальных задач, а не как один крупный rewrite.
- Что:
  - создан локальный набор из семи ready-for-agent задач для реализации новой
    иерархической модели генератора.
  - добавлен handoff с текущим состоянием обсуждения, рекомендуемым следующим
    шагом через TDD и примером команды /goal для запуска задачи 01.
- Проверка:
  - git diff HEAD~1 --stat.

2026-06-11 10:48:37 +03:00

4.0 KiB

Raw Blame History

Handoff: генератор разбит на AFK-задачи

Дата: 2026-06-11 Ветка: feature/data-generator Жанр: одноразовые леса по ADR-0003.

Где остановились

После обсуждения с пользователем дизайн переработки steady-stream генератора переведён из больших спек в локальные задачи для агентов. Код генератора не меняли.

Создан каталог задач:

.scratch/feature-data-generator/issues/01-minimal-connected-visit.md
.scratch/feature-data-generator/issues/02-visit-page-path-and-monotonic-time.md
.scratch/feature-data-generator/issues/03-tick-stream-with-active-visits.md
.scratch/feature-data-generator/issues/04-user-population-and-returns.md
.scratch/feature-data-generator/issues/05-intensity-and-flow-calibration.md
.scratch/feature-data-generator/issues/06-state-v2-and-restart.md
.scratch/feature-data-generator/issues/07-service-integration-and-docs.md

Все задачи имеют Status: ready-for-agent. Разрез сделан как последовательные вертикальные срезы, а не как слои архитектуры. Решение пользователя: идти по этому варианту.

Важный контекст

Старый генератор считаем слабым прототипом, а не ценным кодом для сохранения. Сохранять надо внешние контракты, если они полезны: топики Kafka, формат сообщений для текущего ETL, команды запуска, метрики, идею compact-топика состояния.
Отдельную задачу "зафиксировать внешний контракт" не создавали: контракт встроен в первый и последний срезы.
Детали модели не дублировать отсюда. Источники истины:
- docs/specs/2026-06-10-generator-math-model.md
- docs/specs/2026-06-09-generator-rework-hierarchical.md
- docs/adr/0004-steady-stream-synthetic-generator.md
- CONTEXT.md
- generator/KNOWN_ISSUES.md
Предыдущий handoff .scratch/handoffs/2026-06-10-generator-spec-to-codex.md остаётся полезным как предыстория спек.

Следующий шаг

Начать с задачи 01 через TDD:

написать один красный тест на публичное поведение "минимальный связанный визит";
реализовать минимальное новое генеративное ядро без Kafka;
не тащить старую плоскую модель generate_batch();
после зелёного теста переходить к следующему поведению, не писать все тесты заранее.

Пример запуска задачи:

/goal Реализовать .scratch/feature-data-generator/issues/01-minimal-connected-visit.md с использованием /tdd. Соблюдать цикл: один тест на наблюдаемое поведение → минимальная реализация → зелёный тест → остановиться и отчитаться. Не писать все тесты заранее, не реализовывать задачи 02-07.

Suggested skills

tdd — для реализации каждой задачи короткими циклами red-green-refactor.
adversarial-review или claude-team-review — после реализации нескольких срезов, чтобы сверить код с мат-спекой.
conventional-commits — при фиксации следующих изменений.

4.0 KiB Raw Blame History Unescape Escape