
KI-Coding-Tools stehen inzwischen jedem Unternehmen zur Verfügung, und zwar dieselben. Nach der ersten Euphorie kommt deshalb die Wartungsrealität: Code, der in Minuten entstanden ist, muss über Jahre gepflegt werden.
Eine KI, die ohne Kontext programmiert, erzeugt technische Schulden in Rekordzeit. Sie ignoriert Agentur-Standards, baut nach, was das System längst kann, und riskiert im schlimmsten Fall Verstöße gegen das Barrierefreiheitsstärkungsgesetz oder Sichtbarkeitsverluste beim Deployment.
Der Wettbewerbsvorteil liegt deshalb weder im Modell noch im Tool. Er liegt in einem maschinenlesbaren, portablen Regelwerk und in der Art, wie Sie es betreiben. In unseren TYPO3-Projekten behandeln wir dieses Regelwerk wie Quellcode: mit einer gemeinsamen Quelle, einem Build-Schritt und Prüfungen, die fehlschlagen dürfen.
„Welches KI-Tool sollen wir einsetzen?“ ist die falsche Frage. Tools sind austauschbar, aber nicht gleichwertig. Wer jederzeit das beste Modell nutzen will, braucht eine Arbeitsgrundlage, die an kein Tool gebunden ist. Dafür lohnt es sich, drei Ebenen zu trennen:
Hinter AGENTS.md steht inzwischen eine neutrale Governance. Am 9. Dezember 2025 gründete die Linux Foundation die Agentic AI Foundation (AAIF). Zu den Gründungsbeiträgen gehören das Model Context Protocol (MCP) von Anthropic, goose von Block und AGENTS.md von OpenAI. MCP ist eine Schnittstelle, über die Agenten auf externe Werkzeuge und Daten zugreifen. AGENTS.md nutzen bereits über 60.000 Repositories.
Für die Werkzeuge gibt es seit dem 6. August 2026 einen eigenen Standard: Agent Plugins in Version 1.0.0, getragen unter anderem von Amazon, Cursor, Microsoft, OpenAI und Vercel, mit Google als Core Maintainer. Die Spezifikation von Agent Plugins zieht eine klare Grenze. Sie standardisiert Skills und MCP-Server, also das, was ein Agent können soll. Rules, Commands, Hooks, Agents und LSP-Server schließt sie ausdrücklich aus.
AGENTS.md beschreibt also, wie der Agent arbeiten soll, Agent Plugins liefern ihm die Werkzeuge. Wer beides portabel hält, kann das Modell wechseln, ohne sein Wissen neu aufzubauen.
Der naheliegende Einwand lautet: Dafür gibt es doch die Pipeline. Er ist berechtigt. In einer CI/CD-Pipeline laufen bei jeder Änderung automatische Prüfungen, sogenannte Quality Gates. PHPStan findet Typfehler im PHP-Code, axe-core Barrierefreiheitsfehler, Stylelint Verstöße im CSS, und ein Crawl kontrolliert die ausgelieferte Website. Diese Checks sind deterministisch: Gleicher Code führt zum gleichen Ergebnis. Daran ändert ein Agent nichts.
Er ergänzt die Pipeline an drei Stellen:
01
Er hält Regeln beim Schreiben ein. Die Pipeline misst Verstöße erst im Nachhinein, der Agent vermeidet sie von Anfang an.
02
Er priorisiert und behebt. Wo ein Check nur meldet, wird aus einer Liste von Warnungen eine Korrektur.
03
Er versteht Vorgaben, die kein Linter prüfen kann. „Prüfe erst den TYPO3 Core, bevor du etwas neu baust“ ist eine Architekturregel, keine Syntaxregel.
Genau hier entstehen technische Schulden: in der unnötigen Eigenentwicklung, die alle Checks besteht und trotzdem jahrelang gepflegt werden muss.
KI-generierter Code ist nicht automatisch barrierefrei, eher im Gegenteil. Ein Großteil der Trainingsdaten wurde nie barrierefrei entwickelt. Ohne ausdrückliche Anweisung übernehmen Modelle diesen Bias und erzeugen Komponenten, die optisch funktionieren, mit Tastatur oder Screenreader aber scheitern.
Verstöße gegen das Barrierefreiheitsstärkungsgesetz (BFSG) können rechtliche Folgen haben. Dasselbe gilt für Sicherheitslücken, die ohne menschliches Review und ohne deterministische Checks ins Deployment gelangen. Wer KI-Code ungeprüft ausliefert, trägt beide Risiken.
Unser Frontend-Agent arbeitet deshalb mit einem festen Accessibility-Set aus vier Prüfungen:
Damit der Agent Farben und Abstände nicht rät, liest er vor dem Schreiben die Design-Tokens über einen Figma-MCP-Server aus. Design-Tokens sind die zentral definierten Gestaltungswerte eines Projekts. So entsteht Code, der zum Design passt und die Anforderungen an barrierefreie Websites von Anfang an berücksichtigt.
Was steht in einem Regelwerk eigentlich drin? Im Backend vor allem Prüfreihenfolgen und Architekturentscheidungen. Seit dem 21. April 2026 ist TYPO3 v14 als LTS-Version 14.3.0 verfügbar. Sie setzt mindestens PHP 8.2 voraus und unterstützt PHP bis Version 8.5. Die Neuerungen in TYPO3 v14 fließen direkt in unser Regelwerk ein.
Die wichtigste Regel heißt Core First. Bevor der Agent etwas baut, prüft er in fester Reihenfolge: Gibt es eine Core-API? Gibt es eine Lösung im vendor/-Ordner? Erst danach entsteht eine eigene Extension. Eigene Inhaltselemente definieren wir mit Content Blocks statt mit veralteten Mask-Konfigurationen.
Für Assets gilt eine noch strengere Vorgabe. CSS, JavaScript und Bilder werden auf genau einem zugelassenen Weg ausgeliefert, über eine interne Asset-Einbindungs-Extension. Ohne diese Regel entstehen typische Fehlgriffe, bei Agenten genauso wie bei Menschen:
Lighthouse meldet im ersten Fall zwar „render-blocking resources“, sagt aber nicht, welchen Weg der Agent hätte nehmen sollen. Die Regel verhindert den Fehler, die Metrik entdeckt ihn nur. Für den dritten Fall gibt es nicht einmal eine Metrik.
Vor jedem Livegang crawlen wir die Website über den MCP-Server von Screaming Frog. Warum, zeigt ein Muster, das wir regelmäßig sehen, hier aus einem Kundenprojekt.
In einer gewachsenen Shortlink-Lösung war ein Feld in der TCA, der zentralen Konfiguration von Datenbankfeldern in TYPO3, so eingerichtet, dass ein leerer Shortlink als „/“ interpretiert wurde. In der Middleware, die Anfragen vor der eigentlichen Seitenauslieferung verarbeitet, fehlte ein Guardrail für genau diesen Fall. Zusätzlich prüfte niemand, ob kurze Slugs eindeutig sind. Das Ergebnis: Die Startseite lieferte eine Produktdetailseite aus.
Der Fehler trat ausschließlich während der Entwicklung und lokal auf, nie live. Der Crawl hat ihn früh entdeckt, entsprechend schnell war er behoben. Betroffen gewesen wäre ausgerechnet der Haupteingang der Website: die URL mit den meisten Backlinks, dem meisten Brand-Traffic und der höchsten Crawl-Frequenz.
Den Code hatte übrigens keine KI gebaut, es war eine gewachsene Implementierung. Unvollständig gedachte Randfälle gehören trotzdem zu den zuverlässigsten Schwächen von Agenten, unabhängig davon, wer den Code ursprünglich geschrieben hat. Der Fall zeigt aus vier Gründen, was ein Crawl-Gate leistet:
Über AGENTS.md wird viel geschrieben, meist darüber, welche Regeln hineingehören. Wie sie aktuell bleiben, beschreibt kaum jemand. Unsere Beobachtung: Der Markt diskutiert Regelinhalte und ignoriert den Regelbetrieb. Genau dort liegt der eigentliche Vorsprung.
Die AGENTS.md in unseren Repositories ist deshalb keine handgepflegte Datei. Die Single Source of Truth, also die eine maßgebliche Quelle, ist eine vom Team gepflegte Ordnerstruktur in Obsidian. Ein Sync-Script lädt Regeln und Plugins von dort in die Agenten und sandboxt sie. Die AGENTS.md ist damit ein generiertes Artefakt, so wie eine kompilierte Datei aus Quellcode entsteht. Daraus folgen vier Dinge.
Regeln haben einen Build-Schritt. Quelle, Sync, Artefakt: Das Regelwerk durchläuft denselben Weg wie Code. Der Build schlägt fehl, sobald typische KI-Artefakte auftauchen, etwa Magic Numbers bei Schriftgrößen, also fest eingetragene Werte statt Design-Tokens, oder Kommentare wie IgnoreNextLine und @ts-ignore, mit denen Prüfungen stillschweigend umgangen werden. So bleiben technische Schulden sichtbar, statt sich unbemerkt anzusammeln.
Das Regelwerk ist Agenturwissen. Weil die Quelle im Team-Vault liegt, können auch Kolleg:innen ohne Entwicklerrolle Regeln beitragen, zum Beispiel zu Barrierefreiheit, SEO oder redaktionellen Standards. Für Website-Verantwortliche ist das die vielleicht wichtigste Konsequenz: Ihr Wissen landet direkt dort, wo der Code entsteht.
Harness-Hopping wird konkret. Mit einer werkzeugneutralen Quelle und einem Sync-Schritt bedeutet ein Tool-Wechsel einen neuen Emitter, also ein zusätzliches Ausgabeformat. Das Wissen selbst muss niemand neu schreiben. Wirksamer lässt sich Vendor-Lock-in kaum vermeiden.
Der Sync löst Verteilung, nicht Drift. Rule-Drift heißt: Die Regel existiert, der Agent ignoriert sie, und niemand merkt es. Dagegen hilft, Regeln bewusst abstrakt zu formulieren, etwa „Finde APIs im vendor-Ordner, bevor du selbst welche entwickelst“, „Prüfe Design-Tokens, bevor du Werte hartcodierst“ oder „Schreibe Tokens immer in den abstracts-Bereich der SCSS-Dateien“. Direkte Pfade und versionsabhängige APIs veralten dagegen schnell.
Mit beiden Standards ist Portabilität greifbar geworden. Regeln wandern über AGENTS.md, Werkzeuge über Agent Plugins. Selbst wo ein Anbieter den Werkzeugstandard noch nicht mitträgt, wie derzeit Anthropic mit Claude, lassen sich Werkzeuge mit KI-Unterstützung portieren. Welches Harness Sie nutzen, wird damit zunehmend zweitrangig. Tool-Fanatismus halten wir für den am stärksten überschätzten Trend.
Zur ehrlichen Darstellung gehört aber auch, was der Standard offenlässt. Agent Plugins definiert bewusst kein Trust-Modell, kein Permission-System und kein Sandboxing. Offen bleibt also, welchem Plugin ein Agent vertrauen darf, welche Rechte es bekommt und wie es abgeschottet läuft. Die Spezifikation verlangt zwar, dass Plugins auf ihre eigenen Pfade beschränkt bleiben, und verbietet Zugangsdaten in env-Werten. Wie Unterprozesse abgeschottet werden, regelt sie nicht.
Auch die Regelbefolgung selbst hat eine Grenze. Sie ist probabilistisch und nicht deterministisch, genau deshalb gibt es die Quality Gates. Bei systemübergreifenden Refactorings über mehrere unverknüpfte Repositories verliert die KI den Kontext. Dort bleibt der menschliche Architekt zwingend.
Den Vorsprung bringt also nicht das nächste Tool. Er entsteht durch ein Regelwerk, das portabel ist, wie Quellcode gebaut wird und von deterministischen Gates abgesichert ist. Wer damit beginnt, sollte zuerst zwei Dinge festlegen: wo die gemeinsame Regelquelle liegt und welche Prüfungen vor jedem Livegang laufen.
AGENTS.md beschreibt, wie ein Agent arbeiten soll, also Regeln, Prüfreihenfolgen und Architekturvorgaben. Agent Plugins liefern ihm zusätzliche Fähigkeiten in Form von Skills und MCP-Servern. Beide Standards ergänzen sich, decken aber unterschiedliche Aufgaben ab.
Nein. Deterministische Quality Gates wie PHPStan, axe-core oder ein Crawl vor dem Livegang bleiben unverzichtbar. Der Agent ergänzt sie, indem er Regeln schon beim Schreiben einhält und Vorgaben umsetzt, die sich nicht automatisch prüfen lassen.
Ja. Seit Dezember 2025 gehört AGENTS.md zur Agentic AI Foundation unter dem Dach der Linux Foundation. Damit ist es eine gemeinsame Grundlage für unterschiedliche Coding-Agenten und nicht an ein einzelnes Tool gebunden.
Indem Sie die Regeln unabhängig vom Harness pflegen und automatisiert in die Formate überführen, die das jeweilige Tool braucht. Ein Tool-Wechsel erfordert dann nur einen neuen Sync-Schritt, das Agenturwissen bleibt erhalten.