4.6 KiB
Атомарность и контекст
В основе 22 последовательных этапа и 275 карточек, включая stage gates. Карточка реализации — один module/behavior/adapter или один UI component, контракт/research — один документ с focused spike, QA gate — проверка готовых artifacts, а не реализация всего этапа.
Для небольшой модели
- Не читать tasks.json, все карточки и все specs подряд: использовать next/show/packet.
- Packet включает task outcome/scope/steps/acceptance, exact requirement text, относящиеся секции оригинальных документов и evidence paths прямых dependencies.
- Размер packet ограничен 48 000 символами; его превышение запрещает генерацию, а не обрезает требования.
- Максимум одного packet проверяется для всех карточек тестом. Остальной бюджет контекста отведён роли, contracts и небольшому исходному модулю.
- Один focused input/output, обычно 1–3 production files и focused tests. Scope patterns означают разрешение, не требование создать все перечисленные файлы/расширения.
- Shared interfaces читаются через реестр и accepted ADR; модель не изобретает API зависимости.
- Сложность crypto interoperability не устраняется размером карточки: использовать принятый backend/vector либо конкретный blocker.
Когда split обязателен
Если outcome требует несколько несвязанных user flows, изменения многих shared modules, чтения всего приложения или packet+sources не помещаются в разумный бюджет — текущий агент оформляет атомарную remediation/decomposition proposal через escalate, блокирует original и заканчивает запуск. Отдельный новый orchestrator-агент работает только над назначенной remediation. Идентификатор старой задачи не переиспользуется, status history сохраняется. Принятая small-task карточка не означает, что любая LLM гарантированно правильно реализует её; correctness устанавливает focused test и review.
Gates и coverage
Ссылка requirement в раннем этапе означает allocation/ограничение данного этапа, а не выполнение всей пользовательской функции. Gate подтверждает только deliverables своего этапа. Полная приёмка Web выполняется тематическими S21 reports и release readiness, которые сопоставляют все применимые requirements с реальными tests/evidence. Native-only требования явно excluded в requirements.json. UI Kit содержит также безномерные размеры/контракты; они включаются через ui_sections в feature packets, а не считаются покрытыми одним ID.
Изменение длинного JSON
Использовать show --json и программную точечную правку объекта по ID, не отправлять весь planning/tasks.json в контекст. После изменения sync/validate/render. Изменение definitions в нескольких checkout одновременно требует coordinator; CLI state lock не является редакторским lock definitions.
Автоматический blocker lifecycle
Original blocked → отдельная remediation → новый executor → новый reviewer → original todo/review → новая сессия. Все роли ограничены текущей карточкой. Reporter retired, bare unblock не разрешён. Максимум 3 уровня автоматического blocker nesting/6 remediation на root, затем внешний input. См. docs/AUTOMATION.md.