# Claude-Workflow: CLAUDE.md Template **Version:** 1.0 **Datum:** 2026-06-17 | 16:00 **Zweck:** Kopiervorlage – CLAUDE.md ins Projektroot legen, anpassen, fertig. --- ## Was ist CLAUDE.md? CLAUDE.md ist das Gedächtnis von Claude Code für ein Projekt. Die Datei liegt im Projektroot, wird bei jeder Session automatisch geladen – egal ob Terminal oder Desktop App. Sie ist Teil des Git-Repos und damit immer aktuell. **Faustregeln:** - Unter 200 Zeilen halten - Nur was wirklich dauerhaft gilt – keine temporären Aufgaben - Konkret und prüfbar: "Nutze Python 3.11" statt "Nutze moderne Python-Features" - Jedes Mal wenn Claude Code etwas falsch macht und du es korrigierst → Regel in CLAUDE.md aufnehmen --- ## Template: CLAUDE.md ```markdown # CLAUDE.md – [Projektname] ## Projekt-Kontext **Projekt:** [Name] **Beschreibung:** [1-2 Sätze] **Zielumgebung:** [z.B. Proxmox LXC Ubuntu 22.04 / Hetzner VPS / lokal Windows] **Verantwortlich:** Joachim / Obeco GmbH --- ## Pflichtlektüre beim Start Vor jeder Arbeit diese Dateien lesen: 1. `PROJEKT.md` – Anforderungen, Architektur, offene Schritte 2. `ENTSCHEIDUNGEN.md` – Warum was so gebaut wurde 3. `STATUS.md` – Was zuletzt gemacht wurde, was als nächstes kommt --- ## Schreibrechte (strikt einhalten) | Datei | Darf ich schreiben? | |-------|---------------------| | PROJEKT.md | ❌ NEIN – nur lesen | | ENTSCHEIDUNGEN.md | ❌ NEIN – nur lesen | | CHANGELOG.md | ✅ JA – Konzeptabweichungen eintragen | | RUECKFRAGEN.md | ✅ JA – offene Fragen eintragen | | STATUS.md | ✅ JA – nach jedem Commit aktualisieren | | src/ und Code | ✅ JA | --- ## Abweichungen vom Konzept Wenn die Realität nicht zum Plan passt: - **NICHT** still abweichen - **NICHT** PROJEKT.md ändern - Eintrag in CHANGELOG.md mit: Datum, Modul, Was, Warum, Auswirkung, Status: OFFEN --- ## Offene Fragen Wenn eine Entscheidung nötig ist die ich nicht treffen kann: - Eintrag in RUECKFRAGEN.md mit: Datum, Kontext, Frage, Optionen, was blockiert ist - Danach weitermachen mit dem was möglich ist, oder auf Antwort warten --- ## Git-Disziplin - Nach jedem abgeschlossenen Schritt committen - Commit-Message: `feat: [Schritt X] [kurze Beschreibung]` - Niemals mehrere Schritte in einem Commit zusammenfassen --- ## Tech-Stack [Hier projektspezifisch ausfüllen] | Komponente | Technologie | Version | |------------|-------------|---------| | Backend | | | | Frontend | | | | Datenbank | | | | Laufzeit | | | --- ## Coding-Konventionen [Hier projektspezifisch ausfüllen] - Sprache im Code: [Deutsch / Englisch] - Einrückung: [2 Spaces / 4 Spaces / Tabs] - Kommentare: [Deutsch / Englisch] - Logging: [z.B. immer mit Timestamp und Modul-Name] - Fehlerbehandlung: [z.B. try/except mit sprechendem Log-Eintrag] --- ## Verbote (projektspezifisch ergänzen) - Keine stillen Konzeptabweichungen - Keine Änderungen an PROJEKT.md oder ENTSCHEIDUNGEN.md - [weitere projektspezifische Verbote hier] --- ## Gelernte Regeln (laufend ergänzen) *Hier kommen Regeln rein die aus Korrekturen entstanden sind:* - [Datum]: [Was schiefgelaufen ist] → [neue Regel] ``` --- ## Tipp: Modular bei komplexen Projekten Bei größeren Projekten CLAUDE.md schlank halten und Detailregeln auslagern: ``` /projektroot/ ├── CLAUDE.md ← Kernregeln + Index (max. 100 Zeilen) └── .claude/ └── rules/ ├── api.md ← Regeln für API-Entwicklung ├── datenbank.md ← DB-Konventionen └── frontend.md ← Frontend-Regeln ``` In CLAUDE.md dann nur verweisen: ```markdown ## Detailregeln - API: siehe .claude/rules/api.md - Datenbank: siehe .claude/rules/datenbank.md ``` --- ## Memory prüfen Im Terminal jederzeit ausführbar: ```bash /memory # zeigt welche Dateien geladen sind und was Claude sich gemerkt hat /compact # komprimiert lange Sessions, CLAUDE.md wird danach neu geladen ``` --- ## Verwandte Notes - [[Claude-Workflow-Konzept]] – Das Regelwerk - [[Claude-Workflow-Templates]] – Alle Projektdatei-Vorlagen - [[Claude-Workflow-Prompts]] – Fertige Prompts zum Kopieren --- *Letzte Änderung: 2026-06-17 16:00*