Files
specs/openspec/changes/harden-openspec-sdd-agent-resilience/proposal.md
T

45 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 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 не меняются.