ddmitry/clickstream-ch-kafka-superset-demo

Files

T

ddadmin 79c2c2657c docs(generator): уточнены задачи по модельному времени

- Зачем:
  - ревью выявило слабые места в критериях приёмки модельного времени.
- Что:
  - уточнены правила повторяемости, чистого прогона и review gate.
  - добавлены критерии для однородности визита через восстановление и T_end.
  - обновлён handoff с важными рисками для следующего агента.
- Проверка:
  - git diff --check.

2026-06-14 16:12:46 +03:00

4.7 KiB

Raw Blame History

Handoff: задачи по модельному времени и стартовой истории

Дата: 2026-06-14 Жанр: одноразовый handoff по ADR-0003.

Что сделано

Создан рабочий набор артефактов для следующей фазы работ:

.scratch/generator-model-time-startup-history/PRD.md
.scratch/generator-model-time-startup-history/issues/01-time-and-startup-history-contract.md
.scratch/generator-model-time-startup-history/issues/02-model-time-to-clickhouse.md
.scratch/generator-model-time-startup-history/issues/03-model-speed-and-day-factor.md
.scratch/generator-model-time-startup-history/issues/04-state-v2-model-resume.md
.scratch/generator-model-time-startup-history/issues/05-startup-history-backfill-to-clickhouse.md
.scratch/generator-model-time-startup-history/issues/06-generated-history-as-analytics-source.md

Артефакты режут работу на 6 последовательных issue и 2 review gate. Главная идея: каждый кодовый срез должен подтверждаться через ClickHouse, а не только локальными тестами генератора. Финальная проверка дашбордов глазами остаётся в конце.

Важные решения

Координатор не берёт /goal на всю цепочку: один worker получает один issue.
Worker работает через /tdd, не коммитит и не реализует следующие задачи.
После реализации worker делает саморевью без правок.
Координатор классифицирует находки и коммитит сам.
После задачи 3 нужен review gate по сквозному инварианту времени.
После задачи 5 нужен review gate по распределениям и двум путям генерации.
Для review gate после задачи 5 нужен reviewer другой родословной; без него координатор останавливает цепочку и отдаёт риск человеку. Это следует из docs/research/2026-06-11-subagent-coordinator-experiment.md.

Что важно не потерять

В задаче 1 нужно зафиксировать durable-контракт, а не оставить решение только в комментарии к issue.
При ×K восстановление после сбоя нельзя считать простым datetime.now(): нужна сохранённая связка модельного и настенного времени.
Короткий или долгий простой считается по модельному времени, а не по настенным минутам.
Чистый прогон должен сбрасывать не только ClickHouse, но и Kafka-топики данных и состояние генератора.
Стартовая история должна быть парным артефактом: события, слепок состояния и манифест.
Живой и восстановленный пути не должны менять контекст внутри одного визита; это известная слепая зона из research.
Задача 6 специально сужена до штатного пути стенда и документов запуска. Уроки, новые панели и улучшения дашбордов уходят в follow-up, если окажутся нетривиальными.

Suggested skills

to-issues — если понадобится переразбить или опубликовать дополнительные issue.
tdd — основной режим работы worker-а над каждым кодовым issue.
conventional-commits — перед каждым коммитом координатора.
claude-team-review или другой внешний reviewer — на двух review gate.
handoff — если работа прерывается между issue или после review gate.

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

Начать с .scratch/generator-model-time-startup-history/issues/01-time-and-startup-history-contract.md. Это HITL-задача: нужно закрепить интерфейс модельного времени, манифест стартовой истории, правило границы T_end и способ повторяемой проверки в ClickHouse.

4.7 KiB Raw Blame History Unescape Escape