Ein Briefing für einen KI-Programmieragenten schreiben: praktische Vorlage

Ein hilfreiches Briefing für einen KI-Programmieragenten beschreibt das gewünschte Verhalten, den bestehenden Projektkontext, die Einschränkungen und die Prüfung der Fertigstellung. Der Agent sollte verstehen, was er ändern soll und warum, ohne wichtige Produktentscheidungen erraten zu müssen. Gute Anweisungen erleichtern dir außerdem die spätere Überprüfung.

Du musst nicht jedes Umsetzungsdetail vorgeben. Konzentriere dich auf beobachtbares Verhalten und nenne technische Fakten, die du tatsächlich kennst. Kennzeichne Unsicherheiten als Fragen, statt sie mit selbstsicheren Annahmen zu füllen.

Beginne mit einem Ergebnis

Betrachte eine kleine Terminbuchungsanwendung. „Verbessere die Buchungsseite“ lässt das Ziel offen. Hilfreicher ist: „Ermögliche Besuchern, einen verfügbaren Termin auszuwählen und eine Bestätigung zu erhalten. Verhindere dabei zwei Buchungen für dasselbe Zeitfenster.“

Erkläre den Grund der Änderung. Vielleicht schicken Besucher bisher frei formulierte Anfragen, während Mitarbeitende die Verfügbarkeit manuell abstimmen. Kontext hilft dem Agenten, Möglichkeiten zu bewerten. Das gewünschte Verhalten muss trotzdem ausdrücklich beschrieben sein. Eine lange Geschäftsbeschreibung ersetzt keine klare Aufgabe.

Liefere relevanten Projektkontext

Nenne das Repository, die betroffene Route oder Komponente, das aktuelle Datenmodell und die Befehle zum Starten und Prüfen der Anwendung. Verweise auf bestehende Konventionen und Projektanweisungen. Bitte den Agenten, relevante Dateien zu untersuchen, bevor er Änderungen vorschlägt.

Schreibe keine Zugangsdaten in den Prompt oder ins Repository. Beschreibe nötige Konfiguration über Variablennamen und nutze die übliche sichere Geheimnisverwaltung des Projekts. Ist eine Abhängigkeit oder externe Schnittstelle beteiligt, soll der Agent die aktuelle offizielle Dokumentation der eingesetzten Version prüfen.

Lege Umfang und Grenzen fest

Definiere, was die Änderung betreffen darf. Beim Buchungsbeispiel könnte der Buchungsablauf geändert werden, während Personalverwaltung und E-Mail-Vorlagen erhalten bleiben. Halte fest, ob Datenbankänderungen, Migration, Bereitstellung und externe Benachrichtigungen dazugehören.

Trenne rückgängig zu machende Entwicklungsarbeit von Handlungen mit wesentlichen Folgen. Ein Agent kann eine Migration vorbereiten und testen, ohne automatisch davon auszugehen, dass er sie in Produktion ausführen soll. Klare Grenzen vermindern Missverständnisse und machen die Prüfung konkret: Du kannst vorgeschlagene Änderung, Auswirkungen und Wiederherstellung beurteilen.

Beschreibe Erfolgs- und Fehlerfälle

Erkläre eine erfolgreiche Buchung, eine ungültige E-Mail-Adresse, einen nicht verfügbaren Termin und eine Netzwerkunterbrechung. Verlange einen Test konkurrierender Buchungsversuche für dasselbe Zeitfenster, wenn gleichzeitige Nutzer vorgesehen sind. Die visuelle Prüfung einer Schaltfläche belegt nicht, dass Doppelbuchungen verhindert werden.

Bitte um einen kurzen Abschlussbericht zu geändertem Verhalten, durchgeführten Prüfungen und verbleibenden Einschränkungen. Konnte ein Test nicht ausgeführt werden, muss das sichtbar bleiben. „Umgesetzt“ und „in der bereitgestellten Anwendung überprüft“ sind unterschiedliche Aussagen und sollten entsprechend genau berichtet werden.

Nutze diese wiederverwendbare Struktur

• Ergebnis: Was Nutzer tun können sollen und warum es wichtig ist.
• Kontext: Relevante Dateien, bisheriges Verhalten, Daten und Projektkonventionen.
• Umfang: Enthaltene Änderungen und ausdrücklich gesetzte Grenzen.
• Abnahme: Normalverhalten, Fehlerbehandlung und zu prüfende Beispiele.
• Übergabe: Prüfbare Änderungen, Testnachweise, Konfigurationsbedarf und Erwartungen an die Bereitstellung.

Bitte bei größeren Aufgaben um eine kleine Folge von Änderungen und prüfe jeden abgeschlossenen Schritt. Bewahre die Versionshistorie und vermeide sachfremde Verbesserungen, solange ein zentrales Verhalten ungeklärt ist. Deine Aufgabe ist, Ergebnis und Belege klar zu halten. Die Arbeit des Agenten wird nützlicher, wenn diese Zusammenarbeit ausdrücklich vereinbart ist.

Lerne mit Innoba weiter

Verbinde diese Übung mit dem Lernangebot Mit KI-Programmieragenten entwickeln. Vertiefe die Grundlagen durch das Buch zum Thema Arbeit mit KI-Programmieragenten und die BUILD Academy. Wähle eine Aufgabe aus deinem eigenen Arbeitsalltag, bewahre deine erarbeiteten Unterlagen auf und nutze die Fragen dieses Artikels, um deine Entscheidungen beim Lernen regelmäßig zu überprüfen.

Verwandte Artikel

• Software mit KI entwickeln, ohne programmieren zu können: Was ist möglich?
• Ein mit KI entwickeltes MVP testen, bevor du es teilst