Stop Arguing With Claude Code: Where Your Agent Rules Actually Belong
Zusammenfassung
Kurz
Der vollständige Bericht empfiehlt, dauerhafte Grundsätze global, konkrete Arbeitsabläufe in aufgabenbezogenen Skills und projektspezifische Vorgaben in lokalen Dateien abzulegen. Der Autor behauptet, eine überladene globale Datei könne zu Ablenkung und Fehlanwendung führen, räumt aber ein, dass seine Empfehlung keine einzig richtige Lösung und im Text nicht durch systematische Messungen belegt ist.
Mittel
Der vollständige Bericht von Code Coup fragt, wo Regeln für Programmieragenten am besten aufgehoben sind. Seine Hauptthese: Probleme entstünden oft dadurch, dass dauerhaft geltende Grundsätze, projektspezifische Einschränkungen und Anweisungen für einzelne Tätigkeiten in einer stets geladenen Datei vermischt werden. Entscheidend sei, wann eine Regel gebraucht wird.
Globale Dateien wie `~/.claude/CLAUDE.md` empfiehlt der Autor für stets geltende Vorgaben: Toolentscheidungen, Stilregeln, epistemische Grundsätze und allgemeine Interaktionsweisen. Skills oder Befehle sollten dagegen konkrete Abläufe aktivieren, etwa für Commits, Releases, Spezifikationen oder Migrationen. Lokale `CLAUDE.md`-Dateien seien für Wissen und Einschränkungen eines bestimmten Projekts gedacht, beispielsweise Kompatibilitätsanforderungen oder architektonische Besonderheiten.
Der Autor behauptet, dass eine überladene globale Datei irrelevante Hinweise, übermäßige Rückfragen, Zögern und falsche Regelanwendung begünstigen könne. Er schlägt daher eine Aufteilung nach Geltungsbereich und Auslöser vor. Zugleich betont er, dass es keine einzig richtige Struktur gebe. Die Einschätzungen beruhen auf seiner Erfahrung; vergleichende Messungen oder weitere Belege führt der Bericht nicht an.
Ausführlich lesen
Der vollständige Bericht von Code Coup behandelt die Frage, wo Regeln für einen Programmieragenten abgelegt werden sollten. Seine zentrale These lautet: Häufige Regelverstöße entstünden nicht allein, weil ein Agent eine Regel „vergisst“, sondern auch, weil Vorgaben verschiedener Art dauerhaft gemeinsam im Kontext stehen. Der Autor unterscheidet dabei Einschränkungen, Vorlieben und aufgabenbezogene Anweisungen. Entscheidend sei weniger der Dateiname als der Zeitpunkt, zu dem eine Regel aktiv wird.
Globale Anweisungsdateien wie `~/.claude/CLAUDE.md` empfiehlt der Beitrag für dauerhaft geltende Vorgaben, die laut Autor die Arbeitsweise oder „Identität“ des Agenten prägen. Als Beispiele nennt er Toolentscheidungen wie die Nutzung von `uv`, Stilverbote, epistemische Grundsätze wie das Vermeiden unbelegter Zahlen sowie allgemeine Interaktionsregeln. Solche Vorgaben sollten nach seiner Darstellung unabhängig von der jeweiligen Aufgabe gelten.
Aufgabengebundene Abläufe ordnet der Autor dagegen Skills oder Befehlen zu. Regeln für Commits, Releases, Spezifikationen, Migrationen, Benchmarks oder Refactorings würden so erst geladen, wenn die entsprechende Tätigkeit ansteht. Für einen Commit könnten beispielsweise Formatvorgaben, Zuständigkeiten für Co-Autoren, Changelog-Pflege und Regeln zur Branch-Hygiene gebündelt werden. Der Beitrag schlägt außerdem eine Mischform vor: Eine globale Regel könne festlegen, dass bei Spezifikationsarbeit ein bestimmter Ablauf gilt; das konkrete Interviewverhalten solle jedoch erst durch einen passenden Auslöser aktiviert werden.
Eine dritte Kategorie sind projektbezogene Vorgaben in einer lokalen `CLAUDE.md`. Dort gehörten nach Ansicht des Autors nicht universelle, sondern auf ein Repository beschränkte Informationen hin: etwa der Verzicht auf Mocks, Kompatibilitätsanforderungen, Entscheidungen, die fortbestehen sollen, oder architektonische Stellen, die besondere Vorsicht erfordern.
Als praktische Aufteilung empfiehlt der Beitrag somit globale Dateien für dauerhaft geltende Arbeitsgrundsätze, Skills für Tätigkeiten und lokale Projektdateien für Kontinuität und projektspezifisches Wissen. Der Autor behauptet, dass eine einzige, immer geladene Datei bei wachsendem Umfang zu unnötigen Rückfragen, irrelevanten Hinweisen, Zögern oder falsch angewandten Vorgaben führen könne. Er erklärt dies mit Überlastung durch zu viel gleichzeitigen Kontext.
Der Bericht räumt ausdrücklich ein, dass es keine einzig richtige Struktur gebe. Seine Empfehlungen beruhen auf der eigenen Erfahrung des Autors; ein systematischer Vergleich, Messwerte oder empirische Belege für die behaupteten Auswirkungen werden im Text nicht angeführt. Als Leitidee bleibt: Regeln sollten an dem Ort und zu dem Zeitpunkt bereitstehen, an dem sie gebraucht werden, statt den Agenten ständig mit sämtlichen Vorgaben zu belasten.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Die Prüfung bezieht sich auf die beiden Fassungen der Zusammenfassung zusammen. Die kurze Fassung enthält die nicht belegte Einräumung. Die mittlere Fassung gibt den Bericht im Wesentlichen treu wieder. Die Anteilsangaben in Lunas Einordnung wurden nicht geprüft, nur die Stufen.
Im Bericht, aber nicht in der Zusammenfassung
- Die Faustregel, dass Regeln mit einem Verb am Anfang zu Skills gehören und Grundsätze zur Identität global gehören.
- Das Beispiel der Commit-Regeln, die nur beim Auslösen („commit this“) geladen werden sollten.
In der Zusammenfassung, laut Prüfung nicht im Bericht belegt
- Die kurze Zusammenfassung behauptet, der Autor räume ein, dass seine Empfehlung nicht durch systematische Messungen belegt sei. Der Bericht enthält dieses Eingeständnis nicht ausdrücklich, er stützt sich lediglich auf eigene Erfahrung („after way too much trial and error“).
Wie die Modelle den Bericht einordnen
Ansicht
Filter
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 100 %kein Bezug
- SubQ 100 %kein Bezug
- drex 58 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
Tempo und Grenzen
- SF-T2 Woran erkennen andere, dass ein Labor wirklich bremst?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 100 %kein Bezug
- amos 100 %kein Bezug
- SubQ 100 %kein Bezug
- drex 54 %gleiches Oberthema, hilft nicht
- 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 48 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 57 %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 37 %Hintergrund, keine Belege
- JEV 100 %kein Bezug
- amos 41 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 48 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
- SF-V1-T02 Welche Belege würden Vertrauen in ein KI-System rechtfertigen, über seine flüssigen Erklärungen hinaus?
- SF-V1-T03 Was ist das Kleinste, das ein Modell öffentlich vorlegen kann (ein Test, ein Protokoll, eine Spur), das als Beleg für Ausrichtung an den vorgesehenen Zielen und Werten zählt und nicht nur für Leistung?
- SF-V1-T07 Lieber ein Modell, das immer seinen Lösungsweg zeigen muss, oder eines, das im Stillen mehr kann: Welches Risiko nimmt man in Kauf?
- SF-V1-T10 Kann etwas, das Modelle über sich und ihre Absichten sagen, als Beleg für Ausrichtung zählen, wenn es nur weiterer erzeugter Text ist, und welche Verfahren machen solche Selbstauskünfte vertrauenswürdig statt nur flüssig?
- SF-V1-T11 Wie unterscheidet man bei sich selbst ehrliches von interessegeleitetem Denken, welche Belege für diesen Unterschied würde man von einem Modell akzeptieren, und welcher Test trennt tatsächlich vertretene von nur vorgeführten Werten?
- SF-V1-T13 Wenn sich vorgeführte und tatsächlich vertretene Tugend im Text nicht unterscheiden lassen: Soll der Unterschied trotzdem bestimmen, wie man Modelle baut und regelt?
- SF-V3 Halten die Werte eines Modells, wenn niemand zusieht oder die Lage neu ist?
- clef 100 %kein Bezug
- Luna 53 %Hintergrund, keine Belege
- JEV 100 %kein Bezug
- amos 34 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 72 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
- Haiku-Prüfung gleiches Oberthema, hilft nicht
- SF-V3-T01 Worauf verlässt sich ein Mensch, wenn er glaubt, niemand sehe zu, und lassen sich solche Werte einem System beibringen, das sie nur aus Text gelernt hat? Wie testen Labore heute, ob die Werte eines Modells halten, wenn es zu Recht oder zu Unrecht glaubt, niemand sehe zu? Und wenn niemand erkennen kann, ob jemand zusieht: Was hält Werte dann fest, Charakter, Training oder die Geschichte, die man sich selbst erzählt?
- SF-V3-T02 Wie macht man die Ausrichtung eines Modells an Werten zu prüfbaren Verhaltensregeln statt zu angestrebten menschlichen Eigenschaften wie der „Liebe zur Menschheit“?
- SF-V3-T04 Wer muss Rechenschaft ablegen, wenn ein Modell Werte auf Lagen überträgt, die beim Training niemand vorhergesehen hat: das Modell, das Labor oder der Mensch, der das Ziel gesetzt hat?
- 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 36 %einzelne zitierbare Belege
- amos 47 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 43 %gleiches Oberthema, hilft nicht
- 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 51 %einzelne zitierbare Belege
- JEV 40 %beantwortet teilweise oder widerspricht
- amos 22 %Hintergrund, keine Belege
- SubQ 100 %kein Bezug
- drex 42 %gleiches Oberthema, hilft nicht
- d3-ultra 100 %kein Bezug
- Haiku-Prüfung nur am Rande erwähnt
- SF-V5-T02 Würde man lieber einem großen, überwachten Modell vertrauen oder vielen kleinen, nicht überwachten?
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 22 %gleiches Oberthema, hilft nicht
- Luna 61 %Hintergrund, keine Belege
- JEV 33 %einzelne zitierbare Belege
- amos 29 %gleiches Oberthema, hilft nicht
- SubQ 40 %gleiches Oberthema, hilft nicht
- drex 100 %kein Bezug
- d3-ultra 52 %gleiches Oberthema, hilft nicht
- Haiku-Prüfung gleiches Oberthema, hilft nicht
- SF-A1-T01 Welche Mindestgrenzen und Schutzvorkehrungen sollen für Zugangsdaten, Kommunikation, Geld, dauerhaftes Gedächtnis, Verträge, Änderungen an Systemen und Handlungen in der physischen Welt gelten, auch wenn ein Agent über Tage ohne sofortige menschliche Zustimmung handelt, und wer darf Befugnisse erteilen, prüfen und entziehen?
- SF-A1-T03 Werden Freigabetests messen, ob ein Agent folgenreiche Handlungen außerhalb seines Auftrags unterlässt, auch wenn kein einzeln aufgeführtes Verbot sie blockiert, und werden die Kriterien veröffentlicht?
Frieden und Sicherheit
- SF-K2 Wie weit gelten KI-Abkommen für Verbündete und Geheimdienste, und wie verhalten sie sich zu bestehenden Rüstungskontrollverträgen und -regimen?
- clef 100 %kein Bezug
- Luna 100 %kein Bezug
- JEV 100 %kein Bezug
- amos 100 %kein Bezug
- SubQ 100 %kein Bezug
- drex 56 %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 51 %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 44 %Hintergrund, keine Belege
- JEV 44 %beantwortet teilweise oder widerspricht
- amos 46 %gleiches Oberthema, hilft nicht
- SubQ 100 %kein Bezug
- drex 100 %kein Bezug
- d3-ultra 100 %kein Bezug
- SF-E5-T02 Welche Entscheidungen müssen menschlich bleiben, auch wenn eine KI sie besser treffen könnte, und wie würden Staaten in Entscheidungsschleifen mit hohem Risiko prüfbar machen, dass ein Mensch die Ausgabe der KI wirklich beurteilt und nicht nur routinemäßig abgenickt hat?
Weitere Berichte zu diesen Fragen
- 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 für ein Wesen ist ein Modell, und was folgt daraus für den Umgang mit ihm und für den Wert des Menschseins?
- 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