.claude/rules/

Das Verzeichnis .claude/rules/ ist ein Ort zur Organisation projektspezifischer Anweisungen in mehrere Markdown-Dateien, anstatt in einer einzigen großen CLAUDE.md. Jede Datei in diesem Verzeichnis repräsentiert ein eigenes Thema, wie z. B. testing.md oder api-design.md. Diese Dateien werden rekursiv gefunden, was eine weitere Organisation in Unterverzeichnisse ermöglicht.

Regeln, die in .claude/rules/ ohne ein paths-Frontmatter-Feld platziert werden, werden standardmäßig zu Beginn einer Sitzung geladen, ähnlich wie die Hauptdatei CLAUDE.md. Regeln, die jedoch ein paths-Feld enthalten, gelten als pfadbezogen. Diese pfadbezogenen Regeln werden nur geladen, wenn Claude aktiv mit Dateien arbeitet, die den angegebenen Glob-Mustern entsprechen, z. B. src/**/*.{ts,tsx}. Dieser Mechanismus hilft bei der Verwaltung des Kontextfensters, indem relevante Anweisungen nur bei Bedarf geladen werden, was die Effizienz verbessert. Pfadbezogene Regeln werden ausgelöst, wenn Claude Dateien liest, die dem Muster entsprechen, nicht unbedingt bei jeder Tool-Nutzung.

Persönliche Regeln können in ~/.claude/rules/ platziert werden. Diese globalen Regeln gelten für alle Projekte und werden vor projektspezifischen Regeln geladen, wodurch Projektregeln effektiv eine höhere Priorität erhalten. Das System unterstützt Symlinks, die die Verwendung eines gemeinsamen Regelsatzes über mehrere Projekte hinweg ermöglichen, indem sie in das .claude/rules/-Verzeichnis jedes Projekts verlinkt werden.

Es ist wichtig, zwischen diesen Regeln und Skills zu unterscheiden. Regeln werden entweder zu Beginn einer Sitzung oder beim Öffnen passender Dateien in den Kontext geladen. Für Anweisungen, die aufgabenbezogen sind und keine ständige Präsenz im Kontext erfordern, ist ein Skill der geeignetere Mechanismus. Ähnlich wie Regeln haben auch SKILL.md-Dateien ein paths-Feld in ihrem Frontmatter, das steuert, wann ein Skill basierend auf Dateimatches automatisch aktiviert wird.