Kurz gesagt: KI-Arbeit sollte dokumentiert werden, weil wichtige Entscheidungen sonst leicht in Chats, Toolwechseln und unsichtbaren Korrekturschleifen verschwinden. Ein gutes Arbeitsprotokoll macht nicht jeden Zwischenschritt öffentlich. Es hält fest, welche Annahmen getestet wurden, was tatsächlich funktioniert hat, wo Grenzen lagen und welche Entscheidungen ein Mensch getroffen hat.
Bei klassischer Projektarbeit entstehen sichtbare Artefakte: Entwürfe, Dateien, Tickets, Protokolle, Versionen. Bei KI-Arbeit kann ein großer Teil der eigentlichen Entwicklung dagegen in Gesprächen verschwinden. Ein Prompt wird verändert, ein Ansatz verworfen, ein Agent schlägt etwas vor, ein Mensch korrigiert die Richtung – und am Ende bleibt nur das Ergebnis übrig.
Genau dadurch wird KI-Arbeit schwer prüfbar. Man sieht, dass etwas entstanden ist, aber nicht mehr, warum es so aussieht, welche Alternativen verworfen wurden oder an welcher Stelle menschliches Urteil entscheidend war.
Was sollte bei KI-Arbeit dokumentiert werden?
- Ausgangspunkt: Welche reale Frage oder Aufgabe sollte gelöst werden?
- Annahmen: Was wurde zunächst für sinnvoll oder wahrscheinlich gehalten?
- Versuche und Korrekturen: Welche Ansätze funktionierten nicht – und warum wurde die Richtung geändert?
- Werkzeuggrenzen: Welche Aufgabe konnte ein Agent tatsächlich ausführen und welche nicht?
- Menschliche Entscheidungen: Wo wurden Inhalt, Risiko, Freigabe oder Priorität bewusst entschieden?
- Ergebnis und offener Stand: Was ist belegt, was bleibt Hypothese und was muss noch geprüft werden?
Warum nicht einfach den Chatverlauf aufheben?
Ein Chatverlauf ist Rohmaterial, aber noch keine belastbare Projektdokumentation. Er enthält Wiederholungen, Zwischenideen, Missverständnisse und Kontext, der nur in diesem einen Gespräch verständlich ist.
Für spätere Arbeit braucht es eine verdichtete Spur: Welche Entscheidung gilt jetzt? Welche offene Aufgabe bleibt? Welche Änderung ist tatsächlich im System angekommen? Welche Aussage darf öffentlich gemacht werden?
Genau deshalb trenne ich auf dieser Website zwischen interner Arbeitswahrheit, öffentlichem Logbuch und ausgereiften Beiträgen. Die konkrete Ordnung steht in „KI-Arbeit dokumentieren: GitHub, Logbuch oder Blog?“.
Was sollte öffentlich werden – und was nicht?
Öffentliche Dokumentation bedeutet nicht, jeden Prompt, jede Datei und jeden Fehlversuch ungefiltert zu veröffentlichen. Das würde eher Rauschen erzeugen als Transparenz.
Öffentlich interessant wird eine Arbeitsspur dann, wenn ein Außenstehender daraus etwas verstehen kann: eine überprüfbare Beobachtung, eine begründete Entscheidung, eine Grenze oder einen konkreten Arbeitsweg.
- Intern: operative Details, Zugangsdaten, unfertige Hypothesen, technische Zwischenstände und sensible Informationen.
- Logbuch: sichtbare Veränderungen und wichtige Richtungsentscheidungen.
- Blog/Wissensbeitrag: eine Frage, die auch außerhalb des Projekts verständlich und nützlich ist.
Warum das mehr ist als Content-Produktion
Der Sinn dieser Dokumentation ist nicht, aus jedem Arbeitsschritt einen neuen Artikel zu erzeugen. Das würde genau den generischen Content produzieren, den ich vermeiden will.
Dokumentation ist zuerst ein Qualitätswerkzeug: Sie hält Entscheidungen fest, macht Veränderungen nachvollziehbar und verhindert, dass ein neuer Agent oder ein späterer Chat bei null beginnt. Erst wenn darin eine eigenständige Frage für andere Menschen steckt, wird daraus öffentlicher Content.
Ein praktischer Beleg dafür ist der Beitrag „KI-Agent in WordPress: Dieser Beitrag wurde per MCP veröffentlicht“. Dort ist nicht nur das Ergebnis interessant, sondern die nachprüfbare Verbindung zwischen Auftrag, Werkzeugschicht und WordPress-Aktion.
Was diese Website damit versucht
webseite-mit-ki.de nutzt die eigene Entwicklung als öffentliches Versuchsfeld. Die Entstehungsgeschichte des Projekts steht separat in „Warum es webseite-mit-ki.de gibt“. Dieser Beitrag hat eine andere Aufgabe: Er beschreibt die Methode dahinter.
Das Ziel ist eine Arbeitsspur, die weder glatte Erfolgsgeschichte noch ungefiltertes Rohprotokoll ist. Sie soll zeigen, was tatsächlich gemacht wurde, welche Grenzen aufgetaucht sind und wo menschliche Entscheidungen weiterhin unverzichtbar bleiben.