Claude Blueprint

Persoenliches Claude Code Setup — Skills, Agents, Hooks, Rules & Scripts als wiederverwendbares .claude/-Verzeichnis fuer alle Projekte.

Einmal klonen, init.sh ausfuehren, loslegen. Updates kommen per git pull in alle Projekte gleichzeitig.

---

Quick Start

# 1. Neues Projekt anlegen
mkdir MeinProjekt && cd MeinProjekt

# 2. Blueprint als .claude/ klonen
git clone git@github.com:herbeckrobin/claude-blueprint.git .claude

# 3. Projekt initialisieren (erstellt Ordner + CLAUDE.md)
.claude/init.sh

# 4. Code-Repo einrichten
cd Code && git clone <dein-code-repo> mein-repo

init.sh erstellt die Projektstruktur, optional die User-Level Config und kann Claude Code direkt das Projekt analysieren und notizen.md befuellen lassen.

---

Was ist drin?

Skills (Slash-Commands)

Befehl	Beschreibung
/plan	Strukturierte Planung vor Implementierung
/review	Code-Review der letzten Aenderungen
/security-audit	OWASP, Secrets, Dependencies, DSGVO Check
/verify	Build, Tests, Integritaetspruefung
/bugfix	Systematisches Debugging (6-Phasen-Prozess)
/research	Tiefe Recherche (Codebase + Memory + Web)
/document	Dokumentation erstellen/aktualisieren
/improve	Self-Improvement Loop (Qualitaet, Performance, Architektur)
/learn	Session-Learnings analysieren und ins Blueprint ueberfuehren
/evolve	Blueprint-Gesundheitscheck (Aktualitaet, Luecken, Konsistenz)
/go-live-check	Launch-Checkliste (Legal, SEO, Security, Performance, Technik)
/client-update	Kunden-Update-Mail in Robins Tonalitaet generieren
/estimate	Aufgabe in Teilschritte zerlegen fuer eigene Schaetzung

Agents (Subagents)

Agent	Beschreibung
code-reviewer	Senior Code-Review mit strukturiertem Output
debugger	Systematische Fehlersuche und Root-Cause-Analyse
researcher	Technische Recherche (Codebase + Web + Best Practices)
security-auditor	Security Audit mit OWASP-Fokus und DSGVO-Pruefung

Hooks

Hook	Event	Beschreibung
protect-files.sh	PreToolUse	Blockiert Edit/Write auf sensible Dateien (.env, credentials, keys)
notify-macos.sh	Notification	macOS-Benachrichtigung wenn Claude fertig ist

Rules (immer aktiv, keine Pfad-Einschraenkung)

Rule	Beschreibung
security.md	Input-Validierung, Injection-Schutz, Secrets, Prepared Statements
git-workflow.md	Commit-Konventionen (Deutsch, Imperativ, keine AI-Attribution)
frontend-design.md	Anti-Slop Design-Regeln und aktuelle Trends 2025/2026
toolchain.md	bun statt npm, DDEV fuer WordPress, WP-CLI, SSH-Hosts
legal-compliance.md	DSGVO, Impressum, Datenschutzerklaerung, Barrierefreiheit (BFSG)
deployment.md	sync.sh + .env Pattern, WordPress DB-Sync (Stage/Prod)
projektstruktur.md	Ordnerstruktur-Regeln (Code in Unterordner, kein Repo im Root)
projektmanagement.md	Proaktive Beratung bei Scope, Timing, Kundenkommunikation
tonalitaet.md	Robins Schreibstil fuer Kundenkommunikation
seo.md	hreflang, Canonical, Sitemap, Crawlbarkeit, Search Console
ecommerce.md	Webshop-Entwicklung (Stripe, Payment, DE-Compliance, WooCommerce)
blueprint-evolution.md	Blueprint-Selbstverbesserung (Trigger, Feedback-Schleife)
pdf-generation.md	PDF-Erzeugung fuer Affinity Publisher (pdfkit)
web-scraping.md	Cloudflare-Handling, Wayback Machine, PageSpeed Fallbacks
nextjs.md	Next.js 16 Breaking Changes, App Router, Server Actions, i18n
wordpress-blocks.md	Block Themes, Custom Blocks, Interactivity API, WooCommerce

Scripts

Script	Beschreibung
wpsync.sh	WordPress DB-Sync (Stage/Prod) mit URL-Ersetzung und Backups
env.example	Template fuer .env Konfiguration

---

Projektstruktur nach init.sh

MeinProjekt/
├── .claude/          ← Dieses Repo (git pull fuer Updates)
│   ├── base.md       ← Blueprint-Basis (importiert in CLAUDE.md)
│   ├── settings.json ← Permissions, Hooks, Attribution
│   ├── skills/       ← 13 Slash-Commands
│   ├── agents/       ← 4 Subagents
│   ├── hooks/        ← Hook-Scripts (Datei-Schutz, Notifications)
│   ├── rules/        ← 16 Regel-Dateien (Security, Design, Legal, Next.js, WP, ...)
│   ├── scripts/      ← Deployment-Scripts (wpsync.sh)
│   └── init.sh       ← Setup-Script
├── CLAUDE.md         ← Importiert base.md + notizen.md via @-Referenz
├── Projekt/          ← Doku, Notizen, Assets
│   ├── notizen.md    ← Zentrale Projektinfos
│   └── assets/
└── Code/             ← Code-Repositories (in Unterordnern)
    └── <repo>/

---

Updates

cd MeinProjekt/.claude && git pull

Neue Skills, Agents, Rules und Verbesserungen sind sofort in allen Projekten aktiv.

---

User-Level Config

Beim ersten init.sh wird optional installiert:

Datei	Beschreibung
~/.claude/CLAUDE.md	Persoenliche Praeferenzen (Sprache, Arbeitsweise)
~/.claude/settings.json	Auto-Memory aktivieren

Diese gelten fuer alle Projekte, nicht nur das aktuelle.

---

Philosophie

• Unternehmerisch mitdenken — nicht nur Code schreiben, sondern Geschaeftsziele verstehen
• Planen vor Ausfuehren — Plan-Mode bei komplexen Aufgaben
• Verifizieren nach jeder Aenderung — Tests, Security, Build
• Self-Improvement & Evolution — aus jedem Projekt lernen und das Blueprint selbst verbessern
• DSGVO by Default — keine externen Fonts/CDNs, Datensparsamkeit
• Rechtliche Compliance — Impressum, Datenschutz, Barrierefreiheit proaktiv pruefen
• Anti-Slop Design — kein generisches AI-UI, bewusste gestalterische Entscheidungen

---

Lizenz

Privates Setup-Repo. Nutzung auf eigene Verantwortung.