Initial commit: Project structure, README, AGENTS.md, .env.example, docs

- README.md with project overview, status, architecture - AGENTS.md with agent context and conventions - .env.example with environment variables - docs/research/agent-memory-solutions-2026.md (full research) - docs/architecture/memory-tiers.md (4-tier architecture) - docs/decisions/ADR-001-structured-memory-blocks.md - Directory structure for src/, tests/, scripts/, logs/, data/
2026-06-03 22:25:43 +00:00
commit 33fb180855
6 changed files with 798 additions and 0 deletions
@@ -0,0 +1,117 @@
+# Hermes Memory Next Level
+
+> Lösung für Context Rot und Agent Memory bei Hermes Agent. Von manuellem Key-Value zu strukturiertem, hierarchischem, automatischem Memory.
+
+## Problem
+
+Hermes verliert nach Context-Compression oder Session-Wechsel wichtigen Zustand:
+- Tool-Konfigurationen werden zu "Docker wurde erwähnt"
+- Projekt-Zustände zu "Wir haben an Auth gearbeitet"
+- Präferenzen verschwinden komplett
+- Nutzer muss dieselben Dinge immer wieder erklären
+
+## Vision
+
+Memory wird von **manuell** und **flach** zu **automatisch** und **strukturiert**:
+- Auto-Extraktion aus jeder Session
+- Typisierte Memory-Blöcke mit Entity-Linking
+- Multi-Tier: Working → Short-Term → Long-Term
+- Session-Start Injection: Relevanter Kontext wird automatisch geladen
+
+## Status
+
+| Phase | Status | Ziel |
+|-------|--------|------|
+| P0 Auto-Extraction | 🔄 In Planung | Cronjob extrahiert Fakten aus Sessions |
+| P0 Structured Blocks | 🔄 In Planung | Erweitertes `memory` Tool mit Typen |
+| P1 Entity-Linking | ⏳ Pending | Graph: Projekte, Dateien, Personen verknüpfen |
+| P1 Temporal Memory | ⏳ Pending | "Was war der letzte Stand von X?" |
+| P1 Multi-Tier | ⏳ Pending | SQLite + Vektor-Store |
+| P2 Self-Management | ⏳ Pending | Agent speichert selbst |
+| P2 Session Injection | ⏳ Pending | Automatisches Laden beim Start |
+
+## Architektur
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ TIER 1: WORKING MEMORY (Aktiver Prompt)                     │
+│ • Aktuelle Nachrichten + relevante Kontext                   │
+│ • 4K–128K Tokens (je nach Modell)                            │
+│ • Schnellster Zugriff, höchste Relevanz                     │
+├─────────────────────────────────────────────────────────────┤
+│ TIER 2: SHORT-TERM MEMORY (Letzte N Sessions)                │
+│ • Vollständige Nachrichten der letzten 5–10 Sessions       │
+│ • SQLite/JSON, schneller Zugriff                           │
+│ • Für Rückfragen zu kürzlich abgeschlossenen Tasks         │
+├─────────────────────────────────────────────────────────────┤
+│ TIER 3: LONG-TERM MEMORY (Vektor-Store + Graph)              │
+│ • Embeddings für semantische Suche                         │
+│ • Knowledge Graph für Beziehungen                          │
+│ • Fakten, Präferenzen, Projekt-Zustände                    │
+├─────────────────────────────────────────────────────────────┤
+│ TIER 4: ARCHIVE (Vollständige Historie)                      │
+│ • Alle Sessions, alle Nachrichten                          │
+│ • Nur bei Bedarf durchsucht (langsame Suche)               │
+│ • Compliance, Audit, vollständige Rekonstruktion           │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Memory-Block-Schema
+
+```yaml
+memory_block:
+  id: "uuid"
+  type: "user_preference" | "project_state" | "learned_pattern" | "entity_relationship" | "procedural"
+  category: "formatting" | "workflow" | "tech_stack" | "contact" | "project" | "skill"
+  key: "table_style"
+  value: "compact with │ separators"
+  source: "session_2026-06-03"
+  confidence: 0.95
+  entities: ["Flo", "waldseilgarten-crm"]
+  created_at: "2026-06-03T14:30:00Z"
+  updated_at: "2026-06-03T14:30:00Z"
+  access_count: 1
+  last_accessed: "2026-06-03T14:30:00Z"
+```
+
+## Projektstruktur
+
+```
+hermes-memory-next-level/
+├── AGENTS.md              # Agent-Context (wer ist der Agent, was soll er wissen)
+├── README.md              # Diese Datei
+├── .env.example           # Umgebungsvariablen
+├── docs/
+│   ├── research/
+│   │   └── agent-memory-solutions-2026.md
+│   ├── architecture/
+│   │   └── memory-tiers.md
+│   └── decisions/
+│       └── ADR-001-structured-memory-blocks.md
+├── src/
+│   ├── extraction/        # Auto-Extraction aus Sessions
+│   ├── storage/           # Memory-Tier-Implementierungen
+│   ├── graph/             # Entity-Linking Graph
+│   ├── injection/         # Session-Start Injection
+│   └── api/               # REST API für Memory-Operationen
+├── tests/
+│   ├── unit/
+│   └── integration/
+├── scripts/
+│   └── setup.sh           # Setup-Script
+└── docker-compose.yml     # Für lokale Entwicklung (SQLite, Qdrant, etc.)
+```
+
+## Remote
+
+- **Gitea**: `ssh://git@gitea.insight-it.de:2222/b0rbor4d/Hermes-Memory-Next-Level.git`
+- **SSH-Key**: `id_ed25519` (lokal vorhanden, muss in Gitea hinterlegt werden)
+
+## Mitwirkung
+
+ECC-Standards gelten. Siehe `AGENTS.md` und `CODING.md` (wenn vorhanden).
+
+---
+
+*Projekt gestartet: Juni 2026*
+*Ziel: Context Rot eliminieren, Hermes Memory auf Next-Level bringen*