CLAUDE.md-Dateien sind oft für Entwickler strukturiert, nicht für KI-Modelle – warum das wichtig ist

Ein Beitrag auf r/ClaudeAI zeigt ein häufiges Problem bei CLAUDE.md-Dateien: Sie sind danach strukturiert, was der Entwickler dokumentieren möchte, nicht danach, was das Modell für Entscheidungen braucht. Das sind zwei unterschiedliche Dinge.

Die entwicklerzentrierte Struktur

Beispiel einer Datei, die für den Entwickler organisiert ist:

## Über dieses Projekt
[3 Absätze Kontext]
## Tech-Stack
[15 Einträge]
## Ziele
[5 Aufzählungspunkte]
## Harte Regeln   <- dies ist in Zeile 47

Das Modell liest linear. Bis es zu den harten Regeln kommt, hat es bereits begonnen, Annahmen zu bilden. Wenn eine Einschränkung diese Annahmen überschreiben soll, kämpft das Modell gegen einen Berg.

Eine modellzentrierte Struktur

Der Beitrag schlägt ein Gedankenmodell vor: Fragen Sie sich: „Was muss das Modell 3 Sekunden, bevor es etwas Unwiderrufliches tut, wissen?“ Setzen Sie das an den Anfang. Eine bessere Struktur:

## Harte Regeln (zuerst lesen)
[Ihre tatsächlichen Einschränkungen]
## Aktueller Kontext
[Was gerade live ist]
## Hintergrund
[der Rest]

Das Längenproblem

Eine 4000-zeilige CLAUDE.md ist nicht organisiert – sie ist archiviert. Eine archivierte Datei wird nicht gut gelesen. Eine organisierte Datei wird schnell gelesen. Klarheit schlägt Vollständigkeit, jedes Mal. Der Autor fragt: Was steht in den ersten 20 Zeilen Ihrer CLAUDE.md?