diff --git a/AGENTS.md b/AGENTS.md index 28f262a..c6709be 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,9 +2,16 @@ ## Назначение и authority -React/Vite-клиент WealthLedger. Canonical OpenSpec store — `wealth-ledger-specs` в `../specs/openspec`; OpenSpec commands, читающие или изменяющие change, всегда выполняются с `--store wealth-ledger-specs`. Versioned planning artifacts вне canonical store запрещены, включая `superpowers/plans`; `../references/**` read-only. +React/Vite-клиент WealthLedger. Shared SDD policy, common reading pointers, +audit routing и `../references/**` policy задаёт root `AGENTS.md`. -Перед изменением поставленного поведения прочитать [`../docs/architecture/system-overview.md`](../docs/architecture/system-overview.md), а для доменных терминов — [`../docs/architecture/domain-glossary.md`](../docs/architecture/domain-glossary.md). Testing, build-versus-buy и Delivery Map определены в [`../docs/development/engineering-governance.md`](../docs/development/engineering-governance.md). Audit-derived работа начинается с [`../docs/development/audit-remediation.md`](../docs/development/audit-remediation.md). +Canonical SDD authority находится в `wealth-ledger-specs`, физически в +`../specs/openspec` от этого репозитория. Любая OpenSpec command, читающая или +изменяющая change, должна использовать `--store wealth-ledger-specs`. + +Frontend-specific conventions: [`docs/CONVENTIONS.md`](docs/CONVENTIONS.md), +[`docs/STRUCTURE.md`](docs/STRUCTURE.md), [`docs/API-LAYER.md`](docs/API-LAYER.md), +[`docs/UI-PATTERN.md`](docs/UI-PATTERN.md) и [`docs/TESTING.md`](docs/TESTING.md). ## Canonical gate @@ -16,6 +23,7 @@ npm run verify ``` Gate non-mutating и проверяет runtime, OpenAPI snapshot, hygiene, strict TypeScript, Biome, risk-based tests/coverage ratchet, Knip, dependency boundaries, build и bundle budget. `npm run openapi:sync` — отдельная записывающая команда для атомарного обновления snapshot/types; runtime contract обеих сторон сверяется из workspace через `bash specs/scripts/verify-runtime-openapi.sh`. +Актуальные scripts проверять в `package.json`/`npm run`. ## Enforceable boundaries