Download: claude-pm.zip ↓ — direkter Snapshot vom GitHub-Repo. Oder das Repo öffnen: github.com/e3xler/claude-pm

---

1) Das Problem

Du startest ein neues Projekt. Du öffnest Claude. Du fängst an zu tippen:

„Ich baue eine kleine SaaS für X. Stack ist Next.js, Supabase, Vercel. Bitte antworte auf Deutsch, duze mich, kein Buzzword-Bingo. Bei UI nutze unsere Farben — Primary ist ein dunkles Grün, sekundär ein warmes Beige. Tonalität: direkt, technisch, …"

Drei Tage später startest Du eine neue Session. Du tippst das Gleiche nochmal. Und nochmal. Und nochmal.

Das ist der Job einer CLAUDE.md. Aber eine leere CLAUDE.md ist auch kein Setup — Du brauchst eine Struktur, die Claude erkennt: Wo steht die Strategie? Wo die Personas? Wo die Brand Voice?

Dieses Template ist diese Struktur.

2) Was im Template steckt

claude-pm/
├── CLAUDE.md                # Zentrale Steueranweisung (15 Sektionen, mit Platzhaltern)
├── README.md                # Wie man das Template benutzt
├── .claude/
│   ├── settings.json        # Permissions, Hooks, Modell-Defaults
│   ├── commands/            # 5 Slash-Commands
│   └── agents/              # 3 Subagents
├── docs/
│   ├── product-strategy.md  # Vision, Wette, Outcomes
│   ├── personas.md          # Wer ist der User
│   ├── tech-stack.md        # Was wir nutzen, warum, wann wir wechseln
│   ├── architecture.md      # System-Design, Datenflüsse
│   ├── brand-voice.md       # Wie wir klingen, was wir nie sagen
│   ├── brand-colors.md      # Palette, semantische Verwendung, WCAG
│   ├── design-system.md     # Tokens, Komponenten, Patterns
│   ├── security.md          # Threat-Model, Checks, Incident-Response
│   ├── glossary.md          # Projekt-spezifische Begriffe
│   ├── decisions/           # ADR-Template
│   └── research/            # Struktur für Interviews + Insights
├── .env.example
└── .gitignore

Drei Ebenen, klar getrennt:

Ebene	Was sie tut
CLAUDE.md	Bootstrap-Layer — Claude liest das vor jedem Prompt. Hier stehen Sprache, Stack, Workflow-Regeln.
.claude/	Automation-Layer — Slash-Commands wie /kickoff oder /ship, plus spezialisierte Agents wie brand-guardian.
docs/	Knowledge-Layer — die langen Dokumente, auf die CLAUDE.md verweist. Brand, Strategy, Architektur.

3) Quick Start

Schritt 1: Template runterladen

# Variante A: ZIP-Snapshot
curl -L https://github.com/e3xler/claude-pm/archive/refs/heads/main.zip -o claude-pm.zip
unzip claude-pm.zip
mv claude-pm-main mein-projekt
cd mein-projekt

# Variante B: Git-Clone (wenn Du eh mit Git arbeitest)
git clone https://github.com/e3xler/claude-pm.git mein-projekt
cd mein-projekt
rm -rf .git && git init

Schritt 2: Claude um Hilfe bitten

claude

Im Claude-Prompt:

/kickoff

Der /kickoff-Command prüft, was schon ausgefüllt ist, was fehlt, und schlägt die nächsten Schritte vor — abhängig von Deiner Projekt-Phase (Discovery, Prototyp, MVP, Production).

Schritt 3: CLAUDE.md füllen (10–20 Min)

Die CLAUDE.md hat überall {{PLATZHALTER}}. Ersetz sie — oder lass Claude das machen:

Lies CLAUDE.md. Stell mir die Fragen, deren Antworten Du brauchst,
um die Platzhalter zu füllen. Stell sie einzeln, nicht alle auf einmal.

Schritt 4: Brand-Docs füllen (wenn UI dran ist)

Wenn das Projekt eine UI bekommt, sind das die drei wichtigsten Dokumente — sonst baut Claude generische Tailwind-Templates:

• docs/brand-voice.md — Tonalität, verbotene Phrasen, AI-Pattern die wir vermeiden
• docs/brand-colors.md — Token-Tabellen, WCAG-Kontraste
• docs/design-system.md — Spacing, Typografie, Komponenten-Inventar

4) Die 5 Slash-Commands

Command	Was er tut
/kickoff	Setup-Diagnose und Empfehlung der nächsten Schritte
/new-feature	Strukturierter Feature-Kickoff: Discovery → Plan → Build → Verify
/brand-check	Audit von Copy oder UI gegen die Brand-Doku
/design-review	Designer-Eye QA — Hierarchie, Spacing, States, „looks AI-generic" Smell
/ship	Pre-Deploy Checkliste — Tests, Build, Env, Migrations, UI-Smoke

Commands liegen als Markdown in .claude/commands/<name>.md. Du kannst sie editieren oder neue dazupacken — Claude erkennt sie automatisch.

5) Die 3 Subagents

Subagents sind spezialisierte Claude-Personae, die Du gezielt für eine Aufgabe spawnst. Im Template:

Agent	Wofür
product-strategist	Hinterfragt Scope, formuliert Hypothesen, prüft Outcome-Fit. Nutze ihn, wenn ein Feature-Wunsch reinkommt und Du nicht sicher bist, ob das die richtige Schraube ist.
brand-guardian	Reviewed Copy und UI gegen Brand-Voice, Colors und Design-System. Nutze ihn nach jeder größeren Copy- oder Komponenten-Änderung.
design-critic	Designer-Eye QA. Findet visuelle Inkonsistenz, schwache Hierarchie und „AI-generic" Patterns — bevor sie live gehen.

Du spawnst sie über den Agent-Tool oder direkt in Claude Code via Sub-Agent-Picker.

6) Was die CLAUDE.md alles abdeckt

Die 15 Sektionen der Template-CLAUDE.md:

1. Projekt-Kontext — Name, Status, Owner, Live-URLs
2. Zielgruppe & Use Cases — Personas, Top 3 Jobs to be done
3. Tech-Stack & Architektur — Layer-Tabelle mit Begründung
4. Sprache & Kommunikation — Antwort-Sprache, Anrede, Stil
5. Code-Konventionen — Naming, Kommentare, Errors
6. Brand & Design — Verweis auf die drei Brand-Docs
7. Produkt-Strategie — North Star, Outcomes, was wir NICHT bauen
8. Workflow & Pipeline — Branch-Strategie, Commits, PR-Regeln
9. Testing — Coverage-Ziele pro Test-Typ
10. Sicherheit — Non-Negotiables
11. Performance-Ziele — LCP, INP, CLS, Bundle-Budget
12. Wie Claude in diesem Projekt arbeiten soll — proaktive Erlaubnisse, was nicht ohne Confirm
13. Verfügbare Custom Commands — Liste
14. Verfügbare Custom Agents — Liste
15. Wichtige Pfade — File-Tree

Alles mit Platzhaltern, die Du je nach Projekt austauschst oder löschst.

7) Was Du anpassen solltest

Pflicht (sonst funktioniert das Template nicht für Dich)

• CLAUDE.md → alle {{PLATZHALTER}} ersetzen oder Sektion löschen
• docs/product-strategy.md → mindestens Vision, Persona, North Star
• docs/tech-stack.md → was Du tatsächlich nutzt

Stark empfohlen (sobald UI im Spiel ist)

• docs/brand-voice.md → Voice-Attribute, verbotene Phrasen
• docs/brand-colors.md → echte Token-Werte
• docs/design-system.md → Style-Direction wählen, Tokens setzen

Optional (kannst Du iterativ füllen)

• docs/architecture.md — wenn das System komplexer wird
• docs/security.md — vor dem ersten Production-Deploy
• docs/glossary.md — wenn Begriffe doppeldeutig werden
• docs/decisions/ — ADRs für jede nicht-triviale Entscheidung
• docs/research/ — User-Interviews und Insights

8) Wie Claude das Template versteht

Beim ersten Prompt lädt Claude Code automatisch:

1. CLAUDE.md aus dem Projekt-Root → in den System-Kontext
2. Die Files unter .claude/commands/ → als Slash-Commands verfügbar
3. Die Files unter .claude/agents/ → als spawnbare Sub-Agents

Die Dateien unter docs/ werden nicht automatisch geladen — das wäre zu viel Kontext. Claude liest sie on demand, wenn die CLAUDE.md darauf verweist (z. B. „Bei UI-Arbeit lies docs/brand-voice.md").

Das ist der Trick: kurze CLAUDE.md (bleibt billig im Kontext), tiefe docs/ (werden nur gelesen, wenn relevant).

9) Best Practices

CLAUDE.md kurz halten

Sie steht in jedem Prompt mit drin. Faustregel: unter 250 Zeilen. Was länger ist, gehört in docs/ und wird nur verlinkt.

Brand-Docs vor UI-Arbeit füllen

Sonst baut Claude generische Tailwind-Templates. Mit Brand-Voice/Colors/System bekommst Du Output, der zur Marke passt — nicht zum AI-Standard.

Slash-Commands erweitern

Brauchst Du regelmäßig denselben Workflow? Pack ihn als neuen Slash-Command unter .claude/commands/<name>.md rein. Beispiele aus dem Alltag:

• /standup — generiere Standup-Update aus letztem Git-Log
• /changelog — schreib CHANGELOG.md aus den Commits seit letztem Tag
• /handoff — schreibe HANDOVER.md vor dem Wochenende

Subagents für wiederkehrende Rollen

Wenn Du oft die gleiche „zweite Meinung" brauchst (Strategy, Brand, Design, Security), pack sie als Agent unter .claude/agents/<name>.md. Vorteil: spezialisiertes Prompt, eigener Tool-Scope, kein Themenwechsel im Hauptkontext.

Memory ist lebendig

Wenn Claude den gleichen Fehler dreimal macht oder die gleiche Frage stellt — das ist ein CLAUDE.md-Update. Direkt eintragen, nicht beim nächsten Mal wieder erklären.

10) Quick Reference

Frage	Antwort
Wo liegt das Repo?	github.com/e3xler/claude-pm
Wie lade ich es runter?	ZIP oder git clone
Welche Lizenz?	Frei nutzbar, anpassen, weitergeben
Funktioniert es ohne Claude Code?	CLAUDE.md und docs/ ja — Slash-Commands und Subagents brauchen Claude Code
Was ist der erste Befehl?	/kickoff in Claude Code
Wie lang dauert das Setup?	10–20 Min für CLAUDE.md, 1–2 h wenn Du Brand-Docs ernst meinst
Kann ich Sektionen löschen?	Ja — alles ist modular. Lösch was nicht passt.

11) Nächste Schritte

• ZIP runterladen oder Repo klonen
• Ordner umbenennen, .git neu initialisieren
• claude im Ordner starten, dann /kickoff ausführen
• CLAUDE.md ausfüllen (oder Claude die Fragen stellen lassen)
• Brand-Docs füllen, wenn UI dran ist
• Eigene Slash-Commands und Agents ergänzen, sobald Patterns sich wiederholen