Memory

Curation Coverage — what LifeOS autonomic systems touch

Last synced: Jul 11, 2026

Curation Coverage — what LifeOS autonomic systems touch

LifeOS has several autonomic curation pipelines, each with its own SLA and write boundary. This document is the canonical matrix of which files are touched by which pipeline, and what’s left to manual writes.

The principle is: anything that matters for LifeOS’s context should be managed and curated, with different SLAs for different content types. Hot-layer memory loads every turn; identity-doctrine proposals fire on conversation cadence; TELOS reviews fire on a slower cron; manual files remain manual until promoted.

The four mutation tiers (memory subsystem)

Defined in LIFEOS/TOOLS/MutationTier.ts as a closed allowlist (default-deny):

TierBehaviorFiles
AAuto, set-overwritePRINCIPAL_MEMORY.md, DA_MEMORY.md
BLogged append + auditPROJECTS.md, CONTACTS.md, MEMORY/KNOWLEDGE/**, MEMORY/IDEAS/**
CPropose-only (Telegram approval, or auto-apply at confidence ≥ 0.70)PRINCIPAL_IDENTITY.md, DA_IDENTITY.md, WRITINGSTYLE.md, DEFINITIONS.md, CANONICAL_CONTENT.md, RESUME.md, OPERATIONAL_RULES.md
DUntouchable by memory subsystemEverything else

A new file added to ~/.claude/ is Tier D by default until a code change promotes it.

Coverage matrix

Curated by the memory subsystem (Reviewer + MutationTier)

FileTierCadenceSubtypeCurrently emitting?
USER/PRINCIPAL/PRINCIPAL_MEMORY.mdA8 turns / 30 min / 2 idlememory (actor=the-user)✓ live (set-overwrite)
USER/DIGITAL_ASSISTANT/DA_MEMORY.mdASamememory (actor=your-da)✓ live (set-overwrite)
USER/PROJECTS.mdBSameproposal (kind=projects) — propose-firstP1 extends
USER/CONTACTS.mdBSameproposal (kind=contacts) — propose-firstP1 extends
MEMORY/KNOWLEDGE/**BSameknowledge (append with related: merge)✓ live
MEMORY/IDEAS/**BSameidea (append)✓ live
USER/PRINCIPAL/PRINCIPAL_IDENTITY.mdCSameproposal (kind=identity)✓ live
USER/DIGITAL_ASSISTANT/DA_IDENTITY.mdCSameproposal (kind=identity)✓ live
USER/PRINCIPAL/WRITINGSTYLE.mdCSameproposal (kind=style)P1 extends
USER/DEFINITIONS.mdCSameproposal (kind=definition)P1 extends
USER/CANONICAL_CONTENT.mdCSameproposal (kind=canonical-content)P1 extends
USER/PRINCIPAL/RESUME.mdCSameproposal (kind=resume)P1 extends
USER/CONFIG/OPERATIONAL_RULES.mdCSameproposal (kind=operational-rule)P1 extends

Curated by OTHER autonomic pipelines (orthogonal to MutationTier)

These files are Tier D from the memory subsystem’s POV (untouchable by the reviewer) but have their own dedicated writer:

FileWriterTriggerCadence
USER/TELOS/PRINCIPAL_TELOS.mdLIFEOS/TOOLS/GenerateTelosSummary.tsTELOS source-file changeManual run; planned cron in P2
USER/TELOS/LIFEOS_STATE.jsonLIFEOS/TOOLS/ComputeGap.tsCron / Stop hookHourly
DOCUMENTATION/ARCHITECTURE_SUMMARY.mdLIFEOS/TOOLS/ArchitectureSummaryGenerator.tsDocIntegrity.hook.ts on StopPer session end
MEMORY/WORK/**/ISA.mdhooks/ISASync.hook.tsAlgorithm phase transitionsPer Edit (debounced 30s)
MEMORY/LEARNING/**WorkCompletionLearning, SatisfactionCapture, FailureCapture hooksUserPromptSubmit, Stop, tool failuresPer event
MEMORY/RELATIONSHIP/**RelationshipMemory.hook.tsUserPromptSubmitPer turn (batched)
MEMORY/WISDOM/**WisdomFrameUpdater, WisdomCrossFrameSynthesizerAlgorithm LEARN phasePer LEARN; planned monthly cron in P3
MEMORY/SECURITY/**SecurityPipeline.hook.tsTool callsPer event
MEMORY/OBSERVABILITY/**Many hooks (EventLogger, MemoryReviewer, etc.)Tool eventsContinuous
MEMORY/STATE/work.jsonhooks/ISASync.hook.ts, LIFEOS/TOOLS/AlgoPhase.tsPhase transitionsPer change
MEMORY/STATE/session-names.jsonLIFEOS/TOOLS/SessionRename.ts (manual), SessionAnalysis (auto-name)First prompt at session start; manual renameOne-shot per session
MEMORY/VOICE/voice-events.jsonlPulse VoiceServerVoice eventPer fire

Manual-only (no autonomic pipeline)

These files are Tier D AND have no other writer. the user writes directly; the autonomic system never proposes changes.

File / DirectoryWhy manual
USER/TELOS/TELOS.md + sub-files (GOALS, MISSION, STRATEGIES, NARRATIVES, CHALLENGES, WRONG, TRAUMAS, MODELS)Belief revision is deep-conviction work; planned P2 TELOS Reviewer will propose changes via the Telos skill Update workflow, not direct edit
USER/PRINCIPAL/PRONUNCIATIONS.jsonVoice-server runtime config; principal-curated
USER/CONFIG/memory-review.jsonCadence config for the memory system itself; principal-curated to avoid recursive auto-tuning
USER/CONFIG/CREDENTIALS/**Security boundary — credentials never autonomic
USER/GEAR.md, USER/SMARTHOME.md, USER/SECURITY/SecurityControls.md, USER/DAEMON.mdManually curated documentation (GEAR.md also skill-updated by gear-aware skills)
USER/BUSINESS/**, USER/HEALTH/**, USER/FINANCES/**Domain-specific, principal-curated
USER/INTEGRATIONS/*.yamlPer-skill config; principal-curated
USER/WORK/config.yamlWork-hub config; principal-curated
USER/CUSTOMIZATIONS/**, USER/SKILLCUSTOMIZATIONS/**Per-skill customizations; principal-curated
All of LIFEOS/DOCUMENTATION/ source files (except auto-generated summary)Architecture docs; principal-curated (the ArchitectureSummary derives FROM these)
CLAUDE.md, LIFEOS_SYSTEM_PROMPT.mdConstitutional layer; principal-curated
hooks/, skills/, Algorithm/, Tools/ sourceCode; principal-curated (the system has no auto-codegen path)
.env, settings.json, settings.system.jsonOperational config; principal-curated

SLAs per content type

Different content types update at fundamentally different rates. The cadence per autonomic surface:

Content classCadenceReason
Hot-layer memory (memory items)Per-turn-batched (8 / 30 min / 2 idle)Loads every turn; needs freshness
Knowledge graph (knowledge, idea)SameBM25 retrieval; freshness matters less
Identity / style / definition / canonical / resume / operational-rule proposalsSameTelegram-gated; principal has the final word
TELOS reviews (planned P2)Weekly cronBelief revision; deep observation window
Wisdom frame synthesis (planned P3)Monthly cronCompounding wisdom; long observation window
Architecture summaryPer-session-end (DocIntegrity hook on Stop)Tracks source LifeosSystemArchitecture.md changes
Work / ISA / phase trackingPer Edit (debounced 30s)Mirror of in-flight Algorithm runs
Observability streamsContinuous (per event)Append-only telemetry

Roadmap

  • P1 (this build, 2026-05-25) — extend reviewer prompt with 7 new proposal subtypes (style, definition, canonical-content, resume, operational-rule, projects, contacts); persist target_kind on queue rows; render [kind] badge in Telegram; group pending by subtype in your-da status.
  • P2 (named follow-up ISA) — TELOS autonomic loop. Weekly TelosReviewer.ts cron that reads recent ISAs + LEARNING + WISDOM + recent PRINCIPAL_MEMORY snapshots, emits TELOS-change proposals (goal-deferral, new-strategy, mission-drift) routed via the Telos skill Update workflow.
  • P3 (named follow-up ISA) — WISDOM autonomic loop. Monthly synthesis pass extracts new WISDOM frames from accumulated LEARNING signals; surfaces principle candidates via Telegram for principal review-and-graduate.
  • P4 (named follow-up ISA) — On-demand LLM-agent retrieval tier (your-da recall "<question>" CLI/Telegram command) for deep questions that need tool-using LLM loops over KNOWLEDGE. Different latency budget, different use case from per-turn BM25.

Adding a new file to the curation system

The closed-allowlist posture means new files default to Tier D (untouchable). To bring a new file under autonomic curation:

  1. Add the absolute path to the appropriate Tier set in LIFEOS/TOOLS/MutationTier.ts (Tier A / B / C).
  2. If Tier C — add an entry to PROPOSAL_KIND_TO_FILES in LIFEOS/TOOLS/MemoryTypes.ts with a new target_kind value.
  3. Extend the reviewer prompt in LIFEOS/TOOLS/MemoryReviewer.ts with subtype guidance describing when to emit a proposal targeting the new kind.
  4. Add a row to the matrix above.
  5. Regenerate ARCHITECTURE_SUMMARY.md (or let the DocIntegrity hook do it on next Stop).
  6. Run the MemoryTypes + MemoryReviewer smoke tests; they should still pass.

The principle: code is the source of truth; documentation mirrors. The MutationTier file is the authoritative list — this document is the human-readable view of it.