docs(generator): добавлены задачи реализации и handoff
- Зачем:
- переработку steady-stream генератора нужно передать агентам как набор
проверяемых вертикальных задач, а не как один крупный rewrite.
- Что:
- создан локальный набор из семи ready-for-agent задач для реализации новой
иерархической модели генератора.
- добавлен handoff с текущим состоянием обсуждения, рекомендуемым следующим
шагом через TDD и примером команды /goal для запуска задачи 01.
- Проверка:
- git diff HEAD~1 --stat.
This commit is contained in:
@@ -0,0 +1,66 @@
|
||||
# Handoff: генератор разбит на AFK-задачи
|
||||
|
||||
Дата: 2026-06-11
|
||||
Ветка: `feature/data-generator`
|
||||
Жанр: одноразовые леса по [ADR-0003](../../docs/adr/0003-handoffs-in-scratch.md).
|
||||
|
||||
## Где остановились
|
||||
|
||||
После обсуждения с пользователем дизайн переработки 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:
|
||||
|
||||
1. написать один красный тест на публичное поведение "минимальный связанный
|
||||
визит";
|
||||
2. реализовать минимальное новое генеративное ядро без Kafka;
|
||||
3. не тащить старую плоскую модель `generate_batch()`;
|
||||
4. после зелёного теста переходить к следующему поведению, не писать все тесты
|
||||
заранее.
|
||||
|
||||
Пример запуска задачи:
|
||||
|
||||
```text
|
||||
/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` — при фиксации следующих изменений.
|
||||
Reference in New Issue
Block a user