Wichtigste Erkenntnisse
- Jeder Produktions-Prompt benötigt mindestens eine Einzeiler-Karte (Zweck, Modell, Datum, Autor)
- Jeder geänderte Prompt benötigt einen Versionsblock (Was geändert wurde, warum, Testergebnis)
- Jeder getestete Prompt benötigt einen Testsuite-Header (Erfolgskriterien, Golden-Examples, Fehlermuster)
- Dokumentation am selben Ort wie der Prompt speichern — separate Dokumente werden aufgegeben
- Die Änderungsbegründung ("Warum") ist das wichtigste Feld
Warum undokumentierte Prompts Teams zerstören
📍 In One Sentence
Undokumentierte Prompts zerstören Teams durch stille Regression, Duplizierung und Wissensverlust — jedes durch 5–10 Minuten Dokumentation pro Prompt vermeidbar.
💬 In Plain Terms
Wenn ein Prompt keine Aufzeichnung darüber hat, was er tut oder warum er so geschrieben wurde, kann das Team ihn nicht sicher ändern, nach einer Bearbeitung nicht wiederherstellen oder ohne Kontext an ein neues Mitglied weitergeben.
Undokumentierte Prompts scheitern auf drei Arten: stille Regression (kein Nachweis, was sich geändert hat), Duplizierung und Wissensverlust. Jeder Fehler ist mit 5–10 Minuten Dokumentation pro Prompt vermeidbar.
Die teuerste Fehlerart ist stille Regression. Ein Team ändert einen Produktions-Prompt, um ein Problem zu beheben, beschädigt dabei unbeabsichtigt ein anderes und hat keine Ausgangsbasis für den Vergleich.
Dokumentieren Sie jeden Prompt, der mehr als einmal verwendet, in gemeinsamer Infrastruktur gespeichert oder in der Produktion eingesetzt wird.
⚠️ Risiko stiller Regression
Ohne Versionsblock und Golden Examples hat ein Team, das einen Produktions-Prompt modifiziert, keine Basislinie. Jede Bearbeitung ist eine Vermutung über den vorherigen Zustand.
6 Prompt-Dokumentationsvorlagen
Sechs Vorlagen decken den gesamten Prompt-Lebenszyklus ab. Jede Vorlage ist so konzipiert, dass sie in unter 10 Minuten ausgefüllt werden kann.
- 1Einzeiler-Karte
Why it matters: Zweck: minimaler Nachweis für jeden wiederverwendeten Prompt. Felder: Prompt-Name, Zweck (1 Satz), Zielmodell, Erstellungsdatum, Autor. - 2Versionsblock
Why it matters: Zweck: Prompt-Verlauf verfolgen. Felder: Versionsnummer, Änderungsdatum, Autor, Was geändert wurde (1 Satz), Grund für die Änderung (1 Satz), Testergebnis-Zusammenfassung. - 3Testsuite-Header
Why it matters: Zweck: Abnahmekriterien vor dem Schreiben von Tests definieren. Felder: Testziel, Erfolgskriterien, Golden-Examples (2–3 Ein-/Ausgabe-Paare), bekannte Fehlermuster. - 4Entscheidungsprotokoll
Why it matters: Zweck: Designentscheidungen aufzeichnen, die nicht offensichtlich sind. Felder: getroffene Entscheidung, betrachtete Alternativen, Begründung, Datum. - 5Änderungsbegründung
Why it matters: Zweck: erklären, warum ein Prompt geändert wurde. Felder: Problembeschreibung, vorgenommene Änderung, erwartete Verbesserung, gemessenes Ergebnis. - 6API-Konfigurationsblock
Why it matters: Zweck: Modellparameter in der Produktion aufzeichnen. Felder: Modell, Temperatur, Max-Tokens, Top-P, Stop-Sequenzen, System-Prompt-Version, User-Prompt-Version.
📌 Vorlagenauswahl-Leitfaden
Neuer Prompt → Einzeiler-Karte. Geänderter Prompt → Versionsblock. Getesteter Prompt → Testsuite-Header. Designentscheidung getroffen → Entscheidungsprotokoll. Nach Ausfall geändert → Änderungsbegründung. In Produktion deployt → API-Konfigurationsblock.
Wo Prompt-Dokumentation gespeichert werden soll
Speichern Sie die Prompt-Dokumentation im selben System wie den Prompt.
- Git: am besten für Engineering-Teams mit Prompts als Dateien. Commit-Nachrichten dienen als Versionsblöcke. Kostenlos.
- PromptHub: Prompt-Management mit Versionsverlauf, Reviewer-Signaturen und Testergebnis-Speicherung. 0–49 $/Monat.
- Notion: für Teams, die Prompts als Dokumente verwalten. Einfach einzurichten, fehlt Versionskontrolle.
- Braintrust: speichert Testsuite-Header und Evaluierungsergebnisse neben Prompt-Versionen.
💡 Dokumentation gemeinsam aufbewahren
Dokumentation in einem separaten System (Notion, Confluence, Google Docs) wird innerhalb von Tagen veraltet. Nur Dokumentation, die beim Prompt lebt, bleibt aktuell.
Häufige Dokumentationsfehler
❌ Gar keine Dokumentation
Why it hurts: Prompts können nach Bearbeitungen nicht wiederhergestellt werden; das Team versteht nicht, warum ein Prompt so geschrieben wurde
Fix: Verwenden Sie mindestens die Einzeiler-Karte — 3 Felder, unter 2 Minuten
❌ Dokumentation getrennt vom Prompt gespeichert
Why it hurts: Dokumentation veraltet, wenn sich Prompts ändern; Teams vergessen, sie zu aktualisieren
Fix: Dokumentation in derselben Datei oder demselben Git-Commit wie den Prompt speichern
❌ Fehlendes „Warum"-Feld — beschreibt nur, was der Prompt tut
Why it hurts: Zukünftige Bearbeiter kennen keine Einschränkungen und können nicht sicher refaktorieren
Fix: Ein „Begründung"-Feld zu jeder Vorlage hinzufügen: 1–2 Sätze, warum diese Struktur gewählt wurde
❌ Kein Versionsblock
Why it hurts: Kein Weg zu wissen, ob der in der Produktion laufende Prompt mit der dokumentierten Version übereinstimmt
Fix: Version und Änderungsdatum zu jeder Produktions-Prompt-Datei hinzufügen
Häufig gestellte Fragen
Warum brauchen Prompts eine Dokumentation?
Prompts ohne Dokumentation können nicht geprüft, auditiert oder reproduziert werden. Das Team kann keine Regressionen diagnostizieren und nicht auf bekannte gute Versionen zurückrollen.
Was ist die Mindestdokumentation für einen Prompt?
Das Minimum ist eine Einzeiler-Karte: Prompt-Zweck (ein Satz), Zielmodell, Erstellungsdatum, Autor. Dauert 2 Minuten und verhindert den häufigsten Dokumentationsfehler.
Wo soll Prompt-Dokumentation gespeichert werden?
Am selben Ort wie der Prompt selbst. Git für Code-Dateien, PromptHub für strukturierte Speicherung mit Versionsverlauf.
Wie detailliert muss eine Änderungsbegründung sein?
Drei Zeilen: Was geändert wurde, warum, und welcher Test bestätigt hat, dass es funktioniert.
Welche Vorlage für einen neuen Prompt?
Mit der Einzeiler-Karte beginnen. Bei Produktion: Versionsblock hinzufügen. Bei mehreren Tests: Testsuite-Header. Bei nicht offensichtlicher Designentscheidung: Entscheidungsprotokoll.
Wie oft soll die Dokumentation aktualisiert werden?
Bei jeder Änderung des Prompt-Texts. Versions-Bump und Änderungsbegründung für jede wesentliche Bearbeitung. Nicht rückwirkend aktualisieren.
Kann ich diese Vorlagen in PromptHub verwenden?
Ja. PromptHub bildet Metadatenfelder direkt auf Versionsblock- und API-Konfigurationsblock-Vorlagen ab.