Aus Obsidian-Notizen einen Auftrag machen, den Claude Code heute umsetzt

Freitagabend hatte ich in Obsidian nur diese eine Notiz hinterlassen: “Die Führung zur Anmeldung ist schwach. Viele bemerken den Link zum kostenlosen PDF wohl erst nach dem Scrollen.” Montagmorgen habe ich die Notiz komplett in Claude Code eingefügt und gesagt: “Bitte korrigieren.” Zurück kam eine zwei Bildschirme lange “Bestandsaufnahme”. Keine einzige Zeile Code.

Die Notiz war nicht schlecht. Das Problem war, dass ich sie unverändert übergeben habe. An dem Tag habe ich 30 Minuten verbrannt, nur um mir Hintergrunderklärungen anzuhören.

In Obsidian sammelt sich Wissen an, und trotzdem schreibe ich Claude Code jedes Mal dasselbe Vorgeplänkel hin. Wenn Ihnen das bekannt vorkommt: Was fehlt, ist keine klügere KI, sondern eine feste Schablone, mit der Sie eine Notiz zu einem Auftrag eindampfen.

Das Wichtigste in Kürze

• Fügen Sie eine Obsidian-Notiz unverändert ein, wird Claude Code zum Zusammenfasser und die Umsetzung verzögert sich. Übergeben Sie nicht den ganzen Text, sondern nur die eine Aufgabe, die heute fertig wird.
• Aus der Notiz holen Sie nur sechs Dinge heraus: Ziel, Tabuzone, ersten Schritt, Prüfweg, Wegführung und Rückweg.
• Wenn Sie zuerst “Lesebereich” und “Tabuzone” notieren, verschwindet der Unfall, dass die KI eigenmächtig bis ins Bezahl- oder Login-System ausgreift.
• Speichern Sie den Auftrag als Vorlage in Obsidian, sparen Sie sich beim nächsten Mal das Neuschreiben.
• Statt der Fertigmeldung zu glauben, entscheiden Sie anhand von Belegen wie Screenshots oder Build-Ergebnis.

Warum man die Notiz nicht komplett übergeben darf

Eine Obsidian-Notiz ist ein Brief an das eigene zukünftige Ich. Kontext und Zweifel stehen alle drin. Genau deshalb versucht eine KI, “alles zu lesen und zu verstehen”, sobald sie die Notiz bekommt.

Eine menschliche Kollegin liest die lange Notiz und kürzt sie von selbst auf “Im Kern geht es also um die Position des Führungslinks.” Claude Code denkt nicht so weit mit. Im Verhältnis zur übergebenen Textmenge schickt es eine sorgfältige Zusammenfassung zurück. Hilfsbereit, aber gewollt ist keine Zusammenfassung.

Deshalb kürzen wir auf der menschlichen Seite, bevor wir übergeben. Aus 1000 Zeichen Notiz bleiben nur die 30 Zeichen übrig, die für die Umsetzung nötig sind. Genau dieses Kürzen ist der kürzeste Weg, das ewige Vorgeplänkel loszuwerden.

Wer das Sortieren der Notizen selbst an Claude Code abgeben will, sollte vorab die Grundlagen der Obsidian-Anbindung lesen, dann greifen die Schritte aus diesem Artikel besser ineinander.

Die sechs Punkte, die ich aus der Notiz herausziehe

Aus jeder Notiz hole ich genau diese sechs Dinge heraus. Es ist nicht schlimm, wenn nicht alle sechs in der Notiz stehen. Die fehlenden Felder lege ich beim Kürzen selbst fest.

Punkt	Inhalt	Beispiel
Ziel	Das Ergebnis für die Nutzerin in einem Satz	Besucher bemerken den PDF-Link schon vor dem Scrollen
Tabuzone	Was nicht kaputtgehen darf	Zahlungsabwicklung, Login, Layout in der Mobilansicht
Erster Schritt	Wo man anfängt	Einen Abschnitt im ersten Sichtbereich der Startseite ergänzen
Prüfweg	Womit “fertig” belegt wird	Build läuft durch, Diff der Änderung, Optik der Live-URL
Wegführung	Wohin die Leser als Nächstes geleitet werden	Anmeldeseite für das kostenlose PDF
Rückweg	Der Fluchtweg im Fehlerfall	Nur diesen einen Commit rückgängig machen

Der entscheidende Punkt ist die “Tabuzone”. Lassen Sie dieses Feld leer, kann es passieren, dass Ihnen beim Korrigieren des Führungslinks nebenbei der Bezahl-Code “gleich mit aufgeräumt” wird. Vorab eine Sperrzone zu ziehen, wirkt am stärksten.

Was die KI übernimmt und was der Mensch entscheidet

Vermischt man das hier, gibt es Unfälle. Ich ziehe die Grenze klar.

• Der Mensch entscheidet: Ziel, Tabuzone, Rückweg. Das sind unternehmerische Entscheidungen und gehören nicht blind an die KI.
• Die KI übernimmt: den ersten Schritt konkretisieren, den Code umsetzen, die Prüfbefehle ausführen.
• Der Mensch schaut zum Schluss: Optik der Live-URL und ob der Diff dem entspricht, was geplant war. Nur das prüfe ich mit eigenen Augen.

Überlassen darf man das “Wie wird es gebaut”, nicht das “Was wird geschützt”. Wer festlegt, was geschützt wird, ist immer der Mensch.

Die Prompt-Vorlage, die aus der Notiz einen Auftrag macht

Die sechs herausgezogenen Punkte bringen wir in eine Form, die Sie Claude Code direkt übergeben können. Kopieren Sie die Vorlage unten und fügen Sie am Ende nur Ihre Notiz ein.

Wandle die folgende Obsidian-Notiz in einen einzigen Auftrag um, den du heute umsetzen kannst.
Gliedere die Ausgabe in die folgenden sechs Überschriften. Schreibe noch keinen Code.

- Ziel (das Nutzerergebnis in einem Satz)
- Tabuzone (Stellen, die nicht geändert werden dürfen)
- Erster Schritt (eine kleinste Änderung)
- Prüfweg (Build, Diff, Live-URL usw.)
- Wegführung (wohin die Leser als Nächstes geleitet werden)
- Rückweg (Schritte, um im Fehlerfall zurückzukehren)

[NOTIZ]
(hier die Obsidian-Notiz einfügen)

Wichtig ist der letzte Satz: “Schreibe noch keinen Code.” Fehlt der, versucht Claude Code, Umwandlung und Umsetzung in einem Rutsch zu erledigen, und überspringt die Kontrolle der Tabuzone. Lassen Sie sich erst den Auftrag ausgeben, der Mensch prüft die Sperrzone, und erst dann antworten Sie: “Setze jetzt genau diesen Auftrag um.” Dieses zweistufige Vorgehen reduziert Unfälle.

Wer die Vorlage noch feiner schleifen will, findet im Artikel zu fortgeschrittenem Prompt-Design für Claude Code die Feinheiten der Formulierungen gesammelt.

Ein Umwandlungsskript zum Kopieren

Wenn Ihnen das händische Zusammenbauen des Prompts jedes Mal zu lästig ist, schreiben Sie die Notiz als Objekt und erzeugen den Auftrag automatisch. Mit Node.js läuft es direkt.

// Minimal-Skript, das eine Notiz in einen "heute umsetzbaren Auftrag" wandelt
// Aufruf: node note-to-issue.mjs

const note = {
  ziel: "Besucher bemerken den PDF-Link schon vor dem Scrollen",
  tabuzone: ["Zahlungsabwicklung", "Login", "Layout in der Mobilansicht"],
  ersterSchritt: "Einen Hinweis-Abschnitt im ersten Sichtbereich der Startseite ergaenzen",
  pruefweg: ["Build laeuft durch", "Diff der Aenderung", "Optik der Live-URL"],
  wegfuehrung: "Anmeldeseite fuer das kostenlose PDF",
  rueckweg: "Nur diesen einen Commit rueckgaengig machen",
};

function toIssuePrompt(n) {
  // Fehlt ein Pflichtfeld, soll es vor der Ausgabe des Auftrags auffallen
  const required = ["ziel", "tabuzone", "ersterSchritt", "pruefweg"];
  const missing = required.filter((key) => {
    const v = n[key];
    return v === undefined || (Array.isArray(v) && v.length === 0);
  });
  if (missing.length > 0) {
    throw new Error(`Dem Auftrag fehlen Pflichtfelder: ${missing.join(", ")}`);
  }

  const line = (label, value) =>
    `${label}: ${Array.isArray(value) ? value.join(" / ") : value}`;

  return [
    line("Ziel", n.ziel),
    line("Tabuzone", n.tabuzone),
    line("Erster Schritt", n.ersterSchritt),
    line("Pruefweg", n.pruefweg),
    line("Wegfuehrung", n.wegfuehrung),
    line("Rueckweg", n.rueckweg),
    "Schreibe noch keinen Code, gib nur den kleinstmoeglichen Umsetzungsplan in diesem Rahmen zurueck.",
  ].join("\n");
}

console.log(toIssuePrompt(note));

Beim Ausführen entsteht ein Auftrag aus sechs Zeilen plus dem Schlusssatz. Setzen Sie tabuzone auf ein leeres Array und lassen es erneut laufen, stoppt es vor der Ausgabe mit “Dem Auftrag fehlen Pflichtfelder”. Das ist ein Mechanismus, der den Unfall, mit leerem Feld zu übergeben, schon auf der Code-Seite abfängt.

Drei Situationen, in denen es wirklich wirkt

1. Notiz zur Verbesserung des Führungslinks Fügen Sie die Notiz “Der Link zum kostenlosen PDF ist schwach” unverändert ein, folgen endlose Erklärungen zu Verbesserungsideen. Eingedampft zum Auftrag verengt sich der Erste Schritt auf den einen Punkt “einen Abschnitt im ersten Sichtbereich ergänzen”, und an das Bezahlsystem darf nicht gerührt werden. Vergleichen Sie Vorher und Nachher über die Live-URL, beurteilen Sie die Wirkung mit den Augen statt nach Gefühl.

2. Notiz zur Fehlersuche Die Notiz “Manchmal wird der Bildschirm nach dem Login weiß” enthält zu viele Informationen. Im Auftrag verengen Sie den Ersten Schritt auf “zuerst nur Reproduktionsbedingungen und Fehlerlog teilen”. Lassen Sie Ursachensuche und Korrektur nicht in einem Rutsch laufen, sondern zuerst auf die Reproduktion fokussieren, dann vermeiden Sie eine Korrektur am falschen Ende.

3. Notiz zur Artikelplanung Auch die vage Notiz “Beim nächsten Artikel will ich saubere interne Links setzen” wird umsetzbar, wenn Sie das Ziel auf “zwei interne Links zu verwandten Artikeln fest verankern” eindampfen. Setzen Sie als Prüfweg “Build läuft durch”, stoppen Sie tote Links schon vor der Veröffentlichung. Bevor Sie das Drumherum von Artikeln abgeben, gewöhnen Sie sich einmal an der Claude-Code-Einführung für Nicht-Entwickler daran, dann fühlt es sich sicherer an.

Den Auftrag als Vorlage aufbewahren

Einen einmal erstellten Auftrag werfe ich nicht weg, sondern lege ihn nach Obsidian zurück. Denn beim nächsten Mal, wenn eine ähnliche Notiz kommt, lassen sich die sechs Überschriften samt Aufbau wiederverwenden.

Ich habe eine einzige Notiz namens templates/issue-prompt.md angelegt und dort die leere Vorlage mit sechs Überschriften abgelegt. Kommt eine neue Notiz, kopiere ich die Vorlage und fülle sie nur aus. Die Zeit, jedes Mal das Vorgeplänkel zu schreiben, ist verschwunden.

Verankern Sie zusätzlich die Regeln, die Claude Code lesen soll, direkt im Projekt, wird der Auftrag noch kürzer. Projektweite Absprachen lagern Sie am besten in das Vorgehen für CLAUDE.md aus, dann müssen Sie sie nicht in jedem Auftrag wiederholen.

Stolperfallen und wie man sie behebt

Hier sind die Fehler, die ich am Anfang selbst gebaut habe, jeweils mit Lösung.

• Die Notiz komplett einfügen: Claude Code wird zum Zusammenfasser. Lösung: vor dem Einfügen auf sechs Punkte eindampfen. Eine Notiz, die sich nicht eindampfen lässt, ist der Beweis, dass der Auftrag noch nicht steht. Schreiben Sie vorab selbst einen Satz Fazit.
• Die Tabuzone nicht notieren: Die KI greift eigenmächtig auf Bezahlung oder Login aus. Lösung: kein leeres Feld zulassen und auch nicht “keine Angabe” schreiben. Gewöhnen Sie sich an, mindestens eine Sperrzone zu nennen.
• Prüfweg ist “läuft, also okay”: Es bleibt nur, der Fertigmeldung zu glauben. Lösung: von Build-Ergebnis, Diff und Live-URL mindestens eines zwingend angeben.
• Alles in einem Rutsch umsetzen lassen: Umwandlung und Umsetzung vermischen sich, die Kontrolle der Sperrzone fällt weg. Lösung: immer “Schreibe noch keinen Code” einbauen und die Umsetzung erst nach Prüfung des Auftrags beauftragen.

Jede Stolperfalle war von der Sorte “mit einer vorab festgelegten Zeile wäre sie vermeidbar gewesen”.

Häufige Fragen

F. Meine Notiz ist fragmentarisch, ich kann die sechs Punkte nicht füllen. Es ist okay, wenn nicht alles ausgefüllt ist. Legen Sie wenigstens “Ziel” und “Tabuzone” fest, dann wird daraus ein Auftrag. Den Rest können Sie auch noch füllen, nachdem der Auftrag ausgegeben wurde, anhand von Claude Codes Vorschlägen.

F. Brauche ich eine Anbindung, damit Claude Code die Obsidian-Notiz direkt liest? Anfangs nicht. Die Notiz von Hand kopieren und in die Vorlage einfügen genügt völlig. Erst wenn Sie dieselbe Tätigkeit immer wieder wiederholen, ist es nicht zu spät, über eine automatische Anbindung nachzudenken.

F. Ich schreibe “Schreibe noch keinen Code”, trotzdem fängt es mit der Umsetzung an. Halten Sie in der CLAUDE.md des Projekts ausdrücklich fest: “Beim Umwandeln eines Auftrags keinen Code schreiben.” Eine projektweite Regel wird zuverlässiger befolgt als eine einmalige Anweisung im Prompt.

F. Wie lang sollte der Auftrag idealerweise sein? Ich peile bei sechs Überschriften insgesamt etwa zehn Zeilen an. Wird er länger, ist das ein Zeichen, dass in einer Aufgabe mehrere Ziele stecken. Teilen Sie die Aufgabe auf.

F. Ich weiß nicht, was ich in den Prüfweg schreiben soll. Wenn Sie unsicher sind, starten Sie mit den zwei Punkten “Build läuft durch” und “Optik der Live-URL”. Schon mit diesen beiden entkommen Sie dem Zustand, die Fertigmeldung blind zu schlucken.

Was ich tatsächlich ausprobiert habe

Die Notiz zum Führungslink vom Anfang habe ich mit dieser Sechs-Punkte-Vorlage eingedampft und dann noch einmal an Claude Code übergeben. Diesmal kam keine Zusammenfassung zurück, sondern als Erstes der Umsetzungsplan “einen Hinweis-Abschnitt im ersten Sichtbereich ergänzen”. An der als Tabuzone genannten Zahlungsabwicklung wurde nichts angefasst.

Auch beim Prüfskript habe ich tabuzone absichtlich leer gelassen und es laufen lassen. Es stoppte vor der Ausgabe des Auftrags mit “Dem Auftrag fehlen Pflichtfelder”. Damit war bestätigt, dass sich der häufigste Unfall, mit leerem Feld zu übergeben, schon vor der Ausführung verhindern lässt.

Statt jedes Mal eine clevere Anweisung auszubrüten, ist es schneller, eine einzige Schablone zum Eindampfen von Notizen zu haben. Das ist mein heutiger Eindruck. Wer dieselbe Methode auch auf die Artikelerstellung oder Anfragenbearbeitung im Team ausweiten will, kann im Training und der Beratung fürs Geschäft die Schablone passend zum echten Betrieb aufbauen. Den offiziellen Maßstab finden Sie in der offiziellen Anthropic-Dokumentation.