# So funktioniert unser Claude-Workflow – einfach erklärt **Version:** 1.1 **Datum:** 2026-06-17 | 16:00 **Änderung v1.1:** CLAUDE.md als Gedächtnis-Datei ergänzt --- ## Die Grundidee Stell dir vor, du baust ein Haus. Claude.ai ist der Architekt – der macht den Plan, überlegt was gebaut werden soll und warum. Claude Code ist der Handwerker – der baut dann nach Plan, ohne groß nachzudenken warum die Wand da steht. Das Problem bisher: Der Handwerker hat keinen vernünftigen Plan gekriegt und musste raten. Das geht jetzt anders. --- ## Wie es abläuft **Schritt 1 – Du redest mit Claude.ai** Du erklärst was du bauen willst. Claude.ai fragt so lange nach, bis alles klar ist: Welche Module, welche Datenbank, welche Schnittstellen, warum so und nicht anders. Am Ende schreibt Claude.ai alles sauber auf – in drei Dateien die ins Git-Repo kommen: - `CLAUDE.md` – Das Gedächtnis: Regeln, Konventionen, Schreibrechte (wird von Claude Code bei jeder Session automatisch geladen) - `PROJEKT.md` – Was gebaut wird und wie es aussehen soll - `ENTSCHEIDUNGEN.md` – Warum welche Entscheidungen so getroffen wurden Wenn diese drei Dateien fertig und committed sind, ist Claude.ai erstmal fertig. --- **Schritt 2 – Claude Code baut** Claude Code liest beim Start automatisch CLAUDE.md – das ist sein Gedächtnis für dieses Projekt. Dann liest es PROJEKT.md und ENTSCHEIDUNGEN.md und bekommt einen klaren Auftrag: *Bau Schritt 1.* Claude Code baut, committet nach jedem fertigen Schritt – und wenn dabei irgendwas nicht passt, schreibt er das auf, aber ändert **nicht** eigenmächtig den Plan. Dafür gibt es zwei weitere Dateien: - `RUECKFRAGEN.md` – Wenn Claude Code nicht weiterkommt und eine Entscheidung braucht - `CHANGELOG.md` – Wenn Claude Code merkt dass der Plan in der Realität nicht so klappt wie gedacht --- **Schritt 3 – Du gehst zurück zu Claude.ai** Immer wenn `RUECKFRAGEN.md` oder `CHANGELOG.md` was Wichtiges enthält, nimmst du den Inhalt und gehst damit zurück zu Claude.ai. Claude.ai liest alles durch, beantwortet die Fragen, passt den Plan an – und schreibt bei Bedarf neue Regeln in CLAUDE.md damit der Fehler nicht nochmal passiert. Das ist der Kreislauf. --- ## Die wichtigste Regel **Claude Code darf den Plan nicht ändern – nur drüber schreiben.** Klingt streng, ist aber der Kern der ganzen Sache. Wenn Claude Code still und heimlich den Plan abändert ohne es zu dokumentieren, weißt du irgendwann nicht mehr ob dein Code noch dem entspricht was du dir vorgestellt hast. Das ist genau der Reibungsverlust den wir vermeiden wollen. --- ## Was ist CLAUDE.md genau? CLAUDE.md ist die einzige Datei die Claude Code bei **jeder** Session automatisch lädt – egal ob Terminal oder Desktop App, egal ob neue oder alte Session. Da steht drin: - Welche Dateien Claude Code lesen darf und welche nicht - Wie Code aussehen soll (Einrückung, Sprache, Logging) - Was absolut verboten ist - Was Claude Code in der Vergangenheit falsch gemacht hat und nie wieder tun soll Wenn Claude Code also mal einen Fehler macht und du ihn korrigierst: Neue Regel in CLAUDE.md – und der Fehler taucht nie wieder auf. --- ## Wann wechsle ich von Claude.ai zu Claude Code? Ganz einfach – wenn du dir diese Fragen mit Ja beantworten kannst: 1. Weiß ich welche Module/Tabellen/Funktionen es geben wird? 2. Weiß ich wie die Teile zusammenhängen? 3. Ist der Tech-Stack und die Zielumgebung klar? 4. Ist der erste Bauabschnitt klar abgegrenzt? 5. Sind CLAUDE.md, PROJEKT.md und ENTSCHEIDUNGEN.md in Git? Wenn ja → rüber zu Claude Code. Wenn nein → weiter mit Claude.ai. --- ## Kurz zusammengefasst ``` Claude.ai → plant, entscheidet, dokumentiert, pflegt CLAUDE.md Claude Code → baut, fragt, meldet Abweichungen, liest CLAUDE.md automatisch Du → trägst die Rückmeldungen hin und her Git → merkt sich alles Obsidian → erklärt alles ``` So einfach ist es. --- ## Verwandte Notes - [[Claude-Workflow-Konzept]] – Das vollständige Regelwerk - [[Claude-Workflow-Templates]] – Dateivorlagen inkl. CLAUDE.md - [[Claude-Workflow-CLAUDE-md-Template]] – CLAUDE.md ausführlich erklärt - [[Claude-Workflow-Prompts]] – Fertige Prompts zum Kopieren --- *Letzte Änderung: 2026-06-17 16:00*