docs/AGENTS.md

Docs

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

Этот репозиторий хранит durable as-built документацию WealthLedger. Shared SDD policy, common reading pointers, audit routing и ../references/** policy задаёт root AGENTS.md.

Для SDD roles, approvals и ownership читайте governance; native planning и completion в store wealth-ledger-specs — lifecycle; recovery, fingerprints и evidence reuse — context authority. Audit-derived работа начинается с найденной записи remediation registry. Optional agent adapters не требуются.

Docs фиксирует проверенное as-built состояние. Planning и Completion Evidence принадлежат canonical ../specs/openspec; docs не хранит их параллельную копию.

Canonical gate

Перед Node-командами активировать .nvmrc через nvm use --silent; это выбирает Node 22. Не запускать отдельную проверку версии, кроме диагностики runtime issue. После lockfile install:

npm ci
npm run verify

Gate non-mutating запускает committed Markdown rules и git diff --check. Auto-fix и network/browser link checking в gate не входят; local links affected documentation проверяются scoped review. Актуальные scripts проверять в package.json/npm run.

Boundaries

• architecture/ — текущее устройство, features/ — поставленное поведение, adr/ — устойчивые решения, development/ — процесс и navigation к canonical evidence, audits/ — immutable snapshots. Legacy dated evidence не переписывается.
• Indexes должны вести к новым документам.
• Feature docs описывают фактический поток, API и ограничения, но не повторяют OpenSpec requirements/design/tasks.
• Для диаграмм использовать Mermaid в Markdown. Не хранить application code, secrets или competing SDD artifacts.

Markdown lint и whitespace checks — hard guardrails. Стилистические пожелания без локального checker являются guidance.