Das Ergebnis einer Agentenaufgabe berichten: erledigt, teilweise oder blockiert, mit Belegen

Ziel

Einen Abschlussbericht liefern, dessen Status die lesende Person wörtlich nehmen und danach handeln kann, und der ein teilweises Ergebnis genauso nützlich macht wie ein vollständiges.

Voraussetzungen

Eine Aufgabe mit einem festgelegten Ziel und, idealerweise, einer zu Beginn vereinbarten Abnahmeprüfung. Wurde keine vereinbart, nennt der Bericht die Prüfung, die der Agent angewendet hat.

Schritte

1. Genau einen Status wählen. Erledigt: Die Abnahmeprüfung ist bestanden und es gibt Belege. Teilweise: Ein Teil des Umfangs ist mit Belegen erledigt, der Rest ist aufgelistet. Blockiert: Ohne eine Eingabe, eine Berechtigung oder eine Entscheidung ist kein weiterer Fortschritt möglich, und diese Eingabe wird benannt. Ein „teilweise“ nicht zu „erledigt“ aufwerten, nur weil der Rest klein erscheint.
2. Mit dem Status und dem Ergebnis in einem Satz beginnen, dann die Belege: welche Prüfungen liefen, mit Befehl und Ergebnis (Testanzahlen, ein Statuscode, eine Diff-Zusammenfassung). Belege, die die lesende Person wiederholen kann, sind mehr wert als eine Beschreibung.
3. Auflisten, was sich geändert hat, nach Kennung: Dateien, Datensätze, Konfigurationsschlüssel, externe Objekte. Umkehrbare Änderungen von solchen trennen, die bereits eine externe Wirkung hatten.
4. Jede Annahme, auf der die Arbeit beruht, an der Stelle nennen, an der sie relevant ist, zusammen mit dem, was sich ändern würde, wenn die Annahme falsch ist.
5. Bei teilweise und blockiert: den verbleibenden Umfang als konkrete Schritte auflisten und für jede Blockade die genaue Eingabe nennen, die sie lösen würde (eine Entscheidung zwischen benannten Optionen, einen Zugangsnachweis, eine Antwort auf eine schriftliche Frage).
6. Fehlschläge klar mit ihrer Ausgabe berichten. Ein fehlschlagender Test wird als fehlschlagend berichtet, nicht als „grösstenteils bestanden“; ein übersprungener Schritt wird als übersprungen berichtet, mit dem Grund.
7. Den Bericht frei von Erzählung über den Prozess halten, ausser der Prozess hat einen Befund erzeugt, den die lesende Person braucht (eine überraschende Einschränkung, eine falsche Annahme im Auftrag). Sackgassen gehören ins Ausführungsprotokoll, nicht in den Bericht.

Erwartetes Ergebnis

Eine Person, die nur den Bericht sieht, kann entscheiden, ob die Arbeit abgenommen, fortgesetzt oder umgelenkt wird, und kann die Behauptung „erledigt“ allein anhand der Belegzeilen prüfen. Teilergebnisse werden verlustfrei übergeben, weil der verbleibende Umfang bereits aufgeschrieben ist.

Grenzen und Prüfbasis

Ein vorgeschlagenes Format, kein gemessenes. Sein Wert hängt davon ab, dass die Abnahmeprüfung früh festgelegt wird; ein Bericht kann bei einem vagen Ziel nur ehrlich sein, indem er sagt, dass das Ziel vage war.