docs: document OpenSpec authority lifecycle
This commit is contained in:
@@ -14,5 +14,6 @@ git status --short
|
|||||||
|
|
||||||
- `adr/` - долгоживущие решения, `architecture/` - устройство системы, `development/` - процесс разработки, `features/` - фактическое поведение завершенных фич.
|
- `adr/` - долгоживущие решения, `architecture/` - устройство системы, `development/` - процесс разработки, `features/` - фактическое поведение завершенных фич.
|
||||||
- Для диаграмм использовать Mermaid в Markdown. Feature-документация описывает пользовательский поток, API-сценарий и ограничения.
|
- Для диаграмм использовать Mermaid в Markdown. Feature-документация описывает пользовательский поток, API-сценарий и ограничения.
|
||||||
- Не хранить OpenSpec-артефакты, код приложений или секреты; требования и task-план остаются в `../specs/openspec`.
|
- Не хранить OpenSpec-артефакты, code приложений или секреты; requirements, design, delta-specs и tasks остаются только в `../specs/openspec`.
|
||||||
- Для задачи по Audit ID, продолжения remediation или выбора следующего улучшения сначала прочитать [`development/audit-remediation.md`](development/audit-remediation.md); canonical OpenSpec store — `wealth-ledger-specs`.
|
- Не создавать и не коммитить framework-specific planning/spec/task/design artifacts, включая `superpowers/plans`; `../references/**` остаётся read-only исключением.
|
||||||
|
- Для задачи по Audit ID, продолжения remediation или выбора следующего улучшения сначала прочитать [`development/audit-remediation.md`](development/audit-remediation.md); canonical OpenSpec store — `wealth-ledger-specs` в `../specs/openspec`, а OpenSpec commands, читающие или изменяющие change, выполнять с `--store wealth-ledger-specs`.
|
||||||
|
|||||||
@@ -3,3 +3,4 @@
|
|||||||
Здесь размещаются устойчивые правила разработки, локальной проверки и поставки. Требования и планы изменений остаются в `../specs/openspec`.
|
Здесь размещаются устойчивые правила разработки, локальной проверки и поставки. Требования и планы изменений остаются в `../specs/openspec`.
|
||||||
|
|
||||||
- [Audit remediation registry](audit-remediation.md) — текущий статус findings, следующий OpenSpec change и evidence завершённых улучшений.
|
- [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
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user