CLAUDE.md Vorlagen: Sofort kopieren für dein Projekt

CLAUDE.md ist das wichtigste Dokument fuer produktives Claude Code Arbeiten. Sie laedt bei jeder Session und erspart dir jedes Mal den Kontext zu erklaeren. Hier fertige Vorlagen fuer die haeufigsten Projekt-Typen.

Vorlage 1: Next.js / Full-Stack Web-App

# Projektname

**Live:** https://meine-app.de | **Login:** admin@local

## Tech-Stack
- Framework: Next.js 16 (App Router)
- Sprache: TypeScript (strict)
- DB: PostgreSQL + Prisma ORM
- Auth: Session-basiert (bcrypt + httpOnly Cookies)
- Deploy: Vercel / Railway

## Wichtige Konventionen
- Server Actions mit useActionState (React 19, NICHT useFormState)
- Zod auf jedem API-Input
- Conventional Commits (feat:/fix:/chore:)
- Files max 300 Zeilen, Funktionen max 30 Zeilen
- Nesting maximal 3 Ebenen

## Deploy
- `git push` → automatisch via Vercel
- DB-Migrationen: `npx prisma migrate deploy`

## Offene Punkte
- [ ] Stripe-Integration
- [ ] E-Mail-Verifizierung

Vorlage 2: Python / FastAPI Backend

# API-Service

**URL:** http://localhost:8000 | **Docs:** /docs

## Stack
- FastAPI + Pydantic v2
- SQLAlchemy 2.0 + Alembic
- PostgreSQL (Docker)
- pytest fuer Tests

## Konventionen
- Typen ueberall (kein Any)
- Dependency Injection via FastAPI Depends
- Fehler als HTTPException mit klaren Messages
- Tests: AAA-Muster (Arrange-Act-Assert)

## Befehle
- Start: `uvicorn main:app --reload`
- Tests: `pytest -v`
- Migration: `alembic upgrade head`

Vorlage 3: Side-Project / Micro-SaaS

# Projektname — Ein-Satz-Beschreibung

## Ziel
[Was loest dieses Produkt? Fuer wen?]

## Tech (minimal halten!)
- Next.js + SQLite + Drizzle (kein ORM-Overhead)
- Stripe fuer Payments
- Resend fuer E-Mails

## Prinzipien
- Kein Over-Engineering
- Deploy frueh und oft
- Feature only wenn Nutzer es brauchen

## Aktueller Sprint
- [ ] [Aufgabe 1]
- [ ] [Aufgabe 2]

Was gehort IMMER rein

1. Live-URL + Login — Claude Code kann sofort pruefen ob Deploy funktioniert
2. Deploy-Befehl — Ein Satz, kopierbar
3. Konventionen — Was Claude Code NIE tun soll (z.B. "kein jQuery", "kein useFormState")
4. Offene Punkte — Aktuelle Aufgaben damit Claude Code nach Session-Start weitermacht
5. Stack-Details — Versionsnummern wo relevant (Next.js 16 vs 15 hat Breaking Changes)

Pro-Tipp: @Import fuer grosse Projekte

Bei wachsenden Projekten CLAUDE.md modular halten:

# Mein Projekt
@AGENTS.md
@docs/api-conventions.md

Der @-Syntax laedt die Datei on-demand — kein Token-Overhead wenn Claude Code sie nicht braucht.