Florian Hartmann
33fb180855
- 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/
75 lines
2.6 KiB
Markdown
75 lines
2.6 KiB
Markdown
# 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
|
|
1. `CODING.md` lesen (ECC Standards)
|
|
2. Success-Kriterien definieren
|
|
3. Annahmen formulieren
|
|
4. Plan mit Verifikation
|
|
5. Simplicity First, Surgical Changes, Verify each step
|
|
6. 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
|