---
uai: "1.0"
type: memory-architecture
status: active
stable_id: iarpg-split-memory-operating-model
project: iarpg.com
release: IARPG-OPS-2
version: "2.0.13-wip"
review_state: current-until-superseded
---

# Memory

## Split-Memory Operating Model

- **Hot `.uai/`:** current facts, constraints, decisions, architecture, open work, blockers, operating instructions, and routing summaries.
- **Durable `docs/long-term-memory/`:** full reports, research, architecture explanations, ADRs, migration evidence, implementation history, and superseded material.
- **Raw `.uai/archives/`:** optional session evidence, never polished authority.
- **`.uai/exports/`:** generated transport artifacts, never startup truth.

Durable memory augments hot memory. It never retires, replaces, disables, or makes `.uai/` emergency-only. Architecture detail: [split-memory architecture](../docs/long-term-memory/architecture/split-memory-architecture.md#architecture). Decision record: [ADR-001](../docs/long-term-memory/decisions/adr-001-split-memory-architecture.md#decision).

## Update Rules

1. Establish current truth from instructions, implementation, and tests.
2. Update the smallest relevant hot summary.
3. Write detailed evidence to the correct durable category.
4. Add or update the semantic record in [the pointer ledger](long-term-memory.uai#pointer-records).
5. Add bidirectional deep links.
6. Regenerate public UAI mirrors and manifests.
7. Run `python3 scripts/validate_memory_links.py`.

## Truth Labels

Use **Verified**, **Assumption**, **Proposal**, **Unresolved**, and **Superseded** explicitly. A preserved report can be current as a repository artifact while remaining unverified as factual research.

## Durable Routing

- [Human long-term index](../docs/long-term-memory/index.md#long-term-memory-index)
- [Report collection](../docs/long-term-memory/index.md#current-authoritative-reports)
- [Architecture](../docs/long-term-memory/index.md#architecture)
- [Decisions](../docs/long-term-memory/index.md#decisions)
- [Research](../docs/long-term-memory/index.md#research)
- [Implementation history](../docs/long-term-memory/index.md#implementation-history)

## Current Durable Inventory

- 349 preserved source files under `docs/source-files/`.
- 221 canonical report bodies under `docs/long-term-memory/reports/`.
- 230 authoritative durable documents in the pointer ledger.
- 95 active hot-memory records with byte-identical public mirrors.
- 30 source-derived reports with claim-level `#reviewed-synthesis` sections and 167 machine-readable dispositions.
- Zero nested source archives in the deployable package.

Evidence: [claim-level audit](../docs/long-term-memory/reports/claim-level-review-and-comparative-fairness-audit.md#findings), [durable index](../docs/long-term-memory/index.md#current-authoritative-reports), [source manifest](../docs/source-files/manifest.json), and [pointer ledger](long-term-memory.uai#pointer-records).

## Current Implementation Evidence

- [Claim-Level Review and Comparative Fairness Audit](../docs/long-term-memory/reports/claim-level-review-and-comparative-fairness-audit.md#validation-performed)
- [Hero Clarity, Report Integration, and UAI Routing Report](../docs/long-term-memory/reports/hero-clarity-report-integration-and-uai-routing-report.md#validation-performed)
- [UAI Memory Organization Report](../docs/long-term-memory/reports/uai-memory-organization-report.md#validation-performed)