Claude Code richtig nutzen: Workflow, Briefing und QA für Founder

Eine Abfolge von Idee über Research, Entscheidung, Umsetzung und QA bis Release, mit einer Übergabe-Kapsel zwischen Phasen. — Ein durchgehender Ablauf von der Idee bis zum Release — inklusive sauberer Übergabe zwischen Phasen und Tools.

Claude Code ist ein AI-Coding-Agent: stark im Umsetzen, aber blind für alles, was nicht im Auftrag steht. Ob das Ergebnis trägt, entscheidet sich vor dem ersten Prompt — bei der Vorbereitung und beim Briefing. Diese Seite beschreibt einen nüchternen Arbeitsmodus für Founder, die mit AI-Agenten an echten Projekten arbeiten. Wer die Methode als feste Struktur will, findet sie im AI Orchestrator — oder liest zuerst den Beispiel-Workflow.

Bevor du startest

Die meisten Fehlläufe entstehen nicht im Modell, sondern davor. Ein kurzer Pre-Flight verhindert die häufigsten Probleme:

Ist das Repository sauber (keine ungesicherten Änderungen)?
Bist du auf der richtigen Branch — und nicht versehentlich auf main?
Ist der aktuelle main-Stand geholt (kein veralteter Ausgangspunkt)?
Sind die Projektregeln gelesen (z. B. CLAUDE.md oder AGENTS.md)?
Sind die Schutzbereiche bekannt, die nicht angefasst werden dürfen?
Sind die QA-Befehle bekannt, die vor „fertig" grün sein müssen?
Ist klar, wann abgebrochen wird und auf welchen Stand zurückgesetzt wird?

Erst wenn diese Punkte stehen, lohnt der erste Auftrag. Ein veralteter main-Stand oder eine unklare Schutzzone kostet später mehr Zeit, als die Vorbereitung gekostet hätte.

So briefst du Claude Code

Ein gutes Briefing ist werkzeugneutral — dieselbe Struktur trägt Claude Code, Codex oder ChatGPT. Es besteht aus klaren Bausteinen:

Ziel — eine Aufgabe in einem Satz, mit messbarem Ergebnis.
Kontext — Projekt, aktueller Stand, warum die Aufgabe jetzt ansteht.
Relevante Dateien — konkrete Pfade als Einstieg.
Grenzen — welcher Bereich bearbeitet werden darf.
Was nicht verändert werden darf — Schutzbereiche wie Bezahlung, Recht, Konfiguration.
Risiken — was schiefgehen kann und worauf zu achten ist.
QA — welche Tests und Checks vor „fertig" grün sein müssen.
Akzeptanzkriterien — woran sich Erfolg nachprüfbar zeigt.
Abschlussbericht — was geändert wurde und was offen blieb.

Eine fertige, kopierbare Struktur dafür steht in der AI-Agenten-Briefing Vorlage. Wer mehrere Werkzeuge vergleicht, findet die Unterschiede in Claude Code vs. Codex.

Gute Aufgabengrößen

Die richtige Größe ist die, deren Ergebnis du noch prüfen kannst. Je höher das Risiko, desto stärker das Gate:

Tabelle horizontal scrollen, um alle Spalten zu sehen.

Aufgabengröße	Beispiele	Passendes Gate
Klein	Copy/Inhalt, fokussierter Bugfix, eine Seite, eine Testdatei	Standard-QA: Diff lesen, Tests, kurzer Smoke.
Mittel	Öffentliche SEO-Seite, Komponente plus Tests, Report-Refresh	QA plus unabhängiges Review; klar abgegrenzter Bereich.
Groß / hohes Risiko	Bezahlung/Stripe, Datenbank, Login/Auth, Tracking, Recht/Steuer	Operator-Freigabe und strengeres Gate; nie beiläufig.

Hochriskante Bereiche — Bezahlung, Stripe, Datenbank, Login, Tracking, Recht/Steuer — werden nie beiläufig beauftragt. Sie gehören hinter eine ausdrückliche Operator-Freigabe.

Das Ergebnis prüfen

Ein Agentenlauf endet nicht mit „fertig", sondern mit einer Prüfung. Bevor du etwas übernimmst:

Den Diff lesen und die Liste der geänderten Dateien gegen die Aufgabe halten.
Tests und Build ausführen — und tatsächlich grün sehen, nicht nur behaupten lassen.
Einen kurzen Browser-Smoke machen, wenn die Änderung sichtbar ist.
Prüfen, dass keine Schutzbereiche berührt und keine versteckten Bereiche verändert wurden.
Auf unbelegte Behauptungen achten und einen Abschlussbericht verlangen.

Eine ausführliche Liste dafür steht in der KI-Agenten QA-Checkliste. Welche Kontextdateien einen Coding-Agenten überhaupt steuern, erklärt AGENTS.md, CLAUDE.md und PROJECT_CONTEXT.md.

Typische Fehler beim Arbeiten mit Claude Code

Eine zu breite Aufgabe geben, deren Diff niemand mehr vollständig prüfen kann.
Keine Liste geschützter Dateien benennen — der Agent fasst Sensibles mit an.
Keine QA-Befehle vorgeben, sodass „fertig" nicht überprüfbar ist.
Keine Akzeptanzkriterien — Erfolg bleibt Geschmackssache.
Zwei Agenten gleichzeitig in denselben Dateien arbeiten lassen.
Einen Abschlussbericht akzeptieren, ohne ihn zu verifizieren.
Bezahlung, Umgebung oder Recht ohne ausdrückliches Gate ändern lassen.

Beispiel-Mini-Workflow

Ein kompakter Durchlauf für eine kleine, klar umrissene Aufgabe — bewusst knapp gehalten:

mini-workflow.txt

1. Aktuellen main-Stand holen (git pull)
2. Eigene Branch anlegen
3. Claude Code genau eine klare Aufgabe geben
4. Bericht der geänderten Dateien verlangen
5. QA ausführen (Tests + Build)
6. Browser-Smoke prüfen
7. Nur bei grünem Stand mergen

Der Kern: Erst isolieren (eigene Branch), dann eine klare Aufgabe, dann prüfen (Bericht, QA, Smoke) und erst bei grünem Stand zusammenführen.

Was diese Seite nicht verspricht

Ein klarer Workflow macht die Arbeit mit Claude Code nachvollziehbarer und sicherer steuerbar — mehr nicht. Er ist kein Erfolgsversprechen und kein Ersatz für Entwicklung, Design oder Beratung. Welcher Coding-Agent „der beste" ist, hängt vom Einzelfall ab; diese Seite vergleicht keine Tagesform von Modellen und verspricht keine Suchplatzierung. Was sie leistet: aus einem AI-Agenten ein überprüfbares Werkzeug statt einer Blackbox machen.

Häufige Fragen

Wie nutze ich Claude Code richtig?

Indem du nicht mit „mach mal" startest, sondern mit Struktur: Ziel, Kontext, erlaubter Bereich, Schutzbereiche, Risiken, QA und Akzeptanzkriterien. Kleine, klar umrissene Aufgaben funktionieren besser als ein großer, vager Auftrag — und das Ergebnis prüfst du, bevor du es übernimmst. Tool-Hype ist zweitrangig; Briefing, Scope und QA tragen das Ergebnis.

Was gehört in ein gutes Claude-Code-Briefing?

Dieselben Bausteine wie für jeden AI-Agenten: Ziel in einem Satz, Kontext zum Projekt, relevante Dateien, Grenzen, ausdrückliche Schutzbereiche, Risiken, QA-Schritte, Akzeptanzkriterien und ein Abschlussbericht. Eine fertige Struktur dafür steht in der AI-Agenten-Briefing Vorlage.

Wie groß sollte eine Aufgabe für Claude Code sein?

So klein, dass du den Diff in wenigen Minuten prüfen kannst. Eine Seite, ein Bugfix oder eine Testdatei sind gute Größen. Mittlere Aufgaben (Komponente plus Tests) brauchen ein unabhängiges Review. Große, risikoreiche Bereiche werden zerlegt und mit einer Freigabe versehen — nicht in einem Rutsch beauftragt.

Wann brauche ich eine Operator-Freigabe?

Sobald ein sensibler Bereich berührt würde: Bezahlung und Stripe, Datenbank, Login/Authentifizierung, Tracking oder rechtliche und steuerliche Inhalte. Solche Änderungen gehören hinter ein ausdrückliches Gate mit menschlicher Entscheidung, nicht in einen beiläufigen Agentenlauf.

Darf ein Coding-Agent den Bezahlbereich oder Stripe-Code ändern?

Nur mit ausdrücklicher Freigabe und in einem eng begrenzten, geprüften Schritt. Bezahl-Flow, Preise, Sessions und Webhooks sind Schutzbereiche: Sie stehen in der Aufgabenbeschreibung als nicht berührbar, solange keine bewusste, separat freigegebene Aufgabe genau das vorsieht.

Warum brauche ich QA trotz AI-Agent — und wie hilft AI Orchestrator dabei?

Weil „fertig" ohne Prüfung nur „sieht fertig aus" heißt: Tests, Build und ein kurzer Browser-Smoke trennen ein echtes Ergebnis von einem plausiblen. AI Orchestrator bündelt genau diese Disziplin — wiederverwendbare Aufgaben-Vorlagen, Schutzbereich-Regeln, QA-Gates, Founder-Workflows und ein Berichts-Format — als lokale Markdown-Dateien, damit du sie nicht jedes Mal neu erfindest.