Der erste Tag im neuen Projekt ist Horror

Stell dir vor, Claude müsste dein Projekt verstehen. Alles:

• Projektstruktur
• Tech-Stack
• Development Commands
• Architecture Patterns
• Naming Conventions

Du könntest das manuell alles erklären. Für jeden neuen Chat. Jedes Mal.

Oder: Du sagst claude --init und Claude liest dein Projekt durch, versteht es, und schreibt selbst ein Briefing.

Das ist der Unterschied zwischen "guter Context" und "Claude ist wie ein Vollzeit-Mitglied des Teams".

Phase 1: Was ist .claude.md?

.claude.md ist eine Markdown-Datei im Root deines Projekts.

Sie enthält: Alles, was Claude über dein Projekt wissen sollte.

Typ-Stack. Architecture. Commands. Patterns.

Claude liest das automatisch bei jeder Session.

Es ist dein Projekt-Betriebssystem für Claude.

Phase 2: Init-Befehl – Die Auto-Generation

Der einfachste Weg:

claude --init

Claude durchsucht dein Projekt und schreibt automatisch eine .claude.md.

Das dauert:

• Kleines Projekt: 10 Sekunden
• Mittleres Projekt: 30 Sekunden
• Großes Projekt: 1-2 Minuten

Das Ergebnis:

Eine .claude.md mit:

• Project Overview
• Tech Stack
• Folder Structure
• Development Commands
• Key Patterns

Beispiel Output:

# Project: My-App This is a Next.js 15 application with TypeScript and Tailwind CSS. ## Tech Stack - Next.js 15 (App Router) - TypeScript - Tailwind CSS ## Development Commands npm run dev npm run build npm run lint ## Folder Structure src/ → Source code public/ → Static assets

Phase 3: Customizing .claude.md

Die Auto-Generated Version ist gut. Aber du willst sie wahrscheinlich anpassen.

Schritt 1: Mit Context-Hints arbeiten

Claude hat die Datei generiert. Jetzt editierst du sie:

claude --init --optimized-for-llm --clear-instructions

Das generiert eine optimierte Version speziell für LLMs:

• Kürzer
• Fokussierter
• Bessere Struktur

Schritt 2: Manuell hinzufügen

Öffne die .claude.md und ergänze:

• Deine Conventions (z.B. "Alle Components in camelCase")
• Häufige Fehler (z.B. "Don't use X in this project")
• Team-Guidelines (z.B. "Immer Tests schreiben")
• Important Notes (z.B. "Payment API ist sehr sensibel")

Beispiel:

## Important Notes - Always write tests for business logic - Payment processing is critical - code review mandatory - Use environment variables for all secrets - API responses must be validated

Phase 4: Referenzen innerhalb von .claude.md

Du kannst externe Dateien direkt referenzieren:

Syntax:

@/path/to/file.md

Beispiel:

.claude.md:

## Architecture Guidelines @/docs/architecture.md

## API Patterns @/docs/api-patterns.md

Jetzt kann Claude diese Dateien lesen, wenn er sie braucht:

How should I structure this component?

Claude schaut automatisch in die Architecture Docs.

Phase 5: Das .claude.md Template

Hier ist ein Template, das du nutzen kannst:

# Project: [Project Name]

[One-line description]

## Tech Stack - [Technology 1] - [Technology 2] - [Technology 3]

## Development Commands npm run dev - Start development server npm run build - Create production build npm run test - Run test suite

## Folder Structure src/ → Application code tests/ → Test files docs/ → Documentation

## Key Patterns - Use functional components with hooks - All API calls go through services/ - State management via Context API

## Important Notes - Environment variables in .env.local - Always write tests for new features - PR reviews required before merge

## Architecture Guidelines @/docs/architecture.md

## API Patterns @/docs/api-endpoints.md

Speichern. Fertig.

Phase 6: Struktur der .claude.md

Wichtig: Struktur ist alles.

Claude liest nicht wirklich. Claude scannt.

Deswegen:

• Kurze Sektion (nicht 50 Zeilen Essays)
• Klare Überschriften (H2, H3)
• Bulletpoints statt Prosa
• Konkrete Beispiele

Falsch:

The project uses TypeScript which allows for type safety and is extremely important for maintaining code quality across the organization. We have found that it significantly reduces bugs in production.

Richtig:

- TypeScript (strict mode enabled) - Type-safe API calls and components

Phase 7: Integration mit Slash-Commands

Deine .claude.md arbeitet mit Slash-Commands zusammen.

Beispiel:

Du hast eine Development-Commands Section:

## Development Commands - npm run dev - npm run test - npm run build

Jetzt kannst du einen Slash-Command erstellen:

.claude/commands/dev-help.md:

--- userPrompt: "Show me the development commands from .claude.md" --- @/.claude.md

Jetzt:

/dev-help

Und Claude zeigt die Commands aus deiner .claude.md.

Phase 8: Versionierung und Updates

.claude.md sollte commitet werden ins Repo.

Warum?

Weil es Teil deiner Project-Dokumentation ist.

Neues Team-Mitglied clont dich:

git clone [repo] claude

Claude liest automatisch die .claude.md. Neues Mitglied hat sofort Context.

Wann updaten?

• Neuer Tech-Stack Eintrag? → Update .claude.md
• Neue Command hinzugefügt? → Update .claude.md
• Pattern geändert? → Update .claude.md

Das ist kein Overhead. Das ist Dokumentation.

Phase 9: Brownfield Projects – Die echte Magie

Großes Legacy-Projekt? 500 Dateien? Chaotische Struktur?

claude --init

Claude:

1. Durchsucht alles
2. Findet die tatsächliche Struktur
3. Schreibt eine .claude.md
4. Die ist 100x besser als wenn du es schreibst

Warum? Weil Claude objektiv ist. Claude findet, was wirklich da ist, nicht was du denkst, dass es da sein sollte.

Phase 10: Best Practices

1. Keep it Fresh

Wenn dein Tech-Stack sich ändert, update die .claude.md. Sonst lädt Claude Bullshit.

2. Sei Spezifisch

Uses a database = schlecht

Uses PostgreSQL with Prisma ORM = gut

3. Referenziere External Docs

Nicht alles in .claude.md schreiben. Externe Docs mit @/path referenzieren.

Das spart Token und ist wartbarer.

4. Test es

Nach dem Init, frag Claude:

Summarize this project for me

Claude sollte alles erwähnen, was in .claude.md steht.

Dein Action Plan für heute

1. ✅ Navigiere zu einem Projekt
2. ✅ Führe aus: claude --init
3. ✅ Warte, bis .claude.md generiert ist
4. ✅ Lies die generierte Datei durch
5. ✅ Ergänze 2-3 wichtige eigene Punkte
6. ✅ Speichern und commiten
7. ✅ Starte Claude Code und teste: Summarize my project

Wenn Claude alles richtig zusammenfasst, hast du gewonnen.

Die größte Erkenntnis

.claude.md ist nicht "eine weitere Dokumentation".

Es ist der Kommunikationskanal zwischen dir und Claude.

Alles, das Claude über dein Projekt wissen soll, steht hier.

Mit einer guten .claude.md wird Claude zu einem echten Team-Mitglied.

Ohne .claude.md ist Claude nur ein weiterer Chatbot.

Nächste Woche: Hooks – Automatisierung auf stereoiden. Code, der Code schreibt.

Habt einen tollen Tag. Ciao.