Die eine Datei, die Claude zum Mitarbeiter macht

Claude Code liest beim Start jede Datei namens CLAUDE.md im Ordner, in dem er arbeitet. Alles, was darin steht, gilt für die ganze Sitzung: wie ihr schreibt, was er nicht anfassen darf, wo Dinge liegen. Es ist der Unterschied zwischen einem Praktikanten am ersten Tag und einem Kollegen im dritten Jahr. In meiner Firma hat jedes Projekt eine, dazu eine persönliche, die überall gilt.

Lege die Datei an

Im Ordner, in dem Claude arbeiten soll, eine Datei CLAUDE.md erstellen. Reines Markdown, keine Formatvorgaben. Claude Code kann sie dir auch selbst anlegen:

Kopieren/init

Der Befehl schaut sich den Ordner an und schreibt einen ersten Entwurf. Den nimmst du als Rohfassung, nicht als Ergebnis.

Schreib rein, wer ihr seid und wie ihr arbeitet

Die wichtigsten Zeilen sind die, die ein neuer Mitarbeiter sonst in Woche eins lernt. Kurz, konkret, in Regeln:

Kopieren# Nordloom, Automatisierungsprojekt Kunde Müller

- Antworte auf Deutsch, Fachbegriffe bleiben englisch.
- Secrets liegen in Passbolt, nie im Code, nie im Chat.
- Nichts pushen ohne Rückfrage. Antwort endet mit: Push? (Y/N)
- Kundendaten liegen in `daten/`, werden gelesen, nie verändert.

Jede Regel ist ein Satz mit Verb. Keine Absichtserklärungen, keine Werte, nur das, was Claude tun oder lassen soll.

Nenne die Orte

Claude sucht sonst. Sag ihm, wo was liegt:

Kopieren## Struktur
- `src/` Code, `docs/` Entscheidungen, `scripts/verify.sh` die Prüfung vor jedem Fertig.
- Kundenkontext in `docs/kunde.md`, zuerst lesen.

Ein Verweis auf eine Datei ist besser als deren Inhalt zu kopieren. Die Datei ändert sich, die CLAUDE.md bleibt kurz.

Sag, woran du „fertig“ erkennst

Der größte Hebel. Ohne Prüfung meldet Claude Erfolg, wenn er glaubt, fertig zu sein. Mit Prüfung erst, wenn sie grün ist:

Kopieren## Fertig heißt
Kein Feature ist fertig ohne ausgeführten Check. `scripts/verify.sh` muss grün sein,
Beleg ist die Ausgabe. Nie Erfolg behaupten.

Für ein Skript-Projekt reicht „läuft ohne Fehler durch und gibt X aus“. Für Software ist es Lint, Typen, Tests.

Prüfe, ob es wirkt

Neue Sitzung starten und etwas fragen, was nur aus der Datei beantwortbar ist, zum Beispiel „Wo liegen die Secrets?“. Antwortet Claude mit Passbolt, liest er die Datei. Antwortet er mit einer Gegenfrage, liegt sie am falschen Ort oder heißt anders.

Faustregel: Alles, was du Claude zweimal erklärt hast, gehört in die CLAUDE.md. Alles, was nur heute gilt, gehört in den Chat.

Lass sie wachsen

Die Datei ist nie fertig. Nach jeder Sitzung, in der Claude etwas falsch verstanden hat, kommt eine Zeile dazu. Nach drei Monaten hast du die Betriebsanleitung deiner Firma in 80 Zeilen, und jeder neue Mitarbeiter liest sie zuerst.