specs/AGENTS.md

Specs

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

Этот репозиторий — единственный versioned SDD authority. Canonical OpenSpec store — wealth-ledger-specs, физический root от workspace — specs/openspec (локально openspec). OpenSpec commands, читающие или изменяющие change, всегда получают --store wealth-ledger-specs; nearest-root или default-store fallback запрещён.

Proposal, Delta Specs, Design, Tasks, changes и archives хранятся только в openspec. Не создавать versioned planning artifacts вне него, включая superpowers/plans; ../references/** read-only. 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. Общая policy: ../docs/development/engineering-governance.md; lifecycle: ../docs/development/openspec-authority-and-lifecycle.md; audit work: ../docs/development/audit-remediation.md.

Из workspace canonical pre-archive gate:

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

Для scoped diagnostics из specs:

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 в specs.
• Для фактической системы и терминов использовать ../docs/architecture/system-overview.md и ../docs/architecture/domain-glossary.md.