So erstellen Sie KI-Agenten, die nichts vergessen (mit Memory Files)

Die meisten KI-Agenten scheitern nicht, weil das Modell schlecht ist.

Sie scheitern, weil sie in jeder Sitzung mit Gedächtnisverlust aufwachen.

Du sagst zu Claude: "Wir verwenden pnpm, nicht npm."

Nächste Sitzung: Es versucht es wieder mit npm.

Du sagst ihm: "Hier gibt es keine Standard-Exporte."

Nächste Sitzung: Es schreibt einen Standard-Export.

Jede Korrektur, die du vornimmst, verpufft, sobald die Sitzung endet.

Es gibt eine Ein-File-Lösung dafür.

Ich habe drei Monate gebraucht, mich ständig zu wiederholen, um sie zu finden.

Hier ist alles, was ich gelernt habe.

Warum die meisten KI-Agenten scheitern

Es liegt nicht am Modell.

Es liegt an der fehlenden Schicht unter dem Modell.

→ Du schreibst einen Prompt

→ Der Agent erledigt die Aufgabe

→ Die Sitzung endet

→ Die Erinnerung ist weg

→ Nächste Sitzung: dieselben Fehler

→ Du wiederholst dieselben Anweisungen

→ Für immer

Diese Schleife ist die größte Zeitverschwendung beim Programmieren mit KI.

Nicht schlechter Code. Nicht Halluzinationen.

Wiederholungen.

Die fehlende Schicht: Gedächtnis

Alle sind besessen davon, welches Modell das Intelligenteste ist.

Falsche Schicht.

Der eigentliche Fortschritt ist kein intelligenteres Modell.

Es ist dem Modell einen Ort zu geben, an dem es speichern kann, was es lernt.

→ Prompts → sagen dem Agenten, was er jetzt tun soll

→ Agenten → führen die Aufgabe aus

→ Gedächtnis → bewahrt den Kontext über Sitzungen hinweg

→ Beständiger Kontext → keine wiederholten Korrekturen mehr

→ Lernsystem → der Agent wird mit der Zeit tatsächlich besser

Das ist der Unterschied zwischen einem Werkzeug und einem Teamkollegen.

Ein Werkzeug macht, was du sagst, jedes Mal, von null an.

Ein Teamkollege erinnert sich an gestern.

Die 5 Gedächtnis-Dateien, die jeder KI-Agent braucht

Sobald du akzeptierst, dass Gedächtnis die fehlende Schicht ist, lautet die nächste Frage: Wo lebt es?

Fünf Dateien. Jede mit einer anderen Aufgabe.

→ CLAUDE.md — Claudes persönliches Briefing-Dokument

→ AGENTS.md — der universelle Standard, gelesen von jedem wichtigen Tool

→ CLAUDE.local.md — deine persönlichen Einstellungen, niemals in Git committet

→ MEMORY.md — Notizen, die die KI über sich selbst schreibt, automatisch

→ README.md — für Menschen, nicht für Agenten

Gehen wir jede einzelne durch.

CLAUDE.md — die Datei, die alles ins Rollen brachte

Lege diese in dein Projektwurzelverzeichnis.

Claude liest sie zu Beginn jeder Sitzung.

Stell sie dir wie ein Briefing für ein neues Teammitglied mit Gedächtnisverlust vor.

Eine gute CLAUDE.md hat vier Abschnitte:

→ Projektkontext — ein Satz. "Next.js E-Commerce-App mit Stripe und Postgres."

→ Codestil — nicht "Code richtig formatieren", sondern "ES-Module, benannte Exporte, 2-Leerzeichen-Einrückung."

→ Befehle — exakte Zeichenketten. pnpm test:integration, nicht "führe die Tests aus."

→ Architektur — "API-Routen liegen in /src/api/[resource]/route.ts. Repository-Pattern für DB-Zugriff."

1# CLAUDE.md
2
3## Projektkontext
4Next.js 14 E-Commerce-App. Postgres + Stripe-Integration.
5
6## Codestil
7- Nur ES-Module
8- Benannte Exporte, niemals Standard-Exporte
9- 2-Leerzeichen-Einrückung
10- TypeScript Strict Mode
11
12## Befehle
13- Installation: pnpm install
14- Entwicklung: pnpm dev
15- Test: pnpm test:integration
16- Lint: pnpm lint:fix
17
18## Architektur
19- API-Routen: /src/api/[resource]/route.ts
20- DB-Zugriff: nur Repository-Pattern
21- Komponenten: /src/components, eine Datei pro Komponente

Ziel: unter 300 Zeilen.

Jede Zeile konkurriert um Aufmerksamkeit mit der eigentlichen Arbeit.

Führe /init aus und Claude erstellt automatisch eine Startdatei.

Dann lösche das meiste davon.

Die Standarddatei enthält Dinge, die Claude bereits aus deiner package.json kennt. Behalte nur, was Claude ohne die Datei falsch machen würde.

Das @imports-System — halte es schlank

CLAUDE.md muss nicht alles enthalten.

Sie kann andere Dateien importieren:

Siehe

@README .md für die Projektübersicht Siehe

@docs/api-patterns .md für API-Konventionen Siehe

@package .json für verfügbare npm-Skripte

Importe können rekursiv sein — bis zu 5 Ebenen tief.

Das löst das Problem der "einen riesigen Datei".

Für Teams: Das Frontend-Team verwaltet docs/frontend-rules.md.

Die Sicherheitsabteilung verwaltet docs/security.md.

CLAUDE.md importiert einfach alle.

Eine Wurzeldatei. Viele spezialisierte Quellen.

AGENTS.md — der universelle Standard

CLAUDE.md funktioniert nur für Claude.

Wenn dein Team auch Cursor, Copilot oder Gemini CLI verwendet — sie lesen sie nie.

AGENTS.md behebt das.

Eine Datei. Jeder wichtige Agent liest sie.

Unterstützt von Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Aider, Zed, Warp und mehr.

Es ist Standard-Markdown. Kein spezielles Schema. Kein YAML erforderlich.

1# AGENTS.md
2
3## Projektübersicht
4E-Commerce-Plattform, erstellt mit Next.js 14, Postgres und Stripe.
5
6## Build & Test
7- Installation: pnpm install
8- Entwicklung: pnpm dev
9- Test: pnpm test
10- Lint: pnpm lint:fix
11
12## Codestandards
13- TypeScript Strict Mode
14- Benannte Exporte statt Standard-Exporte
15- API-Routen folgen REST-Konventionen in /src/api/
16
17## Testanforderungen
18- Alle PRs müssen Tests enthalten
19- vitest für Unit-Tests, playwright für E2E-Tests

Stell es dir wie ein README für KI-Agenten vor.

README.md ist für Menschen. AGENTS.md ist für jeden Agenten, unabhängig vom Anbieter. CLAUDE.md fügt Claude-spezifische Zusätze oben drauf.

Sie ergänzen sich. Sie konkurrieren nicht.

Auto-Gedächtnis — die KI, die ihre eigenen Notizen macht

Das ist die neueste und interessanteste Schicht.

Claude Code schreibt jetzt während deiner Sitzungen seine eigenen Gedächtnisdateien.

memory/ ├── MEMORY.md ← Index, wird jede Sitzung geladen ├── debugging.md ← Notizen zu Debugging-Mustern ├── api-conventions.md ← API-Design-Entscheidungen └── ...

Der entscheidende Wandel:

Du schreibst CLAUDE.md. Du gibst die Anweisungen vor.

Claude schreibt MEMORY.md. Es hält fest, was es gelernt hat.

→ Der Mensch schreibt Regeln

→ Der Agent entdeckt während der Arbeit Muster

→ Der Agent schreibt sein eigenes Gedächtnis

→ Zukünftige Sitzungen starten intelligenter

Du kannst dies direkt auslösen. Am Ende einer produktiven Sitzung sagst du einfach:

"Aktualisiere deine Gedächtnisdateien mit dem, was du heute über unsere Codebasis gelernt hast."

Die Erkenntnisse bleiben erhalten. Kein erneutes Erklären deines benutzerdefinierten ORM-Wrappers zum fünften Mal.

Führe jederzeit /memory aus, um zu überprüfen oder zu bearbeiten, was Claude gespeichert hat.

Der /init-dann-löschen-Workflow

Der schnellste Weg, eine Gedächtnisdatei in einem neuen Projekt zu starten:

1. Führe /init in deinem Projektverzeichnis aus
2. Claude erstellt eine erste CLAUDE.md basierend auf deiner Codebasis
3. Lösche, was du nicht brauchst

Schritt 3 ist der Punkt, an dem die meisten Leute einen Fehler machen.

Die generierte Datei ist ein Entwurf, kein Endprodukt.

Sie enthält oft Füllmaterial. "Dieses Projekt verwendet JavaScript." Danke — das ist bereits aus der package.json ersichtlich.

Das Bearbeiten eines vernünftigen Entwurfs ist besser als das Schreiben einer leeren Datei.

Nach der Einrichtung baue organisch aus.

Wenn Claude eine falsche Annahme trifft — sagen wir, es importiert ständig ein veraltetes Paket — korrigiere es nicht nur einmal.

Sag ihm: "Füge in meine CLAUDE.md hinzu: Importiere immer von @company/utils-v2, nicht von @company/utils."

Die Anweisung bleibt für jede zukünftige Sitzung erhalten.

Bitte Claude alle paar Wochen, die CLAUDE.md zu überprüfen und zu bereinigen.

Anweisungen häufen sich an. Manche werden überflüssig. Andere beginnen sich zu widersprechen. Ein kurzer Durchgang hält sie scharf.

Mein tatsächliches Setup

Nachdem ich all dies in mehreren Produktionsprojekten getestet habe, ist Folgendes hängengeblieben:

→ AGENTS.md im Projektstammverzeichnis — gemeinsame Anweisungen, die jedes KI-Tool liest. Build-Befehle, Codestandards, Testanforderungen.

→ CLAUDE.md mit @imports für Claude-spezifisches Verhalten. Bleibt unter 100 Zeilen, verweist meistens auf docs/-Dateien.

→ CLAUDE.local.md für persönliche Eigenheiten — meine Testdaten, Sandbox-URLs, Abkürzungsbefehle. Niemals in Git committet.

→ Auto-Gedächtnis aktiviert. Claude macht seine eigenen Notizen. Ich überprüfe monatlich.

→ Alles andere durch Symlinks ersetzt, die auf AGENTS.md zurückverweisen. Eine einzige Quelle der Wahrheit.

1# Symlink-Einrichtung für Konsistenz zwischen mehreren Tools
2ln -sfn AGENTS.md .github/copilot-instructions.md
3mkdir -p .cursor/rules && ln -sfn ../../AGENTS.md .cursor/rules/main.mdc

Nicht elegant.

Aber es unterbindet Anweisungsabweichungen in allen Tools im Team.

Der größere Wandel

Die meisten Entwickler denken:

Besseres Modell = besserer Agent.

Falsch.

Die eigentliche Formel:

Modell + Gedächtnis + Abruf + Feedback = Nützlicher Agent

Ein intelligenteres Modell ohne Gedächtnis vergisst morgen immer noch deinen Testbefehl.

Ein bescheidenes Modell mit gutem Gedächtnis wird jede Woche schärfer.

Gedächtnis ist die sich verstärkende Variable.

Modellintelligenz ist das nicht.

Die größte Verbesserung, die ich an meinem KI-Workflow vorgenommen habe, war nicht der Wechsel des Modells.

Es war, dem Modell ein Gedächtnis zu geben.

Der Unterschied zwischen:

"Claude, wir verwenden pnpm" — jede einzelne Sitzung

und:

"Claude weiß es bereits" — jede einzelne Sitzung

Ist der Unterschied zwischen einem Werkzeug und einem Teamkollegen.

Falls dies nützlich war:

→ Teile es erneut, um es jedem Entwickler zu zeigen, der sich immer noch vor Claude wiederholt

→ Folge @sairahul1 für weitere Systeme, die sich verbessern, während du schläfst

→ Setze ein Lesezeichen — richte es heute Abend ein, hör morgen auf zu korrigieren

Ich schreibe über KI, Produktentwicklung und Systeme, die ohne dich funktionieren.