Arton Avdula

Entwickeln mit KI-Agenten, mit Regeln statt Zuruf

Wie aus einzelnen Agenten-Sitzungen ein verlässlicher Entwicklungsprozess wird.

Arbeitsweise

Wie ich mit KI-Agenten entwickle

Entwickelt wird überwiegend mit Claude Code. Damit das bei dieser Größe verlässlich bleibt, steckt die Disziplin im Repository und nicht im Kopf.

190 Notizen im Projektgedächtnis des FPMS
10 Punkte auf der Prüfliste vor jedem Ausrollen
2 feste Prüfrollen: IT Security und Qualitätsmanager
Projektgedächtnis

Die Notizen halten fest, was aus dem Code allein nicht ablesbar ist: Fallen im Regelwerk, Eigenheiten der Datenquellen, getroffene Entscheidungen. Jede Sitzung liest zuerst das Inhaltsverzeichnis.

Feste Regeln

Schemaänderungen nur als Migration mit Drift-Prüfung. Typprüfung und Build vor jedem Ausrollen. Vor jedem Push wird der aktuelle Stand geholt und erneut geprüft.

Nachweise statt Behauptungen

Prüfskripte laufen gegen den laufenden Server und prüfen in beide Richtungen: Sieht jemand, was er sehen soll, und sieht er nicht, was er nicht sehen darf?

Rollen für Agenten

Die beiden Prüfrollen gehen freitags lesend durch alle Anwendungen und liefern Befunde. Beheben dürfen sie nichts.

Betriebsmodell

Mehrere Agenten-Sitzungen arbeiten wie ein Team

Neun Projekt-Sitzungen bauen an zwölf Anwendungen und einer Datenpipeline. Was gilt, steht in Dateien und nicht im Gedächtnis eines Chats.

1 Entscheiden ein Mensch: was gebaut wird und was live geht
2 Führen eine Hauptsitzung verteilt und bündelt
3 Bauen Projekt-Sitzungen entwickeln und rollen aus
4 Prüfen Nachschau und Rundgang am Freitag
5 Berichten jeden Morgen ein Blatt
Wer was darf

Zugangsdaten und Löschen bleiben beim Menschen. Projektübergreifend spricht jede Sitzung nur mit der Hauptsitzung. Die Projekt-Sitzungen rollen selbst aus, sobald Build und Prüfliste grün sind.

Schnittstellenbuch

Jeder Vertrag zwischen zwei Anwendungen steht an einer Stelle: Routen, Token-Ansprüche, Nutzlasten und welche Anwendung für welche Angabe die Quelle ist. Wer einen Vertrag ändert, meldet es im selben Zug. Ins Buch schreibt nur die Hauptsitzung.

Prüfliste vor jedem Ausrollen

Zehn Punkte, darunter: Wird das Übergabe-Token vollständig geprüft? Prüft jede Route Sitzung und Rechte? Stehen keine Geheimnisse im Code und keine Personendaten in den Logs?

Chronik und Patch-Notes

Vertragsänderungen und Auslieferungen werden festgehalten. So bleibt nachvollziehbar, wann sich was geändert hat.

Feedback-Schleife

Vom Feedback zum Commit, mit menschlicher Freigabe

Zwischen „jemand hat es gelesen“ und „das wird gebaut“ liegt eine Entscheidung, und die trifft die verantwortliche Person.

1 Feedback Knopf in jeder Anwendung, mit Screenshot
2 Postfach im Mosaik Ein Postfach für alle Anwendungen
3 Freigabe Nur die verantwortliche Person gibt frei, der Agent kann das nicht
4 Umsetzung Eine Agenten-Sitzung holt die Arbeitsliste und setzt um
5 Rückmeldung Commit und Antwort gehen an den Absender
Wenn ein Eintrag unklar ist

Die Sitzung stellt eine Rückfrage an den Absender, statt die Aussage umzuformulieren. Bis zur Antwort bleibt der Eintrag liegen.

Weiter Überblick Zurück zum Einstieg mit allen Anwendungen, dem ennoo-Kreis und der Wirkung.