Checkliste: Seid ihr bereit für KI-Agenten in der Entwicklung?
24 Voraussetzungen zu Git, Tests, Vorschau, Regeldatei, Review und Rechten, zum Abhaken und Kopieren
Inhalt
Bereit für KI-Agenten in der Entwicklung seid ihr, wenn sechs Dinge stehen. Ihr braucht eine Codebasis in Git, die euch gehört, automatische Tests und eine Vorschau für jede Änderung. Dazu kommen eine Regeldatei für die Agenten, eine Freigabe durch Menschen und klar begrenzte Rechte. Fehlt eines davon, arbeitet ein Agent trotzdem. Nur weiß dann niemand sicher, ob sein Ergebnis stimmt.
Die Liste unten hat 24 Punkte in diesen sechs Bereichen. Acht davon sind Pflicht, die übrigen machen den Ablauf schneller und sicherer. Am Ende stehen eine kurze Auswertung und die ganze Liste als Kopiervorlage, etwa für ein Issue oder ein Teamgespräch.
Die Liste stammt aus dem Alltag mit Coding-Agenten an kopfwelt.com und gehört zur Serie über die Agentic Software Factory.
So nutzt ihr die Liste
Geht die Punkte für eine konkrete Codebasis durch, nicht für die ganze Firma. Ein Altsystem ohne Tests und eine neue Anwendung mit Vorschau-Umgebung bekommen sehr unterschiedliche Ergebnisse, und beide Ergebnisse stimmen.
Hakt einen Punkt nur ab, wenn er heute gilt, nicht wenn er geplant ist. Mit (Pflicht) markierte Punkte sollten vor dem ersten Einsatz eines Agenten an echtem Code erfüllt sein. Die anderen könnt ihr nachziehen, während die ersten Aufgaben laufen.
Codebasis und Git
(Pflicht) Der gesamte Code liegt in einem Git-Repository, auf das euer Team Zugriff hat und das euch gehört, nicht nur einem Dienstleister.
(Pflicht) Niemand arbeitet direkt auf dem Hauptzweig. Änderungen kommen über Branches und Pull Requests (oder Merge Requests).
Der Hauptzweig ist durch Schutzregeln gesichert, zum Beispiel mit Pflicht-Review und erfolgreichen Prüfungen vor dem Zusammenführen. Quelle: GitHub, About protected branches.
Ein neues Teammitglied bringt das Projekt mit einer dokumentierten Befehlsfolge lokal zum Laufen, ohne jemanden fragen zu müssen.
Der letzte Punkt klingt nach Komfort. Er ist der beste Test, ob ein Agent das Projekt überhaupt starten kann. Was ein Mensch ohne Nachfrage nicht schafft, schafft ein Agent auch nicht.
Tests und automatische Prüfungen
(Pflicht) Es gibt automatische Tests, die mit einem Befehl laufen und in wenigen Minuten ein Ergebnis liefern.
Linter und Typprüfung laufen ebenfalls mit einem Befehl.
Die Prüfungen laufen bei jedem Pull Request automatisch, nicht nur auf dem Rechner einer Person.
Wichtige Abläufe, etwa Anmeldung, Bestellung oder Formularversand, sind durch Tests im Browser abgedeckt, zum Beispiel mit Playwright.
Ein behobener Fehler bekommt einen Test, der ihn festhält, mit einem Kommentar, welcher Fehler das war.
Tests sind für einen Agenten das, was eine Rückmeldung für einen Menschen ist. Ohne sie hält er eine Aufgabe für erledigt, sobald der Code fehlerfrei kompiliert. Auf kopfwelt.com sichern 122 Testdateien die Arbeit ab, die meisten davon gegen einen bestimmten Fehler, der schon einmal passiert ist. Mehr dazu steht im Fallbericht zu kopfwelt.com.
Vorschau und Auslieferung
(Pflicht) Jede Änderung lässt sich vor der Freigabe ansehen: auf einer eigenen Vorschau-Adresse oder einer Testumgebung. Hostinganbieter wie Vercel legen dafür je Pull Request automatisch eine Vorschau an. Quelle: Vercel, Preview Deployments.
Die Vorschau nutzt Testdaten oder Entwurfsinhalte, keine echten Kundendaten.
Ein Release auf die Live-Umgebung ist ein eigener, bewusster Schritt und lässt sich zurücknehmen.
Ladezeiten und Fehler der Live-Umgebung werden gemessen, damit ihr Verschlechterungen bemerkt.
Regeldatei und Kontext
(Pflicht) Im Repository liegt eine Regeldatei für Agenten, etwa eine
AGENTS.mdoderCLAUDE.md, mit Befehlen, Aufbau und den wichtigsten Regeln.Regeln stehen mit ihrem Grund, wenn möglich mit dem Vorfall, aus dem sie entstanden sind.
Die Regeldatei wird im selben Pull Request angepasst wie der Code, den sie beschreibt.
Aufgaben werden mit Ziel, Akzeptanzkriterien und Prüfweg beschrieben, nicht nur mit einem Satz.
Wie eine solche Datei aufgebaut ist, mit Vorlage, erklärt der Artikel zu Context Engineering und AGENTS.md. Wie man Aufgaben prüfbar beschreibt, steht im Artikel zu Spec-driven Development.
Review und Freigabe
(Pflicht) Jede Änderung eines Agenten wird von einem Menschen geprüft, bevor sie in den Hauptzweig kommt.
Es ist festgelegt, wer prüft und freigibt, auch bei Urlaub und Krankheit.
Die Beschreibung eines Pull Requests nennt Befund, Änderung und wie geprüft wurde, damit die Prüfung nicht beim Lesen des Codes anfängt.
Wie viel ein Agent allein darf und wo ein Mensch entscheiden muss, behandelt der Artikel zu Human in the Loop ausführlicher.
Rechte und Sicherheit
(Pflicht) Agenten haben keinen Zugriff auf Zugangsdaten der Live-Umgebung. Geheimnisse liegen in Umgebungsvariablen oder einem Tresor, nie im Code.
(Pflicht) Was ein Agent ausführen darf, ist technisch eingeschränkt, nicht nur in der Regeldatei beschrieben. Claude Code etwa erlaubt, Befehle und Werkzeuge über Rechte-Einstellungen zu erlauben oder zu sperren. Quelle: Anthropic, Permissions.
Erweiterungen wie Skills oder MCP-Server werden vor dem Einsatz geprüft. Wie das geht, beschreibt der Artikel Agent Skills prüfen, was ein MCP-Server ist, der Artikel zu MCP-Servern.
Es ist geklärt, welche Daten an den Anbieter des Sprachmodells gehen dürfen. Für personenbezogene Daten gilt dasselbe wie bei jedem anderen Dienst, siehe KI und DSGVO.
Auswertung
Zählt die erfüllten Pflichtpunkte und die erfüllten übrigen Punkte getrennt.
Ergebnis | Was es bedeutet |
|---|---|
Alle 8 Pflichtpunkte und mindestens 10 der übrigen 16 | Ihr könnt Agenten an echten Aufgaben arbeiten lassen. Beginnt mit kleinen, gut prüfbaren Aufgaben und weitet aus, wenn die Freigaben reibungslos laufen. |
Alle 8 Pflichtpunkte, weniger als 10 der übrigen | Ein Einstieg ist möglich, aber jede Prüfung kostet mehr Zeit. Zieht zuerst Tests im Browser, Schutzregeln und Vorschau nach. |
5 bis 7 Pflichtpunkte | Fangt mit den fehlenden Pflichtpunkten an. Ein Agent kann dabei schon helfen, etwa beim Schreiben von Tests oder der Regeldatei, unter enger Aufsicht. |
Weniger als 5 Pflichtpunkte | Die Grundlage fehlt. Bevor Agenten Code ändern, braucht die Codebasis Versionierung, Tests und einen Prüfweg. Das lohnt sich auch ohne KI. |
Die Schwellen sind eine Faustregel, kein Prüfsiegel. Ein Team mit erfahrenen Prüfern kommt mit weniger Automatik aus, ein Team, in dem eine Person alles freigibt, braucht mehr.
Die Liste zum Kopieren
## Codebasis und Git
- [ ] (Pflicht) Code in einem Git-Repository, das uns gehört
- [ ] (Pflicht) Änderungen nur über Branches und Pull Requests
- [ ] Hauptzweig mit Schutzregeln (Review, Prüfungen)
- [ ] Projekt startet lokal mit dokumentierter Befehlsfolge
## Tests und automatische Prüfungen
- [ ] (Pflicht) Automatische Tests mit einem Befehl, Ergebnis in Minuten
- [ ] Linter und Typprüfung mit einem Befehl
- [ ] Prüfungen laufen bei jedem Pull Request automatisch
- [ ] Wichtige Abläufe durch Browsertests abgedeckt
- [ ] Behobene Fehler bekommen einen Test mit Kommentar
## Vorschau und Auslieferung
- [ ] (Pflicht) Vorschau oder Testumgebung für jede Änderung
- [ ] Vorschau ohne echte Kundendaten
- [ ] Release ist ein eigener Schritt und lässt sich zurücknehmen
- [ ] Ladezeiten und Fehler der Live-Umgebung werden gemessen
## Regeldatei und Kontext
- [ ] (Pflicht) AGENTS.md oder CLAUDE.md im Repository
- [ ] Regeln stehen mit ihrem Grund
- [ ] Regeldatei wird im selben Pull Request gepflegt
- [ ] Aufgaben mit Ziel, Akzeptanzkriterien und Prüfweg
## Review und Freigabe
- [ ] (Pflicht) Jede Agenten-Änderung wird von einem Menschen geprüft
- [ ] Zuständigkeit für Prüfung und Freigabe ist geregelt
- [ ] Pull Requests nennen Befund, Änderung und Prüfung
## Rechte und Sicherheit
- [ ] (Pflicht) Kein Agentenzugriff auf Zugangsdaten der Live-Umgebung
- [ ] (Pflicht) Rechte des Agenten technisch eingeschränkt
- [ ] Skills und MCP-Server vor dem Einsatz geprüft
- [ ] Geklärt, welche Daten an den Modellanbieter gehen
Auswertung: __ von 8 Pflichtpunkten, __ von 16 weiteren PunktenWie es weitergeht
Regeldatei und Vorschau je Änderung lassen sich in einer bestehenden Codebasis oft ohne Umbau ergänzen. Tests für ein gewachsenes System brauchen länger, sind aber die Voraussetzung dafür, dass die Prüfung nicht an einem Menschen hängen bleibt.
Wer die Lücken nicht allein schließen will: Wir richten diesen Ablauf mit euch ein, von der Regeldatei über Tests und Vorschau bis zur Freigabe. Was dazugehört, steht auf der Seite zu KI-gestützter Softwareentwicklung.
Häufige Fragen zur Checkliste
Können wir KI-Agenten auch ohne automatische Tests einsetzen?
Können wir KI-Agenten auch ohne automatische Tests einsetzen?
Ja, aber dann prüft ein Mensch jede Änderung vollständig von Hand. Das hebt einen großen Teil der Zeitersparnis wieder auf und übersieht leichter Fehler an Stellen, die niemand angesehen hat. Ein guter erster Auftrag für einen Agenten ist deshalb oft, Tests für die wichtigsten Abläufe zu schreiben.
Warum ist die Vorschau ein Pflichtpunkt?
Warum ist die Vorschau ein Pflichtpunkt?
Weil viele Fehler erst im Browser sichtbar werden: Darstellung, Ladezeit, ein Formular, das nicht abschickt. Eine Vorschau je Änderung lässt einen Menschen genau den Stand prüfen, der live gehen soll, ohne die Live-Umgebung zu berühren.
Reicht eine Regeldatei, um einen Agenten zu begrenzen?
Reicht eine Regeldatei, um einen Agenten zu begrenzen?
Nein. Eine Regeldatei ist Kontext, an den sich der Agent meistens hält. Was auf keinen Fall passieren darf, etwa ein Zugriff auf Zugangsdaten oder ein direktes Release, muss technisch verhindert werden: über Rechte-Einstellungen, Schutzregeln im Repository oder getrennte Zugänge.
Gilt die Checkliste auch für Altsysteme?
Gilt die Checkliste auch für Altsysteme?
Ja. Bei Altsystemen fehlen meist Tests und eine Vorschau-Umgebung. Dann lohnt es sich, diese Grundlage zuerst zu schaffen, auch mit Hilfe eines Agenten, aber unter enger Aufsicht. Danach gelten dieselben Punkte wie für neue Anwendungen.
Wie lange dauert es, die Pflichtpunkte zu erfüllen?
Wie lange dauert es, die Pflichtpunkte zu erfüllen?
Das hängt vom Ausgangsstand ab und lässt sich ohne Blick auf die Codebasis nicht seriös sagen. Git, Pull Requests und eine Regeldatei sind oft schnell eingerichtet. Tests und eine Vorschau-Umgebung für ein gewachsenes System brauchen mehr Zeit.
Quellen
GitHub: About protected branches, Dokumentation, Abruf 22.11.2026.
Vercel: Preview Deployments, Dokumentation, Abruf 22.11.2026.
Anthropic: Permissions, Dokumentation zu Claude Code, Abruf 22.11.2026.
AGENTS.md, Projektseite des Formats, Abruf 22.11.2026.
Playwright: Installation, Dokumentation, Abruf 22.11.2026.