Files
specs/openspec/changes/archive/2026-08-26-harden-openspec-sdd-agent-resilience/proposal.md
T

3.7 KiB
Raw Blame History

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 не меняются.