AI Agents Rules (summary)

Full rules: repository root AGENTS.md.

Plane workflow:

Plane Task Template — стандартные секции для Plane issues и current-plane-task.md
Plane Task Execution Rules — scope, verification, security, DoD для агентов
Git / Plane Traceability — direct commits to main, commit format, DoD, risks

Git and Plane traceability

Workflow: direct commits to main; pull request не обязателен.
Commit message format: [MHPAY-XXX] <краткое описание> (например [MHPAY-123] Implement feature).
Plane issue id в комментариях к коду — только при долговременной архитектурной/операционной причине.
Полный DoD checklist и risk warning: Git / Plane Traceability.

Before any new task, read in order:

Then open only files relevant to the task domain — do not rescan the entire repo by default.

Update docs/docs/ai-agents/current-implementation-state.md (see checklist in that file).

Read AGENTS.md before changes
Keep docs in sync with API/UI/architecture changes
Documentation sync (mandatory): code is the source of truth. After behavior/API/UI/role/route/env/architecture changes, update the docs portal (docs/) in the same iteration — operator guides (ru/en/id), API docs, screenshots for significant UI changes. Local preview: run docs/run-dev.cmd (VitePress on port 5174).
Add bank formats via new adapters only
Bank fixtures: never commit real bank files; use only sanitized fixtures under Fixtures/BankStatements/; do not paste raw bank lines into code/docs/tests/Plane comments; run python tools/security/guard-bank-files.py . before handoff — see Bank Statement Fixture Policy
Syrve/iiko writes must be idempotent, audited, approval-gated
Reuse UI components; no copy-paste tables/forms
Update dependencies centrally (Directory.Packages.props, npm lockfiles)
Codegraph: read codegraph/manifest.yaml before architecture/API/component changes; see Codegraph / MCP
JSON: no System.Text.Json; Newtonsoft via PayJsonSerializer / NewtonsoftJsonDefaults; typed DTOs only — no JToken/JObject