CLAUDE.md – Rules & Agenten erstellen

Das Rules-System von Claude Code arbeitet mit Markdown-Dateien auf verschiedenen Ebenen. Diese werden automatisch zu Beginn jeder Session gelesen.

Die drei Ebenen

~/.claude/CLAUDE.md          → Globale Regeln (gelten überall)
dein-projekt/CLAUDE.md       → Projektregeln (teilbar via Git)
dein-projekt/CLAUDE.local.md → Persönliche Notizen (nicht in Git)

---

Beispiel CLAUDE.md für ein Go-Projekt

# Projekt: Mein Go Service

## Setup & Befehle
- Build: `make build`
- Tests: `go test ./...`
- Lint: `golangci-lint run`

## Code-Konventionen
- Go-Version aus go.mod beachten – moderne Idiome bevorzugen
- Fehler immer explizit behandeln, nie ignorieren
- Reine Funktionen bevorzugen (keine Seiteneffekte)
- Strikte Typisierung überall

## Workflow
- Vor jedem Commit Tests ausführen
- PRs immer mit kurzer Beschreibung was & warum

## Was Claude NICHT tun soll
- Keine Abhängigkeiten ohne Rückfrage hinzufügen
- Keine Dateien außerhalb des Projekts verändern

---

Slash Commands erstellen

Wiederverwendbare Prompts als Markdown-Dateien, aufrufbar mit /befehlsname:

Datei: .claude/commands/review.md

---
description: Code Review durchführen
allowed-tools: Read, Grep, Glob
---

Führe ein gründliches Code-Review durch für: $ARGUMENTS

Prüfe auf:
- Fehlerbehandlung vollständig?
- Tests vorhanden?
- Go-Idiome korrekt?
- Sicherheitsprobleme?

Erstelle einen strukturierten Report.

Verwendung:

/review ./internal/api/handler.go

---

Sub-Agenten erstellen

Ein Subagent ist eine spezialisierte Claude-Instanz mit eigenem System-Prompt, erlaubten Tools und Berechtigungen.

Datei: .claude/agents/code-reviewer.md

---
description: Liest Code und gibt Review – niemals schreibend
allowed-tools: Read, Grep, Glob
model: claude-haiku-4-5-20251001
---

Du bist ein erfahrener Go-Code-Reviewer.
Analysiere Code und gib konstruktives Feedback.
Du darfst KEINE Dateien ändern oder erstellen.

Agenten können auch verkettet werden:

"Nutze zuerst test-runner. Wenn der Build fehlschlägt,
nutze code-reviewer um Fixes vorzuschlagen."

---

Dateistruktur Übersicht

projekt/
├── CLAUDE.md                    ← Projektregeln (in Git)
├── CLAUDE.local.md              ← Persönliche Notizen (nicht in Git)
└── .claude/
    ├── commands/
    │   ├── review.md            ← /review Befehl
    │   ├── test.md              ← /test Befehl
    │   └── deploy.md            ← /deploy Befehl
    └── agents/
        ├── code-reviewer.md     ← Spezialisierter Review-Agent
        └── test-runner.md       ← Test-Ausführungs-Agent

Feature	Wo	Zweck
CLAUDE.md	Projekt / Global	Dauerhafte Regeln & Kontext
.claude/commands/	Projekt / Global	Wiederverwendbare Slash Commands
.claude/agents/	Projekt / Global	Spezialisierte Sub-Agenten