---
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.14-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)

## Alliance Research Routing

- Six source files are preserved under `docs/source-files/alliance-and-faction-systems-research/` and map one-to-one to six canonical reports.
- Use each report’s `#reviewed-synthesis` for current reuse; preserved source-derived prose remains archival.
- The three topic UAI records route current alliance, faction-access, and network-influence doctrine without duplicating report bodies.
- The pointer ledger contains seven new durable records: six reviewed source reports plus the integration report.

Evidence: [integration report](../docs/long-term-memory/reports/alliance-faction-and-network-world-system-integration-report.md#findings), [source manifest](../docs/source-files/manifest.json), and [review register](../alliance-research-review-register.json).

## Current Durable Inventory

- 355 preserved source files under `docs/source-files/`.
- 229 canonical report bodies under `docs/long-term-memory/reports/`.
- 238 authoritative durable documents in the pointer ledger.
- 98 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)
- [Interface Density and Navigation Polish Report](../docs/long-term-memory/reports/interface-density-and-navigation-polish-report.md#validation-performed)
- [UAI Memory Organization Report](../docs/long-term-memory/reports/uai-memory-organization-report.md#validation-performed)