# Claude ↔ Claude Code Workflow-Konzept
**Version:** 1.1
**Datum:** 2026-06-17 | 16:00
**Autor:** Joachim / Obeco GmbH
**Status:** Aktiv
**Änderung v1.1:** CLAUDE.md als sechste Projektdatei ergänzt
---
## Ziel
Reibungsloser Informationsfluss zwischen Claude.ai (Entwurf) und Claude Code (Umsetzung) für komplexe Projekte mit DB, API und Frontend. Keine Kontextverluste, keine stillen Konzeptabweichungen.
---
## Rollenverteilung
| Rolle | Werkzeug | Zuständigkeit |
|-------|----------|---------------|
| Architekt | Claude.ai | Was & Warum – Anforderungen, Architektur, Entscheidungen |
| Umsetzer | Claude Code | Wie – Implementierung, Dateistruktur, Code |
| Protokollant | Claude Code | Änderungen & Rückfragen dokumentieren |
| Reviewer | Claude.ai | Konzeptpflege nach Rückmeldungen aus Claude Code |
---
## Phasenmodell
### Phase 1 – Entwurf (Claude.ai)
**Ziel:** Das *Was* und *Warum* vollständig klären.
Ergebnisse:
- `PROJEKT.md` – Anforderungen, Architektur, Module, Tech-Stack
- `ENTSCHEIDUNGEN.md` – Architekturentscheide mit Begründung
- `CLAUDE.md` – Dauerhafte Regeln und Konventionen für Claude Code
**Übergabepunkt zu Claude Code ist erreicht, wenn:**
1. ✅ Alle Module/Tabellen/Endpoints namentlich bekannt
2. ✅ Abhängigkeiten zwischen Modulen geklärt
3. ✅ Tech-Stack und Zielumgebung festgelegt
4. ✅ Schritt 1 klar und abgegrenzt definiert
5. ✅ PROJEKT.md, ENTSCHEIDUNGEN.md und CLAUDE.md in Git committed
6. ❌ Noch kein Code existiert (das ist Claude Codes Job)
---
### Phase 2 – Umsetzung (Claude Code)
**Ziel:** Schrittweise Implementierung auf Basis der Konzeptdokumente.
Regeln:
- Claude Code liest CLAUDE.md automatisch beim Start (Gedächtnis)
- Claude Code liest PROJEKT.md + ENTSCHEIDUNGEN.md als Wahrheitsquelle
- Claude Code schreibt **niemals** in PROJEKT.md oder ENTSCHEIDUNGEN.md
- Rückfragen → `RUECKFRAGEN.md`
- Konzeptabweichungen → `CHANGELOG.md`
- Commit nach jedem abgeschlossenen Schritt
---
### Phase 3 – Rückkopplung (zurück zu Claude.ai)
**Trigger für Rückkehr zu Claude.ai:**
- Ein Abschnitt in PROJEKT.md wird durch die Realität ungültig
- Eine Grundsatzentscheidung muss revidiert werden
- Neue Anforderungen entstehen aus der Praxis
- Eine neue dauerhafte Regel soll in CLAUDE.md aufgenommen werden
**Ablauf:**
1. Du bringst CHANGELOG.md + RUECKFRAGEN.md zu Claude.ai
2. Claude.ai aktualisiert PROJEKT.md (neue Versionsnummer + Datum)
3. ENTSCHEIDUNGEN.md wird ergänzt
4. CLAUDE.md wird bei Bedarf um neue Regeln erweitert
5. Zurück zu Claude Code mit aktualisierten Dokumenten
---
## Schreibrechte-Regel (strikt einhalten)
| Datei | Claude.ai | Claude Code |
|-------|-----------|-------------|
| PROJEKT.md | ✅ Schreiben | 🔴 Nur lesen |
| ENTSCHEIDUNGEN.md | ✅ Schreiben | 🔴 Nur lesen |
| CLAUDE.md | ✅ Schreiben | 🔴 Nur lesen |
| RUECKFRAGEN.md | 🔴 Nur lesen | ✅ Schreiben |
| CHANGELOG.md | 🔴 Nur lesen | ✅ Schreiben |
| STATUS.md | ✅ Schreiben | ✅ Schreiben |
| Code / src/ | 🔴 Nicht anfassen | ✅ Schreiben |
---
## Dateistruktur im Git-Repo
```
/
├── CLAUDE.md ← Dauerhaftes Gedächtnis für Claude Code (auto-geladen)
├── PROJEKT.md ← Anforderungen, Architektur, Schritte
├── ENTSCHEIDUNGEN.md ← Architekturentscheide + Begründungen
├── CHANGELOG.md ← Konzeptänderungen aus Claude Code
├── RUECKFRAGEN.md ← Offene Fragen aus Claude Code
├── STATUS.md ← Aktueller Stand, wer ist dran
├── .claude/
│ └── rules/ ← Modulare Detailregeln (optional, bei größeren Projekten)
└── src/
└── ...
```
---
## Versionierung der Konzeptdokumente
PROJEKT.md trägt im Header immer:
```
Version: X.Y
Datum: YYYY-MM-DD
Änderungsgrund: [kurze Beschreibung]
```
Jede Aktualisierung durch Claude.ai = neue Versionsnummer + Git-Commit.
---
## Verwandte Notes
- [[Claude-Workflow-Templates]] – Alle Dateivorlagen inkl. CLAUDE.md
- [[Claude-Workflow-CLAUDE-md-Template]] – CLAUDE.md erklärt und als Template
- [[Claude-Workflow-Prompts]] – Prompts für Claude.ai und Claude Code
- [[Claude-Workflow-Einfach]] – Einfache Erklärung für den schnellen Überblick
---
*Letzte Änderung: 2026-06-17 16:00*