diff --git a/AGENTS.md b/AGENTS.md index e193ac7..da52c62 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -14,5 +14,6 @@ git status --short - `adr/` - долгоживущие решения, `architecture/` - устройство системы, `development/` - процесс разработки, `features/` - фактическое поведение завершенных фич. - Для диаграмм использовать Mermaid в Markdown. Feature-документация описывает пользовательский поток, API-сценарий и ограничения. -- Не хранить OpenSpec-артефакты, код приложений или секреты; требования и task-план остаются в `../specs/openspec`. -- Для задачи по Audit ID, продолжения remediation или выбора следующего улучшения сначала прочитать [`development/audit-remediation.md`](development/audit-remediation.md); canonical OpenSpec store — `wealth-ledger-specs`. +- Не хранить OpenSpec-артефакты, code приложений или секреты; requirements, design, delta-specs и tasks остаются только в `../specs/openspec`. +- Не создавать и не коммитить 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`. diff --git a/development/README.md b/development/README.md index 5191c56..7270adf 100644 --- a/development/README.md +++ b/development/README.md @@ -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. diff --git a/development/openspec-authority-and-lifecycle.md b/development/openspec-authority-and-lifecycle.md new file mode 100644 index 0000000..ea35ef4 --- /dev/null +++ b/development/openspec-authority-and-lifecycle.md @@ -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 --type change --strict --store wealth-ledger-specs +```