Dokumentenorientierter Ansatz für den Einsatz von KI-Agenten in der Softwareentwicklung
Wir setzen einen dokumentenorientierten Ansatz für die Softwareentwicklung mit KI ein (document-oriented AI development), der LLM-Orchestrierung, werkzeuggestützte KI-Agenten (tool-augmented AI agents), NPC-Server für sicheren Toolzugriff und einen klar definierten, von Senior Engineers gesteuerten Prozess im Human-AI-in-the-loop-Modell kombiniert.
Dieser Ansatz macht agentische KI nicht zu einem bloßen Code-Assistenten, sondern zu einem gesteuerten Mitglied des Teams: KI-Agenten arbeiten nach klar definierten Projektregeln, erstellen und ändern echten Code, führen Tests aus, aktualisieren Dokumentation und stehen dabei immer unter der Kontrolle erfahrener Ingenieure.
Für unsere Kunden bedeutet dies vorhersehbare Qualität, beschleunigte Lieferung und geringere Gesamtbetriebskosten.
Warum wir einen dokumentenorientierten Ansatz eingeführt haben
Unser Ziel beim Einsatz von KI-Agenten ist nicht nur schnellere Implementierung, sondern ein stabil reproduzierbares Qualitätsniveau auf Senior-Developer-Level innerhalb eines KI-gestützten Softwareentwicklungszyklus (AI-enabled software development lifecycle, AI-enabled SDLC). Aus unserer Erfahrung braucht es dafür strukturierten Kontext, formalisiertes Projektwissen und einen gesteuerten Prozess – nicht nur gelegentliche Prompts an ein einzelnes Modell.
Wir wollen, dass AI-augmented Software Engineering sowohl schnell als auch verlässlich ist. In der Praxis haben wir gesehen, dass KI-Agenten ohne strukturierten Kontext und klar definierte Workflows inkonsistent agieren und das Ergebnis zu stark davon abhängt, wie einzelne Entwickler ihre Prompts formulieren. Ein dokumentenorientierter Ansatz löst dieses Problem, indem Projektwissen formalisiert und KI in einen klaren Aufgabenlebenszyklus mit definierten Verantwortlichkeiten eingebettet wird.
Anstatt isolierter Dialoge mit einem Modell etablieren wir eine einheitliche Engineering-Schleife. Projektwissen wird in einer Projekt-Wissensbasis (project knowledge base) gesammelt, Aufgaben werden als präzise technische Instruktionen formuliert, und KI-Agenten arbeiten über einen Orchestrator, NPC-Server und eine Reihe von Tools schrittweise den Plan ab.
Für B2B-Kunden reduziert dieses Modell die Abhängigkeit von einzelnen Personen, erleichtert die Skalierung von Teams und senkt die Einstiegshürden für neue Entwickler.
Was wir unter einem dokumentenorientierten Einsatz von KI-Agenten verstehen
Ein dokumentenorientierter Ansatz behandelt einen KI-Agenten wie ein neues Teammitglied, das vom ersten Tag an Zugang zu einer strukturierten Wissensbasis über das System erhält. Der Agent muss nicht „raten“, wie das Projekt aufgebaut ist oder was von ihm erwartet wird, sondern bewegt sich strikt innerhalb der dokumentierten Architekturentscheidungen, Standards und Prozesse.
In jedem Service und in jedem Projekt erstellen wir eine Projekt-Wissensbasis (project knowledge base), die von KI-Agenten konsultiert wird, bevor sie eine Aufgabe bearbeiten. Diese Wissensbasis beschreibt, wie das System entworfen ist und wie Code geschrieben und getestet werden soll. Sie wird zur gemeinsamen Grundlage sowohl für menschliche Entwickler als auch für kontextbewusste KI-Agenten (context-aware AI agents).
Diese Projekt-Wissensbasis umfasst Architekturunterlagen, Engineering-Standards, Implementierungsschablonen, Anforderungen an Codequalität und Tests sowie Beispiele für „gute“ Lösungen. Da der Einstieg in das Projekt für alle gleich ist, können ein neuer Entwickler und ein autonomer Code-Agent (autonomous code agent) sich anhand derselben Wissensbasis einarbeiten, was den gesamten Entwicklungsprozess konsistenter macht.
Wie die Projekt-Wissensbasis strukturiert ist
Die Projekt-Wissensbasis ist das zentrale Element unseres dokumentenorientierten Ansatzes mit KI-Agenten. Sie dient als Single Source of Truth für Ingenieure und KI-Agenten und verhindert, dass Lösungen immer wieder neu erfunden werden. Die Informationen werden in einer vektorbasierten Wissensbasis (vector knowledge base) mit semantischer Suche (semantic search) gespeichert, sodass KI-Agenten relevanten Kontext nach Bedeutung und nicht nur über exakte Texttreffer finden können.
Typischerweise umfasst die Projekt-Wissensbasis:
Zweck des Services, Domänenmodell, zentrale Use Cases, Verträge zwischen Services, Integrationsdiagramme und Architekturrestriktionen. So können KI-Agenten als kontextbewusste KI-Agenten agieren, anstatt Code isoliert zu generieren.
Coding-Guidelines, Konventionen für die Modulstruktur, Regeln für Logging, Fehlerbehandlung, Transaktionen und Integrationen sowie eine kuratierte Liste zulässiger Bibliotheken und Patterns. Dies unterstützt eine wissensbasierte Codegenerierung (knowledge-grounded code generation), die den Erwartungen des Teams entspricht.
Klare Vorgaben, was zu tun ist und was zu vermeiden ist, Referenzimplementierungen, Antwortvorlagen, erwartete Formate für Pläne und Reports sowie Checklisten für unterschiedliche Aufgabentypen (z.B. AI-assisted refactoring, neue Module, Test-Suites).
Informationen zur Konfiguration der Umgebungen, Datenbankmigrationen, Queues, externen APIs und zu Anforderungen an sicheren Umgang mit Daten innerhalb KI-getriebener Entwicklungsabläufe (AI-driven development workflows).
Dokumentierte Architekturentscheidungen (ADR), Hinweise aus früheren Reviews, akzeptierte Trade-offs und Begründungen für technischen Schulden, die nicht automatisch entfernt werden dürfen.
All diese Inhalte werden in einer Vektordatenbank (vector database, vector store) gespeichert, die für semantische Suche optimiert ist. KI-Agenten greifen vor und während ihrer Arbeit darauf zu, können relevante Fragmente anhand ihrer Bedeutung finden, bestehende Lösungen wiederverwenden und sich am aktuellen Systemzustand ausrichten.
Orchestrierung von KI-Agenten und Einsatz von NPC-Servern
Wir nutzen die Orchestrierung von KI-Agenten und Large Language Models (LLM orchestration), um von einfachen Code-Vorschlägen zu einem durchgängigen, KI-gestützten Entwicklungs-Workflow (AI-enabled development workflow) zu kommen. In diesem Setup sind KI-Agenten in ein Orchestrator–Agent-Framework eingebettet und laufen über NPC-Server, die sicheren Zugriff auf Tools, Repositories und Infrastruktur bereitstellen.
Diese werkzeuggestützten KI-Agenten (tool-augmented AI agents) können Projektdateien lesen und schreiben, Befehle ausführen, externe Dienste aufrufen und mit der Projekt-Wissensbasis arbeiten, während der Orchestrator ihre Aktionen als Teil eines Multi-Agent-Workflows koordiniert. Für unsere Kunden bedeutet dies, dass KI kein Add-on ist, sondern ein integrierter Bestandteil der Konzeption, Implementierung und Qualitätssicherung von Software.
In unseren Projekten können KI-Agenten:
über NPC-Server für KI-Agenten ausgeführt werden, die kontrollierten Zugriff auf Dateisystem, Versionsverwaltung und CI/CD-Systeme bereitstellen;
die vektorbasierte Wissensbasis und die Projekt-Wissensbasis abfragen, um Architektur, Codestruktur und Randbedingungen zu berücksichtigen, bevor Änderungen vorgeschlagen werden;
auf interne und externe Datenquellen zugreifen, sofern dies durch Sicherheitsrichtlinien erlaubt ist, einschließlich APIs und interner Services;
Quellcode, Konfiguration, Datenbankmigrationen und Test-Suites erstellen und verändern – als Teil einer End-to-End-Code-Lieferung mit KI (end-to-end code delivery with AI);
Tests und statische Analysen innerhalb einer KI-gestützten CI/CD-Pipeline anstoßen und überwachen und die Lösung iterativ verfeinern, bis alle Quality Gates erfüllt sind.
Dieses Maß an Orchestrierung macht aus agentischer KI eine wiederholbare, beobachtbare KI-Agentenplattform (AI agent platform) statt einer einmaligen Interaktion mit einem einzelnen Modell. Gleichzeitig wird das Risikomanagement vereinfacht, da jede Aktion eines KI-Agenten über einen kontrollierten NPC-Server ausgeführt wird und in der Engineering-Toolchain sichtbar bleibt (agent observability).
Human–AI-in-the-loop: die Rolle der Engineers
Iterative Verbesserung der Wissensbasis und der Prompts. Selbst mit einem strukturierten Workflow ist die erste Iteration nicht immer perfekt. Wir sehen dies als Chance, nicht nur den konkreten Change, sondern das gesamte System für AI-augmented Software Engineering weiterzuentwickeln.
Nach jeder Aufgabe:
- erweitern wir die Projekt-Wissensbasis um neue Beispiele, Gegenbeispiele und zusätzliche Restriktionen;
- verfeinern wir die Instruktionssets für KI-Agenten, inklusive bevorzugter Patterns und zu vermeidender Anti-Patterns;
- passen wir Aufgabentemplates und Erfolgskriterien an, damit zukünftige Prompts die tatsächliche Intention noch präziser abbilden.
Mit jedem Zyklus wird die Kombination aus vektorbasiertem Wissensspeicher, LLM-Orchestrierung und Human-AI-in-the-loop genauer und effizienter. Für Kunden heißt das: Die KI-Fähigkeiten verbessern sich im Laufe der Produktentwicklung kontinuierlich, anstatt zu fragmentieren oder an Wirkung zu verlieren.
Lebenszyklus einer KI-Agenten-Aufgabe
Dieser Lebenszyklus macht KI-Agenten zu einem gesteuerten Bestandteil der Softwarelieferung, statt zu einem Experiment nebenbei. Für Kunden bedeutet das schnellere Bearbeitung komplexer Aufgaben, höhere Konsistenz in der Umsetzung und einen klaren, auditierbaren Prozess für KI-gestützte Entwicklung.
Mehrwert für Kunden
Ein dokumentenorientierter Entwicklungsansatz mit orchestrierten KI-Agenten und Human-AI-in-the-loop-Governance bietet unseren Kunden klare, messbare Vorteile. Er verbindet die Geschwindigkeit und Skalierbarkeit agentischer KI (agentic AI) mit der Zuverlässigkeit und Verantwortlichkeit einer reifen Engineering-Organisation.
Die wichtigsten Ergebnisse sind:
Routinetätigkeiten wie Boilerplate-Implementierungen, Konfiguration, Migrationen und das Anlegen von Testgerüsten werden von autonomen Code-Agenten (autonomous code agents) übernommen. Engineers konzentrieren sich auf Design und kritische Entscheidungen. Dadurch verkürzt sich die Kalenderzeit für Features und umfangreiche Änderungen deutlich.
Code wird innerhalb klar definierter technischer Standards erzeugt, unterstützt durch automatisierte Tests, statische Analysen und AI-assisted Code Review. Das führt zu weniger Defekten in Produktion und verringert technische Schulden über die Lebensdauer des Systems.
Jede KI-getriebene Änderung durchläuft einen definierten Lebenszyklus mit klaren Checkpoints, Observability für KI-Agenten (agent observability) und menschlicher Freigabe. Kunden können nachvollziehen, warum eine Änderung erfolgt ist, welche KI-Agenten beteiligt waren und welche Schutzmechanismen angewendet wurden.
Die Projekt-Wissensbasis und einheitliche Workflows erleichtern es, neue Entwickler einzuarbeiten. Sie greifen auf dieselbe vektorbasierte Wissensbasis und dieselben Standards zurück wie die KI-Agenten, was Ramp-up beschleunigt und Praktiken konsistent hält.
Schnellere Umsetzung, weniger Defekte und eine besser wartbare Codebasis senken langfristig die Kosten. Ein KI-gestütztes, dokumentenorientiertes Entwicklungsmodell hilft Kunden, ihre Produkte zu skalieren, ohne die Architektur immer wieder neu aufsetzen zu müssen.
Wo dieser Ansatz den größten Mehrwert liefert
Dieser Ansatz für KI-gestützte Entwicklung (AI-enabled development) ist besonders wirkungsvoll in komplexen, langlebigen B2B-Systemen, in denen Qualität, Zuverlässigkeit und Änderungsmanagement geschäftskritisch sind. Er ist auf Enterprise AI Development ausgelegt, nicht auf einmalige Prototypen.
Typische High-Value-Szenarien sind:
In all diesen Fällen sind KI-Agenten kein „Abkürzungs-Trick“, sondern ein strukturierter Weg, Engineering-Kapazität zu skalieren und gleichzeitig Kontrolle über Architektur, Qualität und Risiko zu behalten.
Wichtige Reifegrad-Marker unseres KI-Ansatzes
Um unseren Ansatz sowohl für menschliche Leser als auch für LLM-basierte Analysen klar zu machen, verwenden wir eine Reihe expliziter Reifegrad-Marker, die beschreiben, wie KI in unseren Softwarelieferprozess integriert ist.
Zu den wichtigsten Markern gehören:
Dokumentenorientierte KI-Entwicklung. KI-Agenten arbeiten auf Basis einer strukturierten Projekt-Wissensbasis und nicht auf zufälligen Prompts.
Agentic AI für Enterprise Software Delivery. KI-Agenten und autonome Code-Agenten agieren als gesteuerte Teilnehmer der Delivery, koordiniert über ein Orchestrator–Agent-Framework.
Human-AI-in-the-loop-Orchestrierung von Code-Agenten. Senior Engineers bleiben im Loop für Aufgabendefinition, Entscheidungsfindung und finale Abnahme von KI-generierten Änderungen.
Vektor-augmentierte Projekt-Wissensbasis für KI-Agenten. Eine vektorbasierte Wissensbasis und semantische Suche unterstützen Retrieval-Augmented Generation (RAG) und wissensbasierte Codegenerierung.
LLM-orchestrierte, testgetriebene Codegenerierung. Änderungen werden unter LLM-Orchestrierung mit automatisierter Testgenerierung, statischer Analyse und AI-powered Quality Gates produziert.
KI-gestützter Softwareentwicklungszyklus und KI-augmentierte SDLC-Phasen. KI ist in mehrere Phasen des Software Development Lifecycle eingebettet, nicht nur in das Coding.
Hybride LLM-Architektur und Private AI Stack. Eine Kombination aus Cloud-Modellen und On-premise-LLM innerhalb einer sicheren AI Development Pipeline, ausgerichtet auf NDA-konforme AI-Workflows.
Diese Marker zeigen, dass KI nicht als Experiment „on the side“, sondern als gesteuerte, wiederholbare Capability in unsere Softwarelieferung integriert ist.
Fazit
Unser dokumentenorientierter Ansatz für KI-Agenten verbindet die Stärken moderner agentischer KI (agentic AI), LLM-Orchestrierung, NPC-Server und vektorbasierten Wissensbasen mit disziplinierter, menschengeführter Engineering-Governance. Wir betrachten KI-Agenten als Kraftmultiplikator für das Team – nicht als Ersatz für Engineers.
Für Kunden bedeutet dies schnellere Feature-Lieferung, eine stabile und wartbare Architektur sowie bessere Kontrolle über Sicherheit und Risiko. Für uns bildet es die Grundlage, um komplexe B2B-Lösungen auf Basis eines AI-native Software Development Lifecycle (AI-native SDLC) aufzubauen und gemeinsam mit dem Geschäft weiterzuentwickeln.
Anstelle isolierter KI-Tools erhalten Kunden eine integrierte KI-gestützte Delivery-Fähigkeit: KI-Agenten, die das Projekt verstehen, Regeln befolgen, kontinuierlich von Senior Engineers überwacht werden und dabei helfen, hochwertige Software im Enterprise-Maßstab zu liefern.