13 Prinzipien für agentisches Engineering

KI-Agenten in produktionsnahen Architekturprojekten scheitern selten am Modell — sondern an fehlender Struktur. Wer Legacy-Code analysieren, Dokumentation pflegen oder Migrationspläne erarbeiten lässt, braucht kein weiteres Chat-Fenster, sondern ein Engineering-Framework: wiederholbar, prüfbar, isoliert. Die folgenden 13 Prinzipien bilden ein solches Gerüst — unabhängig vom konkreten Tooling.

1 — CLAUDE.md / AGENTS.md: Persistente Projektinstruktionen im Repository, nicht im Chat-Verlauf. Was der Agent immer wissen muss — Konventionen, Pfade, Verbote — steht in versionierten Markdown-Dateien. Das ist das Agenten-Äquivalent zu blueprint.md in der AGM: der Orchestrator, der jede Session startet.

2 — Specification First: Bevor Code oder Dokumentation entsteht, steht die Spezifikation. Was ist Scope? Was sind Nicht-Ziele? Welche Evidenz gilt? In Architekturarbeiten bedeutet das: work/WRK-Items mit klarem Auftrag, bevor der Agent loslegt — nicht umgekehrt.

3 — Subagents · Skills · Hooks: Komplexe Aufgaben werden zerlegt. Subagents übernehmen fokussierte Teilaufgaben (Security-Scan, Dependency-Map). Skills kapseln wiederverwendbares Wissen. Hooks steuern den Lebenszyklus — vor und nach Tool-Aufrufen. Monolithische „Mache alles"-Prompts sind Anti-Pattern.

4 — Plan & Task Breakdown: Mehrstufige Pläne mit expliziten Tasks, nicht ein Schritt ins Blaue. Für Modernisierungsprojekte: erst Inventar, dann Bewertung, dann Empfehlung — jede Stufe als abgeschlossene Einheit mit eigenem Deliverable.

5 — Exit Criteria & Gates: Jede Phase endet mit definierten Abbruchkriterien. „Fertig" heißt: Link-Integrität geprüft, Evidenz verlinkt, Review bestanden — nicht: der Agent hat aufgehört zu schreiben. Gates verhindern, dass unsichere Zwischenstände als Ergebnis durchgereicht werden.

6 — Context Management: Kontext ist endlich und teuer. Was landet im Fenster, muss kuratiert sein — Graph-Traversierung statt Volltext- dump. In AGM-Projekten: entry-point.md, always-on.md und gezielte Kapitel laden, nicht das gesamte Repo.

7 — Sandboxing & Isolation: Agenten arbeiten in abgegrenzten Umgebungen — Branch, Worktree, Container. Kein direkter Zugriff auf Produktion, keine unkontrollierten Netzwerkpfade. In Enterprise-Kontexten nicht optional, sondern Voraussetzung für Freigabe.

8 — Trajectory Review: Nicht nur Ergebnis prüfen, sondern den Weg. Welche Tools wurden aufgerufen? Welche Annahmen getroffen? Wo wich der Agent vom Plan ab? Trajectory Review ist die Wurzelursachen-Analyse für Agenten-Fehler — vergleichbar mit Post-Mortems in CI/CD.

9 — Guardrails: Harte Grenzen für das, was ein Agent nicht tun darf — Dateien löschen, Secrets committen, externe APIs ohne Freigabe. Guardrails sind Policy as Code, nicht Höflichkeitsbitte im Prompt.

10 — Verification Loops: Ergebnisse werden automatisch und manuell verifiziert — Link-Checks, Lint, Tests, frischer Chat für Review-only. Die AGM-Review-Phase (Verify in separatem Chat) ist genau das: Report-only, ohne Schreibzugriff.

11 — Retrieval Stack: RAG hat seinen Platz — aber als Schicht, nicht als Fundament. Deterministischer Graph zuerst, Retrieval für Lücken und Exploration. Wer nur vektorisiert, verliert Struktur; wer nur linkt, verpasst semantische Nähe. Beides kombinieren — mit klarer Priorität.

12 — Agentic CI/CD: Agenten-Artefakte durchlaufen dieselbe Pipeline wie Code — PR, Review, Merge. Dokumentations-Updates bei git diff, broken links blockieren den Build. Architekturwissen ist kein Nebenprodukt, sondern ein versioniertes Deliverable.

13 — Feedback & Iteration Loop: Jeder Lauf verbessert den nächsten — Session-Logs, blueprint.md-Fortschritt, Lessons Learned in AGENTS.md. Agentisches Engineering ist kein One-Shot, sondern ein kontinuierlicher Kreislauf aus Plan, Execute, Verify, Learn.

Für technische Leitung lässt sich daraus ableiten: Agenten in Architekturprojekten sind kein Feature-Toggle, sondern ein Prozess-Design-Problem. Wer die 13 Bausteine ignoriert, bekommt schnelle Demos — wer sie ernst nimmt, bekommt Ergebnisse, die in Roadmaps, Audits und Migrationsentscheidungen standhalten.