docs(generator): уточнены задачи по модельному времени
- Зачем: - ревью выявило слабые места в критериях приёмки модельного времени. - Что: - уточнены правила повторяемости, чистого прогона и review gate. - добавлены критерии для однородности визита через восстановление и T_end. - обновлён handoff с важными рисками для следующего агента. - Проверка: - git diff --check.
This commit is contained in:
@@ -19,12 +19,17 @@ Status: Draft
|
||||
|
||||
- Каждый кодовый срез должен заканчиваться проверкой через ClickHouse, а не
|
||||
только локальными тестами генератора.
|
||||
- Быстрый цикл внутри задачи идёт через `/tdd`: один поведенческий тест,
|
||||
минимальная реализация, зелёная проверка.
|
||||
- Кодовые AFK-задачи идут через `/tdd`: один поведенческий тест, минимальная
|
||||
реализация, зелёная проверка. HITL- и документные задачи идут через
|
||||
обсуждение и фиксацию решения, без искусственного теста.
|
||||
- Координатор не работает в `/goal` на всю цепочку. Один worker получает один
|
||||
issue, не коммитит и не реализует следующие задачи.
|
||||
- После реализации worker делает саморевью без правок. Координатор
|
||||
классифицирует находки и возвращает только обязательные исправления.
|
||||
- В задачах 03 и 05 worker заранее даёт промежуточный статус, если статистический
|
||||
прогон или стендовая проверка идут долго.
|
||||
- Если исправление после review gate меняет дизайн, формат state, манифест или
|
||||
схему проверки, результат исправления проходит повторный review gate.
|
||||
- Коммиты делает координатор после своих проверок и `git status --short`.
|
||||
- Ручная проверка дашбордов глазами выполняется только в конце всей цепочки.
|
||||
|
||||
@@ -33,16 +38,21 @@ Status: Draft
|
||||
- `event_timestamp` — модельное время, а не настенные часы компьютера.
|
||||
- Операционные метки сервиса, история пачек, метрики здоровья и длительность
|
||||
тика остаются настенным временем, если отдельная задача не докажет обратное.
|
||||
- При одинаковых `GEN_SEED`, `T0`, скорости и настройках поток повторяем.
|
||||
- Контракт задачи 1 должен разделить, где повторяемость точная, а где
|
||||
статистическая: промотка прошлого должна быть точной, живой режим зависит от
|
||||
выбранного драйвера часов.
|
||||
- При ×K модельное время и событийный бюджет идут по модельной длительности
|
||||
тика, а не по реальной длительности сна процесса.
|
||||
- Часовой пояс модельных часов явно задан в контракте; дневной коэффициент
|
||||
считается по нему, а не по неявному локальному времени.
|
||||
- После сбоя точка возобновления считается из сохранённой связки модельного и
|
||||
настенного времени, а не простым `datetime.now()`.
|
||||
- Стартовая история — это события плюс слепок состояния плюс манифест, чтобы не
|
||||
смешать данные от разных `GEN_SEED`, `T0` и `T_end`.
|
||||
- На стыке `[T0, T_end]` и живого продолжения не должно быть дублей и дыр.
|
||||
- Повторная проверка на чистом стенде должна быть воспроизводимой: либо команда
|
||||
явно чистит данные, либо процесс идемпотентен.
|
||||
явно чистит ClickHouse, Kafka-топики данных и состояние генератора, либо
|
||||
процесс идемпотентен.
|
||||
|
||||
## Задачи
|
||||
|
||||
@@ -68,9 +78,11 @@ Status: Draft
|
||||
генерации: проверить форму данных, стык истории и живого продолжения,
|
||||
однородность визита до и после восстановления.
|
||||
|
||||
Для этих контрольных точек по возможности нужен reviewer другой родословной, а
|
||||
не тот же worker: research показал, что сквозные свойства и форма распределений
|
||||
хуже ловятся одной линией проверки.
|
||||
Для review gate после задачи 3 reviewer другой родословной сильно желателен.
|
||||
Для review gate после задачи 5 он обязателен: research показал, что форма
|
||||
распределений и свойства на стыке двух путей хуже ловятся одной линией проверки.
|
||||
Если такого reviewer-а нет, координатор останавливает цепочку и явно отдаёт
|
||||
решение человеку.
|
||||
|
||||
## Финальная ручная приёмка
|
||||
|
||||
@@ -78,3 +90,6 @@ Status: Draft
|
||||
генерации: видны история, возвраты, воронка и суточное «дыхание». Если текущих
|
||||
панелей не хватает для такого просмотра, создаётся отдельная задача на панель
|
||||
или runbook, а не расширяется эта цепочка задним числом.
|
||||
|
||||
Миграция уроков по ADR-0006 сознательно отслеживается отдельно. Задача 6 должна
|
||||
создать follow-up, если учебные материалы требуют нетривиальной переделки.
|
||||
|
||||
Reference in New Issue
Block a user