Eine CLAUDE.md ist eine Datei mit Regeln und Hinweisen, die Claude beim Arbeiten automatisch bekommt, ohne dass jemand sie öffnen muss. Davon gibt es bei uns drei Sorten. Die Endnutzer-Container sind hier nicht dabei, die haben ihre eigenen Dateien.
Sie liegt unter ~/.claude/CLAUDE.md, also außerhalb aller Projekte, und existiert
genau einmal auf diesem Rechner. Sie ist vier Zeilen lang und enthält nichts weiter als die
Anweisung, unsere Konventionen nachzuladen.
Wann kommt sie an: bei jedem Start, in jedem Projekt, egal woran gearbeitet wird.
Sie liegt oben im Plattform-Ordner, also lina4-platform/CLAUDE.md, und ist
36 Zeilen lang. Darin stehen die Fallen dieses Projekts, vor allem der Unterschied zwischen
unserer Admin-Welt und der Welt der Endnutzer-Container.
Es ist EINE Datei für alle Arbeitsplätze. Jeder Arbeitsplatz hat eine Kopie davon, und die bleiben nur deshalb gleich, weil sie über main zusammengeführt werden.
Wann kommt sie an: bei jedem Start einer Sitzung, die in irgendeinem Ordner dieses Projekts sitzt. Auch nach einem Zusammenfassen des Gesprächs bleibt sie erhalten.
Drei Bereiche haben zusätzlich eine eigene: web/CLAUDE.md für die Website,
lina-app/CLAUDE.md für die App und lina-pocket/CLAUDE.md für Pocket.
Darin steht nur, was diesen einen Bereich angeht: wie man ihn lokal startet, wohin er
ausgeliefert wird, worauf beim Bauen zu achten ist.
Wann kommt sie an, an einem Beispiel: Öffne ich die Datei web/app/main.py, um
hineinzusehen, dann bekomme ich im selben Moment web/CLAUDE.md dazu. Arbeite ich in
derselben Sitzung nur an Dateien unter infra/, sehe ich sie nie.
Auslösen tut das nur echtes Öffnen einer Datei. Wenn ich bloß nach einem Wort suche oder eine Datei ungelesen überschreibe, kommt die Bereichs-Datei nicht. Sitzt die Sitzung von Anfang an im Ordner des Bereichs, ist sie schon beim Start da. Und nach einem Zusammenfassen des Gesprächs kommt sie nicht noch einmal, anders als die Projekt-Datei.
Der Haken, gemessen am 19.08.2026: Öffnen heißt hier das Lese-Werkzeug. Im
Auto-Modus wird aber gar nicht damit geöffnet, sondern über die Kommandozeile gelesen und
geschrieben, weil der Modus genau das vorschreibt. Fünf Testläufe im normalen Modus bekamen die
Regel jedes Mal, fünf im Auto-Modus kein einziges Mal. Das trifft die Bereichs-Dateien genauso wie
die Regeln unter .claude/rules/. Beim ANLEGEN einer neuen Datei kommt in keinem Modus
etwas an.
lina4-platform auf main, nie aus dem
Arbeitsplatz, in dem die Sitzung gerade sitzt. Folge: eine Änderung an den Konventionen wirkt
erst, wenn sie nach main zusammengeführt ist. Vorher merkt keine Sitzung etwas davon.| Arbeitsplatz | Welche Bereichs-Datei | Wie er auf den neuesten Stand kommt | Stand heute |
|---|---|---|---|
| lina4-platform-area Bereich platform |
keine eigene. Die Ordner web und lina-app liegen auch hier; wird dort eine Datei geöffnet, kommt deren Bereichs-Datei mit | Bei jedem Sitzungsstart wird main automatisch hereingeholt, aber nur wenn nichts Ungespeichertes herumliegt und es keinen Konflikt gibt. Sonst meldet er es nur. | aktuell |
| lina4-web Bereich web |
web/CLAUDE.md | Gleicher Weg: main kommt beim Sitzungsstart automatisch herein. | 14 Änderungen im Rückstand, holt sie beim nächsten Start selbst |
| lina4-cockpit Bereich cockpit |
web/CLAUDE.md, weil die Steuerkonsole im Ordner web liegt | Gleicher Weg: main kommt beim Sitzungsstart automatisch herein. | aktuell |
| lina-app-dev Bereich lina-app |
lina-app/CLAUDE.md | Gleicher Weg: main kommt beim Sitzungsstart automatisch herein. | aktuell |
| lina4-webchat Bereich pocket |
lina-pocket/CLAUDE.md | Holt main genauso herein wie alle anderen. Nur der Rückweg fehlt: Pocket wird nie nach main zusammengeführt, seine eigenen Dateien bleiben dort. | aktuell |
| lina4-platform Haupt-Ordner |
keine eigene, sonst wie oben | Er IST main. Hier wird nichts hereingeholt, hier wird zusammengeführt: erst dadurch erreichen die Änderungen eines Bereichs alle anderen. | aktuell |
In jeder Sitzung ihres eigenen Bereichs kam die Bereichs-Datei tatsächlich an: Website 97 von 119 Sitzungen, Steuerkonsole 52 von 69, App 191 von 241, Pocket 17 von 19. Im platform-Arbeitsplatz kamen die fremden Bereichs-Dateien 56 und 25 mal in 252 Sitzungen vor, im Haupt-Ordner 125 und 31 mal in 882.
Die Bereichs-Dateien sind kein Nebenschauplatz: in ihrem eigenen Bereich kommen sie in vier von fünf Sitzungen an. Trotzdem tauchen sie in unserer Regel-Doku bis heute nicht auf, dort stehen nur die persönliche und die Projekt-Datei. Eine Regel, die nur einen Bereich angeht, hat also eine Heimat, die wir bisher nicht mitgedacht haben.
Neben den CLAUDE.md-Dateien gibt es einen vierten Weg, der nach demselben Muster
zündet: die Regeln unter .claude/rules/, die an bestimmte Ordner oder Dateitypen
gebunden sind. Die kommen sogar häufiger zum Zug als die Bereichs-Dateien.
Seit dem 19.08.2026 leben diese Regeln nur noch im Repo. Vorher lagen sie zusätzlich
im persönlichen Ordner ~/.claude/rules/ und kamen dadurch doppelt an, in fremden
Projekten wie tic-tac-toe oder distilltube sogar ungewollt. Ein Doctor-Check meldet es, falls sie
dort wieder auftauchen.