Obsidian-Notizen in ein präzises Claude-Code-Briefing verwandeln

Letzte Woche hatte ich in Obsidian eine Notiz mit gut 2000 Zeichen liegen lassen und bat Claude Code am nächsten Tag nur kurz: “Reparier mal diesen Checkout-Button.”

Zurück kam: die Button-Korrektur, dazu ein angepasster Header-Abstand, eine umsortierte Linkliste im Footer und obendrein eine aufgeräumte CSS-Namenskonvention – verteilt über drei Dateien. Nichts davon hatte ich verlangt. Der Grund war simpel: Ich hatte die komplette Notiz hineinkopiert. Selbst mein Gemurmel von vor drei Tagen (“das hier stört mich auch”) wurde mit demselben Gewicht gelesen wie die heutige Anweisung.

Die Notiz war nicht das Problem. Das Problem war ich, weil ich die Notiz für etwas hielt, das man “einfach so weitergeben” kann. Eine lange Notiz taugt zum Festhalten, nicht zum Anweisen. Heute zeige ich dir den Weg, der diese Lücke schließt: wie du eine Obsidian-Notiz in ein kurzes, klares Briefing verwandelst – Schritt für Schritt, mit Vorlage und Code.

Das Wichtigste in Kürze

• Kopierst du eine lange Notiz komplett hinein, kann die KI altes Gemurmel nicht von der heutigen Anweisung trennen und weitet die Arbeit auf Dinge aus, die du nie verlangt hast.
• Übergeben werden nur vier Dinge: “gesicherte Fakten”, “getroffene Entscheidungen”, “noch Offenes” und “der nächste Schritt”. Dazu kommen “nicht anfassen” und “Nachweis, dass es fertig ist”.
• Halte die Abschlussbedingung klein: eine Datei, ein Screen, ein Befehl – und prüfe Build plus Screenshot, bevor du weitergehst.
• Die Prompt-Vorlage und ein kurzer Code, der eine Notiz in ein Briefing umwandelt, lassen sich direkt kopieren.
• Der KI überlässt du “schreiben, suchen, reparieren”. Du selbst entscheidest über “Umfang, Priorität, Freigabe”. Vermischt du das, kracht es.

Warum ein kompletter Copy-Paste die Arbeit aufbläht

Claude Code arbeitet schnell. Genau deshalb läuft das Tool, wenn die erste Information breit ist, mit voller Kraft in die Breite.

In einer Notiz steckt ein Zeitversatz. Der heutige Fakt “der Button bricht um” und der Gedanke von vor einer Woche “die Farben wirken eigentlich alt” stehen als gleichwertige Stichpunkte nebeneinander. Ein Mensch unterscheidet das nach Datum und Kontext; die hineinkopierte KI kann nicht erkennen, welche Anweisung noch lebt. Aus lauter Hilfsbereitschaft fasst sie alles an.

Noch ein Punkt: In Notizen vermischen sich “Entschiedenes” und “noch Unentschiedenes”. Wird auch das Zögern als Anweisung gelesen, trifft die KI eigenmächtig eine Wahl und macht weiter. Das ist das Gefährlichste. Deshalb musst du vor der Übergabe einmal von Hand sortieren.

Übergeben werden nur vier Dinge

Die Sortierachse ist einfach – du verteilst alles auf diese vier Kategorien:

1. Fakt: Was tatsächlich überprüft ist. “Auf einem 375-px-Screen bricht der Button auf zwei Zeilen um”, “die öffentliche URL stimmt” – Dinge, denen jeder zustimmt, der hinschaut.
2. Entscheidung: Was schon feststeht. “Das kostenlose PDF steht vor dem bezahlten Kurs” – eine ausdiskutierte Linie, die sich nicht mehr bewegt.
3. Offen: Was noch unklar ist. “Welche Komponente den Button-Abstand trägt, ist unbekannt” – Lücken, die die KI nicht eigenmächtig füllen soll.
4. Nächster Schritt: Die eine Sache für dieses Mal. So konkret wie: “Komponente identifizieren, die kleinste CSS-Änderung setzen, auf Smartphone-Breite prüfen.”

Dazu kommen zwei Ergänzungen: Nicht anfassen (z. B. die Auth-Dateien rührst du diesmal nicht an) und Nachweis, dass es fertig ist (z. B. der Build läuft durch, ein Screenshot in Smartphone-Breite). Diese sechs Punkte sind der Inhalt des Briefings.

Worauf es beim Sortieren ankommt: Lösche das “Offene” nicht. Lässt du Unklarheiten ehrlich stehen, fragt die KI an genau dieser Stelle nach. Streichst du das Offene und schreibst es wie einen Fakt, rennt sie mit einer falschen Annahme los.

Was du der KI überlässt – und was du selbst entscheidest

Zieh die Grenze zwischen Delegieren und Selbst-in-der-Hand-Behalten gleich zu Beginn. Bleibt sie unscharf, verwackelt am Ende auch das beste Briefing.

Schritt	Der KI überlassen	Selbst entscheiden
Umfang	-	auf welche Datei/welchen Screen begrenzt
Recherche	Komponenten und Code suchen	Priorität der Suchziele
Umsetzung	die kleinste Änderung schreiben	erlaubte Obergrenze der Änderung
Prüfung	Build und Tests laufen lassen	finale Freigabe-Entscheidung

Wie die Tabelle zeigt, kann die KI gut “suchen, schreiben, laufen lassen”. “Wie weit gehen wir?” und “darf das live?” behältst du selbst in der Hand. Steht diese Grenze im Briefing, stoppt die KI von selbst, sobald sie den Umfang ausweiten will.

Die Prompt-Vorlage zum Kopieren

Markiere zuerst die Notiz so, wie sie ist, und füge sie unter diesen Auftrag ein. Hier lässt du die Sortierarbeit selbst von der KI erledigen.

Bitte ordne die folgende Obsidian-Notiz zu einem kurzen Briefing für Claude Code.
Gib ausschließlich diese Abschnitte aus und verwirf alles andere.

- Fakt: nur Überprüftes
- Entscheidung: feststehende, unbewegliche Linie
- Offen: nicht eigenmächtig füllen, als unklar stehen lassen
- Nächster Schritt: die eine Sache für dieses Mal, konkret
- Nicht anfassen: Dateien oder Funktionen, die diesmal unberührt bleiben
- Nachweis: woran man erkennt, dass es fertig ist (Build, Screenshot etc.)

Alte Gedanken und Geplauder fasse separat unter "Referenznotiz" zusammen
und mische sie nicht in die Anweisung.

Lies das entstandene Briefing noch einmal durch und prüfe nur zwei Dinge: ob aus “Offen” heimlich ein “Fakt” geworden ist und ob der nächste Schritt wirklich auf eine Sache eingegrenzt ist. Passt es, fügst du es direkt in deine CLAUDE.md oder in den Issue-Kommentar ein und bittest um die Umsetzung. Wie man eine CLAUDE.md schreibt, habe ich ausführlich in claude-md-best-practices zusammengefasst.

Der Prüfcode, der eine Notiz in ein Briefing umwandelt

Bevor du es von Hand machst, hier ein kleines Stück Code, das dir die Struktur in den Körper bringt. Es läuft mit Node.js. Es hält die Notiz in den sechs Punkten von oben und baut daraus ein einziges Briefing zusammen, das du Claude Code übergibst.

// Notiz in "Fakt, Entscheidung, Offen, naechster Schritt" gegliedert halten
const note = {
  title: "Checkout-Button bricht auf dem Smartphone um",
  facts: ["Auf 375px bricht der Button auf zwei Zeilen um", "Oeffentliche URL stimmt"],
  decision: "Kostenloses PDF steht vor dem bezahlten Kurs",
  unknowns: ["Unbekannt, welche Komponente den Button-Abstand traegt"],
  nextAction: "Komponente identifizieren, kleinste CSS-Aenderung setzen, auf Smartphone-Breite pruefen",
  doNotTouch: ["Dateien rund um die Authentifizierung"],
  proof: ["Build laeuft durch", "Screenshot bei 375px Breite"],
};

// Die sechs Punkte zu einem einzigen Briefing-Text zusammenbauen
function toBrief(item) {
  return [
    `Ziel: ${item.nextAction}`,
    `Fakt: ${item.facts.join(" / ")}`,
    `Entscheidung: ${item.decision}`,
    `Offen (nicht eigenmaechtig fuellen): ${item.unknowns.join(" / ")}`,
    `Nicht anfassen: ${item.doNotTouch.join(" / ")}`,
    `Nachweis: ${item.proof.join(" / ")}`,
  ].join("\n");
}

// Tuersteher, der fehlende Sortierung maschinell prueft
function checkBrief(item) {
  const missing = [];
  if (item.facts.length === 0) missing.push("Fakt");
  if (item.unknowns.length === 0) missing.push("Offen");
  if (!item.nextAction) missing.push("naechster Schritt");
  if (missing.length) {
    throw new Error(`Sortierung unvollstaendig: ${missing.join(", ")}`);
  }
  return true;
}

checkBrief(note);
console.log(toBrief(note));

checkBrief ist unscheinbar, aber das Herzstück. Versuchst du, ein Briefing mit leeren Fakten, leerem Offenem oder leerem nächstem Schritt auszugeben, stoppt es genau hier. Verbietest du das “erst mal reinkopieren” schon auf Code-Ebene, sinkt die Zahl der Unfälle, bei denen eine schlampige Notiz ungefiltert zur KI fließt. Fügst du das Ergebnis direkt in den Issue-Kommentar oder in eine Übergabenotiz ein, kannst du dieselbe Entscheidung beim nächsten Mal wiederverwenden. Wie man eine Übergabenotiz aufbaut, zeigt claude-code-session-handoff-template.

In diesen Situationen zahlt es sich aus

1. Wenn du um eine Artikel-Verbesserung bittest Wirfst du der KI ein “mach diesen Artikel besser” hin, schreibt sie gern den ganzen Text neu. Schreib stattdessen ins Briefing: “Übergeben werden nur Suchintention und CTA-Richtung”, “ein Neuschreiben des gesamten Textes ist verboten”. Fakt ist die aktuelle Überschrift, Entscheidung die Linie der Nutzerführung, Offen die schwachen Absätze, nächster Schritt eine einzige Überschrift korrigieren. So bleibt der Diff klein und ein Zurückrollen dauert nur einen Augenblick. Die Einrichtung der Obsidian-Anbindung selbst habe ich in claude-code-obsidian-integration zusammengefasst.

2. Wenn du einen Bug behebst Der Trick ist, den reproduzierten Fakt und die noch unklare Ursache getrennt zu übergeben. “Bei 375px bricht der Button um” ist ein Fakt, “welche Komponente den Abstand trägt” ist Offenes. Vermischt du das und schreibst “die Ursache liegt sicher im CSS”, beginnt die KI mit einem falschen Verdacht zu reparieren. Übergibst du Offenes als Offenes, untersucht die KI das zuerst.

3. Wenn du bei einer Einführung berätst Zeig die Geschäftsnotiz des Kunden nicht roh, sondern aufgeteilt in “diesmal berührter Bereich”, “auf keinen Fall berührter Bereich” und “beim nächsten Mal zu prüfen”. Echte Daten oder die Abrechnung lässt du nicht im offenen Zustand automatisch anfassen. Steht diese Grenze im Briefing, kannst du im Beratungsgespräch beruhigt deinen Bildschirm teilen.

Häufige Fehler und wie du sie behebst

Meine ersten Patzer passen fast alle in diese drei Schubladen.

Erstens: den ganzen Vault hineinkopiert. Alte Entscheidungen und aktuelle Vorgaben vermischten sich, und die KI wusste nicht mehr, welcher Seite sie glauben sollte. Die Korrektur ist banal: vor dem Einfügen einfach in die sechs Punkte von oben sortieren. Den Gedanken von vor drei Tagen isolierst du in der “Referenznotiz”.

Zweitens: nur die Entscheidung übergeben. Schrieb ich bloß “PDF nach vorne”, wusste die KI nicht, warum, und tat in anderem Kontext das Gegenteil. Lässt du Fakt und Begründung zusammen stehen, lässt es sich übertragen.

Drittens: die Abschlussbedingung zu groß gemacht. Bittest du um “alles ein bisschen aufräumen”, weitet die KI hilfsbereit den Umfang aus. Begrenze auf eine Datei, einen Screen, einen Befehl, und sieh dir Build plus Screenshot an, bevor du weitergehst. Allein das senkt die Rückrollzeit, ohne das Tempo zu drosseln. Zum Eingrenzen von Prompts passt auch claude-code-prompt-engineering-advanced.

Häufige Fragen

F. Ist ein Briefing zu bauen nicht mehr Aufwand, als die Notiz komplett einzufügen? Die ersten paar Male fühlt sich das so an. Aber die Zeit, einen aufgeblähten Diff aus dem Hinwurf wieder durchzulesen und zurückzurollen, wiegt auf lange Sicht schwerer. Das Sortieren ist mit etwas Übung in einer Minute erledigt.

F. Darf auch das Sortieren die KI machen? Ja. Die Prompt-Vorlage oben ist genau diese Nutzung. Lies das entstandene Briefing aber einmal selbst und prüfe nur, ob aus Offenem heimlich ein Fakt geworden ist.

F. Wie unterscheiden sich CLAUDE.md und Briefing? Die CLAUDE.md ist der Ablageort für Regeln, die im ganzen Projekt gleich bleiben; das Briefing ist der Auftrag für genau diese eine Aufgabe. Taucht eine “Entscheidung” aus dem Briefing immer wieder auf, ist das das Signal, sie in die CLAUDE.md hochzustufen.

F. Geht das auch ohne Obsidian? Ja. Notion oder eine simple Textnotiz tun es ebenso. Entscheidend ist nicht das Tool, sondern die Denkweise: in Fakt, Entscheidung, Offen und nächsten Schritt zu gliedern.

F. Wie viel überlasse ich der KI und ab wann entscheide ich selbst? “Suchen, schreiben, laufen lassen” kannst du ruhig überlassen. “Wie weit weiten wir den Umfang aus?” und “darf das live?” behältst du in der Hand. Der Trick ist, diese Grenze ins Briefing zu schreiben. Die Grundlagen, wie man der KI etwas überlässt, erkläre ich in claude-code-for-non-engineers.

Was ich tatsächlich getestet habe

Nach dem “Drei-Dateien-Unfall, den ich nie verlangt hatte” aus der Einleitung sortiere ich jede Notiz jetzt zwingend in die sechs Punkte, bevor ich sie einfüge.

Ich habe dieselbe Checkout-Button-Korrektur diesmal als Briefing übergeben. Der Diff: eine Datei, ein paar CSS-Zeilen. Weder Header noch Footer – nichts, was ich nicht verlangt hatte, wurde angefasst. Dass checkBrief mich einmal stoppte, als ich das Offene leer ausgeben wollte, und ich erst “welche Komponente den Abstand trägt” nachtrug, hat sicher geholfen: Die KI hat genau diese Komponente nämlich zuerst gesucht.

Bestätigt habe ich zwei Dinge. Erstens: Lasse ich Offenes stehen, füllt die KI es nicht eigenmächtig, sondern recherchiert. Zweitens: Grenze ich den nächsten Schritt auf eine Sache ein, bleibt der Diff klein und leicht zurückzurollen. Mein heutiges Fazit: Statt nach dem cleveren Prompt zu suchen, ist die eine Minute Sortieren vor der Übergabe am Ende der schnellste Weg.

Wenn du dich ans Sortieren gewöhnt hast und denselben Ablauf als Nächstes im ganzen Team fahren willst, gibt es auch das Training und die Beratung, bei denen wir das Vorgehen gemeinsam aufsetzen.

Die offiziellen Voraussetzungen findest du unter Anthropic Claude Code getting started.