# Agent Guide

When making any updates to the repository, decide if there is useful information to get from the docs first.

## Docs Registry

| Area | Canonical Document(s) |
| --- | --- |
| Architecture | [docs/design/architecture.md](./docs/design/architecture.md) |
| Product specs | `docs/product-specs/` (`book.md`, `tif.md`, `tick-ladder.md`, `market-depth.md`, `settlement.md`, `cross-matching.md`, `orderbook_fast_storage.md`) |
| Plans | `docs/plans/` (currently empty; add plan files directly) |
| References | [docs/references/module-map.md](./docs/references/module-map.md), [docs/references/book-event.yaml](./docs/references/book-event.yaml) |
| Active engineering follow-ups | [TODO.md](./TODO.md) |

## Doc Maintenance

- Add docs directly under the correct category folder in `docs/`.
- Keep this registry updated when adding or modifying features
