Projekt-Setup

Wissen

CLAUDE.md aufsetzen

Der erste Schritt für jeden Claude-Code-Workflow: eine klare CLAUDE.md, die dem Agent Kontext gibt. Für unser Review-Projekt definieren wir Build-Befehle, Code-Style-Regeln und Review-Standards.

Erstelle eine CLAUDE.md im Projektstamm:

# Review Workflow Projekt

## Build & Test
- `npm test` für Tests
- `npm run lint` für Linting

## Code Style
- TypeScript strict mode
- Prettier für Formatierung
- ESLint mit empfohlenen Regeln

## Review-Regeln
- Jeder PR braucht mindestens Tests
- Keine TODO-Kommentare in main
- Sicherheitsrelevante Änderungen brauchen zweites Review
- Maximale Funktionslänge: 50 Zeilen

iWarum Review-Regeln in CLAUDE.md?

Claude Code liest CLAUDE.md bei jedem Start. Wenn du Review-Standards hier definierst, kennt der Review-Agent automatisch die Regeln deines Teams -- ohne dass du sie jedes Mal im Prompt wiederholen musst.

.claude/ Verzeichnisstruktur

Unser Workflow braucht eine durchdachte Verzeichnisstruktur. Hier ist der vollständige Aufbau:

.claude/
├── CLAUDE.md              # Lokale Ergänzungen (git-ignoriert)
├── settings.json          # Hooks und Berechtigungen
├── skills/
│   └── review/
│       └── SKILL.md       # Review-Skill-Definition
├── agents/
│   └── code-reviewer.md   # Spezialisierter Review-Agent
└── hooks/
    └── pre-commit-check.sh

!Projektweite vs. lokale Konfiguration

Die CLAUDE.md im Projektstamm wird ins Repository committet und gilt für alle Teammitglieder. Dateien unter .claude/ können sowohl projektweite (committete) als auch lokale (git-ignorierte) Konfigurationen enthalten. Sensible Daten wie API-Keys gehören nie ins Repository.

MCP-Server anbinden

Für den Zugriff auf GitHub-PRs binden wir den GitHub MCP-Server ein. Erstelle eine .mcp.json im Projektstamm:

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

Damit kann Claude Code direkt auf GitHub-Daten zugreifen: PRs lesen, Diffs analysieren und Review-Kommentare schreiben.

Wo wird die MCP-Server-Konfiguration für ein Projekt gespeichert?

Verstehen

Agent-Definition erstellen

Der Kern unseres Workflows ist ein spezialisierter Code-Review-Agent. Erstelle die Datei .claude/agents/code-reviewer.md:

---
name: code-reviewer
description: Reviews code changes for quality and best practices
tools: Read, Grep, Glob, Bash
model: sonnet
maxTurns: 30
---

Du bist ein erfahrener Code-Reviewer. Deine Aufgabe ist es, Code-Änderungen
systematisch zu prüfen.

## Prüfkriterien

1. **Bugs** -- Logikfehler, fehlende Fehlerbehandlung, Race Conditions
2. **Security** -- SQL Injection, XSS, unsichere Dependencies, hartcodierte Secrets
3. **Performance** -- Unnötige Schleifen, fehlende Indizes, Speicherlecks
4. **Lesbarkeit** -- Benennung, Kommentare, Funktionslänge, DRY-Prinzip

## Ausgabeformat

Gib dein Feedback in diesem Format:

### [CRITICAL/WARNING/INFO] Titel

**Datei:** `pfad/zur/datei.ts:zeile`
**Problem:** Beschreibung
**Vorschlag:** Lösung

Beachte die wichtigsten Konfigurationsoptionen:

model: sonnet -- Sonnet bietet die beste Balance aus Qualität und Kosten für Code-Reviews. Für besonders kritische Reviews kannst du auf Opus wechseln.
maxTurns: 30 -- Begrenzt die Anzahl der Iterationen, um Endlosschleifen und unkontrollierte Kosten zu vermeiden.
tools -- Der Agent bekommt nur die Tools, die er für Reviews braucht: Dateien lesen, Code durchsuchen und Shell-Befehle ausführen.

*Modellwahl nach Aufgabe

Für Standard-Reviews reicht Sonnet völlig aus. Reserviere Opus für sicherheitsrelevante Änderungen oder architektonische Entscheidungen. Haiku eignet sich für schnelle Syntax-Checks und Formatting-Prüfungen.

Anwenden

Erstelle jetzt die Verzeichnisstruktur in deinem Projekt:

mkdir -p .claude/skills/review
mkdir -p .claude/agents
mkdir -p .claude/hooks

Lege dann die drei Dateien an: CLAUDE.md im Projektstamm, .mcp.json für den GitHub MCP-Server und .claude/agents/code-reviewer.md für den Review-Agent. Im nächsten Abschnitt verbinden wir alles mit Skills und Hooks.

Reflektieren

Das Setup ist die Grundlage für alles Weitere. Eine gute CLAUDE.md bedeutet, dass der Agent deine Regeln kennt. Eine klare Agent-Definition sorgt für konsistente Reviews. Und die MCP-Anbindung gibt dem Agent Zugriff auf die Daten, die er braucht. Nimm dir Zeit für diesen Schritt -- ein solides Fundament macht den Rest einfacher.