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.

vor der Sitzung
# 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:

nach der Sitzung
# 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.

See changes an einer Notiz, die Claude Code bearbeitet hat: die Worte des Agenten, Grandfathering ended on 2026-10-01, über einem Diff des Absatzes, den er umgeschrieben hat, mit Close und Undo this edit (öffnet in voller Größe in einem neuen Tab)See changes an einer Notiz, die Claude Code bearbeitet hat: die Worte des Agenten, Grandfathering ended on 2026-10-01, über einem Diff des Absatzes, den er umgeschrieben hat, mit Close und Undo this edit (öffnet in voller Größe in einem neuen Tab)
See changes an einer Notiz, die Claude Code bearbeitet hat, in einem Demo-Workspace. Tippe darauf, um es in voller Größe zu öffnen.

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:

.claude/settings.json
{
"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:

AGENTS.md (Auszug)
## 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:

decisions/annual-plans.md
---
type: Decision
title: Abrechnung auf Jahrespläne umstellen
generated: { 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
---
  • generated sagt, wer den aktuellen Inhalt wann geschrieben hat. Agenten signieren als name/version, Menschen als human:name.
  • verified listet 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 ein human:-Akteur geprüft hat, ist human-reviewed.
  • stale_after ist 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:

Terminal
# 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

  1. Committe und leg dann einen Branch für die Sitzung an.
  2. Starte den Agenten im Modus Manual oder plan, mit Deny-Regeln für Ordner, die er nie anfassen soll.
  3. Gib ihm eine Aufgabe. Bitte am Ende um eine Liste der angefassten Dateien.
  4. Vergleich diese Liste mit und lies dann .
  5. Behalte mit , womit du einverstanden bist, und stell den Rest wieder her.
  6. 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:

ToolFängt abÜbersieht
Git diff und add -pJede Änderung an den Dateien, Zeile für ZeileOb ein geänderter Fakt anderswo noch stimmt
Checkpoints von Claude CodeSchnelles 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 hastSkripte, die selbst Dateien schreiben
Frontmatter zur HerkunftWelche Notizen nie geprüft wurden, und von wemFür sich allein nichts: Jemand muss die Prüfung auch machen
Verlauf und optionales Review in KnowtariumJede Ä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 wartenEine Ä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.

Ein Änderungsvorschlag eines Agenten in der Review-Warteschlange von Knowtarium: vorgeschlagen von Claude Code, seine Begründung in eigenen Worten, Approve und Reject und ein zeilenweiser Diff der Notiz (öffnet in voller Größe in einem neuen Tab)Ein Änderungsvorschlag eines Agenten in der Review-Warteschlange von Knowtarium: vorgeschlagen von Claude Code, seine Begründung in eigenen Worten, Approve und Reject und ein zeilenweiser Diff der Notiz (öffnet in voller Größe in einem neuen Tab)
Eine Änderung, die Claude Code in einem Ordner mit Ask me first vorgeschlagen hat, wartend in der Prüfliste. Tippe darauf, um es in voller Größe zu öffnen.

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:

StufeWas sie bedeutet
UnverifiedGeschrieben, noch nicht geprüft
Machine-confirmedVon einem Test oder Prozess geprüft
Human-reviewedVon einem Menschen geprüft
Fully verifiedVon beiden geprüft, nach der letzten Änderung
StaleNach 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.