specs/openspec/changes/archive/2026-08-24-harden-agent-sdd-governance/specs/project-documentation/spec.md

ADDED Requirements

Requirement: Completion Evidence сохраняет фактическое завершение change

Durable development documentation SHALL хранить для завершённого change ссылку на canonical OpenSpec archive, Delivery Map, commit identifiers изменённых репозиториев, точные выполненные verification commands, их наблюдённые результаты и итог independent read-only review. Completion Evidence MUST создаваться из фактов после выполнения работы, MUST быть доступно из устойчивого index или registry и MUST NOT дублироваться как unchecked task либо планируемый результат внутри archived change.

Scenario: Участник проверяет основание terminal status

• WHEN участник открывает evidence завершённого change в новой сессии
• THEN он может проследить связь от change и Delivery Map к фактическим commits, локальным gates и independent review без восстановления контекста из чата

Scenario: Реализация ещё продолжается

• WHEN часть commands, commits или review ещё не существует
• THEN documentation не представляет ожидаемые значения как Completion Evidence и change остаётся незавершённым

MODIFIED Requirements

Requirement: Durable documentation is not a parallel SDD store

Репозиторий docs SHALL хранить только долговечную architecture, development, feature, audit и remediation documentation вместе с completion evidence. Документация MUST описывать фактическое текущее состояние поставленной системы и MUST NOT представлять планируемое или частично реализованное поведение как доступное. Change-specific requirements, proposals, designs, delta specifications и tasks MUST храниться только в canonical OpenSpec store и MUST NOT пересказываться в docs как параллельная спецификация в другом формате. Docs SHALL обновляться после реализации и проверки соответствующей области; она MAY ссылаться на canonical OpenSpec change, но MUST сохранять собственную as-built задачу и не копировать его нормативный текст.

Scenario: Change требует постоянной документации

• WHEN завершённый change должен оставить устойчивое объяснение фактического решения или evidence
• THEN documentation фиксирует реализованное состояние или completion evidence и ссылается на canonical OpenSpec change без дублирования его requirements, design или tasks

Scenario: Agent планирует незавершённый change

• WHEN агент создаёт requirements, design или tasks для незавершённого изменения
• THEN он сохраняет их под specs/openspec и не создаёт framework-specific planning document или описание будущего поведения в docs

Scenario: Реализация расходится с прежней документацией

• WHEN проверенный change изменяет поставленное поведение, архитектурную границу или устойчивое решение
• THEN affected docs обновляется до фактического текущего состояния до terminal status и не сохраняет прежнее утверждение как действующее