Document portable SDD workflow and Storybook catalog

This commit is contained in:
2026-09-07 22:22:13 +03:00
parent 8721e93849
commit 024e240303
8 changed files with 510 additions and 197 deletions
+13 -5
View File
@@ -6,11 +6,17 @@
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`.
Для SDD roles, approvals и ownership читайте
[governance](development/engineering-governance.md); native planning и completion
в store `wealth-ledger-specs` —
[lifecycle](development/openspec-authority-and-lifecycle.md); recovery, fingerprints
и evidence reuse — [context authority](development/agent-token-efficiency.md).
Audit-derived работа начинается с найденной записи
[remediation registry](development/audit-remediation.md). Optional agent adapters
не требуются.
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).
Docs фиксирует проверенное as-built состояние. Planning и Completion Evidence
принадлежат canonical `../specs/openspec`; docs не хранит их параллельную копию.
## Canonical gate
@@ -28,7 +34,9 @@ Gate non-mutating запускает committed Markdown rules и `git diff --che
## Boundaries
- `architecture/` — текущее устройство, `features/` — поставленное поведение, `adr/` — устойчивые решения, `development/` — процесс и Completion Evidence, `audits/` — immutable snapshots.
- `architecture/` — текущее устройство, `features/` — поставленное поведение,
`adr/` — устойчивые решения, `development/` — процесс и navigation к canonical
evidence, `audits/` — immutable snapshots. Legacy dated evidence не переписывается.
- Indexes должны вести к новым документам.
- Feature docs описывают фактический поток, API и ограничения, но не повторяют OpenSpec requirements/design/tasks.
- Для диаграмм использовать Mermaid в Markdown. Не хранить application code, secrets или competing SDD artifacts.