# Specs

## Назначение и authority

Этот репозиторий — единственный versioned SDD authority. Shared SDD policy,
common reading pointers, audit routing и `../references/**` policy задаёт root
`AGENTS.md`.

Canonical OpenSpec store — `wealth-ledger-specs`, физический root от workspace —
`specs/openspec` (локально `openspec`). OpenSpec commands, читающие или
изменяющие change, всегда получают `--store wealth-ledger-specs`.

Proposal, Delta Specs, Design, Tasks, changes и archives хранятся в `openspec`.
`docs` хранит as-built state и Completion Evidence, но не копию change artifacts.

## Workflow и verification

Поддерживаемая CLI version задана в `openspec/.cli-version`; новые changes
используют project-local schema `wealth-ledger-sdd`. Артефакты создаются по
одному после approval Change Owner. Lifecycle:
[`../docs/development/openspec-authority-and-lifecycle.md`](../docs/development/openspec-authority-and-lifecycle.md).

Из workspace canonical pre-archive gate:

```bash
bash specs/scripts/verify-workspace-change.sh <change>
```

Для scoped diagnostics из `specs`:

```bash
bash scripts/verify-openspec-version.sh
openspec schema validate wealth-ledger-sdd --verbose
openspec validate <change> --type change --strict --store wealth-ledger-specs
openspec validate --specs --strict --store wealth-ledger-specs
bash scripts/verify-openspec-authority.sh
```

Structural validation не заменяет semantic verification и independent read-only review. Tasks отмечаются только после выполненной работы; archive не допускает unchecked tasks или verification override.

## Boundaries

- Design содержит Delivery Map `frontend`, `backend`, `specs`, `docs` и условный Solution Assessment.
- Specs описывают observable behavior, не изменения кода; Design — architecture, не line-by-line implementation; Tasks — implementation checklist без будущего evidence.
- Application code и durable ADR принадлежат affected application/docs repos.