# Memory & Reports

This page explains the public memory layer packaged with the site. The project now ships a root `/.uai/` folder for hot project memory and a root `/docs/` folder for durable report bodies, implementation docs, and the published long-term memory ledger.

## Primary memory routes

| Route | Purpose |
| --- | --- |
| [`/docs/index.md`](/docs/index.md) | Durable documentation index for reports, research, implementation docs, source-memory pages, and dogfood notes. |
| [`/docs/reports/index.md`](/docs/reports/index.md) | Index of source-backed report memory extracted from the review bundle. |
| [`/docs/long-term-memory.uai`](/docs/long-term-memory.uai) | Published copy of the long-term pointer ledger with public-docs overlay. |
| [`/.uai/docs-routing.uai`](./.uai/docs-routing.uai) | Hot deep-link map from .uai memory to every durable report and memory file. |
| [`/.uai/long-term-memory.uai`](./.uai/long-term-memory.uai) | Active long-term pointer ledger. |
| [`/.uai/file-handoff.uai`](./.uai/file-handoff.uai) | Agent File Handoff configuration and active intake rules. |

## Why reports live in /docs instead of hot .uai files

The site follows the file-handoff pattern: `.uai` files carry current routing, synthesis, pointer records, checksums, and startup guidance. Full report bodies live in durable Markdown under `/docs/`, where humans and agents can deep-link exact sources without overloading the startup memory layer.

## Included durable memory

- source report bodies under `/docs/reports/`;
- model-breeding and zero-dependency research under `/docs/research/`;
- uploaded website architecture research under `/docs/web-research/`;
- source-memory maps under `/docs/source-memory/`;
- TinyRustLM implementation docs under `/docs/implementation/`;
- UAIX dogfood notes under `/docs/dogfood/`;
- the published long-term memory ledger at `/docs/long-term-memory.uai`.

## Agent startup rule

For memory-aware work, start with `/.uai/index.uai`, then `/.uai/docs-routing.uai`, then `/.uai/long-term-memory.uai`. Open the durable report or research body only when the current task needs that evidence.