docs(specs): version audit snapshot in docs

This commit is contained in:
2026-08-23 12:49:30 +03:00
parent ea587970ae
commit ead48345de
5 changed files with 21 additions and 19 deletions
@@ -1,6 +1,6 @@
## Context
См. мотивацию в `proposal.md`. `audit-20-08-2026.md` является dated evidence snapshot в workspace root, а frontend, backend, specs и docs — независимые Git-репозитории. OpenSpec already captures a concrete change, но не даёт сводного состояния всех ещё не начатых audit findings и не связывает terminal status с evidence по нескольким Git roots.
См. мотивацию в `proposal.md`. Корневой `audit-20-08-2026.md` является исходной локальной копией dated evidence snapshot; её versioned canonical copy будет храниться в `docs/audits/audit-20-08-2026.md`. Frontend, backend, specs и docs — независимые Git-репозитории. OpenSpec already captures a concrete change, но не даёт сводного состояния всех ещё не начатых audit findings и не связывает terminal status с evidence по нескольким Git roots.
## Goals / Non-Goals
@@ -20,11 +20,11 @@
## Decisions
### Один versioned registry в `docs/development`
### Versioned snapshot в `docs/audits` и один registry в `docs/development`
`docs/development/audit-remediation.md` становится единственным живым обзором audit findings. Dated audit остаётся evidence source и содержит полные доказательства; registry хранит только ID, краткую цель, priority, status, linked change, affected repositories, next action и terminal evidence. Это предотвращает расхождение двух полных копий аудита и даёт Git history именно там, где хранится устойчивая документация.
`docs/audits/audit-20-08-2026.md` становится неизменяемым canonical evidence source под Git. `docs/development/audit-remediation.md` становится единственным живым обзором audit findings и хранит только ID, краткую цель, priority, status, linked change, affected repositories, next action и terminal evidence. Это предотвращает расхождение двух полных копий аудита, отделяет historical evidence от текущего workflow и даёт Git history в durable documentation repository.
Альтернатива — обновлять dated audit checkboxes — отклонена, потому что это смешивает состояние снимка на 20.08.2026 с последующими решениями. Альтернатива — использовать только active/archived OpenSpec directories — отклонена, потому что они не представляют ещё не начатые findings одним приоритетным списком.
Альтернатива — хранить evidence snapshot внутри OpenSpec change — отклонена: archive перемещает change и делает постоянную ссылку нестабильной. Альтернатива — обновлять dated audit checkboxes — отклонена, потому что это смешивает состояние снимка на 20.08.2026 с последующими решениями. Альтернатива — использовать только active/archived OpenSpec directories — отклонена, потому что они не представляют ещё не начатые findings одним приоритетным списком.
### Реестр контролирует выбор, OpenSpec контролирует реализацию
@@ -40,7 +40,7 @@ Registry допускает не более одной `active` записи и
### Progressive discovery через короткие локальные ссылки
`docs/development/README.md` индексирует registry. Каждый versioned local `AGENTS.md` в frontend, backend, specs и docs получает короткую ссылку «для audit-derived work прочитать registry и связанный OpenSpec change». Инструкции не копируют statuses и audit details. Root `AGENTS.md` остаётся компактной картой workspace и не становится отдельным, неверсированным backlog source.
`docs/audits/README.md` индексирует immutable snapshots, а `docs/development/README.md` — registry. Каждый versioned local `AGENTS.md` в frontend, backend, specs и docs получает короткую ссылку «для audit-derived work прочитать registry, snapshot и связанный OpenSpec change». Инструкции не копируют statuses и audit details. Root `AGENTS.md` остаётся компактной картой workspace и не становится отдельным, неверсированным backlog source.
Альтернатива — ссылка только в root `AGENTS.md` — отклонена: agent может открыть один из независимых Git roots напрямую и не получить root context.
@@ -53,7 +53,8 @@ Registry допускает не более одной `active` записи и
## Migration Plan
1. Создать development registry и индекс со всеми confirmed findings от 20.08.2026 в состоянии `planned`.
2. Добавить local instruction links и проверить их из каждого Git root.
3. Пометить `stabilize-frontend-query-and-strict-contracts` как единственную следующую задачу, не создавая этот functional change в данном scope.
4. Проверить change в canonical store; после implementation и archive использовать registry для первого functional remediation change.
1. Скопировать immutable audit snapshot в `docs/audits`, добавить index и зафиксировать его как canonical source для registry.
2. Создать development registry и индекс со всеми confirmed findings от 20.08.2026 в состоянии `planned`.
3. Добавить local instruction links и проверить их из каждого Git root.
4. Пометить `stabilize-frontend-query-and-strict-contracts` как единственную следующую задачу, не создавая этот functional change в данном scope.
5. Проверить change в canonical store; после implementation и archive использовать registry для первого functional remediation change.