docs(specs): archive session workflow changes

2026-08-27 15:24:31 +03:00
parent 69d4e63a51
commit 216956e0c6
14 changed files with 1014 additions and 0 deletions
@@ -0,0 +1,48 @@
+## Why
+
+AI-assisted работа над одним change сейчас может смешивать discovery,
+спецификацию, реализацию, проверку и завершение в одной задаче. Из-за этого
+контекст растёт без явной границы, проверка получает reasoning реализации и
+сложнее независимо оценить результат. Нужен повторяемый способ начинать и
+продолжать SDD-работу отдельными сессиями, не меняя OpenSpec как источник
+истины.
+
+## What Changes
+
+Ввести session-oriented SDD workflow для агентов: каждая сессия выполняет только
+одну из ролей Discovery, Specification, Implementation, Validation или
+Finalization, передаёт следующей сессии минимальное явное состояние и
+останавливается на границе фазы. Пользователь сможет начать или продолжить
+change без ручного восстановления всей истории; следующая фаза будет
+определяться сохранённым состоянием.
+
+Workflow сохраняет OpenSpec единственным источником требований, delta specs,
+design и tasks. История выполнения и краткие handoff-данные не дублируют
+спецификацию и не загружаются в новую сессию без необходимости. Validation
+остается независимой от Implementation и не исправляет реализацию.
+
+Non-goals:
+- Не изменяются существующий OpenSpec artifact graph, approval gates, canonical
+  store или archive blockers.
+- Не вводятся автоматическое выполнение нескольких фаз, собственный workflow
+  CLI, автоматические метрики либо отдельные domain-specific workflows.
+- Не меняется продуктовое поведение frontend, backend или публичный API.
+
+## Capabilities
+
+### New Capabilities
+- `agent-sdd-session-workflow`: агентский workflow, который изолирует SDD-фазы,
+  передаёт минимальное состояние между сессиями и сохраняет OpenSpec
+  единственным источником спецификации.
+
+### Modified Capabilities
+- _none_
+
+## Impact
+
+- Разработчики, которые запускают SDD-задачи с AI-агентами: явные границы роли
+  и повторяемое продолжение change.
+- Процесс Engineering/SDD: независимая validation, минимальная загрузка
+  контекста и сохраняемая история переходов фаз.
+- Workspace agent entrypoints и canonical OpenSpec specs: появляется новый
+  процессный capability без изменений приложений или API.