# Repository Instructions

## Project Map
- Read `PROJECT_MAP.md` before doing substantive work in this repo.
- Treat `PROJECT_MAP.md` as the primary orientation file for code structure, hot paths, feature ownership, and known issues.
- Update `PROJECT_MAP.md` when commands, modules, feature areas, persistence contracts, or major known issues change.
- After any meaningful structural or user-facing change, append a short one-line entry to the `PROJECT_MAP.md` change log.