Was gehört in die CLAUDE.md und was nur an einzelne Aufgaben?

Claude Code liest beim Start die Datei CLAUDE.md aus dem Repository. Codex und viele andere Agenten haben eine gleichartige Datei, AGENTS.md. Dort lässt sich alles ablegen, was der Agent über das Projekt wissen soll: wie die Tests laufen, wo was liegt, welche Coderegeln gelten.

Mit der Zeit wächst die Datei, und es sammeln sich Anweisungen an, die nicht in jeder Aufgabe gebraucht werden.

Ein Beispiel: Reviewer nach der Entwicklung

Bei Aufgaben mit Code hilft ein Vorgehen mit unabhängigen Reviewern. Nach der Entwicklung startet der Agent separate Subagenten, die nicht gesehen haben, wie der Code entstanden ist. Sie lesen die Änderungen und gleichen sie mit der Aufgabe und den Projektregeln ab. Einer prüft, ob umgesetzt wurde, was verlangt war. Ein anderer achtet auf Stil und überflüssigen Code. Was die Reviewer finden, korrigiert der Agent, bevor er „fertig“ meldet.

Eine solche Anweisung umfasst etwa fünfzehn Zeilen. Steht sie in CLAUDE.md, bekommt der Agent sie in jeder Sitzung: bei einer Aufgabe zum Landingpage-Text genauso wie bei einer Log-Analyse, wo es keinen Code zu prüfen gibt. Das ist unnötiger Kontext, manchmal auch unnötige Arbeit.

In jeder Aufgabe von Hand schreiben ist ebenfalls unpraktisch. Man vergisst sie leicht, und beim Kopieren aus einer alten Aufgabe erwischt man schnell eine veraltete Fassung.

Eine Anweisung für eine Art von Aufgaben

In Tascue wird so eine Anweisung zu einem Baustein, zum Beispiel „Unabhängige Reviewer“. Man hakt ihn bei Aufgaben ab, in denen sich Code ändert, und beim Kopieren landet er am Ende des Prompts. Bei Aufgaben zu Texten und Recherche fehlt er einfach.

Entsteht ein Baustein, wenn im Backlog schon viele Aufgaben liegen, lässt er sich auf einen Schlag zu allen hinzufügen: „Auf alle Aufgaben im Backlog anwenden“. Aufgaben in Arbeit und erledigte Aufgaben bleiben unverändert.

Was wohin gehört

Anweisung Wo sie steht
Wird in jeder Aufgabe dieses Repositorys gebraucht: wie die Tests laufen, wie das Projekt aufgebaut ist CLAUDE.md
Wird in Aufgaben einer Art gebraucht: Code-Review, Prüfung im Browser, Regeln für Texte Projekt-Baustein
Wird in allen Projekten gebraucht: „keine Commits machen“ Gemeinsamer Baustein, der standardmäßig in neuen Aufgaben aktiviert ist
Wird in einer einzigen Aufgabe gebraucht Aufgabentext

Ein einfacher Test für eine neue Anweisung: Wird sie in jeder Aufgabe gebraucht? Wenn nicht, gehört sie in einen Baustein, und CLAUDE.md bleibt kurz genug, um in einer Minute gelesen zu werden.

Der Prompt einer Aufgabe setzt sich von selbst zusammen: Intro, Felder, Text, Bausteine. In Claude Code lässt er sich nach „Kopieren“ einfügen oder über MCP übergeben, und der Agent erhält dieselbe Aufgabe vollständig.

Folgen Sie Tascue auf LinkedIn