feat: harden OpenSpec agent resilience

2026-08-26 10:11:02 +03:00
parent 6719160c13
commit 8462a3ba75
15 changed files with 798 additions and 320 deletions
@@ -0,0 +1,44 @@
+## Why
+
+Вторая независимая оценка подтвердила зрелость текущего SDD workflow, но
+выявила несколько остающихся рисков для работы AI-агента: критические правила
+теряются внутри плотных инструкций, исходная форма Delta Specs подталкивает к
+одному виду изменения, а разные причины planning failure и задачи без прямого
+поведенческого покрытия могут интерпретироваться неоднозначно. Эти риски нужно
+снизить сейчас, пока workflow остаётся компактным и его принятые границы можно
+сохранить без нового процессного слоя.
+
+## What Changes
+
+- Сделать критические правила SDD короче и заметнее, сохранив их единственный
+  authoritative источник и принятые границы артефактов.
+- Сделать исходную форму Delta Specs нейтральной к виду изменения, чтобы она не
+  склоняла агента к неверной операции и не создавала пустых разделов.
+- Различать исправимые нарушения planning artifact, ошибки вызова workflow и
+  проблемы окружения, чтобы агент изменял artifact только по относящейся к нему
+  диагностике.
+- Требовать содержательного объяснения технической необходимости для задач без
+  прямого покрытия Requirement и направлять Apply к явно объявленному контексту
+  затронутых областей.
+- Включить выводы второго аудита в существующий remediation workflow, сохранив
+  внешние рекомендации как evidence для triage, а не как project authority.
+- Не вводить persistent approval markers, дополнительные planning или
+  completion artifacts, универсальную repository topology, отдельный context
+  mapping, Success Metrics, sizing, commit conventions, schema changelog,
+  cross-change dependency graph, CI либо числовой лимит размера инструкций.
+
+## Capabilities
+
+### New Capabilities
+
+### Modified Capabilities
+
+- `openspec-authority-and-lifecycle`: уточнить наблюдаемое поведение planning workflow для компактной передачи критических правил, нейтрального формирования Delta Specs, явного чтения разрешённого контекста и раздельной обработки artifact, invocation и environment failures.
+- `multi-repository-delivery`: уточнить contract задач без прямого Requirement coverage, сохранив детерминированную structural validation отдельно от semantic оценки их необходимости.
+
+## Impact
+
+Изменение затрагивает Engineering Owner и AI-агентов, которые планируют и
+проверяют WealthLedger changes, а также specification и as-built process
+documentation. Пользовательское поведение приложения, frontend/backend runtime
+и публичный API contract не меняются.