AGENTS.md · git:20260407.1fb2296 · 2026-04-07 · sha256 72a2ba7a9a0b3d34

AGENTS.md git:20260407.1fb2296A

Immutable. This exact content never changes and is served at /api/v1/blob/72a2ba7a9a0b3d34.

# Useful commands

```bash
npm prep          # lint + build + test
docker compose up # start database
npm run dev       # local dev server (not Docker)
npm run lint:fix
npm run test
```

# Architecture

- Next.js 16, Onion Architecture, DDD.
- Paths:
  - API routes `src/app/api/`.
  - Frontend `src/app/`
  - Backend `src/contexts/`.

# Documentation

- Detailed conventions with examples live in `docs/`.
- When working on a task, use this map to find and read **only relevant docs** to your task:

```
docs/
├── code-style.md
├── documentation-format.md
├── backend/
│   ├── api-routes-reflect-metadata.md
│   ├── dependency-injection-diod.md
│   ├── hexagonal-architecture.md
│   └── thin-api-routes.md
├── database/
│   ├── not-null-fields.md
│   ├── table-naming-singular-plural-convention.md
│   └── text-over-varchar-char-convention.md
└── testing/
    ├── mock-objects.md
    └── object-mothers.md
```