Vorlagen & Templates
KI-Agent Report: Vorlage für nachvollziehbare Ergebnisse
„Fertig, alles erledigt" ist keine Aussage, die sich nachprüfen lässt. Ein Abschlussbericht wird erst nützlich, wenn er einer festen Struktur folgt - unabhängig davon, ob Claude Code, Codex oder ChatGPT ihn schreibt.
Diese Seite liefert die Struktur, ein ausgefülltes Beispiel und eine kurze Anleitung, wie du einen Report gegenprüfst statt ihm zu glauben.
Warum ein freier Abschlussbericht nicht reicht
Ein Agent, der über die eigene Arbeit berichtet, hat keinen Anreiz, Lücken hervorzuheben - „fertig" klingt bei einer vollständigen Lösung genauso wie bei einer halbfertigen. Ein freier Fließtext-Bericht lässt sich zudem schlecht mit dem Bericht der letzten Aufgabe vergleichen, weil jedes Mal eine andere Struktur, eine andere Reihenfolge und ein anderer Detailgrad gewählt wird. Eine feste Struktur behebt beides: Sie zwingt zu Vollständigkeit und macht Berichte über mehrere Aufgaben hinweg vergleichbar.
Was ein guter Agent-Report enthalten muss
Tabelle horizontal scrollen, um alle Spalten zu sehen.
| Baustein | Was reingehört |
|---|---|
| Auftrag | Die ursprüngliche Aufgabe in einem Satz |
| Geänderte Dateien | Vollständige Liste, nicht nur die „wichtigsten" |
| Nicht angefasste Schutzbereiche | Explizite Bestätigung, dass definierte Schutzbereiche unberührt blieben |
| Ausgeführte Tests | Welche Tests liefen, mit welchem Ergebnis - nicht nur „grün" |
| Offene Punkte | Was bewusst nicht gelöst wurde oder unklar blieb |
| Annahmen | Welche Annahmen getroffen wurden, wo der Auftrag Spielraum ließ |
| Empfehlung | merge-ready / Review nötig / do-not-merge, mit Begründung |
| Nächste Schritte | Was folgen sollte, falls die Aufgabe nicht vollständig abgeschlossen ist |
Die Report-Vorlage zum Kopieren
AGENT-REPORT - Vorlage
Auftrag: [ursprüngliche Aufgabe in einem Satz]
Geänderte Dateien:
- [Datei 1]
- [Datei 2]
Nicht angefasste Schutzbereiche:
[Bestätigung, z. B. "Zahlung, Auth, .env unberührt"]
Ausgeführte Tests:
[Befehl + Ergebnis, z. B. "npm test - 42/42 grün"]
Offene Punkte:
[was bewusst nicht gelöst wurde, oder "keine"]
Annahmen:
[getroffene Annahmen, oder "keine"]
Empfehlung: [merge-ready / Review nötig / do-not-merge]
Begründung: [ein bis zwei Sätze]
Nächste Schritte:
[falls nicht abgeschlossen, sonst "keine"]Beispiel: Ein ausgefüllter Report
Fiktives Beispiel für eine kleine Aufgabe im Projekt „FeedbackPing":
Auftrag: Formular-Validierung für die Feedback-Seite ergänzen
Geänderte Dateien:
- src/components/FeedbackForm.tsx
- src/components/FeedbackForm.test.tsx
Nicht angefasste Schutzbereiche:
Zahlung, Auth, .env, Tracking - unberührt
Ausgeführte Tests:
npm test - 18/18 grün (inkl. 3 neue Tests für Validierung)
Offene Punkte:
Fehlermeldung ist aktuell nur auf Deutsch, keine i18n-Anbindung geprüft
Annahmen:
E-Mail-Feld ist Pflichtfeld, da im Auftrag nicht anders spezifiziert
Empfehlung: merge-ready
Begründung: Diff entspricht dem Auftrag, Tests grün, keine Schutzbereiche berührt
Nächste Schritte:
Falls i18n relevant ist, separate Aufgabe für Fehlermeldungen anlegenWie du einen Report gegenprüfst, statt ihn zu glauben
Der Report ist ein Ausgangspunkt für die Prüfung, nicht ihr Ersatz. Mindestens drei Angaben verdienen einen eigenen Blick: die Liste der geänderten Dateien, das Testergebnis und die Empfehlung. Eine vollständige Prüfroutine dafür liefert die Merge-Checkliste für AI-generierten Code; die allgemeinere QA-Perspektive steht in der KI-Agenten QA-Checkliste.
Typische Schwächen in Agent-Reports
- „Tests laufen" ohne Befehl, Ausgabe oder Ergebnis.
- Eine unvollständige Dateiliste, die kleinere „Nebenbei"-Änderungen auslässt.
- Eine Empfehlung ohne nachvollziehbare Begründung.
- Keine Angabe zu Schutzbereichen, obwohl das Projekt welche definiert hat.
- Offene Punkte, die im Bericht verschwiegen statt benannt werden.
Was diese Vorlage nicht leistet
Die Vorlage macht Ergebnisse vergleichbar und Berichte vollständiger - sie prüft nichts von selbst. Ob eine Empfehlung tatsächlich stimmt, entscheidet weiterhin ein Mensch anhand von Diff, Tests und Kontext. Die Vorlage ersetzt außerdem keine Dokumentation für Dritte oder rechtliche Nachweise, sie ist ein internes Arbeitsmittel für nachvollziehbare Entscheidungen.
Häufige Fragen
Muss der Agent das Format selbst ausfüllen, oder ich?
Im Idealfall wird das Format Teil des Auftrags, sodass der Agent direkt in dieser Struktur berichtet. Die AI-Agenten-Briefing Vorlage zeigt, wo dieser Baustein hingehört.
Was, wenn der Agent das Format ignoriert?
Die fehlenden Felder selbst ergänzen, bevor die Empfehlung übernommen wird. Meist reicht ein kurzer Nachtrag.
Wie unterscheidet sich das vom Abschlussbericht-Baustein im Briefing?
Das Briefing fordert den Bericht ein, diese Seite definiert, wie er im Detail aussehen sollte.
Reicht diese Vorlage auch bei kleinen Aufgaben?
Ja, in verkürzter Form. Auch bei kleinen Aufgaben lohnen sich mindestens Dateiliste, Testergebnis und Empfehlung.
Wie lang sollte ein Report sein?
So kurz wie möglich, aber vollständig in allen acht Bausteinen. Meist passt er auf eine Bildschirmseite.
Was mache ich mit dem Report, nachdem die Aufgabe gemergt wurde?
Kurz archivieren oder in einem Änderungsprotokoll sammeln. Das ist nützlich, wenn spätere Aufgaben auf denselben Bereich zurückgreifen.