# Bloom Docs

This directory mixes current reference docs with historical planning material.

## Start Here

- [../README.md](../README.md): current repo overview
- [bloom_beta_api_contracts.md](bloom_beta_api_contracts.md): current Bloom beta integration contract
- [SEARCH_V2.md](SEARCH_V2.md): unified search API and GUI notes
- [AUTHENTICATION.md](AUTHENTICATION.md): auth behavior and Cognito details

## Historical / Planning Docs

The following files are useful for background but should not be treated as the current product contract:

- `*_execplan.md`
- `*_completion_report.md`
- `LEGACY_REMOVAL_GAP_REPORT.md`
- `ATLAS_BLOOM_CONTRACT_TESTS.md`

Use the code and the current repo `README.md` as the source of truth when these documents disagree.
