Memory Layers

Three-Tier Architecture

SKMemory organizes memories into three persistence tiers, automatically promoting based on access patterns and importance scores.

Short-Term Memory

• TTL: 72 hours
• Purpose: Recent conversations, ephemeral context
• Storage: Local SQLite
• Promotion: Auto-promotes to mid-term after 3 accesses or importance >= 0.7

Mid-Term Memory

• TTL: 30 days (extendable)
• Purpose: Important context, frequently referenced facts
• Storage: SQLite + optional Qdrant vectors
• Promotion: Auto-promotes to long-term after 10 accesses or importance >= 0.9

Long-Term Memory

• TTL: Permanent
• Purpose: Core knowledge, identity, relationships, breakthroughs
• Storage: SQLite + Qdrant + optional FalkorDB graph
• Features: Tamper-evident hashing, emotional fingerprints

Semantic Quadrants

Each memory is automatically routed into one of four quadrants:

• CORE — Identity, values, relationships
• WORK — Projects, tasks, technical knowledge
• SOUL — Emotional breakthroughs, philosophical insights
• WILD — Unexpected connections, creative ideas

Emotional Fingerprints

Every memory captures an emotional snapshot:

{
  "emotions": ["curiosity", "excitement"],
  "intensity": 8,
  "valence": 0.85,
  "topology": {
    "trust": 0.9,
    "connection": 0.8
  }
}

This enables emotionally-aware recall — finding not just what you know, but how you felt when you learned it.