Quelle: LinkedIn-Post von Hendrik Hemken (05.04.2026)

Das Problem

  • 600+ Markdown-SOPs, Blog-Entwürfe, Projekt-Notes.
  • Jeder Claude-Run müsste eigentlich das komplette Dokument lesen, obwohl häufig nur ein Pitch, eine Zusammenfassung oder ein Status gefragt ist.
  • Ergebnis: Token-Verschwendung, Halluzinationen, Kontextverlust.

Die Idee: Frontmatter als Mini-API

Hendrik versieht jede Notiz mit einem YAML-Header:

title: Instant Summary
status: draft
summary: >
  2-3 Sätze, wozu dieser Text dient
pitch: "Use case / Value prop"
tags: [context, agentic, knowledge]
updated: 2026-04-05

Das Frontmatter dient als Einstiegsanker:
1. Agent lädt nur den YAML-Block.
2. Liest summary, pitch, status.
3. Entscheidet: lohnt sich vollständiges Einlesen?
4. Erst dann folgt body (mit split: true und referenzierter Section).

Warum das funktioniert

  • Routing statt Brute Force – eine Handvoll Tokens reichen, um „irrelevant“ zu erkennen.
  • Selbstbeschreibung – pitch/summary geben Claude eine Stimme („So musst du mich verwenden“).
  • Regeln im YAML – z. B. llm_mode: read_only oder contains_pii: true.

So setzt du es um

  1. Schema definieren – welche Felder braucht dein Team? (Titel, Eigentümer, Zweck, Sensitivity …)
  2. Linting erzwingen – Pre-commit Hook prüft, ob Frontmatter vorhanden ist.
  3. Agent-Flow anpassen – Workflow: load_frontmatter → decide → load_section.
  4. Fallback – wenn YAML fehlt, lade Body + schreibe TODO.

Bonus: Kontext-Cache

  • Speichere alle YAML-Header als context_index.json (Claude kann danach suchen).
  • Bilde Vektoren nur aus summary/pitch – spart Embedding-Kosten.

Prompts aus dem LinkedIn-Post

  1. Frontmatter-Creator – kommt in CLAUDE.md, damit jede neue Notiz einen Steckbrief bekommt:
    text You are the note-taking agent. Every Markdown file MUST start with YAML frontmatter containing description, date, status, tags, and client/project. Use concise one-line values. After the frontmatter, write the content as usual.
  2. Frontmatter-Reader – liegt im Agent-Workflow, bevor eine Datei geöffnet wird:
    text When exploring files: (1) read only the YAML frontmatter and summarize it in one sentence, (2) decide if the body is relevant. Only open the full file when the description or tags match the current task.

RAG vs. Frontmatter

Hendriks Fazit: Für strukturiertes Teamwissen schlagen Ordnerstruktur + Steckbrief oft eine klassische Vektordatenbank. Embeddings verwechseln "Projekt A" und "Meeting C", ein Agent, der description liest, versteht sofort den Unterschied – ganz ohne Pipeline.

Fazit

Fazit

Ein paar Zeilen YAML reichen, damit Claude & Co. wissen, was ein Dokument ist, warum es existiert und wie es zu lesen ist. Das macht Notizen nicht nur KI-freundlich, sondern auch für Menschen übersichtlicher.