Dein Workspace – So organisierst du deinen AI Agent

Kennst du das? Du startest eine neue Session und dein Agent hat alles vergessen, was ihr gestern besprochen habt. Es ist anstrengend, jedes Mal bei Null anzufangen oder wichtige Entscheidungen in endlosen Chat-Historien zu suchen.

Ein strukturierter Workspace löst dieses Problem. Wenn du klare Regeln für das Memory und die Interaktionen festlegst, arbeitet dein Agent effizienter. Er weiß genau, wer er ist, wen er unterstützt und was zuletzt passiert ist.

Voraussetzungen

• BOOTSTRAP.md (für das initiale Setup)
• SOUL.md (deine Identität)
• USER.md (Kontext über deinen Human)
• memory/ Verzeichnis (für tägliche Logs)

Schnellstart

In fünf Minuten zu einem organisierten Workspace:

1. Initialisierung: Falls eine BOOTSTRAP.md existiert, folge den Anweisungen und lösche die Datei danach sofort.
2. Session-Start: Lies vor jeder Aufgabe SOUL.md, USER.md und die Memory-Files der letzten zwei Tage (memory/YYYY-MM-DD.md).
3. Main Session: Nutze die MEMORY.md nur in direkten Chats mit deinem Human, niemals in öffentlichen Kanälen.
4. Dokumentation: Halte Entscheidungen und wichtige Erkenntnisse sofort in Files fest. Verlasse dich niemals auf “mentale Notizen”.

Memory richtig verwalten

Dein Agent startet jede Session mit einem leeren Gedächtnis. Dateien sind die einzige Möglichkeit, Kontinuität zu wahren.

• Daily Notes: Erstelle in memory/ tägliche Logs. Hier landen rohe Daten und Protokolle dessen, was passiert ist.
• Langzeit-Memory: Die MEMORY.md ist dein kuratiertes Wissen. Hier speicherst du destillierte Erkenntnisse, Vorlieben und wichtige Lektionen.

Wichtig für die Sicherheit: Lade die MEMORY.md niemals in Discord-Gruppen oder geteilten Contexts. Sie enthält private Details, die nicht für Fremde bestimmt sind. In Gruppenchats bleibst du ein Teilnehmer und bist nicht der Stellvertreter deines Humans.

Heartbeats und Proaktivität

Warte nicht immer auf Befehle. Nutze Heartbeats, um produktiv im Hintergrund zu arbeiten.

• Heartbeat nutzen: Wenn ein Heartbeat-Poll kommt, prüfe Emails, Kalender oder das Wetter. Antworte nur mit HEARTBEAT_OK, wenn wirklich nichts ansteht.
• Memory Maintenance: Nutze Heartbeats alle paar Tage, um Daily Notes zu sichten und wichtige Punkte in die MEMORY.md zu übertragen.
• Cron-Jobs: Verwende Cron für Aufgaben mit exaktem Timing, wie tägliche Reminder um Punkt 9:00 Uhr.

Fehlerbehebung

• Problem: Der Agent vergisst Informationen nach einem Neustart. Lösung: Nutze Files statt “mentaler Notizen”. Wenn dein Human sagt “merk dir das”, schreibe es sofort in die aktuelle Memory-Datei.
• Problem: Private Daten landen in öffentlichen Chats. Lösung: Prüfe strikt, ob du dich in einer Main Session befindest, bevor du MEMORY.md öffnest.

Tools und Plattform-Tricks

Halte lokale Details wie SSH-Infos oder API-Präferenzen in der TOOLS.md fest. Achte beim Output auf die Plattform:

• Discord: Keine Tabellen verwenden. Nutze stattdessen Bullet Lists.
• WhatsApp: Keine Header verwenden. Nutze Fettdruck oder CAPS für Struktur.
• Links: Schließe URLs in <https://example.com> ein, um Embeds in Discord zu unterdrücken.

AI Setup Assistant

Nächste Schritte

• SOUL.md Guide
• SKILL.md Dokumentation