mensch×ki
Praxis-Paper · Agentic Engineering

Agenten schreiben den Code.
Den Rahmen baut
das Team.

Wie Teams den Rahmen bauen, in dem KI-Agenten in einem echten Projekt arbeiten können — ohne die Kontrolle über Architektur, Qualität und Verantwortung abzugeben.

Autor
Daniel Grobelny, mensch × ki
Stand
August 2026
Für
Entwicklungsteams, technische Leitung
Umfang
10 Abschnitte, ca. 14 Minuten
Kurzfassung

Vier Sätze, falls Sie nur diese Seite lesen.

  1. 01

    Der Unterschied zwischen KI-Assistenz und Agentic Engineering ist nicht das Modell, sondern der Rahmen, den das Team baut: Auftrag, Ausführung, Prüfung, Freigabe als geschlossener Kreis.

  2. 02

    Autonomie entsteht nicht durch mehr Freiheit, sondern durch automatisierte Prüfbarkeit. Wo Tests, Typen und Reviews greifen, darf ein Agent mehr tun.

  3. 03

    Ein System aus wenigen, klar begrenzten Rollen ist belastbarer als ein Universal-Agent mit Zugriff auf alles.

  4. 04

    Der Engpass verschiebt sich vom Schreiben zum Prüfen. Wer das nicht mitplant, tauscht Tippzeit gegen Review-Staus.

01 · Abgrenzung

Drei Reifegrade, die im Alltag ständig verwechselt werden.

Die meisten Teams sind heute auf Stufe 2: Ein Entwickler beschreibt im Chat, was er braucht, kopiert das Ergebnis, prüft es selbst. Die Zeitgewinne sind real, aber sie enden an der Person, die zwischen Modell und Repository sitzt.

Stufe 3 verlagert diese Vermittlungsarbeit in ein System: Der Agent holt sich Kontext selbst, führt Werkzeuge aus, prüft sein Ergebnis gegen Tests und legt es an definierten Punkten dem Menschen vor.

Stufe
01
Autovervollständigung
02
Assistenz im Chat
03
Agentic Engineering
Einheit der Arbeit
Die Zeile
Die Datei, das Snippet
Die Aufgabe — vom Ticket bis zum prüfbaren Diff
Kontext kommt von
der offenen Datei
dem Menschen, der ihn hineinkopiert
dem Projekt selbst: Regeln, Repository, Tickets, Testausgaben
Der Mensch tut
schreiben und annehmen
formulieren, einfügen, selbst prüfen
Ziel setzen, Grenzen setzen, Ergebnis freigeben
Der Engpass
Tippgeschwindigkeit
der Mensch als Kopier-Schnittstelle
Review-Kapazität und Prüfbarkeit des Codes

Stufe 3 ersetzt Stufe 2 nicht. In der Praxis laufen beide parallel: Der Chat bleibt für Exploration und Verständnis, der Agenten-Workflow übernimmt wiederkehrende, klar beschreibbare Arbeit.

02 · Der Agent-Loop

Jeder Schritt erzeugt ein Ergebnis, das man anhalten kann.

Ein Agent ist kein einmaliger Prompt, sondern eine Schleife. Der entscheidende Teil ist nicht die Ausführung, sondern die Verifikation: Erst wenn ein Schritt maschinell überprüfbar ist, wird aus Modell-Output nachvollziehbare Entwicklungsarbeit. Der Mensch steht an genau zwei Stellen im Kreis — am Anfang und an der Freigabe.

01 Mensch
Auftrag

Ziel, Akzeptanzkriterien, betroffener Bereich, erlaubte Werkzeuge.

02 Agent
Kontext & Plan

Relevanten Code lesen, Regeln laden, Vorgehen in kleine Schritte zerlegen.

03 Agent
Ausführung

Änderungen im Feature-Branch, nur über freigegebene Werkzeuge.

04 Agent
Verifikation

Typecheck, Tests, Build, Lint. Befunde sind Daten, nicht Meinung.

05 Mensch
Freigabe

Review des Diffs, Entscheidung über Merge. Verantwortung bleibt hier.

Fehlgeschlagene Prüfung geht mit Befund zurück in den Plan-Schritt — begrenzt auf eine feste Zahl von Versuchen, dann Abbruch mit Bericht.
Beobachtbar

Jeder Werkzeugaufruf wird protokolliert. Sie können hinterher rekonstruieren, warum eine Änderung entstanden ist.

Begrenzt

Schrittzahl, Laufzeit, Dateiumfang und Werkzeugliste sind gedeckelt. Ein Agent ohne Deckel ist ein Ausfallrisiko.

Abbrechbar

Ein Abbruch ist ein normales Ergebnis, kein Fehler. Wichtig ist, dass er einen lesbaren Bericht hinterlässt.

03 · Systemarchitektur

Nicht ein Super-Agent. Fünf Schichten mit klaren Zuständigkeiten.

Ein einzelner Agent, der alles darf, wird mit jedem Schritt unschärfer: Der Kontext füllt sich, Ziele verwischen, Fehler pflanzen sich fort. Deshalb trennen wir Verantwortung in Schichten — von oben nach unten immer konkreter, immer stärker eingeschränkt.

Lesen Sie das Bild von unten: Ohne das Fundament — Tests, CI, dokumentierte Entscheidungen — hat keine der oberen Schichten etwas, woran sie sich prüfen kann.

Ebene 05
Mensch
Ziel & Priorität Architekturentscheidungen Risikoabwägung Freigabe & Verantwortung
Ebene 04
Orchestrierung

Hält den Auftrag zusammen: zerlegt ihn in Teilaufgaben, wählt die passende Rolle, sammelt Ergebnisse ein und entscheidet, wann etwas zum Menschen zurückgeht.

zerlegen delegieren Zustand halten eskalieren
Ebene 03
Spezialisten
Analyse

Liest Code, benennt Auswirkungen, schreibt nichts.

Implementierung

Ändert Code im Branch, in kleinen Schritten.

Test

Schreibt und führt Prüfungen aus, unabhängig vom Autor.

Review

Prüft Diff gegen Regeln, markiert Risiken für den Menschen.

Ebene 02
Werkzeuge & Rechte

Jede Fähigkeit ist ein einzeln freigegebenes Werkzeug mit engem Wirkungsbereich. Was nicht freigegeben ist, existiert für den Agenten nicht.

Repository lesen Branch schreiben Tests ausführen Build starten Ticket lesen Doku durchsuchen Produktion — gesperrt
Ebene 01
Fundament

Das Projekt selbst. Hier entscheidet sich, wie viel Autonomie überhaupt möglich ist — nicht im Modell.

Versionskontrolle CI-Pipeline Testabdeckung Architekturentscheidungen (ADR) Projektregeln im Repo

Diese Aufteilung ist werkzeugunabhängig. Sie lässt sich mit gängigen Coding-Harnesses und Agent-SDKs umsetzen; die Wahl des Anbieters ist die letzte Entscheidung, nicht die erste.

04 · Kontext-Architektur

Ein Agent ist so gut wie das, was er über Ihr Projekt weiß.

Die häufigste Ursache für schlechte Agenten-Ergebnisse ist nicht das Modell, sondern fehlender oder falscher Kontext: implizite Konventionen, undokumentierte Entscheidungen, ein Ticket, das nur der Autor versteht. Wissen, das nirgends steht, kann kein Agent nutzen — und übrigens auch kein neuer Kollege.

Dauerhaft
Projektwissen

Coding-Standards, Architekturregeln, Domänenbegriffe, bewusste Ausnahmen.

im Repository, versioniert
Pro Aufgabe
Auftragswissen

Ticket, Akzeptanzkriterien, betroffene Module, ausdrücklich ausgeschlossene Bereiche.

aus dem Ticketsystem
Pro Schritt
Arbeitskontext

Gelesene Dateien, aktueller Diff, Testausgaben, Fehlermeldungen.

zur Laufzeit erzeugt
Flüchtig
Zwischenstände

Verworfene Ansätze, Suchergebnisse, Gedankengänge.

wird verdichtet, nicht bewahrt

Praktische Konsequenz: Projektwissen gehört in versionierte Dateien neben den Code, nicht in Chat-Verläufe oder Prompt-Sammlungen einzelner Entwickler. Wenn eine Regel dreimal im Review erklärt wurde, ist sie eine Datei wert. Damit profitieren Agenten und Menschen von derselben Quelle.

Faustregel

Kontext ist ein Budget, kein Lager. Mehr Text heißt nicht mehr Verständnis — relevanter Text schon.

05 · Rechte & Guardrails

Autonomie wird pro Aktion vergeben, nicht pro Agent.

Die Frage „Wie viel darf die KI selbst entscheiden?" ist zu grob gestellt. Sinnvoll ist eine Tabelle: Für jede Aktion wird festgelegt, ob sie autonom laufen darf, ob ein Mensch vorher zustimmt oder ob sie ausgeschlossen ist. Diese Matrix ist ein Dokument, das Sie mit Ihrem Team einmal erstellen und dann pflegen — sie ist die eigentliche Governance.

Aktion
Autonom
Mit Freigabe
Gesperrt
Code im Feature-Branch ändern
×
·
·
Tests schreiben und ausführen
×
·
·
Öffentliche Schnittstelle ändern
·
×
·
Abhängigkeit hinzufügen
·
×
·
Datenbank-Migration schreiben
·
×
·
Nach main mergen
·
×
·
Produktionsdaten lesen
·
·
×
In Produktion deployen
·
·
×

Beispielbelegung aus Pilotprojekten — kein Standard. Die Zuordnung hängt von Ihrer Testabdeckung, Ihrer Domäne und Ihren regulatorischen Anforderungen ab. Wichtig ist, dass sie explizit ist und dass Sie sie mit steigendem Vertrauen bewusst verschieben.

06 · Quality Gates

Qualität entscheidet die Pipeline, nicht die Zuversicht des Modells.

Ein Agent, der behauptet, fertig zu sein, ist kein Nachweis. Jede Änderung läuft durch dieselben Tore wie menschlicher Code — nur öfter und früher. Je dichter diese Tore sind, desto mehr Autonomie können Sie gefahrlos zulassen. Die Investition in Testbarkeit zahlt sich hier doppelt aus.

Tor 01
Umfang

Diff bleibt im vereinbarten Bereich und in vertretbarer Größe.

stoppt bei: Wildwuchs
Tor 02
Statik

Typecheck, Lint, Formatierung, verbotene Muster.

stoppt bei: Schlamperei
Tor 03
Verhalten

Bestehende Tests grün, neue Tests belegen die Änderung.

stoppt bei: Regression
Tor 04
Integration

Build, Migrationen, Zusammenspiel der Komponenten.

stoppt bei: Nebenwirkung
Tor 05
Mensch

Review von Absicht, Architektur und Angemessenheit.

stoppt bei: falscher Lösung
Tor 06
Nachvollzug

Protokoll, Begründung und Doku liegen bei der Änderung.

stoppt bei: Blackbox
Tore 01–04 laufen automatisch: Ein Befund geht direkt zurück an den Agenten, ohne dass ein Mensch involviert ist.
Erst hier kostet Prüfen menschliche Zeit — deshalb muss vorher so viel wie möglich hängen bleiben.
07 · Einführung

Klein anfangen, messbar bleiben, bewusst erweitern.

Agentic Engineering scheitert selten an Technik, sondern an der Einführung: zu großer erster Schritt, kein Vergleichsmaßstab, kein Zuständiger. Der folgende Ablauf hat sich als Rahmen bewährt — die Dauer verschiebt sich je nach Reifegrad Ihres Projekts.

Woche 1–2
Diagnose

Wir sehen uns Repository, Tests, CI und Review-Praxis an und suchen die Stellen, an denen Arbeit wiederkehrend und prüfbar ist.

  • ×Kandidaten-Aufgaben sammeln und bewerten
  • ×Baseline messen: Durchlaufzeit, Review-Aufwand, Fehlerquote
  • ×Rechte-Matrix in erster Fassung
Ergebnis: ein Pilotumfang, den alle Beteiligten verstehen.
Woche 3–8
Pilot

Ein Team, ein Aufgabentyp, ein echter Branch. Wir bauen den Loop, die Guardrails und die fehlenden Prüfungen — und arbeiten damit im Alltag.

  • ×Projektregeln als versionierte Dateien anlegen
  • ×Rollen, Werkzeuge und Gates in die CI einhängen
  • ×Wöchentliche Auswertung: Was ging schief, und warum
Ergebnis: ein Workflow, der ohne Begleitung läuft.
Woche 9–12
Ausweitung

Was belastbar war, wird zum Standard: weitere Aufgabentypen, weitere Teams, mehr Autonomie an den Stellen, die sich bewährt haben.

  • ×Rechte-Matrix nachziehen, Grenzen begründet lockern
  • ×Team befähigen: Arbeitsweise, Review, Fehlerbilder
  • ×Betrieb und Zuständigkeit intern übergeben
Ergebnis: eine Arbeitsweise, die Ihrem Team gehört.
08 · Was Sie messen

Vier Kennzahlen, gemessen vor und nach dem Pilot.

Wir nennen hier absichtlich keine Prozentzahlen. Zeitgewinne hängen von Codebasis, Testlage und Aufgabentyp ab; jede pauschale Zahl wäre Werbung. Belastbar wird es, wenn Sie Ihre eigene Baseline kennen.

Durchlaufzeit

Vom aufgenommenen Ticket bis zum Merge — inklusive Wartezeiten, nicht nur Arbeitszeit.

Quelle: Ticketsystem, Git-Historie
First-pass rate

Anteil der Agenten-Ergebnisse, die ohne inhaltliche Nacharbeit durchs Review gehen.

Quelle: Review-Kommentare, Nach-Commits
Review-Last

Menschliche Prüfzeit pro Änderung. Die Kennzahl, die bei schlechter Einführung als Erste kippt.

Quelle: Stichprobe im Team
Stabilität

Fehler nach dem Merge und Rollbacks. Tempo ohne diese Zahl ist keine Verbesserung.

Quelle: Incident-Log, Monitoring
09 · Ehrlich betrachtet

Was in der Praxis regelmäßig nicht funktioniert.

Diese fünf Muster sehen wir am häufigsten. Sie sind alle vermeidbar, aber keines löst sich durch ein besseres Modell.

01
Der große erste Schritt

Ein Agent soll ein ganzes Feature bauen. Das Ergebnis ist ein Diff, den niemand mehr sinnvoll prüfen kann — und damit unbrauchbar, unabhängig von seiner Qualität.

02
Autonomie ohne Prüfbarkeit

In einer Codebasis ohne Tests kann kein Agent belegen, dass er nichts kaputt gemacht hat. Dann ist die erste Maßnahme nicht der Agent, sondern die Prüfschicht.

03
Prompts als Privatbesitz

Wenn Projektwissen in persönlichen Chat-Verläufen liegt, entsteht kein System, sondern eine Abhängigkeit von einzelnen Personen. Regeln gehören ins Repository.

04
Review als Formsache

Wenn Agenten mehr Änderungen produzieren, als das Team prüfen kann, wird durchgewinkt. Die Kapazität für Reviews ist Teil der Planung, nicht ein Rest.

05
Werkzeugwahl vor Prozessklärung

Die Entscheidung für ein Produkt ersetzt keine Klärung von Rollen, Rechten und Qualitätsanforderungen. Der Prozess bestimmt das Werkzeug, nicht umgekehrt.

Alle fünf Muster haben eine gemeinsame Ursache: Es wurde ein Werkzeug eingeführt, aber kein Arbeitsmodell vereinbart.

10 · Rolle der Entwickler

Die Arbeit verschwindet nicht. Sie verschiebt sich nach vorn.

Wer heute gute Software baut, wird in diesem Modell wichtiger, nicht überflüssig: Aufgaben präzise schneiden, Grenzen festlegen, Ergebnisse beurteilen. Das ist Senior-Arbeit — und für viele Teams die eigentliche Umstellung.

Code selbst schreiben
Aufgaben und Akzeptanzkriterien schreiben
Wissen im Kopf halten
Wissen ins Repository schreiben
Manuell testen
Prüfungen bauen, die ein Agent auslösen kann
Reviews nebenbei
Review als eingeplante Kernaufgabe
Tickets als Notiz
Tickets als ausführbarer Auftrag
Agentic Engineering in Ihrem Projekt

Sprechen wir über Ihren konkreten Entwicklungsprozess.

Ein Erstgespräch dauert 30 Minuten und kostet nichts. Wir schauen uns an, wie Ihr Team heute arbeitet, und sagen offen, ob und wo ein Agenten-Workflow bei Ihnen Sinn ergibt — auch dann, wenn die Antwort „noch nicht" ist.

Der Einstieg
Workshop, ein Tag

Ihr Team versteht Loop, Rollen und Guardrails und bewertet eigene Aufgaben auf Eignung.

Der Weg
Pilot mit Begleitung

Wir bauen den Workflow gemeinsam im echten Projekt auf und messen gegen Ihre Baseline.

Die Tiefe
Enablement im Team

Schulung, Review-Praxis und Übergabe, damit der Betrieb ohne uns weiterläuft.