Welche CLAUDE.md wo ankommt

Stand 17.08.2026, korrigierte Fassung. Die Container-Welt ist bewusst nicht dabei. Wichtig zur Herkunft: gezaehlt werden konnten nur die Bereichs-Dateien, weil nur sie im Mitschnitt protokolliert werden. Dass die persoenliche und die Projekt-Datei laden, ist mit Wegwerf-Sitzungen nachgestellt und durch die Anthropic-Doku belegt, nicht gezaehlt.

Drei Ebenen, mehr gibt es nicht

1. Deine persoenliche

~/.claude/CLAUDE.md

Liegt ausserhalb des Repos, existiert genau einmal auf dieser Maschine. Vier Zeilen, und ihr ganzer Inhalt ist ein Verweis: sie holt CONVENTIONS.md aus dem Haupt-Checkout.

laedt in JEDER Sitzung, ueberall

2. Die des Projekts

CLAUDE.md (Repo-Wurzel)

36 Zeilen. Eine Datei fuer alle Worktrees, sie kommt ueber main zu jedem. Inhalt: die Fallen dieses Repos, vor allem die zwei Welten Admin und Container.

laedt in jeder Sitzung dieses Repos

3. Die des Bereichs

web/CLAUDE.md
lina-app/CLAUDE.md
lina-pocket/CLAUDE.md

Eigene Dateien mit eigenem Inhalt, je eine pro Bereich. Sie tragen keine allgemeinen Regeln, nur die Eigenheiten des Bereichs und Wegweiser. Gemessen: sie laden NUR, wenn eine Datei aus dem Ordner mit dem Lese-Werkzeug geoeffnet wird. Eine Textsuche loest sie nicht aus, Schreiben auch nicht. Sitzt die Sitzung von Anfang an in dem Ordner, sind sie schon beim Start da. Nach einem Zusammenfassen des Gespraechs kommen sie nicht erneut.

laedt beim Lesen einer Datei aus diesem Ordner

Die Kette, wenn eine Sitzung startet

Wichtig an Schritt zwei: die Konventionen kommen immer aus dem Haupt-Checkout auf main, nie aus dem Worktree, in dem die Sitzung sitzt. Eine Aenderung an CONVENTIONS wirkt also erst nach dem Merge nach main.

Welcher Arbeitsplatz was bekommt

Worktree (Bereich)	persoenliche	Repo-CLAUDE.md	Bereichs-Datei	gemessen
lina4-platform-area (platform)	ja	ja	keine eigene, aber web/ und lina-app/ liegen auch hier und laden beim Lesen	56 bzw. 25 von 252 Sitzungen
lina4-web (web)	ja	ja	web/CLAUDE.md	97 von 119 Sitzungen
lina4-cockpit (cockpit)	ja	ja	web/CLAUDE.md, weil das Cockpit in web/app/ liegt	52 von 69 Sitzungen
lina-app-dev (lina-app)	ja	ja	lina-app/CLAUDE.md	191 von 241 Sitzungen
lina4-webchat (pocket)	ja	ja, aeltere Fassung	lina-pocket/CLAUDE.md	17 von 19 Sitzungen
lina4-platform (Haupt-Checkout, nur Merge)	ja	ja	keine eigene, aber web/ und lina-app/ liegen auch hier und laden beim Lesen	125 bzw. 31 von 882 Sitzungen

Was daraus folgt

Die Bereichs-Dateien kommen in ihrem eigenen Bereich fast immer an, sie sind also ein echter Wirkort und keine Randnotiz. In unserer Regel-Doku fehlen sie bis heute: dort stehen nur die persoenliche und die Projekt-Datei.

Neben diesen Dateien gibt es einen vierten, haeufiger zuendenden Weg: die path-scoped Regeln unter .claude/rules/. Sie laden nach demselben Muster wie die Bereichs-Dateien, kommen aber oefter zum Zug.

Gleichstand zwischen den Arbeitsplaetzen entsteht ausschliesslich durch Merges nach main, nicht durch Kopien. Deshalb hat webchat gerade eine aeltere Fassung der Repo-Datei: der Branch hat main noch nicht nachgezogen.