I Deleted the Viral CLAUDE.md File. My Code Got Better.
Zusammenfassung
Kurz
Der Autor berichtet, dass allgemeine Leitlinien in seiner dreitägigen? dreitägigen Korrektur: dreiwöchigen Nutzung bei einfachen Aufgaben Rückfragen auslösten und in zwei Fällen mit der Projektarchitektur kollidierten. Nach dem Wechsel zu projektspezifischen Anleitungen meldet er für zwölf Pull Requests weniger Rückfragen und bessere Erstabnahmen; dies sind Selbstauswertungen aus vier Repositories, kein kontrollierter Vergleich.
Mittel
Der Autor berichtet, dass er die virale, vier allgemeine Leitlinien umfassende `CLAUDE.md` drei Wochen lang in vier Repositories verwendete und danach durch kürzere, projektspezifische Anleitungen ersetzte. Die Regel, stets nachzufragen, habe bei einfachen Aufgaben unnötige Rückfragerunden erzeugt. Die Vorgabe, die einfachste Lösung zu wählen, habe in zwei Fällen mit dem bewusst eingesetzten Repository-Muster kollidiert und zu direkten Datenbankabfragen geführt. Außerdem fehlten der allgemeinen Datei konkrete Projektinformationen wie Befehle, Architektur, Zuständigkeiten und geschützte Altmodule.
Für die folgenden zwölf Pull Requests gibt der Autor rund 40 Prozent weniger Rückfragerunden, keine weiteren beschriebenen Architekturumbauten und eine Zunahme der beim ersten Review akzeptierten PRs von etwa sieben auf zehn an. Er folgert, dass allgemeine Prinzipien als Orientierung nützlich sein können, aber eine CLAUDE.md zusätzlich konkrete, überprüfbare Projektregeln enthalten sollte. Seine Empfehlung: eine knappe Anleitung aus dem jeweiligen Repository ableiten und auf Befehle, Architektur und Konventionen konzentrieren. Die Zahlen stammen aus seiner eigenen Auswertung; ein kontrollierter Vergleich wird nicht beschrieben und andere Einflussfaktoren sind nicht ausgeschlossen.
Ausführlich lesen
Der Autor berichtet von einem dreiwöchigen Praxiseinsatz der vielverbreiteten `CLAUDE.md` mit vier allgemeinen Leitlinien für Claude Code: nachfragen statt annehmen, zuerst die einfachste Lösung wählen, nicht betroffenen Code unangetastet lassen und Unsicherheit kenntlich machen. Er nutzte die Datei in vier Repositories mit unterschiedlichen Technologien und verglich anschließend die nächsten zwölf Pull Requests mit einer angepassten Anleitung. Seiner Darstellung nach ist die virale Datei ein brauchbarer philosophischer Ausgangspunkt, aber keine projektspezifische Arbeitsanweisung.
Als wiederkehrendes Problem beschreibt der Autor, dass die Regel „nachfragen statt annehmen“ selbst bei seiner Einschätzung nach eindeutigen Kleinigkeiten Rückfragen auslöste. Als Beispiel nennt er eine Variablenumbenennung: Die Aufgabe habe mit der allgemeinen Datei samt Rückfragerunde etwa 90 statt zuvor 40 Sekunden gedauert. Er bewertet die Regel deshalb als hilfreich bei mehrdeutigen oder folgenreichen Änderungen, aber als unnötigen Aufwand bei vielen offensichtlichen Aufgaben.
Zudem habe die Vorgabe, zuerst die einfachste Lösung zu suchen, nicht immer zur bestehenden Architektur seiner Projekte gepasst. Er führt zwei Fälle an, in denen Claude Aufrufe über das Repository-Muster durch direkte Datenbankabfragen ersetzt habe. Das sei zwar einfacher zu schreiben gewesen, aber nach seiner Einschätzung weder wartbarer noch konsistent mit dem übrigen Code. Er betont, dass er dies als Folge einer allgemeinen Regel ohne ausreichend projektspezifischen Kontext versteht, nicht als Beweis, dass das Prinzip grundsätzlich falsch sei.
Der Autor bemängelt außerdem, dass die generische Datei keine konkreten Test- und Lint-Befehle, Ordnerzuständigkeiten, Architekturvorgaben oder Hinweise zu geschützten Altmodulen enthalte. Nach seiner Schätzung deckten die allgemeinen Regeln nur rund 30 Prozent dessen ab, was seine Anleitung leisten sollte. Er entfernte die Datei aus den vier Repositories und erstellte jeweils eine unter 60 Zeilen lange, aus ` /init` abgeleitete und gekürzte Projektanleitung. Diese enthielt unter anderem Befehle, Architektur- und Konventionsregeln sowie die Vorgabe, vor neuen Abhängigkeiten zu fragen.
Für die folgenden zwölf Pull Requests meldet er rund 40 Prozent weniger Rückfragerunden, keine weiteren Fälle des beschriebenen Architekturumbaus und einen Anstieg der beim ersten Review akzeptierten PRs von ungefähr sieben auf zehn. Daraus leitet er ab, dass die allgemeine Datei und eine konkrete Projektspezifikation unterschiedliche Aufgaben erfüllen: Die erste könne gemeinsame Grundsätze vermitteln, die zweite müsse das jeweilige Projekt beschreiben. Er empfiehlt, eine Anleitung aus dem tatsächlichen Repository abzuleiten und auf überprüfbare Befehle, Architekturregeln und Konventionen zu beschränken. Als mögliche Entwicklung vermutet er zwei Ebenen, eine organisationsweite Philosophie und eine projektspezifische Spezifikation.
Die Ergebnisse sind die Selbstauswertung des Autors zu vier eigenen Repositories und zwölf Pull Requests. Im Bericht wird kein kontrollierter Vergleich beschrieben, der andere Einflussfaktoren ausschließt; die genannten Effekte und Prozentangaben sind daher als seine Beobachtungen und Einschätzungen zu verstehen. Der Autor sagt ausdrücklich, keine der beiden Varianten sei generell besser, sondern sie lösten verschiedene Probleme.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Bewertet wurde die Zusammenfassung 'mittel', weil sie den Bericht vollständiger wiedergibt. Die Fassung 'kurz' enthält einen unbereinigten Fehler ('dreitägigen? dreitägigen Korrektur: dreiwöchigen'), der die Dauer falsch nennt, und ist deshalb schwächer.
Im Bericht, aber nicht in der Zusammenfassung
- Entstehung des viralen Files: Forrest Chang bündelte vier Beobachtungen Karpathys in eine 70-zeilige CLAUDE.md, die über 144.000 Sterne erreichte und 28 Tage auf Platz 1 von GitHub Trending stand
- Konkretes Beispiel: Umbenennung einer Variable, 40 Sekunden ohne die Datei gegenüber 90 Sekunden mit Rückfragerunde
- Die im Abschnitt 'The Math' genannten Effizienzwerte von etwa 30 % und 90 % sind unbelegte Schätzungen des Autors
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Vorfälle melden
- SF-M4 Wie kommen Meldungen von Laboren, Betreibern und Nutzern schnell und geschützt zu den Stellen, die handeln müssen, auch über Grenzen hinweg?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 100 %kein Bezug
- amos 45 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
Fähigkeiten messen
- SF-F4 Für welche Modelle, Entwickler und Einsätze gelten Prüfregeln, und wann muss neu geprüft werden?
- clef 100 %kein Bezug
- Luna 40 %Hintergrund, keine Belege
- JEV 30 %nur am Rande erwähnt
- amos 40 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
Unabhängig prüfen
- SF-P3 Woran erkennt man, dass ein Labor sich ehrlich selbst überwacht und dass seine Prüfungen gültig sind?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 100 %kein Bezug
- amos 42 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 42 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
Tempo und Grenzen
- SF-T1 Welche messbaren Schwellen sollen eine Pause auslösen, und wer prüft sie?
- clef 100 %kein Bezug
- Luna 32 %Hintergrund, keine Belege
- JEV 29 %gleiches Oberthema, hilft nicht
- amos 100 %kein Bezug
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- SF-T3 Woran erkennt man, dass KI beginnt, ihre eigene Weiterentwicklung voranzutreiben, und wer darf das erlauben?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 100 %kein Bezug
- amos 46 %gleiches Oberthema, hilft nicht
- SubQ 53 %gleiches Oberthema, hilft nicht
- drex 60 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
Vertrauen in Modelle
- SF-V1 Was zählt als Beleg für die Werte eines Modells, wenn sein sichtbares Denken und seine Selbstauskünfte allein nicht genügen?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 24 %einzelne zitierbare Belege
- amos 37 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 45 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
- SF-V3 Halten die Werte eines Modells, wenn niemand zusieht oder die Lage neu ist?
- clef 100 %kein Bezug
- Luna 46 %einzelne zitierbare Belege
- JEV 24 %einzelne zitierbare Belege
- amos 29 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 58 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
- Haiku-Prüfung gleiches Oberthema, hilft nicht
- SF-V4 Was für ein Wesen ist ein Modell, und was folgt daraus für den Umgang mit ihm und für den Wert des Menschseins?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 100 %kein Bezug
- amos 48 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- SF-V5 Was soll heute für das Verhalten und den Betrieb von Modellen gelten?
- clef 100 %kein Bezug
- Luna 38 %einzelne zitierbare Belege
- JEV 41 %beantwortet teilweise oder widerspricht
- amos 22 %einzelne zitierbare Belege
- SubQ 100 %kein Bezug
- drex 33 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
- Haiku-Prüfung Hintergrund, keine Belege
Agenten und vernetzte Systeme
- SF-A1 Welche Befugnisse darf ein KI-Agent haben, also eine KI, die selbstständig mit Werkzeugen handelt? Wer entzieht sie ihm, und wie prüft man, dass er in seinem Auftrag bleibt?
- clef 100 %kein Bezug
- Luna 26 %einzelne zitierbare Belege
- JEV 34 %einzelne zitierbare Belege
- amos 27 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 46 %gleiches Oberthema, hilft nicht
- Haiku-Prüfung Hintergrund, keine Belege
Offenlegung und Rechenschaft
- SF-O2 Was sollten Regierungen, Labore und Prüfer über ihre Gespräche, Zusagen, Prüfungen und Eingriffe offenlegen?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 100 %kein Bezug
- amos 100 %kein Bezug
- SubQ 100 %kein Bezug
- drex 45 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
Beteiligung und Gemeinwohl
- SF-E4 Wie bleibt KI ein gemeinsames Gut, statt Abhängigkeit und Marktmacht zu vertiefen?
- clef 100 %kein Bezug
- Luna 46 %gleiches Oberthema, hilft nicht
- JEV 100 %kein Bezug
- amos 100 %kein Bezug
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- SF-E5 Welche Mitsprache haben die Menschen, die mit KI leben, bei Tempo und Grenzen, und welche Entscheidungen müssen bei ihnen bleiben?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 36 %umfangreiche Belege
- amos 50 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
Weitere Berichte zu diesen Fragen
- Für welche Modelle, Entwickler und Einsätze gelten Prüfregeln, und wann muss neu geprüft werden?
- Welche messbaren Schwellen sollen eine Pause auslösen, und wer prüft sie?
- Was zählt als Beleg für die Werte eines Modells, wenn sein sichtbares Denken und seine Selbstauskünfte allein nicht genügen?
- Halten die Werte eines Modells, wenn niemand zusieht oder die Lage neu ist?
- Was soll heute für das Verhalten und den Betrieb von Modellen gelten?
- Welche Befugnisse darf ein KI-Agent haben, also eine KI, die selbstständig mit Werkzeugen handelt? Wer entzieht sie ihm, und wie prüft man, dass er in seinem Auftrag bleibt?
- Welche Mitsprache haben die Menschen, die mit KI leben, bei Tempo und Grenzen, und welche Entscheidungen müssen bei ihnen bleiben?
- Alle Berichte im Archiv