Shopify droht Claude Code wegen einer Datei

In einem Repo mit Tausenden Entwicklern wandern Agent-Anweisungen den Verzeichnisbaum hinunter. Fehlt in einem Ordner die Brücke zu Claude Code, arbeitet ein Teil der Leute ohne denselben Kontext. Der Chef von Shopify nennt das eine Steuer, die niemand zahlen sollte.

Das Wichtigste in Kürze

Verwandt:Claude Code fährt jetzt auch Alibabas Qwen  /  Codex Micro: Agent-Steuerung am Schreibtisch

Was ist AGENTS.md? AGENTS.md ist eine Markdown-Datei im Repository. Sie gibt Coding-Agenten Build-Befehle, Tests, Konventionen und Grenzen mit, damit sie im Projekt nicht raten. Codex, Cursor, Copilot und Gemini CLI öffnen genau diesen Namen. Claude Code öffnet CLAUDE.md und zieht AGENTS.md nur über einen Import oder einen Symlink. Fehlt die Brücke in einem Unterordner, arbeitet ein Teil des Teams mit anderem Kontext.

Shopify macht aus einem Dateinamen eine Chefsache

Am 25. August 2026 schrieb Tobi Lütke auf X, er denke darüber nach, Claude Code bei Shopify zu verbannen, bis Anthropic AGENTS.md und den Ordner .agents/skills für geteilte Agent-Fähigkeiten mitlese. Wer nur CLAUDE.md einlese, erzeuge Split-Brain, sobald im selben Team verschiedene Werkzeuge laufen. Der Wortlaut bleibt Drohung. Ein firmenweites Verbot hat er nicht ausgesprochen.

Lütkes zweiter Post macht die rekursive Geltung im Monorepo zum eigentlichen Punkt. Agent-Dateien und Claude-Dateien gelten im ganzen Baum. In einem Monorepo mit Tausenden Entwicklern fehlt in einem Verzeichnis irgendwann eine der beiden. Dann arbeitet ein Teil der Leute mit einem Agenten, dem Lütke eine Lobotomie bescheinigt. Shopify flickt das laut Lütke mit Automatisierung. Lütke nennt den Preis eine dumme Komplexitätssteuer, die niemand zahlen sollte.

Die beiden Posts liegen offen: der erste Anstoß und Lütkes zweiter Post. Wer sie als Produktverriss liest, verfehlt den Punkt. Lütke greift die Datei an, die der Agent am Arbeitsplatz öffnet.

Der Baum vergibt zwei Wahrheiten

AGENTS.md ist die gemeinsame Anweisung für Coding-Agenten. Die Seite agents.md beschreibt sie als README für Agenten: Build, Tests, Konventionen, Grenzen. Codex, Cursor, Copilot und Gemini CLI suchen genau diesen Namen. OpenAI hatte das Format 2025 angeschoben.

Claude Code öffnet CLAUDE.md. Die Memory-Doku von Anthropic sagt das ohne Umweg: Claude Code liest CLAUDE.md. AGENTS.md kommt erst, wenn CLAUDE.md sie importiert oder ein Symlink beide Namen auf dieselbe Bytespur legt. Nested-Dateien in Unterordnern lädt Claude on demand, sobald dort Dateien gelesen werden. Beide Welten wandern denselben Baum hinunter. Sie tragen nur verschiedene Schilder.

Im flachen Projekt fällt das kaum auf. Im Monorepo schon. Ein Paketverzeichnis kann AGENTS.md tragen und CLAUDE.md schuldig bleiben. Der Codex-Nutzer im Nachbarraum bekommt die Testregel, der Claude-Nutzer bekommt sie nicht. Genau das meint Lütke mit Split-Brain: zwei Wahrheiten in einem Commit.

Die Tricks kennt Tobi schon

Unter dem ersten Post sammelten sich Symlink-Ratschläge und die Zeile in CLAUDE.md, die AGENTS.md einliest. Lütke antwortete, er kenne sie alle. Die Anthropic-Doku empfiehlt diese Brücke und erlaubt darunter Claude-eigene Hinweise. In einem Repo mit einer Wurzeldatei ist das eine Zeile Arbeit.

Der rekursive Fall bleibt: jedes Verzeichnis ist eine eigene Welt. Wer nur die Wurzel verdrahtet, lässt Pakete ohne Brücke.

Wer den Baum ernst nimmt, erzeugt die Brücke dort, wo AGENTS.md schon liegt. Ein Generator oder ein CI-Check pflanzt CLAUDE.md als Import oder als Verweis nach. Menschen, die Ordner zu Fuß ablaufen, skalieren das nicht. Lütke will die Automatisierung loswerden.

Anthropic verteidigt den eigenen Prompt

Thariq Shihipar von Claude Code antwortete Lütke öffentlich. Das Team arbeite daran, Claude Code hackbarer zu machen, inklusive leichterer Nutzung von AGENTS.md und anderer Eingriffe in den System-Prompt. Einen Termin nannte er nicht. Die Begründung lag beim Modell: Modellfamilien seien nicht austauschbar, der System-Prompt wirke stark auf die Leistung, Claude Code führe je Modell eigene Prompts.

Kurzfristig bleibt die dokumentierte Brücke. Wer AGENTS.md in CLAUDE.md importiert, zieht den gemeinsamen Text beim Start herein. Darunter dürfen Claude-spezifische Zeilen stehen. Skills, die nur Claude Code versteht, gehören in .claude. Die gemeinsame Wahrheit gehört nach AGENTS.md, sonst driftet sie beim nächsten Werkzeugwechsel.

Die Modell-Begründung erklärt, warum Anthropic den eigenen Dateinamen liebt. Sie erklärt nicht, warum der Datei-Lader von Claude Code den De-facto-Standard AGENTS.md ignoriert. Ein anderer Prompt kann in CLAUDE.md leben. Der Datei-Lader kann trotzdem AGENTS.md öffnen. Lütke zahlt die Steuer im Baum. Anthropic zahlt sie mit gesunkener Kompatibilität zum Rest der Agent-Welt.

Eine Datei führt, die Brücke folgt

Die Betriebsregel ist kurz. AGENTS.md trägt, was jedes Werkzeug braucht: Install, Test, Lint, Architekturgrenzen, Tabus. CLAUDE.md bleibt dünn: Import der gemeinsamen Datei, danach nur das, was Claude Code zusätzlich braucht. Persönliches bleibt in CLAUDE.local.md und außerhalb der Versionskontrolle. Wer nur Claude Code einsetzt, kommt mit CLAUDE.md aus. Der Mix im Team zwingt zur gemeinsamen Datei.

Für Unterordner gilt dieselbe Regel eine Ebene tiefer. Liegt in einem Paket AGENTS.md, liegt daneben eine Brücke. Die Prüfung gehört in die Pipeline, sonst wiederholt sich Lütkes Lobotomie bei jedem neuen Package. Der Mensch im Review sieht den fehlenden Zwilling zu spät, nämlich wenn der Agent schon falsch gebaut hat.

Shopify automatisiert das laut Lütke bereits. Anthropic könnte den Dateinamen lesen, den der Rest der Agent-Landschaft schon schreibt. Bis das passiert, bleibt die dünne Brücke der Preis für ein gemischtes Team. Die Chefsache von Lütke ist AGENTS.md. Wer ihren Inhalt zusätzlich in CLAUDE.md pflegt, hat den Streit schon verloren.

Häufige Fragen

Bildquelle: KI-generiert (August 2026)