60 lines
4.7 KiB
Markdown
60 lines
4.7 KiB
Markdown
## Why
|
||
|
||
Текущий session-oriented SDD уже отделяет инженерные роли и сохраняет OpenSpec
|
||
единственным источником требований, но продолжение change всё ещё требует
|
||
лишних переключений между сессиями, повторного восстановления неизменившегося
|
||
контекста и неоднозначной передачи ответственности за checkpoints,
|
||
verification и завершение. Эти издержки затрудняют локальную разработку и
|
||
создают повторную работу без дополнительной гарантии корректности. Workflow
|
||
нужно сделать проще и предсказуемее сейчас, сохранив explicit approvals,
|
||
независимую Validation и жёсткие blockers завершения.
|
||
|
||
## What Changes
|
||
|
||
- Сгруппировать тесно связанные planning artifacts в ограниченные
|
||
Specification-сессии, сохранив отдельное явное решение Change Owner перед
|
||
каждым downstream artifact.
|
||
- Сделать продолжение workflow однозначным и достаточным по минимальному
|
||
актуальному состоянию, без обязательного перечитывания неизменившейся истории
|
||
или повторного подтверждения уже принятого и не пересмотренного artifact.
|
||
- Разрешить Implementation завершать связный ограниченный batch, сохранять
|
||
оставшуюся работу и продолжаться в следующей Implementation-сессии без
|
||
ложного blocker outcome.
|
||
- Закрепить, что semantic verification, acceptance verification и independent
|
||
review принадлежат Validation, а Finalization использует актуальный PASS и
|
||
направляет проблему к точной ответственной роли без повторения неизменившейся
|
||
проверки.
|
||
- Устранить противоречия и дублирование в активных SDD и repository
|
||
instructions, сделать операционный workflow независимым от конкретного
|
||
AI-agent runtime и сохранить одну понятную authority для context discipline.
|
||
- Перенести Completion Evidence к завершённому canonical change и сохранять в
|
||
ней только уже существующие факты поставки, не вынуждая технический change
|
||
создавать несвязанное as-built documentation.
|
||
- Не вводить telemetry, числовые token budgets, автоматический multi-agent
|
||
pipeline, отдельный workflow service или database и не менять поведение
|
||
frontend/backend приложения либо публичный API.
|
||
- Не ослаблять explicit approvals, canonical gates, risk-based testing,
|
||
semantic verification, independent review или archive blockers; не
|
||
переписывать historical changes, audits и иные датированные evidence.
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
|
||
### Modified Capabilities
|
||
|
||
- `agent-sdd-session-workflow`: уточнить наблюдаемую модель bounded sessions,
|
||
approvals, восстановления контекста, Implementation checkpoints, независимой
|
||
Validation и точной маршрутизации Finalization.
|
||
- `project-documentation`: изменить контракт Completion Evidence и terminal
|
||
verification так, чтобы фактическое завершение сохранялось рядом с canonical
|
||
archived change без обязательной параллельной docs-записи.
|
||
|
||
## Impact
|
||
|
||
Change затрагивает участников, которые планируют, реализуют, проверяют и
|
||
завершают SDD changes в локальной multi-repository workspace. Он меняет
|
||
ожидаемый процесс перехода между SDD-ролями, форму durable completion evidence и
|
||
активные инженерные инструкции, но не пользовательские возможности WealthLedger,
|
||
данные, публичные контракты или runtime-поведение приложения.
|