# Specs

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

Этот репозиторий — единственный versioned authority для change artifacts.
Workspace layout и reference 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, Completion Evidence и archives
хранятся в `openspec`; `docs` владеет as-built документацией и общей policy.

## Workflow и verification

Новые changes используют project-local schema `wealth-ledger-sdd`.
Для planning, implementation, validation и завершения читай canonical lifecycle:
[`../docs/development/openspec-authority-and-lifecycle.md`](../docs/development/openspec-authority-and-lifecycle.md).

Сначала определить current stage и capability paths через native OpenSpec
instruction; читать main specs и supporting docs только для этих paths и
affected areas. Recovery и выбор relevant evidence определяет context discipline
из [`../docs/development/agent-token-efficiency.md`](../docs/development/agent-token-efficiency.md),
а не дублируется в schema instructions.

Для structural validation из `specs`:

```bash
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
```

Под Node 22: если локальной `.nvmrc` нет, активировать frontend `.nvmrc`
через `nvm use --silent` до перехода в specs. Native structural gate проверяет
форму; terminal safeguards определяет canonical lifecycle, доступный без skills.

## 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.