Ein wiederverwendbares Projekt-Template für Claude Code — kein Code-Skeleton, sondern reines AI-Tooling: vorkonfigurierte Skills, Hooks, MCP-Server und eine geführte Setup-Anleitung, mit der Claude ein frisches Projekt selbstständig einrichtet.
Statt bei null zu starten, bekommst du ein vollständig vorkonfiguriertes Claude-Code-Setup:
Skills (Slash-Commands) — sofort einsatzbereite Workflows:
/changelog— versionierte Changelog-Einträge (git-Analyse → Vorschau → Eintrag, via MCP)/handoff— Session-Abschluss: aktualisiertHANDOFF.md, Memory und die Projekt-Struktur-Karte für den nächsten Chat/code-review— Multi-Agent Code-Review, nur high-impact Findings statt Style-Nits/gemini_quick·/gemini_deep— unabhängige Zweitmeinung bzw. tiefer, iterativer Gemini-Dialog für knifflige Fälle
Hooks — laufen automatisch im Hintergrund:
- Auto-Commit als Rollback-Punkte nach jeder Datei-Änderung
- Secret-Scan, der Secrets vor MCP-Aufrufen blockt
- optionale Audio-Benachrichtigungen
MCP-Server — vorverdrahtet (Keys als .env-Referenzen): Changelog, Context7 (Live-Doku), Gemini, Chrome DevTools, Stitch, n8n.
Geführtes Setup — der Agent arbeitet setup-new.md Phase für Phase ab und richtet für dich ein: eine projektspezifische CLAUDE.md (Coding-Regeln & Workflows), eine saubere Doku-Struktur (project/ = Produktsicht, knowledge/ = Technik & Architektur-Karte), ein frisches Git-Repo, den Changelog und die Projekt-Doku. Zum Schluss entfernt es die Template-Reste — übrig bleibt dein Projekt.
Die generierte CLAUDE.md gibt dem Agenten in jedem Projekt eine feste Arbeitsdisziplin vor — die wichtigsten:
Versionierter Git-Flow mit Sicherheitsnetz
- Nach jeder Datei-Änderung setzt der Auto-Commit-Hook einen WIP-Commit (z. B.
1.0.16-WIP) als Rollback-Punkt — du kannst jeden Zwischenstand zurückrollen. - Beim regulären Commit werden diese WIP-Commits per Soft-Reset zu einem sauberen Versions-Commit zusammengefasst; die Commit-Message ist nur die Versionsnummer (aus dem Changelog-Store gelesen).
- Commit und Push sind getrennt: Push passiert nur auf ausdrückliche Anweisung, läuft über SSH und blockt, solange noch WIP-Commits in der Range hängen. Git ausschließlich über die Scripts — kein manuelles
git commit/push.
Changelog-Pflicht — jede Implementierung wird über den Changelog-MCP versioniert (append-only, nie von Hand editiert). Die Version treibt den Commit.
Coding-Disziplin — die CLAUDE.md erzwingt u. a.: Simplicity First (minimaler Code, keine spekulativen Abstraktionen), Surgical Changes (nur anfassen was nötig ist, bestehenden Stil matchen), Dateien unter 350 Zeilen, klare Naming-Conventions, Security First (Secrets nur in .env), deutsche Kommentare & Antworten.
Zweitmeinung & Review eingebaut — Gemini-Konsultation für knifflige Architektur-/Debugging-Fragen, Multi-Agent-Code-Review vor Merges, Secret-Scan vor MCP-Aufrufen.
Session-Handoff — /handoff am Session-Ende hält HANDOFF.md, Memory und die Architektur-Karte aktuell, damit der nächste Chat nahtlos weiterarbeitet.
git clone <dieses-repo> mein-projekt
cd mein-projektDanach das Projekt in Claude Code öffnen und sagen:
„Lies
documentation/dws_install/setup-new.md"
Claude arbeitet die Setup-Anleitung Phase für Phase ab: Skills & Hooks konfigurieren, .mcp.json anpassen, ein eigenes Git-Repo anlegen, CLAUDE.md zusammenstellen und die Projekt-Doku befüllen.
Hinweis zum mitgeklonten
.git: Beim Clone kommt die Git-History dieses Templates mit. Das Setup entfernt sie automatisch (rm -rf .git) und initialisiert ein frisches Repo für dein Projekt — du schleppst also keine fremde History oderoriginmit. Alternativ auf GitHub den „Use this template"-Button nutzen; dann entsteht direkt ein sauberes Repo ohne diesen Schritt.
Die echte .env ist gitignored und im Repo nicht enthalten. Als Gerüst dient .env.example:
cp .env.example .env # dann Werte eintragenEnthält Git-Identität (GIT_USER_NAME / GIT_USER_EMAIL) und optionale MCP-Server-Keys (nur ausfüllen, wenn der jeweilige Server genutzt wird). Push-Auth läuft über SSH (~/.ssh), kein Token nötig.
| Pfad | Zweck |
|---|---|
.claude/ |
Skills & Hooks (Changelog, Handoff, Code-Review, Gemini-Zweitmeinung, Security-Scan, Auto-Commit u.a.) |
.mcp.json |
MCP-Server-Konfiguration (Referenzen auf .env, keine literalen Secrets) |
documentation/dws_install/ |
Setup-Anleitungen — Einstieg: setup-new.md (Neuinstallation), setup-migrate.md (Update) |
documentation/project/ |
Anwender-/Produkt-Sicht (projekt.md, HANDOFF.md) |
documentation/knowledge/ |
Entwicklungs-Sicht (project-structure.md + technische Anleitungen) |
services/, docker-compose*.yml |
Docker-Gerüst (api, frontend) |
Ein einmal eingerichtetes Projekt ist von diesem Template entkoppelt (keine Upstream-Verbindung). Um ein bestehendes Projekt auf einen neueren Template-Stand zu heben, dient documentation/dws_install/setup-migrate.md (manueller, geführter Abgleich) — kein git pull.
documentation/dws_install/enthält die Setup-Anleitungen und gehört zum Template, nicht zu deinem Projekt — das Setup entfernt den Ordner nach Abschluss automatisch.