Freitag, 14:00 Uhr. Ein neuer Entwickler hat gestern das Projekt übernommen. Der Kunde meldet einen Produktionsfehler - etwas ist mit dem individuellen Queue-Worker kaputt. In der Vergangenheit bedeutete dieses Szenario, den vorherigen Entwickler aufzuspüren, der den Code kennt. Beratungen, Erklärungen, Zeitverschwendung. Alles an einem Freitag.
Jetzt? Der Entwickler öffnet Cursor, fragt die KI nach dem Queue-Worker und die KI antwortet mit nützlichen Antworten, weil sie das Projekt kennt. Sie weiß, dass du DDEV verwendest, dass der Cache auf eine bestimmte Art und Weise konfiguriert ist, dass du benutzerdefinierte Modul-Prefixe verwendest. Wie ist das möglich? Nur eine Datei in deinem Projekt: AGENTS.md.
Problem: KI kennt Ihr Projekt nicht
Sie erkennen wahrscheinlich dieses Szenario: Sie fragen KI (Cursor, Copilot, Claude) um Hilfe bei Drupal und erhalten Code, der ... nicht passt.
KI weiß nicht, dass Sie Absätze verwenden. Sie weiß nicht, dass Ihr Thema einen anderen Namen hat, als Sie annimmt. Sie kennt Ihre spezifische Verzeichnisstruktur nicht. Sie kennt nicht Ihre Coding-Standards.
Sie müssen den Kontext erklären. Bei jeder Konversation, von vorne. KI halluziniert, weil sie keine Informationsquelle hat und nicht weiß, wie Ihr Projekt aussieht.
Lösung: AGENTS.md
AGENTS.md ist eine Datei im Stammverzeichnis Ihres Projekts, die KI zu Beginn jeder Sitzung automatisch liest. Sie enthält alles, was die KI über das Projekt wissen muss.
Es enthält Informationen wie: - Drupal- und PHP-Versionen, - Verzeichnisstruktur (web/, docroot/, oder etwas anderes), - benutzerdefinierte Module und deren Prefixe, - Thema und seine Organisation, - Codierungsstandards (PHPStan, PHPCS), - Workflow (DDEV, Git, Composer), - Inhaltsarten, Entitäten, Drupal-Integrationen.
Hört sich nach viel Arbeit an? Um das zu vermeiden, haben wir ein einfaches Tool erstellt, das diese Datei automatisch generiert.
Wie unser AGENTS.md-Tool in der Praxis funktioniert
Der gesamte Prozess dauert etwa 5 Minuten:
- Laden Sie
AGENTS-TEMPLATE.mdaus dem Repository herunter (ein Curl-Befehl in README). - Kopieren Sie die Aufforderung aus README in Ihr KI-Werkzeug.
- Die KI scannt Ihr Projekt - überprüft composer.json, Konfiguration, Module, Theme.
- Sie erhalten eine fertige
AGENTS.md, die an Ihr Projekt angepasst ist.
Sie tun dies einmal und profitieren davon in jeder KI-Sitzung.
Das Tool funktioniert mit Assistenten wie: Cursor, Copilot, Claude Code, Codex, Aider, Gemini CLI, Roo Code, Zed, Devin - und wahrscheinlich anderen, die wir noch nicht getestet haben.
Repository: github.com/droptica/drupal-agents-md
Was ändert sich nach der Hinzufügung von AGENTS.md?
Ich werde nicht behaupten, dass "die Produktivität um 47% gestiegen ist", weil ich es nicht gemessen habe. Aber hier sind einige Dinge, die ich auf Projekten mit AGENTS.md bemerkt habe:
Die Einarbeitung neuer Leute ist mehrere Male schneller. Neue Entwickler müssen nicht fragen "Was sind die Konventionen?", "Wie heißt das Thema?", "Was verwenden Sie für den Cache?". Die KI weiß es bereits und schlägt entsprechend dem Projekt vor.
Debugging mit Kontext. Wenn Sie ein Problem melden, müssen Sie keine ausführliche Beschreibung der Architektur schreiben. Die KI weiß, dass Sie Absätze haben, dass Sie ein bestimmtes Modul für Warteschlangen verwenden, dass der Cache auf eine bestimmte Weise funktioniert.
Weniger Erklären, mehr Codieren. Anstatt jede Unterhaltung mit "wir verwenden DDEV, wir haben web/ als root, Modul-Präfixe sind xyz_" zu beginnen - schreiben Sie einfach, was Sie tun möchten. Dies verbessert die Entwicklungserfahrung in einer ähnlichen Weise, wie bessere Werkzeuge Content-Editing-Workflows verbessern.
Weniger Halluzinationen. Die KI erfindet keine Dinge, die nicht im Projekt sind. Sie weiß, was installiert ist, welche Entitäten existieren, welche Abhängigkeiten vorhanden sind - ähnlich wie KI-Module in Drupal den Projekt-Kontext verwenden, um Inhalte zu generieren.
3 Elemente von AGENTS.md, die wir immer noch verfeinern
Um es klar zu sagen, AGENTS.md ist nicht nur voller Superlative. Es gibt ein paar Dinge, an denen wir noch arbeiten:
- Große Projekte generieren große Dateien. Wenn Sie 50 benutzerdefinierte Module und eine komplexe Architektur haben, kann AGENTS.md umfangreich sein. Wir arbeiten daran, dass die KI nur das nimmt, was in einem gegebenen Kontext benötigt wird.
- Die Datei benötigt Updates bei größeren Änderungen. Sie fügen ein neues Modul hinzu, ändern die Struktur - es lohnt sich, die Datei zu regenerieren. Es ist nicht automatisch (noch nicht).
- Es hängt von der Organisation Ihres Projekts ab. Wenn Ihr Code chaotisch ist, wird AGENTS.md dieses Chaos dokumentieren. Die KI wird wissen, dass da ein Durcheinander ist, aber sie wird das Durcheinander selbst nicht beheben.
Was beinhaltet die fertige AGENTS.md-Vorlage?
Die Vorlage deckt die meisten Dinge ab, die in einem Drupal-Projekt wichtig sind:
- Umgebung: DDEV, Git-Workflow, Composer.
- Code-Standards: PHPStan, PHPCS, PHPUnit, Codeception, Xdebug.
- Entwicklung: Codierungsstandards, Entitäten, Module, Formulare, Datenbank.
- Modernes Drupal: kopfloses/API, SEO, mehrsprachig.
- Frontend: Themes, SCSS, JS/CSS-Optimierung, Caching.
- Operationen: Konfigurationsmanagement, Leistung und Website-Sicherheit, Fehlerbehebung, automatisierte Audits.
Wenn für Ihr Projekt etwas fehlt, können Sie Ihre eigenen Abschnitte hinzufügen. Es ist nur eine normale Markdown-Datei.
AGENTS.md-Tool - Zusammenfassung
In wenigen Minuten können Sie AGENTS.md zu Ihrem Drupal-Projekt hinzufügen und sofort den Unterschied in der Genauigkeit der KI-Vorschläge sehen.
Repository: github.com/droptica/drupal-agents-md
Und wenn Sie auf der Suche nach einer Drupal-Agentur sind, die Ihre Projektentwicklung mit den neuesten Technologien übernimmt, nehmen Sie Kontakt mit uns auf.
