# Repository Working Agreement

- Never commit a real API key, `.env`, Docker secret, private document, or restricted evaluation sample.
- Keep backend code under `backend/`, frontend code under `frontend/`, and all design decisions under `docs/`.
- Prefer a modular monolith and small, reviewable changes. Do not introduce a new service or dependency without documenting why it is needed.
- Preserve traceability from every answer citation to a document version, page, section, and chunk.
- Run `make verify` before every commit and push each verified delivery stage.
- Update or add an ADR when changing the vector store, model API mode, embedding dimension, chunking contract, or deployment topology.
- Do not claim that OCR of a map is equivalent to spatial understanding of the map.