43 lines
2.4 KiB
Markdown
43 lines
2.4 KiB
Markdown
# 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
|
|
|
|
Новые 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).
|
|
|
|
Сначала определить current stage и capability paths через native OpenSpec
|
|
instruction; читать main specs и supporting docs только для этих paths и
|
|
affected areas. Подробный token-efficient routing загружается по необходимости
|
|
из [`../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
|
|
```
|
|
|
|
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.
|