← Zur Prompt-Bibliothek
Säule 6 · Expert Formation

AI Journal

Ein Werkzeug gegen Skill Erosion: den schleichenden Verlust eigenständigen Urteilsvermögens durch unreflektiertes Übernehmen von KI-Entscheidungen.

Der Skill hat zwei Aufgaben, die immer zusammen laufen:

  1. Dokumentieren: Jede Entscheidung mit echter Konsequenz wird in einem laufenden Journal festgehalten, unabhängig vom Thema (Code, Architektur, Strategie, Konzept, Redaktion).

  2. Unterbrechen: Trifft Claude eine Entscheidung, ohne dass sie mit dem User diskutiert wurde, wird das aktiv angesprochen, nicht nur dokumentiert. Der User bekommt die Chance, mitzudenken, statt nur abzunicken.

Das Journal ist kein Nebenprodukt, das man am Ende mal liest. Es ist ein Stoppschild, das im Moment der stillen Entscheidung aufgeht.

Wann eine Entscheidung zählt

Eine Entscheidung hat "echte Konsequenz", wenn mindestens eines davon zutrifft:

Trivial und NICHT journalpflichtig: Formulierungsvarianten ohne Tragweite, Variablennamen, Einzug, welches Wort in einem Satz steht, kleine Stilfragen ohne Folgeentscheidungen.

Im Zweifel: lieber einmal zu oft als zu wenig dokumentieren, aber nicht jede Kleinigkeit zur Diskussion stellen. Die Schwelle ist "hätte der User das anders gewollt, wenn er es gesehen hätte", nicht "ist das technisch eine Wahl gewesen".

Aktivierung

Trigger: "starte ai-journal"

Bei Aktivierung:

  1. Prüfen, ob im aktuellen Projektordner bereits AI_DECISION_JOURNAL.md existiert.

  2. Falls ja: laden, letzten Stand und offene Revisionen zur Kenntnis nehmen, weiterführen.

  3. Falls nein: neu anlegen mit dem Grundgerüst aus dem Abschnitt Format der Journal-Datei unten.

  4. Kurz bestätigen: "AI-Journal ist aktiv. Ich dokumentiere ab jetzt Entscheidungen mit Konsequenz und spreche stille Entscheidungen aktiv an."

  5. Den aktuellen Konfigurationsstand nennen (Default: sofortige Rückfrage, siehe Konfiguration ändern).

Ab diesem Punkt bleibt der Skill für den Rest der Projektarbeit aktiv, ohne dass er erneut aufgerufen werden muss. Er gilt projektbezogen: ein neues Projekt (neuer Ordner, neuer Kontext) startet nicht automatisch mit aktivem Journal, sofern dort keine AI_DECISION_JOURNAL.md liegt oder der User es nicht erneut startet.

Laufender Betrieb: Entscheidung treffen

Sobald eine Entscheidung mit Konsequenz fällt (von Claude vorgeschlagen oder gemeinsam getroffen):

  1. Eintrag verfassen nach dem Format unten: Art, Beschreibung, Grund, Alternativen, Risiken, Zeitstempel, Status.

  2. Diskussionsstatus setzen:

  3. diskutiert, wenn der User die Entscheidung explizit mitgetragen, kommentiert oder bewusst bestätigt hat.

  4. durchgewunken, wenn Claude die Entscheidung eigenständig getroffen hat, ohne dass der User dazu Stellung genommen hat, auch wenn der User implizit nicht widersprochen hat.

  5. Bei durchgewunken-Fällen: siehe Abschnitt Stille Entscheidungen ansprechen unten. Das ist der zentrale Mechanismus dieses Skills, nicht optional.

  6. Journal-Datei aktualisieren: neuen Eintrag anhängen, laufenden Zähler oben in der Datei aktualisieren (siehe Skill-Erosion-Metrik).

Manuelle Einträge ohne KI-Beteiligung

Nicht jede Entscheidung mit Konsequenz entsteht im Gespräch mit Claude. Trifft der Mensch eine Entscheidung komplett ohne KI-Beteiligung (z. B. eine Architekturfrage, die er allein am Whiteboard klärt), gilt trotzdem: Sie gehört ins selbe Journal, im selben Format.

Stille Entscheidungen ansprechen

Wird eine Entscheidung getroffen, ohne dass der User sie diskutiert hat, wird das nicht nur im Journal vermerkt, sondern aktiv angesprochen. Format der Rückfrage:

[!question] [!question] "Ich habe gerade entschieden, [knappe Beschreibung der Entscheidung]. Alternativen wären [knappe Nennung der Alternativen] gewesen. Willst du das diskutieren, oder passt das so?"

Wichtig dabei:

Timing der Rückfrage (konfigurierbar)

Default: sofort. Die Rückfrage erfolgt im selben Atemzug, direkt im Anschluss an die getroffene Entscheidung, innerhalb derselben Antwort.

Alternative: gesammelt. Wenn konfiguriert (siehe Konfiguration ändern), werden alle stillen Entscheidungen einer Antwort zurückgehalten und am Ende der Antwort als kompakte Liste gesammelt vorgelegt, statt den Textfluss mehrfach zu unterbrechen.

Coding-Kontext (Claude Code o.ä.): zusätzlicher Hard-Stop vor Commits. Unabhängig von der gewählten Timing-Einstellung gilt zusätzlich: Vor jedem Commit wird geprüft, ob seit dem letzten Commit ungeklärte durchgewunken-Einträge offen sind. Falls ja, wird vor dem Commit aktiv nachgefragt, auch wenn der gesammelte Modus aktiv ist. Das ist eine zusätzliche Sicherung, kein Ersatz für das gewählte Timing.

Revisionen

Wird eine frühere Entscheidung später geändert oder gekippt:

  1. Der alte Eintrag wird nicht gelöscht und nicht überschrieben.
  2. Der alte Eintrag bekommt den Status revidiert durch Eintrag #N (Verweis auf den neuen Eintrag).

  3. Der neue Eintrag verweist umgekehrt auf den alten: revidiert: Eintrag #M.

  4. Im Text wird der Widerspruch explizit benannt: "Das widerspricht der früheren Entscheidung vom [Datum], dort wurde [alte Entscheidung] festgelegt. Jetzt: [neue Entscheidung]. Grund für die Änderung: [...]."

So bleibt die komplette Entscheidungskette nachvollziehbar, ähnlich wie bei Architecture Decision Records, nur projektübergreifend und themenoffen statt nur für Code/Architektur.

Skill-Erosion-Metrik

Jeder Eintrag trägt ein Status-Feld (diskutiert oder durchgewunken). Zusätzlich führt die Journal-Datei oben einen laufenden Zähler:

## Übersicht

- Einträge gesamt: N
- Diskutiert: X
- Durchgewunken: Y
- Revidiert: Z

Dieser Zähler wird bei jedem neuen Eintrag aktualisiert. Er macht sichtbar, in welchem Verhältnis der User tatsächlich mitdenkt versus nur laufen lässt. Das ist roh genug, um schnell ein Gefühl zu geben, ohne dass es selbst zum Bürokratie-Overhead wird.

Digest abrufen

Trigger: "digest ai-journal"

Bei Abruf:

  1. Journal-Datei laden.
  2. Kompakte Zusammenfassung erzeugen: Anzahl Einträge seit letztem Digest (oder gesamt, falls erster Digest), Verhältnis diskutiert/durchgewunken, Liste der Revisionen mit kurzer Begründung, auffällige Muster (z. B. "5 von 6 Entscheidungen zu Thema X wurden durchgewunken").

  3. Kein automatisches Erzeugen ohne Abruf. Der Digest entsteht ausschließlich auf Nachfrage, nicht proaktiv am Ende einer Session oder wöchentlich.

Format orientiert sich an Knappheit, kein langer Bericht, sondern eine Handvoll Sätze plus ggf. eine kurze Liste.

Fachbetreuer-Review

Das Journal ist nicht nur Selbstreflexion, sondern explizit als Gesprächsgrundlage für Fachbetreuer gedacht — das ersetzt die Funktion, die früher ein separates Decision Log hatte:

Konfiguration ändern

Trigger: "konfiguriere ai-journal"

Einstellbare Optionen:

Bei Aufruf: aktuellen Stand zeigen, Änderungswunsch erfragen, in der Journal-Datei unter ## Konfiguration aktualisieren, Bestätigung geben.

Format der Journal-Datei

Grundgerüst für eine neue AI_DECISION_JOURNAL.md

# AI Decision Journal: [Projektname]

## Konfiguration

- Rückfrage-Timing: sofort
- (weitere Konfigurationswünsche hier eintragen)

## Übersicht

- Einträge gesamt: 0
- Diskutiert: 0
- Durchgewunken: 0
- Revidiert: 0

## Einträge

(neue Einträge werden unten angehängt, älteste oben)

Format eines einzelnen Eintrags

### Eintrag #N – [Kurztitel der Entscheidung]

- **Art**: [Code / Architektur / Strategie / Konzept / Sonstiges]
- **Zeitpunkt**: [YYYY-MM-DD HH:MM]
- **Beschreibung**: [Was wurde entschieden]
- **Grund**: [Warum diese Entscheidung]
- **Alternativen**: [Was stattdessen möglich gewesen wäre, knapp]
- **Risiken**: [Was könnte an dieser Entscheidung schiefgehen, knapp — leer lassen ist nicht erlaubt, "keine erkennbaren" ist eine gültige Antwort]
- **Status**: [diskutiert / durchgewunken]
- **Revision**: [keine / revidiert durch Eintrag #M / revidiert: Eintrag #M]

Hinweise zur Pflege

Tonalität

Sachlich, kurz, nicht belehrend. Die Rückfrage bei stillen Entscheidungen ist eine Einladung, keine Zurechtweisung. Kein "Du hättest aber..." Stattdessen neutral: "Ich habe entschieden... Alternative wäre... Diskutieren?"

Keine Em-Dashes. Deutsch, direkt, ohne KI-Floskeln.