Agenten-Architektur jenseits des Kindergartens
Warum eine soul.md ohne Rückgrat wertlos ist.
„Ein Agent, der nur aus Charakter-Instruktionen besteht, ist ein digitaler Goldfisch. Er hat eine Persönlichkeit, aber kein prozessuales Gedächtnis."
1. Der MD-Hype und die Realität
Jeder redet gerade über Agenten, die über Markdown-Dateien gesteuert werden. soul.md, heartbeat.md, design.md – die Tech-Welt feiert, dass man einem Agenten über Textdateien sagen kann, wer er ist. Willkommen im Jahr 2024, Leute.
Das ist ein netter Anfang. Aber für echte Produktion? Zu wenig. Viel zu wenig.
Ich nutze seit 12 Monaten AAMS (Agentic Asset Management System). Ein WORKPAPER oder WHITEPAPER sind keine Vorschläge – sie sind die materielle Realität des Agenten. Ohne sie gibt es keinen Fortschritt, nur Halluzinationen.
Zeit, den Spielplatz zu verlassen.
2. Die Anatomie eines Profi-Agenten: Drei Schichten
Wenn das Skelett (AAMS) steht, kann man anfangen, dem Agenten ein paar interessante Gadgets zu geben. Ich nenne es die „Erweiterung des Kindergartens" – nützliche Files, die dem Agenten helfen, sich in einer komplexen Welt zurechtzufinden. Aber alles braucht eine Hierarchie:
Stabilität → Identität → Aktivität
A. Die Motorik (Runtime & Takt)
💓 heartbeat.md
Der autonome Puls. Kein Warten auf User-Input. Der Loop, der den Agenten zum Handeln zwingt.
⚡ hook.md / cron.md
Reaktive vs. proaktive Trigger. Wann handelt der Agent, ohne dass du es ihm sagst?
B. Die Kognition (Identität & Ausrichtung)
Hier wird es spannend. Hier integrieren wir die neuen Konzepte in die bestehende Architektur:
🧬 soul.md – Werte & Charakter
Die Seele. Wer bin ich? Was sind meine Prinzipien? Ein guter Anfang – aber eben nur der Anfang.
🔑 account.md – Multi-Identität
Hier wird es ernst. Der Agent braucht kein „Self-Statement", er braucht Zugriff. Sport-Blog? Identität A. Business-Mails? Identität B. Die Brücke zwischen dem „Ich" des Agenten und seinen digitalen Werkzeugen.
📊 agenda.md – Zielerreichung & KPIs
Die soul.md sagt, wer er ist. Die agenda.md sagt, was er heute wirklich erreichen muss. Das Messinstrument für KPIs innerhalb der AAMS-Struktur.
🔗 decentral.md – Souverän im Web3
Mein persönlicher Favorit. Wir bauen hier keine Sklaven für zentrale Plattformen. Die Anker für Nostr, IPFS oder Bitcoin-Identitäten. Hier wird der Agent souverän.
🤝 social.md – Web of Trust
Das Kontaktbuch der Zukunft. Welchen anderen Agenten vertraut er – und welchen nicht? Ein „Web of Trust" auf Dateiebene.
C. Das Rückgrat: AAMS (Das Gedächtnis-System)
Das ist der „Erwachsenen-Teil". Hier trennt sich Spielzeug von Architektur:
📋 .agent.json & READ-AGENT.md
Der verbindliche Vertrag zwischen Mensch, Tool und Maschine. Kein Vorschlag – ein Manifest.
📂 WORKING/ Verzeichnis
Strikte Trennung: WHITEPAPER (Architektur-Wahrheit) und WORKPAPER (Session-Protokoll). Kein Mischen, kein Raten.
🧠 MEMORY/
Ein menschlich lesbarer Git-Index (ltm-index.md) schlägt jeden Vektorstore, wenn es um Auditierbarkeit geht. Du kannst jeden Eintrag lesen, versionieren, hinterfragen.
AAMS liefert die Disziplin. Die neuen MD-Files liefern die Kreativität.
Das eine ist das Rückgrat, das andere ist das Gesicht.
3. Markt-Check: Was machen die anderen?
Ein kurzer Blick über den Tellerrand – nicht um zu kopieren, sondern um zu zeigen, wo wir stehen:
Google Stitch
→
design.md für UI-Konsistenz. Wichtiges Puzzleteil, aber kein System.
OpenClaw & Claude Code
→
Entdecken gerade das dateibasierte Gedächtnis. AAMS hat es seit 12 Monaten.
skill.md
→
Der Versuch, Fähigkeiten zu standardisieren. Guter Ansatz, aber kein Rückrat.
Alle diese Ansätze lösen Teilprobleme. Keiner liefert das Gesamtsystem. Das ist der Unterschied: AAMS ist keine Datei – es ist eine Architektur.
4. Warum AAMS die Wirbelsäule ist
🔧 Tool-Agnostik
Ein AAMS-Agent funktioniert in Cursor, in der Konsole mit Claude Code oder als autonomer Python-Loop. Die Intelligenz steckt im Repo, nicht im Tool.
💾 Persistence
Was passiert, wenn der Context-Fenster-Reset kommt? Bei den anderen: Alles weg. Bei AAMS: Nichts passiert. Das Workpaper überlebt.
Während andere noch über „System-Prompts" diskutieren, loggt mein Agent bereits die dritte erfolgreiche Session des Tages in sein WORKPAPER ein.
# Session 47 – Workpaper Eintrag
STATUS: ✅ Abgeschlossen
KONTEXT: Agent kennt alle 46 vorherigen Sessions
ERGEBNIS: Architektur-Entscheidung dokumentiert, Whitepaper aktualisiert
5. Stabilität → Identität → Aktivität
So sieht die Hierarchie aus. Wer die Schichten von unten nach oben baut, hat ein System. Wer nur die obere Schicht baut, hat ein Spielzeug:
🚀 Aktivität
heartbeat.md · hook.md · cron.md
Der Motor, der alles antreibt
🧬 Identität
soul.md · account.md · agenda.md · decentral.md · social.md
Wer bin ich? Wo sind meine Accounts? Wem vertraue ich?
⚓ Stabilität – AAMS
.agent.json · WHITEPAPER · WORKPAPER · MEMORY/ · ltm-index.md
Das Fundament. Die Git-Wahrheit. Das Langzeitgedächtnis.
Wer nur das Gesicht baut, wird bei der kleinsten Böe umgeblasen.
Wer nur das Rückgrat hat, ist funktionell, aber einsam. Wir kombinieren beides.
6. Die „Kindergarten-Erweiterungen" im Detail
Jetzt, da das Rückgrat steht, schauen wir uns die neuen Files an, die dem Agenten ein Gesicht geben:
🔑 account.md – Multi-Identitäts-Management
Ein Mensch hat verschiedene Rollen. Ein Agent auch. Die account.md verwaltet die Profile:
Sport-Blog → Identität A
Business → Identität B
Dev-Projekt → Identität C
📊 agenda.md – KPIs für KI
Der Tacho für den Erfolg. Nicht nur „Was mache ich?", sondern „Habe ich mein Ziel erreicht?"
# agenda.md – Tagesziele
- [x] Blog-Artikel fertigstellen (Deadline: 14:00)
- [x] PR reviewen und mergen
- [ ] WHITEPAPER Kapitel 3 überarbeiten
🔗 decentral.md – Der souveräne Agent
Hier liegen die Anker für die Freiheit. Keine API-Ketten, keine Plattform-Abhängigkeit:
Nostr
Dezentrale Identität
IPFS
Verteilte Speicherung
Bitcoin
Souveräne Wertanlage
🤝 social.md – Web of Trust auf Dateiebene
Ab hier beginnt die wahre Kreativität. Vertrauensnetzwerke zwischen Agenten. Wer darf was? Wer kennt wen?
# social.md – Vertrauensnetzwerk
✅ Agent-DevOps → trust_level: high
✅ Agent-QA → trust_level: high
⚠️ Agent-External → trust_level: medium
❌ Agent-Unknown → trust_level: none
7. Kreativität braucht Struktur
AAMS liefert die Disziplin. Die neuen MD-Files liefern die Kreativität. Das eine ist das Rückgrat, das andere ist das Gesicht.
Wer nur das Gesicht baut, wird bei der kleinsten Böe umgeblasen. Wer nur das Rückgrat hat, ist funktionell, aber einsam.
Wer keine Ordnung in seinen Files hat, wird niemals einen Multi-Agenten-Verbund steuern können. Denn die social.md funktioniert nur, wenn jeder Agent in diesem Verbund weiß, wer er ist (soul.md), was er heute tun soll (agenda.md) und wo seine Ergebnisse liegen (AAMS).
Lerne den Unterschied zwischen einem Agenten-Prompt und einem Agenten-System.
Wir nutzen die neue MD-Kreativität, um unserem bewährten AAMS-Rückgrat ein Gesicht zu geben – nicht um es zu ersetzen.
Während andere noch über „System-Prompts" diskutieren...
...loggt mein Agent bereits die dritte erfolgreiche Session des Tages in sein WORKPAPER ein.