CLAUDE.md Startvorlage für Claude Code

Ein schwaches CLAUDE.md lässt jede Sitzung kalt starten

Wenn du Claude Code immer wieder dieselben Projektregeln erklären musst, liegt das Problem nicht nur am Prompt. Das Projekt braucht eine kleine Betriebsdatei mit Befehlen, Grenzen, Risikopfaden und Done-Kriterien.

Diese Vorlage passt zu bestehenden Codebasen und ergänzt den First Task Runbook.

Was in die Startvorlage gehört

Du brauchst kein riesiges Regelwerk. Starte mit Stack, Befehlen, riskanten Pfaden, Ausgabepräferenzen und Definition of Done.

# CLAUDE.md

## Project snapshot
- stack: Astro + TypeScript
- package manager: npm
- main app: site/

## Commands
- dev: cd site && npm.cmd run dev
- build: cd site && npm.cmd run build

## Guardrails
- do not touch: .env, dist, generated exports
- ask before: destructive git commands, production deploys, secret rotation

## Definition of done
- code change is applied
- verification command has run
- remaining risks are stated

Damit startet die nächste Sitzung mit deutlich mehr Kontext.

Beispiel für eine Content-Seite

Bei einer mehrsprachigen Astro-Seite ergänze Regeln für gleiche Slugs, pubDate, updatedDate, heroImage und öffentliche Prüfung von h1, canonical, Textsprache und CTA-Links.

Der typische Fehler ist: alle Sprachdateien existieren, aber nicht-englische Seiten enthalten englischen Text. Korrektes Frontmatter reicht nicht.

Wann weitere Regeln nötig sind

CLAUDE.md sollte nicht beliebig wachsen. Ergänze Regeln erst, wenn ein Fehler wiederholt auftritt: Build-Befehle, Mehrsprachigkeitsregeln, Review-Kriterien oder Deploy-Prüfung.

Nächster Schritt

Für Befehlsnotizen reicht das kostenlose Cheatsheet. Bei Rechten, Hooks, MCP oder CLAUDE.md nimm den Setup Guide. Für Teamregeln nutze die Beratung.