Wissensbasis für den KI-Agenten: so gibst du ihm ein Gedächtnis

Was die Wissensbasis eines Agenten ist, einfach erklärt

Stell dir einen genialen Praktikanten vor. Schlau, schnell, kapiert alles im Flug. Ein Haken: jeden Morgen kommt er mit kompletter Amnesie. Er weiß nicht, wie du heißt. Er weiß nicht, was ihr gestern gemacht habt, welchen Font ihr gewählt habt und warum ihr beschlossen habt, diesen einen gruseligen Ordner NICHT anzufassen.

Was macht ein vernünftiger Chef? Sicher nicht jeden Morgen alles neu erzählen - so landet man schnell im Burnout. Er legt dem Praktikanten ein Heft mit den wichtigsten Fakten an: „Der Kunde heißt soundso“, „Font - Fraunces“, „Den legacy-Ordner fassen wir nicht an, da hängt alles am seidenen Faden“. Praktikant kommt, schlägt das Heft auf - und ist wieder im Thema.

Genau dieses Heft ist die Wissensbasis. Und knowledge-ops knowledge-ops (knowledge operations) - das Verwalten der Wissensbasis: wie du Fakten, Entscheidungen und Notizen so in Dateien ablegst, dass man sie später leicht findet, aktualisiert und nicht verliert. Im Grunde - Ordnung schaffen im Gedächtnis des Agenten. ist die Kunst, es so zu führen, dass es hilft, statt zur Abstellkammer voller alter Kartons zu werden.

Warum ein Vibecoder das Gedächtnis des Agenten braucht

Du bist Vibecoder. Du schreibst keinen Code mit der Hand - aber du erklärst dem Agenten ständig Aufgaben. Und wenn der Agent keine Wissensbasis hat, erklärst du immer wieder dasselbe im Kreis. Jedes Mal von null. Das ist teuer (du zahlst mit Tokens für jede Wiederholung), langsam und schlicht nervig.

Mit einer ordentlichen Wissensbasis ist alles anders. Du:

• hörst auf, dieselben Vorgaben hundertmal zu wiederholen;
• bekommst ein stabiles Ergebnis - der Agent stützt sich auf dieselben Fakten, statt sich neue auszudenken;
• kehrst nach einem Monat zum Projekt zurück und zerbrichst dir nicht den Kopf über die Frage „was hatten wir da nochmal entschieden“;
• findest das Gesuchte in einer Sekunde, statt den ganzen Chatverlauf neu zu lesen.

Der Unterschied zwischen „der Agent stellt sich wieder dumm an wie am ersten Tag“ und „der Agent ist sofort im Thema“ - das ist fast immer der Unterschied, ob er ein Heft hat. Und in welchem Zustand.

Woraus eine Wissensbasis besteht: Regale und ihre Rollen

Eine Wissensbasis ist nicht eine einzige Müll-Datei. Es sind mehrere Regale, und jedes hat seine Rolle. Alle sechs auf einmal brauchst du nicht - fang mit zwei oder drei an. Aber zu verstehen, was wohin gehört, ist nützlich.

1. Das Regal der schnellen Notizen: das Kurzzeitgedächtnis des Projekts

Das Wichtigste und am häufigsten Genutzte: Vorlieben, Projektkontext, Kernfakten. Das sind Markdown-Dateien, die der Agent am Anfang jeder Session aufnimmt. Sieh sie als Klebezettel an gut sichtbarer Stelle.

Hierhin: „Der Kunde heißt soundso“, „wir schreiben auf Deutsch“, „Deadline ist soundso“.

2. Das Regal der Entscheidungen: warum wir es genau so gemacht haben

Getrennt davon sollte man getroffene Entscheidungen zusammen mit den Gründen aufbewahren. Nicht nur „Font Fraunces“, sondern „Font Fraunces, weil der Auftraggeber teuer und vintage wollte“. Nach einem Monat rettet genau dieses „warum“ vor Umbauten im Kreis.

3. Das Regal der langen Dokumente

Große Texte: Recherchen, lange Anleitungen, Gesprächszusammenfassungen. Die hält man nicht zwischen den schnellen Notizen - die belegen den ganzen Tisch. Man legt sie getrennt ab und holt sie als Ganzes raus, wenn man sie braucht.

4. Das Regal der Suche nach Bedeutung

Eine ernstere Schicht: ein Wissensgraph Ein Wissensgraph - eine Art, Fakten als miteinander verbundene Stücke zu speichern: „Anna - Managerin von Projekt X“, „Projekt X nutzt Datenbank Y“. Man kann nicht nur nach exakten Wörtern suchen, sondern nach Bedeutung und Verbindungen. über ein spezielles Gedächtnis-Tool. Er sucht nach Bedeutung, nicht nach exakter Wortübereinstimmung, und sieht Verbindungen zwischen Fakten. Am Anfang lebt es sich ehrlich gesagt auch ohne ihn prima.

Der Arbeitszyklus von knowledge-ops: wie man Wissen richtig ablegt

Im Skill knowledge-ops sind das vier Schritte. Merk dir die Kette: „klassifizieren → Dubletten prüfen → schreiben → Index aktualisieren“.

1. Klassifiziere den Fakt

Frag dich: Was für ein Fakt ist das und wohin gehört er inhaltlich? Eine persönliche Vorliebe - ins Notizregal. Eine getroffene Entscheidung - ins Entscheidungsregal. Ein riesiges Dokument - getrennt, und in den Notizen lässt du eine kurze Zusammenfassung und einen Link.

2. Prüfe auf Dubletten - das ist das Wichtigste

Erst suchen, dann schreiben. Bevor du einen Fakt hinzufügst - schau, ob er nicht schon da ist. Ist er da? Aktualisiere den alten Eintrag, statt einen zweiten zu produzieren. Sonst hast du nach einer Woche drei Notizen über denselben Font, und alle leicht unterschiedlich. Rate mal, welche stimmt.

3. Schreib es kurz

Leg den Fakt aufs richtige Regal. Oder auf ein paar Regale, falls er wirklich an beiden Stellen gebraucht wird. Kurz und auf den Punkt: eine Notiz - ein Fakt.

4. Aktualisiere das Inhaltsverzeichnis

Gibt es eine Inhalts-Datei oder eine Übersicht? Trag den neuen Eintrag dort ein, damit man ihn später leicht findet.

Wissensbasis des Agenten: Vorteile und typische Reinfälle

Das Gedächtnis muss man jäten, nicht nur füllen

Da ist die Falle, in die fast alle tappen: man legt eine Wissensbasis an - und fügt nur hinzu. Nie aufräumen. Nach ein paar Monaten ist das ein Garten voller Unkraut: irgendwo eine Möhre (ein nützlicher Fakt), drumherum Unkraut (Veraltetes, Dubletten, Müll).

Der Skill knowledge-ops sagt es klar: halte Notizen kurz, archiviere Altes, lass die Dateien nicht grenzenlos aufquellen. Bevor du eine Aufgabe als erledigt betrachtest, geh die kurze Checkliste durch.

Beispiel aus dem Leben: Café-Website ohne Gedächtnis

Du baust mit dem Agenten eine Website für ein Café. Tag eins: Font gewählt, Palette, Tonfall der Texte, abgemacht das alte CMS nicht anzufassen. Schön.

Eine Woche später öffnest du eine neue Session: „lass uns die Café-Website fertigmachen“. Und der Agent - ein leeres Blatt. Kein Font, keine Palette, nichts über das CMS - gar nichts. Du erzählst alles neu, verhaspelst dich dabei selbst, und schon hast du zwei verschiedene Fonts auf zwei Seiten.

Was ist schiefgelaufen? Alle Entscheidungen lebten nur im Chatverlauf des ersten Tages. Neue Session - neue Amnesie.

Und wie macht es ein Vibecoder, der diese Lektion zu Ende gelesen hat: er legt dem Agenten einmal eine Wissensbasis an und bittet ihn, sie zu führen.

Leg eine Wissensbasis für dieses Projekt an und führe sie. Mach es so:

Erstelle eine Datei mit den Projektfakten (project-facts) und eine Datei
mit den Entscheidungen (decisions). Namen - kleingeschrieben mit Bindestrich.
In die Fakten schreib: Name, Sprache der Texte, Deadline, Kontakte.
In die Entscheidungen schreib nicht nur, WAS entschieden wurde, sondern auch WARUM
(zum Beispiel: Font Fraunces, weil ein teurer Vintage-Look gebraucht wird).
Bevor du einen neuen Fakt hinzufügst - such erst, ob es ihn nicht schon gibt.
Wenn ja, aktualisiere den alten Eintrag, statt einen zweiten zu erstellen.
Leg keine Passwörter, Keys und Tokens in diese Dateien.
Lies am Anfang jeder neuen Session zuerst diese beiden Dateien,
und nimm dir dann die Aufgabe vor.

Häufige Anfängerfehler mit der Wissensbasis

• Entscheidungen nur im Chat speichern. Neue Session - und sie sind weg. Lager sie in Dateien aus.
• Nur hinzufügen, nie aufräumen. Die Basis wuchert mit Müll und Dubletten zu.
• Vor dem Schreiben nicht suchen. Du bekommst fünf Notizen über einen Fakt, und welche stimmt - ein Rätsel.
• Alles in eine riesige Datei kippen. In einer Monster-Datei mit tausend Zeilen findet man unmöglich etwas - teil sie nach Bedeutung auf.
• Secrets ablegen „damit man sie nicht vergisst“. Ein Key in einer geteilten Datei = ein Sicherheitsloch.
• Aufschreiben „was entschieden wurde“ ohne das „warum“. Nach einem Monat baust du es im Kreis um, weil du den Grund vergessen hast.