docs: document OpenSpec authority lifecycle

2026-08-23 17:49:48 +03:00
parent 4cc8565524
commit 0bc8d1c9ae
3 changed files with 34 additions and 2 deletions
@@ -3,3 +3,4 @@
 Здесь размещаются устойчивые правила разработки, локальной проверки и поставки. Требования и планы изменений остаются в `../specs/openspec`.

 - [Audit remediation registry](audit-remediation.md) — текущий статус findings, следующий OpenSpec change и evidence завершённых улучшений.
+- [OpenSpec authority и lifecycle](openspec-authority-and-lifecycle.md) — единственный SDD store, границы постоянной документации и условия archive.
@@ -0,0 +1,30 @@
+# OpenSpec authority и lifecycle
+
+## Назначение
+
+Этот документ фиксирует постоянные границы SDD-процесса WealthLedger. Он не содержит requirements, design, delta-specs или tasks конкретного change: они живут только в canonical OpenSpec store.
+
+## Единственный SDD store
+
+- Canonical OpenSpec store: `wealth-ledger-specs`.
+- Физический root: `specs/openspec` относительно workspace.
+- Requirements, design, delta-specs, tasks, changes и archives создаются и коммитятся только в этом store.
+- Любая OpenSpec command, читающая или изменяющая change, явно использует `--store wealth-ledger-specs`; cwd, ближайший root и глобальная конфигурация машины не выбирают store проекта.
+
+## Границы артефактов
+
+- `docs` хранит только долговечную architecture, development, feature, audit и remediation documentation, включая completion evidence после archive.
+- `frontend` и `backend` хранят runtime code и tests, но не framework-specific planning artifacts.
+- Framework-specific requirements, plans, specs, design и task artifacts вне `specs/openspec` не создаются и не коммитятся; это включает `superpowers/plans`.
+- `references/**` — read-only reference content. Его framework artifacts не являются нарушением и не подлежат переносу или очистке без отдельной задачи.
+
+## Завершение change
+
+Archive разрешён только после завершения всех planning artifacts и всех tasks. Post-archive bookkeeping не может быть незакрытым task: после успешного archive durable registry/history фиксирует фактический archive path, commits затронутых репозиториев, команды проверки и observed results.
+
+Перед завершением change выполните из workspace:
+
+```bash
+bash specs/scripts/verify-openspec-authority.sh
+openspec validate <change> --type change --strict --store wealth-ledger-specs
+```