Von Michael Backs · Veröffentlicht am
Agentische Softwareentwicklung mit KI
Das Problem
Wenn man mit modernen KI-Tools in der Entwicklung arbeitet, fehlt bei jedem neuen Chat-Fenster der Kontext. Das bedeutet, dass die KI bei jeder Aufgabe wieder die Struktur des Projektes in Erfahrung bringen muss. Die Ergebnisse sind meist ok-ish, aber nicht wirklich gut. Es hilft, mittels einer Beschreibung des Projektes von Anfang an immer den richtigen Kontext zu haben. Dies hilft dabei, gute Ergebnisse zu bekommen, da die Beschreibung des Projekts initial genutzt wird, um das Projekt zu verstehen.
How
Neues Projekt
Sofern ein neues Projekt anliegt, macht es Sinn, am Anfang ein Software Design Document zu erstellen. Hierbei beauftragt man das Modell der Wahl, solch ein Dokument zu erstellen.
Prompt Beispiel:
"Du bist ein erfahrener Softwareentwickler. Du erhältst im Folgenden die Projektbeschreibung und sollst alle Antworten so geben, als wärst du Teil des Entwicklerteams. Bitte stelle Rückfragen, wenn dir Kontext fehlt, und liefere strukturierte, nachvollziehbare Lösungen. Projektbeschreibung: -- die Projektbeschreibung --"
Dieser erste Entwurf sollte grob gereviewed werden und dann anschließend noch einmal durch ein anderes Modell validiert werden. Das jeweilige Feedback wird wieder eingearbeitet. Dieses “Ping-Pong” sollte man ein paar Mal wiederholen, bis ein hoher Reifegrad erreicht ist. Google Gemini eignet sich gut durch das hohe Kontext-Fenster.
Nachdem dieses SDD (Software Design Document) erstellt ist, beauftragt man die agentische KI (z.B. Cursor, Claude Code, Windsurf), diese Spezifikation umzusetzen.
Prompt Beispiel:
"Implementiere die Spezifikation des Software Design Documents und führe die Aufgaben nacheinander aus. Hole dir bei Unklarheiten das Feedback vom Nutzer."
Bestehendes Projekt
Bei größeren Codebasen ist es für das LLM noch schwieriger, das Richtige zu tun. Daher empfehle ich, vor dem ersten agentischen Auftrag an das LLM eine Beschreibung des Projektes vornehmen zu lassen. Dazu gehören Informationen wie Befehle zum Kompilieren, Testausführung, welche Tools genutzt werden sollen (z.B. Playwright MCP bei Webapplikationen). Bei sehr großen Projekten ist es sinnvoll, eine Zusammenfassung auf Ordnerebene zu erstellen, dadurch ist es sehr transparent, wo was in der Projektstruktur liegt.
QS
Um eine Sicherung der Qualität zu gewährleisten, ist es sinnvoll, in der Spezifikation auf die vereinbarten Aspekte des Entwicklungsprojekts einzugehen. Hier bringen solche Instruktionen einen Mehrwert.
Checkliste vor Commit
- Code entspricht Projekt-Konventionen
- Tests sind vorhanden und grün
- Performance-Impact überprüft
- Security-Aspekte bedacht
- Dokumentation aktualisiert