docs: clarify domain and agent authority

This commit is contained in:
2026-08-25 12:06:41 +03:00
parent c68c978c91
commit 0c53c50c62
3 changed files with 66 additions and 7 deletions
+9 -2
View File
@@ -2,7 +2,13 @@
## Назначение и authority
Этот репозиторий хранит durable as-built документацию WealthLedger. Canonical OpenSpec store — `wealth-ledger-specs` в `../specs/openspec`; OpenSpec commands, читающие или изменяющие change, всегда выполняются с `--store wealth-ledger-specs`. Proposal, Delta Specs, Design, Tasks и другие versioned planning artifacts вне canonical store запрещены, включая `superpowers/plans`; `../references/**` read-only.
Этот репозиторий хранит durable as-built документацию WealthLedger. Shared SDD
policy, common reading pointers, audit routing и `../references/**` policy
задаёт root `AGENTS.md`.
Canonical SDD authority находится в `wealth-ledger-specs`, физически в
`../specs/openspec` от этого репозитория. Любая OpenSpec command, читающая или
изменяющая change, должна использовать `--store wealth-ledger-specs`.
Docs обновляется до фактического проверенного состояния affected change и не представляет planned behavior как поставленное. Artifact ownership и Completion Evidence определены в [`development/engineering-governance.md`](development/engineering-governance.md); audit-derived работа начинается с [`development/audit-remediation.md`](development/audit-remediation.md).
@@ -16,11 +22,12 @@ npm run verify
```
Gate non-mutating и запускает runtime preflight, committed Markdown rules и `git diff --check`. Auto-fix и network/browser link checking в gate не входят; local links affected documentation проверяются scoped review.
Актуальные scripts проверять в `package.json`/`npm run`.
## Boundaries
- `architecture/` — текущее устройство, `features/` — поставленное поведение, `adr/` — устойчивые решения, `development/` — процесс и Completion Evidence, `audits/` — immutable snapshots.
- Перед изменением current state сверяться с [`architecture/system-overview.md`](architecture/system-overview.md) и [`architecture/domain-glossary.md`](architecture/domain-glossary.md); indexes должны вести к новым документам.
- Indexes должны вести к новым документам.
- Feature docs описывают фактический поток, API и ограничения, но не повторяют OpenSpec requirements/design/tasks.
- Для диаграмм использовать Mermaid в Markdown. Не хранить application code, secrets или competing SDD artifacts.