feat: harden OpenSpec SDD workflow

2026-08-26 00:42:35 +03:00
parent 039b72eed3
commit a8b2c4eed9
42 changed files with 4024 additions and 181 deletions
@@ -0,0 +1,58 @@
+## Why
+
+WealthLedger уже использует строгий SDD lifecycle, но его качество сейчас
+зависит от нескольких разрозненных соглашений и ручной семантической проверки.
+Собранные независимые оценки выявили повторяющиеся риски: требования могут быть
+недостаточно явно связаны с работой по их поставке, ответственность задач в
+multi-repository workspace может читаться неоднозначно, а восстановление и
+эволюция workflow требуют слишком много неявного знания. Эти риски стоит
+устранить до следующих remediation changes, чтобы последующая разработка
+опиралась на воспроизводимый и проверяемый процесс.
+
+## What Changes
+
+- Установить единый проверяемый контракт качества SDD, связывающий изменяемые
+  требования, запланированную delivery-работу и ответственность каждой области.
+- Сделать возврат к upstream artifact, повторное утверждение и риск-обусловленный
+  rollback явными частями lifecycle, не создавая параллельных planning artifacts.
+- Обеспечить воспроизводимость project-owned agent workflow и управляемую
+  совместимость при будущей смене поддерживаемой версии инструмента.
+- Сохранить исходные multi-source audit assessments неизменными и дать каждому
+  нормализованному замечанию проверяемый итог: исправление, подтверждённое
+  существующее покрытие, осознанное отклонение либо отложенный trigger.
+- Разделить устойчивую policy, artifact-specific guidance и автоматические
+  guardrails так, чтобы обязательное правило имело одного владельца и не
+  зависело от необязательного чтения дополнительного контекста.
+
+Не входят в change: изменение поведения приложений или публичных контрактов,
+создание универсального SDD framework для других проектов, отдельный ускоренный
+lifecycle, новая модель identity для owner approval, дополнительные planning
+artifacts и общий механизм зависимостей между changes без наблюдаемой
+потребности.
+
+## Capabilities
+
+### New Capabilities
+
+Нет.
+
+### Modified Capabilities
+
+- `openspec-authority-and-lifecycle`: усилить воспроизводимость workflow,
+  совместимость поддерживаемой версии, проверки planning artifacts и
+  контролируемый возврат к изменённому upstream artifact.
+- `multi-repository-delivery`: сделать ownership задач и покрытие изменяемых
+  требований явными и проверяемыми для каждой delivery area.
+- `engineering-change-governance`: дополнить risk-based planning обязательной
+  rollback discipline для труднообратимых изменений и проверяемыми SDD
+  guardrails.
+- `audit-remediation-workflow`: поддержать неизменяемое multi-source audit
+  evidence и нормализованные dispositions без превращения внешних оценок в
+  authority проекта.
+
+## Impact
+
+Изменение затрагивает Change Owner и AI-агентов, которые создают, утверждают,
+реализуют и проверяют WealthLedger changes. Оно изменяет нормативный SDD
+workflow и его as-built process documentation, но не меняет frontend, backend,
+пользовательское поведение или runtime API contracts.