A useful memory taxonomy tells an agent what kind of thing it is seeing, how far the claim can travel, and what review it needs before becoming public. It should describe operational states, not pretend memory naturally decays like biology or automatically becomes truth through retrieval.
Memory Kinds
| Kind | Meaning | Public promotion rule |
|---|---|---|
fact |
A source-backed statement about a system, standard, route, artifact, or event. | Needs source span, scope, review date, and contradiction check. |
decision |
A chosen direction, rejected alternative, or governance ruling. | Needs owner, date, decision scope, and supersession path. |
procedure |
A repeatable workflow, runbook, setup path, or gate sequence. | Needs trigger, steps, stop conditions, reviewer, and evidence of safe use. |
risk |
A hazard, failure mode, abuse case, or operational caveat. | Needs mitigation, severity framing, and no exploit-enabling detail. |
preference |
A project or owner preference. | Usually private or local; public only when generalized as a design tradeoff. |
hypothesis |
A plausible but unproven idea. | Publish only as proposal or research lead, never as reviewed guidance. |
evidence |
A source, hash, transcript summary, fixture, test result, or citation record. | Expose only public-safe summary and source identity allowed by policy. |
deprecation |
A record that something should no longer guide new work. | Needs replacement route or explicit no-current-guidance label. |
conflict |
A contradiction between sources, pages, or reviewer decisions. | Preserve the conflict visibly until reviewed; do not synthesize it away. |
Scope Values
| Scope | Default audience | Escalation rule |
|---|---|---|
global_public |
Reviewed shared guidance safe for broad retrieval or citation. | Still needs source, owner, and freshness signals. |
global_private |
Private organization memory. | Needs redaction and lane review before public promotion. |
project_public |
Project-safe guidance for the intended audience. | Must not become universal policy without reviewer approval. |
project_private |
Client, workspace, or project-specific private state. | Retrieve only inside the selected boundary. |
agent_session |
Current run or temporary agent state. | Cannot become durable truth without curation. |
emergency_reconnect_archive |
Break-glass recovery evidence. | Read-only, permissioned, and reviewed before reuse. |
| legacy/local mapped values | Values such as session, project, agent_team, agent_repo, organization, or cross_organization. | Map explicitly into the practical profile before broad retrieval or promotion. |
Promotion Metadata
memory_type: fact | decision | procedure | risk | preference | hypothesis | evidence | deprecation | conflict
promotion_status: candidate | blocked | redacted | reviewed | published | superseded
validation_tier: tier1-public-page | tier2-promoted-memory | tier3-external-standard
source_scope: global_public | global_private | project_public | project_private | agent_session | emergency_reconnect_archive | legacy-local-mapped
target_scope: project | organization | public
source_status: source-linked | source-needed | canonical-linked | derived | unsupported
claim_status: reviewed | proposal | stale | contradicted | blocked
lane_review:
llmwikis: required
uaix: canonical-link-if-standards-claim
neuralwikis: private-evidence-only
source_site: owner-review-required
Retrieval Behavior
- Retrieve
reviewedandpublishedrecords before candidates and proposals. - Filter or label private, blocked, stale, contradicted, and source-needed records before answer drafting.
- Never treat a broader target scope as proven by a narrower source scope.
- Prefer source-linked public pages over private memory summaries for citations.
- Route external standards claims to the canonical standards owner.