# ADR-001: Split Hot and Durable Project Memory

## Status

Accepted.

## Context

The baseline repository had a useful `.uai/` suite and a large report archive, but durable bodies lived under `docs/reports/`, hot records used public-site URLs instead of repository-relative evidence links, several required typed startup records were absent, and one source-map UAI file contained more than 75 KB of durable catalog content.

## Decision

Keep `.uai/` active as the first-load continuity layer and move detailed durable bodies to `docs/long-term-memory/`. Store every active repository-owned canonical report under `docs/long-term-memory/reports/`. Maintain `.uai/long-term-memory.uai` as a semantic pointer ledger and validate bidirectional links locally.

Original source artifacts remain under `docs/source-files/` as immutable provenance inputs. The former `docs/reports/` route remains only as an HTTP compatibility redirect; it contains no canonical report bodies.

## Consequences

- New sessions can recover core state from concise hot memory.
- Detailed evidence remains searchable and checksum-addressed.
- Canonical report locations become uniform.
- Existing raw download URLs redirect instead of silently breaking.
- Memory maintenance requires updating hot summaries, durable bodies, ledger records, mirrors, and link validation together.

## Alternatives Considered

- **Retire `.uai` in favor of docs:** rejected because it removes first-load continuity and violates project handoff requirements.
- **Keep reports under `docs/reports/`:** rejected because it perpetuates scattered durable memory.
- **Copy instead of move reports:** rejected because duplicate bodies create competing paths and future drift.
- **Move immutable source inputs into canonical reports:** rejected because source provenance must remain byte-preserved and separately identifiable.

## Validation

The migration is accepted only when all pointer paths and anchors resolve, report backlinks exist, UAI mirrors are byte-identical, no canonical report remains under the legacy directory, current tests pass, and the flat ZIP contains no nested archive.

## Memory References

- [Active decisions](../../../.uai/decisions.uai#active-decisions)
- [Memory operating model](../../../.uai/memory.uai#split-memory-operating-model)
- [Architecture hot memory](../../../.uai/architecture.uai#split-memory-architecture)

## Related Durable Documents

- [Split-memory architecture](../architecture/split-memory-architecture.md#architecture)
- [Implementation report](../reports/uai-memory-organization-report.md#findings)

## Supersession Status

Current. A later ADR must identify this record by stable ID `adr-001-split-memory-architecture` to supersede it.