spec: finalize wealth-ledger SDD migration
This commit was merged in pull request #26.
This commit is contained in:
@@ -1,12 +1,17 @@
|
||||
# WealthLedger Specs
|
||||
|
||||
Этот репозиторий — единственный versioned SDD authority рабочей области. Canonical OpenSpec store `wealth-ledger-specs` расположен в `openspec/` (`specs/openspec` от workspace), новые changes используют project-local schema `wealth-ledger-sdd`.
|
||||
Этот репозиторий — единственный versioned SDD authority рабочей области. Canonical OpenSpec store `wealth-ledger-specs` расположен в `openspec/` (`specs/openspec` от workspace). Новые changes используют `wealth-ledger-sdd-v2`; существующие active changes с `schema: wealth-ledger-sdd` завершаются по legacy schema без автоматической миграции.
|
||||
|
||||
## Начало работы
|
||||
|
||||
OpenSpec применяется по явному запросу согласно [AGENTS](AGENTS.md). Proposal, Delta Specs, Design и Tasks создаются последовательно по одному после approval Change Owner. Для любой команды, читающей или изменяющей change, явно передавайте `--store wealth-ledger-specs`.
|
||||
OpenSpec применяется по явному запросу согласно [AGENTS](AGENTS.md). Для команд, читающих или изменяющих change, явно передавайте `--store wealth-ledger-specs`. Структурная готовность CLI не означает approval: перед каждым downstream artifact нужно явное решение Change Owner.
|
||||
|
||||
Design должен оценить `frontend`, `backend`, `specs`, `docs` в Delivery Map и при обязательном trigger включить Solution Assessment. Docs описывает as-built state и не становится параллельным store требований.
|
||||
| Change | Lifecycle |
|
||||
| --- | --- |
|
||||
| Active `schema: wealth-ledger-sdd` | Proposal → Delta Specs → Design → Tasks → Apply; действующие approvals сохраняются. Legacy Design оценивает `frontend`, `backend`, `specs`, `docs` в Delivery Map. |
|
||||
| New `schema: wealth-ledger-sdd-v2` | Proposal → Delta Specs → System Analysis → Design + QA Analysis → Docs Impact → Tasks → Apply. Design и QA Analysis готовы после System Analysis; Docs Impact ждёт обоих. |
|
||||
|
||||
Для changes без изменения observable behavior используется `skip_specs: true`. В v2 System Analysis/QA Analysis/Docs Impact всё равно фиксируют только применимое содержание и обоснованное N/A, а не фиктивные contracts или tests. `specs/openspec/specs/` хранит нормативное поведение, `docs/` — текущий AS-IS, backend-generated OpenAPI — текущий executable HTTP contract. Target contracts остаются в change до архива; docs обновляются только по согласованному Docs Impact через `[docs]` tasks. После завершения последнего legacy change эту переходную заметку можно удалить отдельным изменением.
|
||||
|
||||
## Проверка
|
||||
|
||||
@@ -14,11 +19,16 @@ Design должен оценить `frontend`, `backend`, `specs`, `docs` в Del
|
||||
|
||||
```bash
|
||||
openspec schema validate wealth-ledger-sdd --verbose
|
||||
openspec schema validate wealth-ledger-sdd-v2 --verbose
|
||||
openspec status --change <change> --store wealth-ledger-specs
|
||||
openspec validate <change> --type change --strict --store wealth-ledger-specs
|
||||
openspec validate --specs --strict --store wealth-ledger-specs
|
||||
```
|
||||
|
||||
Structural validation не заменяет semantic verification и independent read-only review перед archive.
|
||||
Версия OpenSpec CLI не закреплена отдельным файлом: при обновлении проверяйте обе
|
||||
schema, затронутые changes и canonical specs, фиксируя `openspec --version` вместе
|
||||
с результатами проверок. Structural validation не заменяет semantic verification
|
||||
и independent read-only review перед archive.
|
||||
|
||||
Node задаётся собственной `.nvmrc`; после `nvm use --silent` выполните `npm ci`.
|
||||
`npm run verify` проверяет diff. OpenSpec validation остаётся отдельной проверкой
|
||||
|
||||
Reference in New Issue
Block a user