Anleitung
So prüfst du, was KI-Agenten in deinen Notizen ändern
Um Änderungen von KI-Agenten an deinen Notizen zu prüfen, committest du, bevor der Agent loslegt, liest den Diff, bevor du etwas behältst, und hältst in jeder Notiz fest, wer sie geprüft hat. Git deckt die Grundlagen ab. Knowtarium, eine Ende-zu-Ende-verschlüsselte Wissensdatenbank, signiert jede Änderung eines Agenten, damit du sie sehen und rückgängig machen kannst, und hält Änderungen in den Ordnern, in denen du Review einschaltest, für deine Freigabe zurück.
Von Fadel Kaadan · Aktualisiert am
Warum ungeprüfte Änderungen von Agenten riskant sind
Wenn du einen KI-Agenten in deinen Notizen arbeiten lässt, brauchst du einen Weg, seine Änderungen zu prüfen, bevor du dich darauf verlässt. Ein Coding-Agent ist schnell und formuliert flüssig, und genau das ist das Problem: Ein falscher Satz liest sich genauso wie ein richtiger. Bei Code schlägt oft ein Test fehl, wenn ein Agent etwas falsch macht. In einer Wissensdatenbank schlägt nichts fehl. Das falsche Datum steht einfach da.
Ein paar Dinge gehen immer wieder schief:
- Stille Umformulierungen. Du bittest um eine neue Notiz, und der Agent „räumt“ nebenbei drei alte auf und ändert dabei den Sinn eines Satzes, den du sorgfältig geschrieben hast.
- Überschriebene Änderungen. Du hast gestern von Hand eine Zahl korrigiert. Heute schreibt der Agent die Notiz aus einer älteren Quelle neu, und deine Korrektur ist weg.
- Fehler, die sich ausbreiten. Die nächste Sitzung liest den falschen Fakt als Kontext, wiederholt ihn in zwei weiteren Notizen, und jetzt sieht er bestätigt aus.
- Keine Aufzeichnung. Einen Monat später kannst du nicht mehr sagen, welche Notizen du geschrieben hast, welche ein Agent und welche je jemand geprüft hat.
Die Lösung hat zwei Teile: jede Änderung sehen, bevor sie bleibt, und aufschreiben, wer was geprüft hat. Diese Anleitung zeigt, wie du beides von Hand mit Git und ein paar Frontmatter-Feldern machst, und nach jedem Schritt, wie Knowtarium es handhabt. Genau dafür bauen wir Knowtarium: Änderungen von Agenten sind dort standardmäßig signiert und lassen sich rückgängig machen, und eine Prüfung, bevor eine Änderung bleibt, schaltest du pro Ordner ein.
Änderungen von KI-Agenten mit Git prüfen
Git ist das beste kostenlose Tool für diese Aufgabe. Wenn deine Notizen ein Ordner mit Markdown-Dateien sind, stell sie unter Git und committe vor jeder Agenten-Sitzung. Dann ist alles, was der Agent tut, ein Diff, den du lesen, zum Teil behalten oder verwerfen kannst.
# einmal, in deinem Notizordner# vor jeder Agenten-Sitzung: ein sauberer Ausgangspunkt auf einem eigenen Branch
Ein Branch hält deinen Hauptverlauf sauber: War die ganze Sitzung ein Fehler, wechselst du zurück und löschst den Branch. Wenn der Agent fertig ist, lies, was er geändert hat:
# welche Dateien sich geändert haben, und wie stark# die Änderungen Wort für Wort lesen, das passt besser zu Text als ganze Zeilen# die Stücke behalten, mit denen du einverstanden bist (y = behalten, n = überspringen, s = teilen, e = bearbeiten)# alles verwerfen, was du nicht behalten hast# zurück auf main, das Freigegebene übernehmen
git add -p macht daraus eine echte Prüfung. Es geht jedes geänderte Stück (Hunk) mit dir durch und lässt dich es übernehmen oder überspringen, so behältst du die neue Notiz und verwirfst das ungefragte Umschreiben einer alten. Drück s, um ein großes Stück in kleinere zu teilen, und e, um eines von Hand zu bearbeiten.
Achte auf neue Dateien
git diff zeigt nur Änderungen an Dateien, die Git schon verfolgt. Notizen, die der Agent neu angelegt hat, erscheinen in git status als untracked. Lies sie dort und vergiss sie beim Committen nicht.
Schreib den Namen des Agenten in die Commit-Nachricht. Dann sagt dir git log, welche Sitzung was geschrieben hat, und zeigt den ganzen Verlauf einer einzelnen Notiz.
In Knowtarium
In Knowtarium wird jede Änderung eines Agenten als neue Version gespeichert, signiert mit dem eigenen Schlüssel des Agenten. Der Verlauf der Notiz listet also jede Version mit Urheber und Zeitpunkt, See changes zeigt die Änderung des Agenten als Diff, und Undo holt die vorherige Version zurück. Für Ordner, die du vorher lesen willst, schalte Review ein („Ask me first“): Änderungen von Agenten warten dort als Diffs, bis du sie freigibst oder mit einem Kommentar ablehnst.
(öffnet in voller Größe in einem neuen Tab)
(öffnet in voller Größe in einem neuen Tab)Nutze die eigenen Schutzmechanismen von Claude Code
Wenn du Claude Code nutzt, helfen dir drei seiner Funktionen. Keine davon ersetzt Git, aber sie fangen Probleme früher ab.
Berechtigungsmodi
Ein Berechtigungsmodus legt fest, was Claude tun darf, ohne zu fragen. Im Modus Manual (Konfigurationswert default) fragt es, bevor es Dateien bearbeitet. acceptEdits lässt es ohne Nachfrage bearbeiten, was Anthropic empfiehlt, wenn du lieber hinterher mit git diff prüfst. Im Modus plan recherchiert Claude und schlägt Änderungen vor, ohne sie umzusetzen, bis du den Plan freigibst. Mit Shift+Tab wechselst du während einer Sitzung durch die Modi. Neuere Versionen starten interaktive Sitzungen im Auto-Modus, in dem ein Klassifikator die Aktionen prüft statt du. Wechsle also für Sitzungen in Notizen, die dir wichtig sind, in den Modus Manual oder plan.
Checkpoints
Claude Code speichert vor jedem Prompt, den du schickst, einen Checkpoint. Führ aus oder drück bei leerem Prompt zweimal Esc, um die Dateien, das Gespräch oder beides wiederherzustellen. Kenn die Grenzen: Checkpoints verfolgen keine Dateien, die durch Shell-Befehle wie mv oder rm geändert wurden, stellen Änderungen von Subagenten meist nicht wieder her und werden standardmäßig nach etwa 30 Tagen gelöscht. Die Doku von Anthropic sagt klar, dass Checkpoints kein Ersatz für eine Versionsverwaltung sind.
Berechtigungsregeln
Regeln in .claude/settings.json sperren Änderungen an bestimmten Ordnern oder machen sie von einer Nachfrage abhängig. Deny-Regeln haben Vorrang vor allem anderen und gelten in jedem Modus:
{"permissions": {"ask": ["Edit(/decisions/**)"],"deny": ["Edit(/journal/**)", "Edit(/people/**)"]}}
Hier darf Claude journal/ und people/ nie bearbeiten und muss fragen, bevor es decisions/ anfasst. Edit-Regeln gelten für Claudes eingebaute Datei-Tools und für Dateibefehle, die es in der Shell erkennt, aber nicht für ein Skript, das selbst Dateien öffnet. Für eine harte Garantie verweist Anthropic auf seine Sandbox.
In Knowtarium
Modi, Checkpoints und Berechtigungsregeln legen fest, was Claude Code während einer Sitzung darf. Knowtarium kümmert sich um das, was danach passiert: Egal, in welchem Modus die Sitzung lief, jede Änderung von Claude Code ist signiert, am Dokument markiert und lässt sich rückgängig machen. In einem Ordner mit Review bleibt sie ungeprüft, bis du sie freigibst.
Sag Agenten, was sie ändern dürfen
Die meisten Agenten lesen vor dem Start eine Datei mit Anweisungen: AGENTS.md bei Codex, Cursor und vielen anderen, CLAUDE.md bei Claude Code. Schreib deine Regeln fürs Bearbeiten dort hinein. Halte sie kurz und so konkret, dass man sie überprüfen kann:
## Dokumente ändern- Lösch nie ein Dokument. Setz `status: deprecated` und sag, warum.- Bearbeite nie Dateien in journal/ oder people/.- Schreib keinen Absatz um, den du nicht ändern solltest.- Signiere jedes Dokument, das du schreibst, in `generated`, mit deinem Namen und deiner Version.- Füg nie einen `human:`-Eintrag zu `verified` hinzu. Das macht nur ein Mensch.- Beende die Sitzung mit einer Liste aller Dateien, die du angelegt, geändert oder verschoben hast.
Die letzte Regel ist die nützlichste für die Prüfung: eine Liste aller angefassten Dateien, die du mit vergleichen kannst. Weichen sie voneinander ab, schau genauer hin.
Anweisungen sind Kontext, kein Schloss. Die Doku von Anthropic beschreibt CLAUDE.md als etwas, das Claude liest, nicht als Konfiguration, die es durchsetzt; deshalb gibt es die Berechtigungsregeln oben. Unsere Anleitung zu AGENTS.md und CLAUDE.md für eine Wissensdatenbank hat eine vollständige Vorlage.
Unter macOS und Linux kannst du einen Ordner außerdem mit schreibschützen. Sieh das als Bremsschwelle: Ein Agent, der Shell-Befehle ausführen kann, kann die Rechte auch wieder ändern.
In Knowtarium
Wenn du Claude Code, Codex oder Cursor mit verbindest, gibt Knowtarium dem Agenten mit seinen Tools die Konventionen mit: zuerst die eigene index.md des Workspace lesen, wo es eine gibt, dir sagen, ob eine Änderung gespeichert wurde oder auf Freigabe wartet, und nie einen human:-Eintrag hinzufügen. Sie sagen auch, dass Dokumente nur auf deine Bitte gelöscht oder verschoben werden, und Agenten können beides nur mit deiner Erlaubnis. Für einen Ordner wie journal/ verbindest du den Agenten nur mit den anderen Ordnern, und der Server lehnt alles außerhalb ab; deine übrigen Regeln behältst du in AGENTS.md.
Halte fest, wer jedes Dokument geschrieben und wer es geprüft hat
Ein Diff sagt dir, was sich heute geändert hat. Er sagt der Person, die nächsten Monat liest, nicht, ob jemand eine Notiz geprüft hat. Dafür schreibst du es in die Notiz selbst. Das Open Knowledge Format (OKF), eine offene Spezifikation von Google Cloud, hat genau dafür Felder:
---type: Decisiontitle: Abrechnung auf Jahrespläne umstellengenerated: { by: claude-code/2.1, at: 2026-09-26T09:12:00Z }verified:- { by: human:maya, at: 2026-09-26T11:40:00Z }stale_after: 2027-03-31T00:00:00Z---
generatedsagt, wer den aktuellen Inhalt wann geschrieben hat. Agenten signieren alsname/version, Menschen alshuman:name.verifiedlistet alle, die ihn seitdem geprüft haben, mit Zeitpunkt. Ein Dokument ohne Eintrag ist unverified, eines, das nur Agenten oder Prozesse geprüft haben, ist machine-confirmed, und eines, das einhuman:-Akteur geprüft hat, ist human-reviewed.stale_afterist der Zeitpunkt, ab dem man das Dokument nicht mehr bedenkenlos zitieren kann.
Die Routine ist einfach. Der Agent schreibt und signiert generated, nie verified. Du prüfst den Diff und fügst dann deinen eigenen verified-Eintrag hinzu. Steht das, findest du mit einem einzigen Befehl, was noch niemand geprüft hat:
# Dokumente, die noch niemand geprüft hat: gar keine verified-Zeile
In Knowtarium
In Ordnern mit Review liest Knowtarium diese Felder und kann jedes Dokument im Graph nach seiner Vertrauensstufe einfärben, also fallen ungeprüfte Dokumente ohne grep auf.
Eine Prüfroutine, die trägt
- Committe und leg dann einen Branch für die Sitzung an.
- Starte den Agenten im Modus Manual oder plan, mit Deny-Regeln für Ordner, die er nie anfassen soll.
- Gib ihm eine Aufgabe. Bitte am Ende um eine Liste der angefassten Dateien.
- Vergleich diese Liste mit und lies dann .
- Behalte mit , womit du einverstanden bist, und stell den Rest wieder her.
- Füg jeder Notiz, die du geprüft hast, deinen
verified-Eintrag hinzu, committe mit dem Namen des Agenten in der Nachricht und merge.
Jedes Tool fängt etwas anderes ab:
| Tool | Fängt ab | Übersieht |
|---|---|---|
| Git diff und add -p | Jede Änderung an den Dateien, Zeile für Zeile | Ob ein geänderter Fakt anderswo noch stimmt |
| Checkpoints von Claude Code | Schnelles Rückgängigmachen innerhalb einer Sitzung | Änderungen durch Shell-Befehle, die meisten Änderungen von Subagenten, alles, was älter ist als die Aufbewahrungszeit |
| Berechtigungsregeln | Änderungen an Ordnern, die du ausgeschlossen hast | Skripte, die selbst Dateien schreiben |
| Frontmatter zur Herkunft | Welche Notizen nie geprüft wurden, und von wem | Für sich allein nichts: Jemand muss die Prüfung auch machen |
| Verlauf und optionales Review in Knowtarium | Jede Änderung eines Agenten, signiert und rückgängig zu machen; mit Review auch Änderungen, die auf dich warten, und deine Änderungen, die auf die Prüfung durch einen Agenten warten | Eine Änderung, die du behältst oder freigibst, ohne sie zu lesen |
Für ein paar Dutzend Notizen und einen Agenten können Git und diese Routine reichen. Mühsam wird es, wenn Agenten jeden Tag schreiben, wenn eine Änderung zehn Notizen betrifft oder wenn deine eigene Änderung fünf andere Notizen falsch macht, ohne dass du es merkst. Genau dafür ist Knowtarium gebaut: Jede Änderung eines Agenten ist signiert und einen Klick vom Rückgängigmachen entfernt, und wo du Review einschaltest, warten Änderungen von Agenten auf dich und deine eigenen Änderungen, bis du einen Agenten bittest, sie zu prüfen.
Agenten-Änderungen in Knowtarium prüfen
Knowtarium baut die Routine von oben in eine Ende-zu-Ende-verschlüsselte Wissensdatenbank ein. Deine Agenten verbinden sich über MCP und arbeiten an denselben OKF-Dokumenten, und die App zeigt dir, was sie getan haben und was noch einen Blick braucht. Die Prüfung gibt es in zwei Stärken: standardmäßig Undo für jede Änderung, und vorherige Freigabe, wo du sie haben willst.
Jede Änderung signiert und rückgängig zu machen
Standardmäßig wird die Änderung eines Agenten sofort als nächste Version des Dokuments gespeichert, signiert mit dem eigenen Schlüssel des Agenten. Ein Punkt in der Seitenleiste markiert die Dokumente, die er bearbeitet hat, bis du sie öffnest, eine Zeile unter dem Titel sagt, welcher Agent wann, mit einem Link zu den Änderungen und einem Undo, und die Seite des Workspace listet, was Agenten in den letzten 14 Tagen bearbeitet haben. Undo holt die vorherige Version als deine eigene Änderung zurück, und der Verlauf bewahrt jede Version zum Wiederherstellen auf, so lange du einstellst (zu Beginn 30 Tage, bis zu einem Jahr).
Ask me first: erst Diffs, dann Freigabe
Schalte Review für einen Workspace oder einen Ordner ein, und Änderungen von Agenten warten dort stattdessen als Vorschläge. Öffne einen, und du siehst den Diff mit der Zusammenfassung des Agenten und wer ihn vorgeschlagen hat. Gib ihn frei, lehn ihn mit einem Kommentar ab oder gib mehrere auf einmal frei. Die Freigabe trägt dich mit Uhrzeit in verified ein, das ist der human:-Eintrag, den du sonst von Hand tippen würdest. Der Vorschlag des Agenten bringt seine eigene Prüfung schon mit, also ist die Notiz nach deiner Freigabe vollständig verifiziert.
(öffnet in voller Größe in einem neuen Tab)
(öffnet in voller Größe in einem neuen Tab)In diesen Ordnern sammelt eine Liste alles, was auf eine Prüfung wartet:
- Änderungen, die ein Agent vorgeschlagen hat und die auf dich warten;
- Änderungen, die du gemacht hast und die auf die Prüfung durch einen Agenten warten;
- Konflikte, die ein Agent beim Prüfen gefunden hat.
Dokumente, deren stale_after-Datum vorbei ist oder bald kommt, stehen auf der Seite Stale and expiring, egal, wo sie liegen.
Prüfungen in beide Richtungen
In Ordnern mit Review läuft die Prüfung auch andersherum. Wenn du selbst ein Dokument bearbeitest, ist die Änderung als deine signiert und wartet in der Liste, bis ein Agent sie mit jedem verbundenen Dokument abgleicht. Knowtarium ruft selbst keine KI auf: Du bittest deinen Agenten, die Änderungen von heute zu prüfen, und er erfasst seine Prüfung oder meldet einen Konflikt, wo etwas nicht mehr zusammenpasst.
Vertrauensstufen
In Ordnern mit Review hat jedes Dokument eine Vertrauensstufe:
| Stufe | Was sie bedeutet |
|---|---|
| Unverified | Geschrieben, noch nicht geprüft |
| Machine-confirmed | Von einem Test oder Prozess geprüft |
| Human-reviewed | Von einem Menschen geprüft |
| Fully verified | Von beiden geprüft, nach der letzten Änderung |
| Stale | Nach seinem stale_after-Datum |
Für jeden Agenten gelten dieselben Regeln: Agenten können nichts als von einem Menschen geprüft markieren, sie löschen ein Dokument nur, wenn du ihnen das erlaubt hast, und in Ordnern mit Review können sie deine Prüfung nicht überspringen. Deine Dokumente sind Ende-zu-Ende-verschlüsselt, wir können sie also nicht lesen; die Agenten, die du verbindest, sehen, was sie lesen. Sieh dir die Funktionen an und wie sich Agenten verbinden.
Fragen
Wie verhindere ich, dass Claude Code meine Notizen überschreibt?
Committe vor jeder Sitzung, damit sich jedes Überschreiben rückgängig machen lässt, leg in .claude/settings.json Deny-Regeln wie Edit(/journal/**) für Ordner an, die es nie anfassen darf, und arbeite im Modus Manual oder plan, damit Claude fragt oder vorschlägt, bevor es etwas ändert.
Reichen die Checkpoints von Claude Code, um Änderungen von Agenten rückgängig zu machen?
Allein nicht. Checkpoints verfolgen keine Dateien, die durch Shell-Befehle geändert wurden, stellen Änderungen von Subagenten meist nicht wieder her und werden standardmäßig nach etwa 30 Tagen gelöscht. Die Doku von Anthropic rät, weiter eine Versionsverwaltung wie Git zu nutzen.
Wie sehe ich am einfachsten, was ein KI-Agent geändert hat?
Stell den Ordner unter Git und committe vor der Sitzung. Danach listet git status neue und geänderte Dateien, git diff --stat zeigt, wie viel sich geändert hat, und git diff --word-diff zeigt jede Änderung Wort für Wort.
Wie gebe ich nur einen Teil der Änderungen eines Agenten frei?
Mit git add -p. Es zeigt jedes geänderte Stück und lässt dich es übernehmen oder überspringen. Committe, was du übernommen hast, und verwirf den Rest mit git restore .
Wie markiere ich eine Notiz als geprüft?
Füg dem Frontmatter-Feld verified einen Eintrag mit deinem Namen und der Uhrzeit hinzu, etwa { by: human:maya, at: 2026-09-26T11:40:00Z }. In OKF macht ein verified-Eintrag von einem human:-Akteur die Notiz human-reviewed. In Knowtarium fügt die Freigabe einer Agenten-Änderung in einem Ordner mit Review diesen Eintrag für dich hinzu.
Kann ich Änderungen von Agenten ohne Git prüfen?
Ja, mit Knowtarium. Jede Änderung, die ein Agent speichert, ist eine signierte Version, du siehst also, was er geändert hat (See changes, an der Notiz), und machst sie mit einem Klick rückgängig. Schalte Review für einen Ordner ein, dann warten Änderungen von Agenten dort als Diffs, bis du sie freigibst. Deine Dokumente sind Ende-zu-Ende-verschlüsselt, und du kannst sie jederzeit als einfaches Markdown exportieren.