KI-Coding-Agenten brauchen Leitplanken, bevor sie Produktionsnähe bekommen
Claude Code, Cursor und MCP-Tools werden mächtiger. Für seriöse Produktteams wird die entscheidende Frage deshalb nicht Tempo, sondern Kontrolle.
Kyluke McDougall
Software-Architekt & Gründer
Inhaltsverzeichnis
- Warum sich die Diskussion gerade verschiebt
- Der falsche Reflex: entweder blockieren oder blind freigeben
- Agenten sollten wie neue Teammitglieder behandelt werden
- Welche Leitplanken wirklich zählen
- 1. Repository-Grenzen
- 2. Secrets und Umgebungen
- 3. Dependency- und Extension-Policy
- 4. Architekturregeln, die der Agent wirklich kennt
- 5. Review-Gates für risikoreiche Änderungen
- 6. Beobachtbarkeit und Betrieb
- 7. Klare Eigentümerschaft
- Was das für Gründer und Produktteams bedeutet
- Was das für den Mittelstand bedeutet
- Ein pragmatisches Einführungsmodell
- Wo McDougall Digital helfen kann
- Die Kernbotschaft
- Nächster Schritt
KI-Coding-Agenten verlassen gerade die Spielzeugphase.
Claude Code, Cursor, Codex, Devin, Replit Agent und ähnliche Werkzeuge sind nicht mehr nur bessere Autocomplete-Systeme. Sie lesen Repositories, schreiben Dateien, starten Tests, schlagen Dependencies vor, integrieren MCP-Server, greifen auf Dokumentation zu und können sich immer tiefer in Entwicklungs- und Betriebsabläufe einhängen.
Das ist produktiv.
Aber es verändert auch die Risikoklasse.
Auf X wurde in den letzten Tagen genau darüber diskutiert: Agent-native Entwicklungsprozesse, Claude-Code-Sicherheit, Sandbox-Grenzen, MCP-Zugriff auf Tools wie Logs und Metriken, Supply-Chain-Risiken und die Frage, wie Teams Agenten dazu bringen, die eigene Architektur wirklich zu respektieren.
Die wichtige Botschaft für Gründer, CTOs, Product Owner und Mittelstandsteams ist nicht: KI ist gefährlich.
Die wichtige Botschaft ist:
Ein KI-Coding-Agent ist kein Textfeld mehr. Er ist ein technischer Akteur mit Zugriff.
Und Zugriff braucht Leitplanken.
Warum sich die Diskussion gerade verschiebt
Viele Teams haben KI zuerst als Schreib- oder Ideentool kennengelernt.
Man kopiert eine Fehlermeldung in ChatGPT. Man bittet Cursor um eine Komponente. Man lässt Claude Code einen Test schreiben. Man erzeugt einen Prototypen für eine Demo.
In diesem Modus ist der Schaden meist begrenzt. Ein Mensch kopiert Code, prüft ihn grob, commitet später selbst und entscheidet, was ins System kommt.
Der neue Modus ist anders.
Agenten können über längere Zeit an Aufgaben arbeiten. Sie können mehrere Dateien verändern. Sie können Kommandos ausführen. Sie können externe Tools über MCP anbinden. Sie können Logs, Tickets, Metriken, APIs oder Dokumente lesen. Sie können Dependencies installieren oder Konfigurationen anpassen.
Damit werden sie nützlicher.
Aber sie bewegen sich näher an den Stellen, an denen echte Software kaputtgehen kann:
- Repository-Struktur;
- Build- und Deployment-Prozesse;
- Secrets und Umgebungsvariablen;
- Dependencies und Extensions;
- Kundendaten;
- Produktionslogs;
- interne APIs;
- Architekturentscheidungen.
Das ist der Punkt, an dem aus “Wir nutzen KI im Team” eine ernsthafte Engineering-Frage wird.
Der falsche Reflex: entweder blockieren oder blind freigeben
Viele Unternehmen reagieren auf neue technische Werkzeuge mit einem von zwei Extremen.
Die eine Seite blockiert alles.
Keine Agenten. Kein Zugriff. Keine Experimente. Keine Integration in echte Workflows.
Das ist verständlich, aber oft nicht haltbar. Gute Entwickler werden diese Werkzeuge verwenden wollen. Produktteams werden die Geschwindigkeit sehen. Wettbewerber werden schneller lernen. Ein pauschales Nein verschiebt die Nutzung häufig nur in inoffizielle Kanäle, wo sie schlechter kontrollierbar ist.
Die andere Seite gibt zu schnell zu viel frei.
Der Agent bekommt das gesamte Repository, alle Dateien, Terminalzugriff, Package-Installationen, Tokens, lokale Secrets und vielleicht noch Zugriff auf Produktivsysteme. Am Anfang spart das Zeit. Später fragt niemand mehr genau, welche Grenze eigentlich gilt.
Beides ist schwach.
Der bessere Weg ist Architektur.
Nicht Architektur als großes Diagramm für die Schublade, sondern Architektur als klare Entscheidung darüber, welche Verantwortung ein System tragen darf.
Genau das gilt jetzt auch für KI-Coding-Agenten.
Agenten sollten wie neue Teammitglieder behandelt werden
Ein neuer Entwickler bekommt in einem seriösen Team nicht sofort alle Rechte.
Er bekommt Kontext. Er bekommt Aufgaben. Er bekommt Zugriff auf die Bereiche, die er braucht. Er arbeitet über Branches, Reviews, Tests und Deployment-Prozesse. Er lernt die Konventionen des Teams. Wenn er an sicherheitskritischen Stellen arbeitet, schauen erfahrene Personen genauer hin.
Ein KI-Coding-Agent sollte ähnlich betrachtet werden.
Nicht, weil er eine Person ist.
Sondern weil er Handlungen in einem technischen System ausführt.
Die richtige Frage lautet deshalb nicht:
Kann der Agent das?
Die bessere Frage lautet:
Was darf der Agent tun, ohne dass ein Fehler teuer wird?
Das führt zu einem viel besseren Betriebsmodell.
Welche Leitplanken wirklich zählen
Leitplanken müssen nicht bürokratisch sein. Sie müssen konkret sein.
Für produktnahe Entwicklung sind vor allem sieben Bereiche wichtig.
1. Repository-Grenzen
Nicht jede Aufgabe braucht Zugriff auf alles.
Ein Agent, der eine isolierte UI-Komponente refaktoriert, muss nicht dieselben Rechte haben wie ein Agent, der Authentifizierung oder Billing ändert. Ein Agent, der Tests ergänzt, braucht nicht automatisch Zugriff auf produktive Konfigurationen.
Praktisch heißt das:
- Aufgaben klein schneiden;
- Arbeitsverzeichnisse begrenzen;
- sensible Pfade ausklammern;
- Änderungen über Branches oder Pull Requests führen;
- große, unklare Agentenläufe vermeiden.
Das klingt simpel. Es ist aber oft der Unterschied zwischen kontrollierter Beschleunigung und chaotischem Codewachstum.
2. Secrets und Umgebungen
Ein Agent sollte nicht frei mit Secrets umgehen.
API-Schlüssel, Datenbank-URLs, Cloud-Tokens, OAuth-Secrets und Produktionszugänge gehören nicht in Prompts, Chatverläufe oder unkontrollierte Tool-Kontexte. Auch lokale .env-Dateien sind riskanter, sobald ein Agent Terminalzugriff hat oder Dateien analysieren kann.
Ein solides Setup trennt deshalb:
- lokale Testdaten von echten Kundendaten;
- Entwicklungsumgebungen von Produktion;
- Leserechte von Schreibrechten;
- temporäre Tokens von dauerhaft gültigen Schlüsseln.
Für deutsche Unternehmen kommt zusätzlich die DSGVO-Perspektive hinzu. Wer Kundendaten, Mitarbeiterdaten oder Vertragsdaten in Agentenworkflows einbindet, braucht klare Antworten: Welche Daten verlassen welche Umgebung? Welche Anbieter sind beteiligt? Was wird gespeichert? Wer kann es einsehen?
Das muss nicht jedes Projekt lähmen.
Aber es muss entschieden werden, bevor der Agent produktionsnahe Daten sieht.
3. Dependency- und Extension-Policy
Ein Agent kann eine Library vorschlagen, eine Extension empfehlen oder eine Installation ausführen.
Das ist bequem.
Es ist aber auch eine Supply-Chain-Frage.
Gerade wenn Agenten aus Trainingsmustern oder Webkontext heraus Pakete vorschlagen, ist nicht automatisch klar, ob diese Pakete gepflegt, sicher, lizenzrechtlich passend oder überhaupt notwendig sind.
Teams brauchen deshalb einfache Regeln:
- keine neuen Dependencies ohne Review;
- bekannte Frameworks und vorhandene Projektmuster bevorzugen;
- Package-Reputation und Wartungsstatus prüfen;
- Lockfiles respektieren;
- Security-Scans in CI ernst nehmen;
- Extensions nicht blind installieren, nur weil ein Tool sie empfiehlt.
Das Ziel ist nicht Misstrauen gegenüber jedem Paket.
Das Ziel ist, dass der Agent nicht heimlich zur Einkaufsabteilung für technischen Ballast wird.
4. Architekturregeln, die der Agent wirklich kennt
Viele Probleme mit KI-generiertem Code entstehen nicht, weil der Code syntaktisch schlecht ist.
Sie entstehen, weil der Code nicht zum System passt.
Der Agent legt Logik an die falsche Stelle. Er dupliziert einen bestehenden Mechanismus. Er ignoriert Domain-Begriffe. Er baut an einer API vorbei. Er verwendet ein anderes Fehlerhandling als der Rest des Systems. Er löst das lokale Ticket, aber schwächt die Architektur.
Deshalb brauchen Agenten Projektkontext, nicht nur Aufgabenbeschreibung.
Das kann über AGENTS.md, CLAUDE.md, Cursor Rules, eigene Skills, Architekturentscheidungen, Beispielmodule oder kurze Projektleitlinien passieren. Wichtig ist nicht das Format. Wichtig ist, dass die Regeln spezifisch sind:
- Wo lebt Geschäftslogik?
- Wie werden Daten validiert?
- Wie funktionieren Berechtigungen?
- Welche Patterns sind erwünscht?
- Welche alten Teile dürfen nicht erweitert werden?
- Welche Tests gehören zu welcher Änderung?
Bei McDougall Digital ist das einer der wichtigsten Punkte in KI-unterstützter Entwicklung: Der Agent darf nicht nur wissen, was gebaut werden soll. Er muss wissen, in welches System er baut.
5. Review-Gates für risikoreiche Änderungen
Nicht jede Änderung braucht dieselbe Kontrolle.
Ein Copy-Fix in einer statischen Seite ist etwas anderes als eine Änderung an Authentifizierung, Zahlungslogik, Datenmigration, Rollenmodell, Mandantentrennung oder Deployment-Konfiguration.
Ein gutes Agenten-Setup unterscheidet deshalb Risikoklassen.
Niedriges Risiko:
- Texte;
- einfache UI-Anpassungen;
- zusätzliche Tests;
- kleine Refactorings in isolierten Modulen.
Mittleres Risiko:
- API-Änderungen;
- Datenmodell-Anpassungen;
- neue externe Integrationen;
- größere Komponentenlogik.
Hohes Risiko:
- Authentifizierung;
- Autorisierung;
- Zahlungsflüsse;
- personenbezogene Daten;
- Migrationen;
- CI/CD und Infrastruktur;
- Produktionszugriff.
Je höher das Risiko, desto weniger sollte ein Agent allein entscheiden. Dann braucht es menschliche Review, Tests, Staging, Rollback-Plan und klare Verantwortlichkeit.
6. Beobachtbarkeit und Betrieb
Wenn Agenten produktionsnahe Software beschleunigen, muss der Betrieb mithalten.
Mehr Geschwindigkeit ohne Monitoring ist kein Fortschritt. Es ist nur schnelleres Raten.
Teams sollten deshalb nicht nur fragen, ob der Agent ein Feature bauen kann. Sie sollten fragen:
- Woran erkennen wir, dass es funktioniert?
- Welche Fehler werden geloggt?
- Welche Metriken ändern sich?
- Wie merken wir, dass ein externer Dienst ausfällt?
- Wie rollen wir zurück?
- Wer wird informiert, wenn etwas kaputtgeht?
Das gilt besonders, wenn Agenten künftig über MCP oder ähnliche Mechanismen Zugriff auf Observability-Tools bekommen. Ein Agent, der Logs lesen kann, ist nützlich. Ein Agent, der ohne klare Grenzen operative Schlüsse zieht oder Änderungen vorschlägt, braucht Kontrolle.
7. Klare Eigentümerschaft
Der gefährlichste Satz in KI-Projekten ist:
“Das hat der Agent gemacht.”
Für Kunden, Nutzer und den Betrieb ist das egal.
Software braucht Eigentümer. Jemand muss verstehen, warum eine Änderung gemacht wurde. Jemand muss verantwortlich sein, wenn sie ausfällt. Jemand muss entscheiden, ob ein Vorschlag fachlich richtig, technisch passend und rechtlich akzeptabel ist.
KI kann viel Arbeit übernehmen.
Verantwortung nicht.
Was das für Gründer und Produktteams bedeutet
Für Gründer und kleine Produktteams ist die Versuchung groß, Agenten maximale Freiheit zu geben.
Das ist nachvollziehbar. Wenn ein Tool in Stunden schafft, wofür früher Tage nötig waren, will man diese Geschwindigkeit nicht sofort wieder mit Prozessen bremsen.
Aber gute Leitplanken bremsen nicht. Sie machen Geschwindigkeit wiederholbar.
Ohne Leitplanken wird jeder Agentenlauf ein Experiment. Mit Leitplanken entsteht ein System:
- klare Aufgaben;
- bekannte Grenzen;
- prüfbare Änderungen;
- nachvollziehbare Entscheidungen;
- weniger Überraschungen nach dem Launch.
Gerade für SaaS-Produkte ist das entscheidend. Ein schneller MVP kann wertvoll sein. Aber sobald echte Nutzer, Abrechnung, Support, Berechtigungen und Produktdaten dazukommen, muss die Entwicklung belastbar werden.
Was das für den Mittelstand bedeutet
Mittelstandsteams haben oft andere Sorgen als Venture-Startups.
Sie fragen nicht nur: Können wir schneller bauen?
Sie fragen:
- Passt das in unsere IT-Landschaft?
- Was passiert mit unseren Daten?
- Wer wartet das in zwei Jahren?
- Können wir das einem internen Team übergeben?
- Wird daraus ein weiteres System, das niemand versteht?
Für diese Unternehmen können KI-Coding-Agenten trotzdem sehr wertvoll sein. Besonders bei internen Tools, Prozessautomatisierung, Modernisierung kleiner Altsysteme, Schnittstellen und Reporting.
Aber der Nutzen entsteht nicht durch blindes Vibe Coding.
Er entsteht, wenn KI in einen sauberen Entwicklungsprozess eingebettet wird: mit Architektur, Datenmodell, Sicherheitsannahmen, Betriebsmodell und verständlicher Dokumentation.
Das ist weniger spektakulär als ein virales Demo-Video.
Aber es ist genau der Unterschied zwischen “funktioniert einmal” und “trägt im Alltag”.
Ein pragmatisches Einführungsmodell
Teams müssen nicht monatelang ein KI-Governance-Handbuch schreiben, bevor sie anfangen.
Ein praktikabler Start kann so aussehen:
- Use Cases klassifizieren: Welche Aufgaben sind ungefährlich, welche produktnah, welche sicherheitskritisch?
- Agentenzugriff begrenzen: Welche Repositories, Pfade, Tools und Umgebungen darf der Agent sehen?
- Projektregeln schreiben: Welche Architektur- und Qualitätsregeln muss der Agent kennen?
- Review-Gates festlegen: Welche Änderungen brauchen menschliche Freigabe?
- CI/CD härten: Tests, Linting, Security-Scans und Preview-Umgebungen müssen zuverlässig laufen.
- Secrets aufräumen: Keine produktiven Schlüssel in Agentenkontexten.
- Nach dem ersten Monat prüfen: Was wurde schneller? Wo entstanden Risiken? Welche Regeln fehlen?
Das ist keine Theorie. Es ist ein Betriebsmodell für KI-unterstützte Entwicklung.
Wo McDougall Digital helfen kann
McDougall Digital baut Software mit KI-Unterstützung, aber nicht mit KI-Naivität.
Für uns ist ein Agent ein Werkzeug innerhalb eines Architektur- und Qualitätsprozesses. Nicht der Prozess selbst.
Wir helfen Teams zum Beispiel dabei:
- bestehende Prototypen auf Produktionsrisiken zu prüfen;
- Agentenworkflows für Repositories, Tests und Reviews sauber aufzusetzen;
- Architekturregeln so zu formulieren, dass KI-Tools sie praktisch nutzen können;
- Security- und DSGVO-Fragen früh in den Entwicklungsprozess einzubauen;
- interne Tools oder SaaS-Produkte so zu bauen, dass Tempo und Wartbarkeit zusammenpassen.
Der wertvolle Punkt ist nicht, ob ein Team Claude Code, Cursor, Codex oder ein anderes Werkzeug verwendet.
Der wertvolle Punkt ist, ob das Team weiß, welche Verantwortung dieses Werkzeug tragen darf.
Die Kernbotschaft
KI-Coding-Agenten werden nicht verschwinden. Sie werden mehr Zugriff bekommen, mehr Tools verwenden und tiefer in Entwicklungsprozesse integriert werden.
Das ist eine Chance für Teams, die schneller lernen und besser bauen wollen.
Aber es ist auch ein Test für technische Führung.
Wer Agenten wie magische Autocomplete-Systeme behandelt, wird irgendwann überrascht werden. Wer sie wie technische Akteure mit begrenzten Rechten, klaren Aufgaben und Review-Gates behandelt, kann ihre Geschwindigkeit nutzen, ohne die Kontrolle zu verlieren.
Die Zukunft der KI-unterstützten Softwareentwicklung gehört nicht den Teams mit den meisten Prompts.
Sie gehört den Teams mit den besten Leitplanken.
Nächster Schritt
Wenn ihr KI-Coding-Agenten bereits nutzt oder gerade einführen wollt, lohnt sich ein kurzer Produktionsreife-Check.
Wir können gemeinsam prüfen:
- welche Aufgaben sich für Agenten eignen;
- wo Repository-, Daten- und Sicherheitsgrenzen liegen sollten;
- welche Architekturregeln in eurem Projekt fehlen;
- wie Reviews, Tests und Deployment-Prozesse angepasst werden müssen;
- und welche Teile eures bestehenden Prototyps wirklich produktionsnah sind.
Das Ergebnis ist kein abstraktes KI-Policy-Dokument.
Es ist ein praktischer Satz an Leitplanken, mit dem euer Team schneller arbeiten kann, ohne die Kontrolle über Produkt, Architektur und Betrieb zu verlieren.