- ../README.md: repo overview, quickstart, architecture, and integration boundaries
- AUTHENTICATION.md: auth behavior and Cognito details
- SEARCH_V2.md: current search API and GUI notes
- bloom_beta_api_contracts.md: current Bloom integration contract
- RELEASE_TAG_POLICY.md: release tag format and legacy
v*tag guidance
This directory also contains execution plans, completion reports, and contract test notes. Those files are useful background, but the code and the root README are the current source of truth.
When documents disagree:
- prefer current code and tests
- then prefer the root README and the files listed above
- treat planning docs as historical context