KI-Prompts sind Dokumentation, keine Magie

Wer ein KI-System baut, schreibt meistens einen Prompt. Was danach damit passiert, entscheidet ob das System in sechs Monaten noch zuverlässig läuft oder ob es zum Rätsel wird.

Wir haben 2023 die ersten Systeme gebaut wie die meisten: iterativ, der Prompt im Dokument des Entwicklers oder in einer Testnotiz. Wenn etwas funktionierte, blieb es so. Wenn etwas nicht funktionierte, probierte man weiter. Die erfolgreiche Version irgendwo gespeichert, aber ohne Erklärung warum sie funktionierte.

Was ein Prompt wirklich enthält

Ein Prompt ist keine bloße Anweisungszeile. Er ist die codierte Entscheidung darüber, was ein System tun soll, was nicht, wie es mit Grenzfällen umgeht und welchen Qualitätsstandard es anlegt.

Das ist exakt was Dokumentation ist.

Unser System das Kundenfeedback kategorisiert, enthält in seinem Prompt alle Entscheidungen über Kategorien, Priorisierungslogik und Sonderfälle. Diese Entscheidungen wurden getroffen, meist in einem kurzen Gespräch, dann in den Prompt geschrieben und nirgendwo sonst festgehalten.

Ich habe zweimal erlebt, dass ein System nach einem Modell-Update andere Outputs produzierte. In beiden Fällen dauerte die Ursachenanalyse Stunden — nicht weil das Problem schwer war, sondern weil wir nicht mehr genau wussten, was der ursprüngliche Prompt leisten sollte.

Was passiert wenn Prompts nicht dokumentiert werden

Das Muster ist immer dasselbe: Jemand baut ein System, der Prompt funktioniert gut. Sechs Monate später produziert das System leicht schlechtere Outputs — nicht dramatisch, nicht sofort auffällig. Niemand weiß mehr warum der Prompt so gebaut wurde.

Das ist kein KI-Problem. Das ist ein Dokumentationsproblem, das in der KI-Schicht auftaucht.

Bei uns sind mindestens zwei Systeme aus 2023 in diesem Zustand. Wir wissen was sie tun. Die ursprünglichen Designentscheidungen hinter den Prompts sind nicht mehr vollständig rekonstruierbar. Das macht jede Anpassung langsamer: Man muss zuerst das ursprüngliche Ziel herausfinden, bevor man die Richtung ändern kann.

Wie wir Prompts heute behandeln

Seit Anfang 2025 haben wir drei Regeln eingeführt.

Jeder Prompt liegt in der Versionskontrolle, zusammen mit dem Code des Systems. Nicht in einem separaten Dokument, nicht in einer Testnotiz, nicht im Kopf des Entwicklers.

Jede größere Änderung an einem Prompt wird mit einem Kommentar versehen: was sich ändert und warum. Dieser Kommentar kostet eine Minute. Er spart im Problemfall Stunden.

Wenn ein System auffällig schlechtere Outputs liefert und die Ursache nicht innerhalb von 30 Minuten gefunden ist, lautet die erste Frage: Hat sich der Prompt geändert?

Diese Regeln klingen nach Overhead. In der Praxis sind sie das Mindestniveau für stabilen Betrieb über Monate.

Was das für Teams bedeutet

Wenn Prompts Dokumentation sind, ist Prompt-Schreiben keine mystische Fähigkeit, die wenige besitzen. Es ist eine Fertigkeit, die sich systematisch lernen lässt.

In einem Workshop im Februar 2025 haben acht Teammitglieder, die bisher keine Prompts geschrieben hatten, in vier Stunden funktionierende, dokumentierte Prompts für konkrete Anwendungsfälle erstellt. Nicht perfekt, aber brauchbar. Und vor allem: nicht mehr abhängig von einer einzelnen Person.

Der Unterschied zwischen einem KI-System das ein Jahr lang stabil läuft und einem das nach sechs Monaten zum Pflegefall wird, liegt zu einem großen Teil darin, ob Prompts wie Code behandelt werden oder wie Notizen.

Prompts sind das Pflichtenheft des KI-Systems. Wer sie nicht dokumentiert, baut auf Wissen das verschwindet.