Files
specs/openspec/changes/establish-audit-remediation-workflow/proposal.md
T

3.1 KiB
Raw Blame History

Why

Аудит от 20.08.2026 фиксирует подтверждённые технические находки, но сам является неизменяемым снимком и не отвечает, какую задачу продолжать в новой сессии, что уже завершено и каким evidence это подтверждено. Без отдельного реестра агенту приходится заново интерпретировать аудит и OpenSpec archives, из-за чего растёт риск взять не тот change или преждевременно считать находку закрытой.

What Changes

  • Сохранить неизменяемый versioned snapshot аудита в docs/audits и добавить долговечный remediation registry в docs/development, связанный с этим snapshot.
  • Ввести machine-readable-in-spirit правила статусов planned, active, done, deferred и accepted, включая обязательные поля evidence для каждого terminal status.
  • Зафиксировать один путь продолжения работы: реестр указывает одну следующую рекомендуемую задачу и связывает каждую активную работу с canonical OpenSpec change.
  • Добавить краткие ссылки на реестр в локальные agent instructions, не дублируя в них backlog.
  • Описать, как закрытие OpenSpec change обновляет реестр с archive path, commits и результатами non-mutating verification.

Capabilities

New Capabilities

  • audit-remediation-workflow: единый способ планировать, продолжать и подтверждать исправление findings из технического аудита между сессиями и независимыми Git-репозиториями.

Modified Capabilities

  • project-foundation: локальные AGENTS.md направляют агента к durable remediation registry, когда работа связана с аудитом.
  • project-documentation: документация процесса хранит remediation registry и доказательства завершения audit-derived changes.

Impact

Затрагиваются specs/openspec (новый capability и требования), docs/audits (versioned audit snapshot), docs/development (реестр и индекс) и короткие ссылки в AGENTS.md репозиториев frontend, backend, specs и docs. API, модель данных, runtime-код и зависимости не меняются. Первой функциональной задачей, которую реестр должен сделать однозначно доступной, остаётся будущий change stabilize-frontend-query-and-strict-contracts для WL-P1-01 и WL-P1-02.