# Memory System Architecture

> Migriert aus ByteRover context-tree (April 2026)

## Schichten-Modell (4 Layer)

| Layer | Name | Status |
|-------|------|--------|
| **S1** | Flat-File (MEMORY.md + `memory/*.md`) mit Tags | ✅ Aktiv |
| **S1.5** | KNOWLEDGE.md — kuratierte Langzeit-Memos | ⚠️ Geplant, nie implementiert |
| **S2** | OpenClaw built-in Memory (Voyage voyage-3-lite) | ✅ Aktiv |
| **S3** | LanceDB Vector Store | ❌ Entfernt (2026-04-06) |

### Tag-System (S1)

Vier Tags strukturieren die Flat-File-Erinnerungen:

- `[PREF]` — Präferenzen (z.B. Prefer functional over OOP)
- `[FACT]` — Fakten (z.B. We use PostgreSQL 15)
- `[DECISION]` — Architekturentscheidungen (z.B. Chose ByteRover over LanceDB)
- `[ENTITY]` — Personen/Systeme (z.B. Hector is the bot identity)

## Evolution

1. **Phase 1:** Flat-Files mit Tags — funktional bis heute
2. **Phase 1.5:** KNOWLEDGE.md geplant, nie gebaut
3. **LanceDB-Versuch:** 3 Container-Resets → Datenverlust → entfernt
4. **ByteRover (brv):** Semantic Layer mit Voyage Embeddings → Query funktioniert, Curate blockiert durch OAuth-Token-Verlust bei Container-Reset

Siehe auch: `decisions/2026-04-volume-persistence.md`