docs/AGENTS.md

Docs

Назначение

Репозиторий постоянной документации WealthLedger. Функциональные изменения планируются в ../specs/openspec до реализации; docs фиксирует согласованные и фактически реализованные решения.

Проверка

git status --short
bash ../specs/scripts/verify-runtime-openapi.sh

Границы

• adr/ - долгоживущие решения, architecture/ - устройство системы, development/ - процесс разработки, features/ - фактическое поведение завершенных фич.
• Перед изменением фактического описания системы сверяться с architecture/system-overview.md и architecture/domain-glossary.md; development-документы индексируются в development/README.md.
• Для диаграмм использовать Mermaid в Markdown. Feature-документация описывает пользовательский поток, API-сценарий и ограничения.
• Не хранить OpenSpec-артефакты, code приложений или секреты; requirements, design, delta-specs и tasks остаются только в ../specs/openspec.
• Не создавать и не коммитить framework-specific planning/spec/task/design artifacts, включая superpowers/plans; ../references/** остаётся read-only исключением.
• Для задачи по Audit ID, продолжения remediation или выбора следующего улучшения сначала прочитать development/audit-remediation.md; canonical OpenSpec store — wealth-ledger-specs в ../specs/openspec, а OpenSpec commands, читающие или изменяющие change, выполнять с --store wealth-ledger-specs.