backend/AGENTS.md

Backend router

Общие инструкции — workspace AGENTS. Объединяй triggers задачи, путей и обнаруженных boundaries; читай только нужные темы до решения. Sources выбирает факты/spec/ADR по возникшему вопросу.

Решение / сигнал	Читать
Первое знакомство, data flow, общая архитектура	Mental model
Module/layer/public API/DI/suffix, owner, перенос responsibility	Modules/application
TS vocabulary, domain literals, magic values	Types/values
Controller/DTO/validation, route/status/response, OpenAPI	HTTP API
Application/domain/HTTP error, exception, code	Errors
Repository/Prisma/query, transaction, migration, atomic write	Data
Tests или behavior с regression risk	Testing
JWT/cookie/session/guard/access, encryption, secrets	Security
External client/gateway/SDK/proto, retry/rate limit/cache	Integrations
Logging/context/levels, sensitive logs	Observability; sensitive data также Security
Изменение публичного wire contract / Swagger metadata	HTTP API + HTTP contract source
Helper/dependency/новый pattern, refactor/scope	Code health, для пакета — Dependencies
Выбор gate, tooling, завершение	Guardrails

Новый endpoint обычно требует HTTP API + Testing; Data/Security добавляются по persistence/access trigger. Auth refresh активирует Security + Data + Testing. Повтори routing по итоговому diff, включая новые файлы. Migration backlog читается только при соответствующем finding через plan.