/ — AGENTS.md

Скопируйте этот файл в backend/internal/core/<bc>/<submodule>/AGENTS.md и заполните плейсхолдеры.

Суб-модуль bounded context <bc>. Агрегат(ы): <name(s)>.

Scope

  • Агрегат(ы): <list>
  • DB-таблицы, которыми владеет: <list>
  • OpenAPI-пути, которыми владеет: <list>

Hard rules (в дополнение к backend/AGENTS.md)

  1. Не импортировать пакеты соседних суб-модулей того же BC. Нужна логика из <other-submodule> — объявить consumer-owned порт в собственном domain/port_<thing>.go; адаптер — в собственном infra/; проводка — в core/<bc>/di.go.
  2. Общие SQL-помощники — только core/<bc>/kernel/infra/pg. Не дублировать их в infra/postgres/.
  3. Новый HTTP-endpoint → сначала обновить OpenAPI-схему docs/docs/20-architecture/schemas/api/*.yaml.
  4. Новый код ошибки → сначала добавить в internal/platform/errors/registry.go.
  5. Тесты: mockery для портов; integration-тесты — testutil/pgtest.

Commands

make backend-test
make backend-archlint
mockery
  • BC-level AGENTS: ../AGENTS.md
  • Service-doc: docs/docs/30-services/<bc>/README.md
  • ADR-0031: docs/docs/20-architecture/adr/0031-microkernel-submodules-per-bounded-context.md