docs(specs): version audit snapshot in docs
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user