Points to durable wiki, archive, graph, evidence, and preservation systems without treating all stored history as current truth.
| File | .uai/long-term-memory.uai |
|---|---|
| Category | Long-memory and transfer files |
| Required status | Required for Long-Term Memory packages |
| Main reader | Receiving AI, memory steward, archival reviewer |
| Update frequency | When durable memory systems, promotion rules, archive paths, or evidence stewardship changes. |
| Human review requirement | Required for memory promotion, retention changes, and source-of-truth updates. |
| No-op trigger type | Unreviewed archive treated as current truth, missing steward, stale memory pointer, or unsupported source. |
What this file is
long-term-memory.uai is a bounded UAIX memory record. It is meant to be read before action, compared against related package files, and updated only through a reviewed package-memory change.
Why necessary
The file keeps this class of knowledge explicit instead of burying it in chat history, private assumptions, or stale generated summaries.
When required
Required for Long-Term Memory packages.
What belongs
- Accepted current facts for the declared package scope.
- Source, owner, reviewer, or evidence pointers needed to verify the record.
- No-op or escalation triggers that protect the package boundary.
- Compact instructions the next reader can act on without guessing.
What does not belong
- Raw chat dumps, unresolved brainstorming, or unreviewed generated summaries.
- Secrets, private credentials, personal data beyond the declared minimum, or unsupported public claims.
- Rules that belong in a more specific file such as taboo.uai, constraints.uai, test-plan.uai, or deployment-memory-and-test-report.uai.
- Historical notes that should live in archives until reviewed and promoted.
How receiving AI should use it
- Read it before acting in the scope it controls.
- Compare it with identity.uai, world-context.uai, totem.uai, taboo.uai, and short-term-memory.uai before trusting it as current.
- Use the no-op trigger as a stop point when the file is missing, stale, contradictory, or outside the declared package profile.
- Record any update in short-term-memory.uai and the package changelog when the change affects future agents.
How human reviewer should use it
- Confirm the file states a concrete required scope rather than a softer invitation to read it.
- Check that current facts have an owner, evidence path, or review source.
- Confirm outdated material was moved to archives or replaced with a dated current record.
- Reject vague language that lets agents ignore package-critical material.
Scenario examples
- A receiving agent opens a Project Handoff package and uses this record to decide whether work may proceed.
- A reviewer sees a contradiction between files and uses the no-op trigger to require clarification before release.
- A maintenance pass promotes a reviewed fact into this file and retires the stale note from active memory.
No-op and human-review triggers
- Missing file for its declared required scope.
- Conflict with universal launch-baseline files.
- Current package work depends on an unreviewed fact.
- The file claims authority beyond its declared profile, mode, package type, or capability.
Update and maintenance rules
- Keep entries short enough to be read at startup.
- Date meaningful updates and record why the change happened.
- Move stale detail to archives after accepted current facts are captured.
- Align generated exports and human-facing memory after changes.
Relationship to other .uai files
- identity.uai names the package and owner.
- world-context.uai locates the operating environment.
- totem.uai and taboo.uai anchor mission and boundaries.
- short-term-memory.uai points to the newest active state.
Minimal example
# long-term-memory.uai
file: .uai/long-term-memory.uai
required_status: Required for Long-Term Memory packages
owner: human-reviewed owner or steward
current_state: accepted current record for this package scope
no_op_trigger: Unreviewed archive treated as current truth, missing steward, stale memory pointer, or unsupported source.
evidence: link or local pointer to reviewed source
last_reviewed: YYYY-MM-DDCompleteness checklist
- Required status names the exact scope.
- Owner or reviewer is clear.
- Current facts match related .uai files.
- No-op triggers are concrete.
- Stale material has an archive or replacement path.
Common mistakes
- Using softer language that agents treat as skippable.
- Mixing current truth with raw source intake.
- Letting the file contradict another required record.
- Leaving no review path for high-impact changes.
Related UAIX records
Machine-readable digest
Agents should treat this digest as page-orientation evidence, not runtime authority.