# UAI File Memory and Long-Term Docs

> File-backed memory for handoff, durable reports, and long-term instructions.

## Memory paths

- `.uai/` contains local agent memory, handoff pointers, claim boundaries, progress, and deployment notes.
- `/docs/reports/` contains durable reports and design explanations.
- `/docs/memory/` contains long-term memory instructions and promotion ledgers.
- `/agent-file-handoff/Content/` and `/agent-file-handoff/Improvement/` are active handoff buckets.

## Promotion rule

Short-term observations should not become durable memory until source, scope, authority state, constraints, and allowed use are explicit.

## Receiver instruction

A receiving agent should read `.uai/index.uai`, `.uai/file-handoff.uai`, `.uai/long-term-memory.uai`, and the relevant `/docs` file before modifying public pages.


## Deep memory pointers

- `.uai/startup-packet.uai` defines receiver startup context.
- `.uai/system-profile.uai` defines operating boundaries.
- `.uai/receiver-brief.uai` defines handoff read order and first response behavior.
- `.uai/long-term-memory.uai` deep-links every durable report and memory file under `/docs`.
- `.uai/report-pointer-ledger.uai` provides report-only deep links.
- `.uai/durable-docs-index.uai` records checksums for the `/docs` corpus.
- `/docs/reports/index.html` lists all report bodies and source reports.
- `/docs/memory/index.html` lists long-term memory instructions and preservation ledgers.