docs(specs): plan bounded SDD workflow

2026-09-06 18:22:17 +03:00
parent 0386b6b26f
commit 50a6721a60
6 changed files with 734 additions and 0 deletions
@@ -0,0 +1,59 @@
+## 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-поведение приложения.