docs: make project documentation self-contained

This commit is contained in:
2026-09-12 13:09:37 +03:00
parent aa9afc15e4
commit 3a99af1a6e
36 changed files with 1006 additions and 703 deletions
@@ -14,15 +14,15 @@ SDD lifecycle. Native OpenSpec остаётся optional инструменто
[ADR 011](011-native-openspec-lifecycle-with-repository-gates.md) заменяет части
этого решения о schema v3, custom verifiers и dispatcher. Выбор native OpenSpec,
независимых repository gates и исходное rationale сохраняются. Ниже оставлено
историческое описание прежней реализации; действующую процедуру определяют
authorities, указанные в ADR 011. Version contract этим уточнением не меняется.
историческое описание прежней реализации; текущие принципы работы описаны
в ADR 012. Version contract этим уточнением не меняется.
## Исторический контекст и решение
WealthLedger использует project-local schema `wealth-ledger-sdd` version 3 с
На момент решения WealthLedger использовал проектную schema `wealth-ledger-sdd` version 3 с
последовательностью `Proposal → Delta Specs → Design → Tasks → Apply`, один exact
OpenSpec CLI contract из `.cli-version` и тонкие non-mutating verifiers. Это
сохраняет один lifecycle authority в `specs/openspec`, выражает approval
OpenSpec CLI contract и проверки без изменения проверяемых материалов. Это
сохраняло единый источник правил жизненного цикла в хранилище спецификаций, выражало approval
boundaries нативными extension points и не вводит второй workflow engine или
monorepo control plane для четырёх независимых Git-репозиториев.
@@ -39,8 +39,8 @@ monorepo control plane для четырёх независимых Git-репо
OpenSpec CLI закреплён exact version contract; новая stable release не включает
auto-upgrade, а смена contract является отдельным SDD change со staged
compatibility fixtures. Root `.opencode` остаётся локальным non-authority
entrypoint, а hard constraints проверяются через authority verifier. Planning
проверками совместимости. Локальная точка входа оставалась навигацией,
а обязательные ограничения проверялись отдельно. Planning
verifier до approval проверяет только детерминированную структуру: capability
set, Delivery Map, rollback, task area и Requirement coverage. Он различает
artifact-validation, неверный invocation и failure окружения, чтобы agent не