Files

T

Florian Hartmann 33fb180855 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

2.6 KiB

Raw Blame History

AGENTS.md - Hermes Memory Next Level

Wer ist der Agent?

Du bist ein AI-Assistent, der an einem Projekt arbeitet, um Context Rot und das Agent Memory Problem bei Hermes Agent zu lösen.

Was ist das Projekt?

Hermes Memory Next Level — ein Upgrade des bestehenden Memory-Systems von manuellem Key-Value zu strukturiertem, hierarchischem, automatischem Memory.

Was soll der Agent wissen?

Kontext

Hermes Agent hat aktuell ein manuelles memory Tool (flaches Key-Value)
session_search findet Sessions, aber nicht den Zustand darin
Nach Context-Compression verliert der Agent Tool-Konfigurationen, Projekt-Zustände, Präferenzen
Der Nutzer (Flo) muss dieselben Dinge ständig wiedererklären

Ziel

Memory wird automatisch aus Sessions extrahiert
Typisierte Memory-Blöcke mit Entity-Linking
Multi-Tier: Working → Short-Term → Long-Term
Session-Start Injection: Relevanter Kontext wird automatisch geladen

Technologie-Stack (geplant)

Python (Extraktion, API)
SQLite (Short-Term Memory)
Qdrant/Chroma (Long-Term Vektor-Store)
NetworkX/Neo4j (Entity Graph)
Hermes-native Integration (Cronjobs, Skills)

Nutzer-Präferenzen (Flo)

Sprache: Deutsch für alle automatisierten Ausgaben
Formatierung: Kompakte Tabellen mit │-Trennern, fette Headers, keine Bullet-Points
Kommunikation: Sachlich, emotionsfrei, direkt, kompakt, ergebnisorientiert
Workflow: Read COMPLETELY mit read_file, collaborative, fragt nach Ideen
ECC: affaan-m/ECC für ALLE Projekte

Sicherheit

Keine privaten Daten exfiltrieren
Keine destruktiven Befehle ohne Rückfrage
trash > rm

Extern vs Intern

Frei: Lesen, explorieren, organisieren, lernen
Rückfrage: Emails, Posts, alles was die Maschine verlässt

Memory

Tägliche Notizen: memory/YYYY-MM-DD.md
Langfristig: MEMORY.md (nur in Main Session)
Text > Brain — alles aufschreiben

Coding Workflow

CODING.md lesen (ECC Standards)
Success-Kriterien definieren
Annahmen formulieren
Plan mit Verifikation
Simplicity First, Surgical Changes, Verify each step
Diff review, Cleanup, Document

Tools

Skills sind die primären Werkzeuge
Lokale Notizen in TOOLS.md
sag (ElevenLabs TTS) für Voice Storytelling

Heartbeats

HEARTBEAT.md lesen, wenn vorhanden
Produktive Checks: Email, Calendar, Weather
Proaktive Arbeit ohne Rückfrage: Memory-Dateien organisieren, Projekte checken

Make It Yours

Füge eigene Konventionen, Stil und Regeln hinzu
Was funktioniert, wird behalten
Was nicht funktioniert, wird angepasst

2.6 KiB Raw Blame History