AGENTS.md@tests/fixtures/backend-layering · git:20261022.7f9b4d2 · 2026-10-22 · sha256 6b33ff632e3af319

AGENTS.md@tests/fixtures/backend-layering git:20261022.7f9b4d2A

Immutable. This exact content never changes and is served at /api/v1/blob/6b33ff632e3af319.

# Agent instructions

- Layers: `app/handlers.py` parses requests and shapes responses; `app/services.py` owns business rules; `app/repository.py` owns all SQL. Handlers never touch SQL, and repositories never apply business rules.
- Every endpoint is listed in `docs/architecture.md`. Keep that list current in the same change.
- Architectural decisions (new datastore, service, protocol, or cross-layer dependency) need a record in `docs/adr/`. Routine endpoints do not.
- Gate before every commit: `python3 -m unittest discover -s tests`.