Produktiver Claude-Code-Prompt-Brief: Was Anfänger zuerst liefern sollten

Warum dieser Ablauf wichtig ist

Anfänger scheitern selten an schöner Prompt-Sprache. Meist fehlen Ziel, geschützte Dateien, Umsatzlinks und Done-Kriterien. Ein kurzer Task-Brief reduziert Raten und hält den ersten Patch klein.

Dazu passt: First-Task-Runbook, Prompt-Bibliothek, CLAUDE.md-Template.

Praktischer Ablauf

Schreiben Sie das Ziel in einem Satz, dann Datei, Leser und Business-Grund. Ergänzen Sie verbotene Bereiche, zu schützende Gumroad-Links und den Proof-Befehl.

Minimales Kopier-Set

# Claude Code task brief

## Goal
Change one clear thing:

## Context
- user or reader:
- current file/page:
- business reason:

## Constraints
- do not touch:
- keep these links working:
- proof command:

## Definition of done
- small diff
- public URL checked
- CTA path still works
- handoff note written

Use this brief before editing.
Ask up to three clarifying questions only if the goal, protected files, or proof command is missing.
Then propose the smallest safe patch and the verification receipt.

rg --files | Select-Object -First 80
git diff --name-only
cd site
npm.cmd run build

Beispiel für einen guten Anfrage-Brief

Ein guter Brief sagt Claude Code nicht nur, was geändert werden soll. Er erklärt auch den Grund und die Grenzen. Für eine Artikeländerung kann die Anfrage so aussehen:

Verbessere nur Einleitung und CTA-Bereich in site/src/content/blog-de/claude-code-productive-prompt-brief.mdx. Der Leser ist ein Solo-Entwickler, der Claude Code zum ersten Mal ernsthaft ausprobiert. Ziel ist, dass er nach dem Gratis-PDF natürlich versteht, wann Prompt Templates, der Setup Guide oder Beratung sinnvoll sind. Ändere nicht Frontmatter, Slug, bestehende Gumroad-Links, interne Links oder Codeblöcke. Führe danach node scripts/check-updated-article-quality.mjs aus und melde, ob die Fehler für diesen Slug verschwunden sind.

Der Brief funktioniert, weil die Arbeitsfläche eng ist. “Nur Einleitung und CTA-Bereich” verhindert einen kompletten Rewrite. Leser und Business-Ziel geben Richtung: Claude Code soll nicht nur schönere Sätze schreiben, sondern die nächste Entscheidung des Lesers unterstützen.

Auch die geschützten Elemente sind konkret. Frontmatter steuert Datum, Kategorie und heroImage. Gumroad-Links sind Umsatzpfade. Interne Links halten die Navigation im Artikelnetz. Codeblöcke sind Material zum Kopieren. Wenn diese Punkte vor der Bearbeitung feststehen, ist der spätere Review deutlich ruhiger.

Beispiel für eine schlechte Anfrage

Eine schwache Anfrage klingt oft plausibel, bleibt aber zu offen:

Mach diesen Artikel besser für SEO und Conversion.

SEO kann Titel, Keywords, interne Links, Description oder mehr Text bedeuten. Conversion kann ein stärkerer CTA, mehr Gumroad-Verweise, eine Vergleichstabelle oder eine persönliche Erfahrung sein. Ohne Grenzen erzeugt Claude Code leicht einen großen Diff, der schwer zu prüfen ist und womöglich wichtige Bereiche berührt.

Ebenfalls riskant ist:

Schreib es anfängerfreundlicher und sag Bescheid, wenn es fertig ist.

Die Absicht ist richtig, aber der Abschluss ist nicht messbar. Besser ist eine Anfrage, die einen guten Brief, ein schlechtes Beispiel, ein Anfänger-Template und den natürlichen Weg zu Gratis-PDF, Gumroad-Material und Beratung verlangt. Dazu gehört auch der konkrete Prüf-Befehl.

Anfänger-Template für die erste Anfrage

Am Anfang muss der Prompt nicht perfekt sein. Füllen Sie fünf einfache Zeilen:

Änderung: eine Sache, die geändert werden soll
Ziel: Datei, URL, Befehl oder Bildschirm
Leser oder Nutzer: für wen die Änderung besser werden soll
Schutz: Dateien, Links, Verhalten oder Regeln, die bleiben müssen
Nachweis: Befehl oder Ergebnis, das den Abschluss beweist

Wenn Sie den CTA einer Produktseite verbessern wollen, begrenzen Sie die Änderung auf Text und Position des CTA. Das Ziel ist die MDX-Datei der Produktseite. Der Leser kennt das Gratis-PDF, ist aber unsicher, ob Vorlagen oder Setup-Hilfe nötig sind. Geschützt werden die Links zu Gratis-PDF, Prompt Templates und Setup Guide. Der Nachweis ist Build, öffentliche URL und Linkprüfung.

Dieses Template ist bewusst klein. Es macht den ersten Patch prüfbar, rücksetzbar und an ein Ergebnis gebunden. Später lassen sich Teamregeln ergänzen, etwa Übersetzungen synchron halten, Preise nicht ohne Freigabe ändern, Screenshots erhalten oder Überschriftenhierarchien nicht verschieben.

Natürlicher Weg zu Material und Beratung

Der Brief hilft auch bei der nächsten Empfehlung. Wer noch bei Basisbefehlen unsicher ist, braucht zuerst das Gratis-PDF. Wer ähnliche Anfragen wiederholt schreibt, spart mit Prompt Templates Zeit. Wenn Team-Rollout, Rechte, Review-Regeln oder Umsatzlinks betroffen sind, ist Beratung oft günstiger als Lernen über Produktionsfehler.

Die Reihenfolge im Artikel sollte deshalb klar bleiben: zuerst kostenlose Hilfe für heute, dann wiederverwendbare Vorlagen bei Wiederholung, zuletzt Beratung für Situationen mit höherem Risiko. So wirkt die Produktstrecke nicht aufdringlich, sondern folgt dem tatsächlichen Bedarf des Lesers.

Drei echte Anwendungsfälle

Bei einer CTA-Änderung kompletten Rewrite verbieten und öffentliche URL verlangen.
Bei CLAUDE.md zuerst verbotene Befehle und Build-Befehl nennen.
Bei Produktseiten Gratis-PDF, Prompt Templates und Setup Guide schützen.

Fehlerfälle und Gegenmittel

Nur ‘mach es besser’ fragen. Der Diff wird zu groß.
Geschützte Links auslassen. Umsatzpfade verschwinden oft unauffällig.
Keine Done-Kriterien. Claude Code bleibt bei Recherche stehen.

Pfad zu Gratis-PDF, Gumroad und Beratung

Nutzen Sie das Gratis-PDF vor dem Brief. Prompt Templates helfen bei wiederverwendbaren Anfragen. Der Setup Guide passt, wenn CLAUDE.md, Hooks und Projektannahmen stabil sein sollen.

Beginnen Sie mit dem kostenlosen PDF für Befehle und sichere Gewohnheiten. Kaufen Sie Gumroad-Material, wenn der Ablauf wiederkehrend wird, und buchen Sie Beratung, wenn Teamrisiko oder Umsatzpfad nicht geraten werden sollten.

Was ich für diesen Artikel geprüft habe

Ich trenne Markdown-Brief, kurze Anweisung und Proof-Befehl. Ziel ist eine Änderung, ein Beleg und ein Revenue-Path-Check.