specs/AGENTS.md

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.

Сначала определить 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, а не дублируется в schema instructions.

Для structural validation из specs:

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.