Begriffsformat-Leitfaden

Jede Begriffsnotiz im Vault muss diesem Standard entsprechen, bevor ihr Status auf review oder published gesetzt werden darf.

Version 2.0 (2026-06-11): Zusammenführung der historisch entstandenen zwei Strukturen. Basis bleibt die konsistent umgesetzte Standard-Struktur der Anbau-Kategorien (01–18). Sie wurde um die nützlichen Teile der Monographie-/ Pharmakologie-Struktur (Kat 19–22) ergänzt: domänenabhängiger Relevanz-Abschnitt, fachliche Unterabschnitte in tiefen Monographien, optionaler ## Forschungsstand, sowie die Typwerte monographie und produkt. Gleichzeitig gelten die strengeren Regeln der Basis-Struktur jetzt vault-weit: verwandt immer als Wikilinks, kategorie/thema exakt = Ordnernamen, kein UTF-8-BOM.

Dateiort & Name

NN_Kategorie/<Thema-Ordner>/<slug>.md

Regeln für den Dateinamen (slug): - Kleinbuchstaben, Kebab-Case: bbch-skala.md, aba-abscisinsaeure.md - Umlaute ersetzen: ä→ae, ö→oe, ü→ue, ß→ss - Kein -cannabis-Suffix als Standard — nur wenn der Begriff im Cannabis-Kontext eine klar andere Bedeutung hat als in der allgemeinen Biologie - Synonyme werden nicht als eigene Dateien angelegt, sondern nur im Frontmatter

Kodierung: UTF-8 ohne BOM. Ein Byte-Order-Mark (EF BB BF) vor dem öffnenden --- verhindert, dass Obsidian das Frontmatter als Properties erkennt → strikt verboten.

YAML-Frontmatter — Pflichtfelder

---
begriff: Anzeigename des Begriffs (wie er im Glossar erscheinen soll)
slug: dateiname-ohne-md (identisch mit Dateinamen)
kategorie: NN_Kategoriename   # EXAKT der Ordnername, z.B. 01_Pflanzenbiologie
thema: NN_Themaname           # EXAKT der Unterordnername, z.B. 01_Botanik_Lebenszyklus
typ: siehe Typwert-Tabelle
synonyme: [Synonym 1, Synonym 2]   # leer: []
verwandt:                          # IMMER Wikilinks, nie nackte Slugs; leer: []
  - "slug-a"
  - "slug-b"
status: stub | draft | review | published
laienrelevanz: hoch | mittel | niedrig
quellen:
  - DOI:10.xxxx/yyyy
  - PMID:xxxxxx
last_updated: YYYY-MM-DD
---

`kategorie` und `thema` — exakt = Ordnernamen

Beide Werte müssen zeichengenau mit den Ordnernamen übereinstimmen (Format NN_Name, Unterstriche, keine Leerzeichen, keine Umlaute, keine Punktnummerierung, kein &). Falsch: kategorie: "03 Physiologie-Stoffwechsel", thema: "04.3 Flavonoide & Phenole". Richtig: kategorie: 03_Physiologie_Stoffwechsel, thema: 03_Flavonoide-Phenole. Das &-Zeichen und Doppelpunkte in unquotierten YAML-Werten brechen die Validierung.

`verwandt` — immer Wikilinks

Funktionale Obsidian-Graph-Kanten entstehen nur durch Wikilink-Syntax. Nackte Slugs in einer Flow-Liste (verwandt: [cb1-rezeptor, gpr55]) sind reine Strings ohne Verknüpfung und damit ungültig. Verbindlich ist die Block-Liste mit quotierten Wikilinks:

verwandt:
  - "cb1-rezeptor"
  - "gpr55"

Die Inline-Form verwandt: A, B ist zulässig, aber die Block-Liste ist Standard.

Typwerte erklärt

Wert	Wann verwenden
`konzept`	Abstraktes Konzept, Theorie, anatomische Struktur
`substanz`	Chemische Verbindung, Molekül, Wirkstoff
`mechanismus`	Biologischer Prozess oder Signalweg
`methode`	Technik, Verfahren, Protokoll (inkl. Extraktions-/Postprocessing-/Analytik-Verfahren)
`hormon`	Pflanzenhormon
`enzym`	Enzym
`pathogen`	Krankheitserreger (Pilz, Virus, Viroid, Bakterium)
`werkzeug`	Messgerät, Analysetechnik, Software
`produkt`	Konkretes Endprodukt / Material (z.B. Konzentrat-Typen: Rosin, Hash, Live Resin)
`monographie`	Tiefe Einzelstoff-Monographie mit vollem pharmakologischem Profil (Kat 20/21)
`term`	Fallback, wenn kein spezifischerer Typ passt

Kat 01 verwendet spezifische Typen. Kat 02–18 nutzen historisch überwiegend term als Fallback. Kat 20/21 nutzen monographie, Kat 22-Konzentrate produkt. Semantische Verfeinerung erfolgt im Review-Pass.

Laienrelevanz

Wert	Bedeutung
`hoch`	Begriff taucht in Konsumenten-Fragen auf, wird auf Portal priorisiert
`mittel`	Für interessierte Laien verständlich und nützlich
`niedrig`	Rein wissenschaftliches Fachvokabular, für Spezialisten

Pflichtfeld: biologische_wirkung

ALLE Begriffe müssen dieses Feld ausfüllen oder es komplett weglassen. Ein leerer Block ist nicht zulässig. Dieses Feld ist das wichtigste für das spätere Erklär-Programm.

Die Interpretation hängt von der Struktur ab:

Struktur A (Kat. 01–18): Anbau-Effekt — was der Grower sieht/verursacht

biologische_wirkung:
  - auslöser: "Lichtreduktion auf 12/12 h Photoperiode"
    stadium: "BBCH 51 (erste Blütenanlage)"
    molekular: "CsFT3-Hochregulation, florigen-Protein aktiviert SAM"
    sichtbar: "erste Pistille sichtbar in Blüten-Achseln"

Struktur B (Kat. 19–21): Pharmakog-Effekt — wie der Körper reagiert

biologische_wirkung:
  - auslöser: "THC bindet an CB1-Rezeptor im Gehirn"
    stadium: "nach Inhalation / oral im ZNS"
    molekular: "Gi/o-Protein-Aktivierung, Adenylylcyclase-Hemmung, cAMP↓"
    sichtbar: "psychoaktiver Effekt, verzögerte motorische Reaktion"

Body-Struktur — Zwei Varianten

Es gibt zwei gleichberechtigte Strukturvarianten je nach Domäne. Beide Varianten sind zulässig. Der Unterschied liegt im Relevanz-Abschnitt und der Tiefe der Fachlichkeit, nicht in den Pflicht-Abschnitten.

Struktur A: Anbau-fokussiert (Kat. 01–18, teils 22)

Zielgruppe: Laien, Grower, Praktiker (Heimanbau & Pflanzenkunde)

## Kurzdefinition
Ein Satz, allgemeinverständlich. Kein Fachjargon ohne Erklärung.

## Wissenschaftliche Beschreibung
Tiefe Erklärung: Mechanismus, beteiligte Moleküle/Gene/Strukturen, Zahlen, Studien.
Mindestens 3–5 Sätze. Mit Quellen belegt.

## [opt: Biologische Auswirkungen]
Nur wenn `biologische_wirkung` im FM gefüllt. Was auf zellulärer Ebene passiert.

## Anbau-Relevanz
**Kernfrage:** Was kann der Grower damit anfangen? Wie nutzt er diesen Begriff praktisch?
Konkrete Entscheidungen, BBCH-Stadien, Timing, sichtbare Marker.

## Verwandte Begriffe
- slug-a — Beziehung
- slug-b — Beziehung

## Quellen
- Autor et al. (Jahr): Titel. Journal. DOI:…

Subsection-Richtlinie (H3): Mindestens 6 Subsections wo sinnvoll, z.B.: - ### Überblick / Definition - ### Genetische Grundlagen
- ### Umweltabhängigkeit - ### BBCH-Stadien / Timing - ### Praktische Feldbeobachtung - ### Fehlerquellen & Häufige Probleme

Struktur B: Pharmakog-fokussiert (Kat. 19–21)

Zielgruppe: Fortgeschrittene (beruflich tätig, aber nicht akademische Wissenschaftler)

## Kurzdefinition
Ein Satz, allgemeinverständlich. Kein Fachjargon ohne Erklärung.

## Wissenschaftliche Beschreibung
(oder mehrere fachliche H2-Abschnitte, siehe unten)

## [opt: Biologische Auswirkungen]
Nur wenn `biologische_wirkung` im FM gefüllt. Was im Körper auf Zellebene passiert.

## Pharmakologische Relevanz
**Kernfrage:** Wie funktioniert das Molekül / der Mechanismus im menschlichen Körper?
Rezeptor-Bindung, Signalwege, Organverteilung, Effekte.

## Verwandte Begriffe
- slug-a — Beziehung
- slug-b — Beziehung

## [opt: Forschungsstand]
Für unsichere/lückenhafte Evidenzlage.

## Quellen
- Autor et al. (Jahr): Titel. Journal. DOI:…

Subsection-Richtlinie (H3): Mindestens 6 Subsections wo sinnvoll, z.B. (je nach Stoff): - ### Struktur und Chemie / Biosynthese - ### Rezeptor-Pharmakologie (CB1, CB2, andere) - ### Signaltransduktion / Nachgelagerte Effekte - ### Pharmakokinetik (Absorption, Metabolismus, Elimination) - ### Quantitative Bindungsdaten / IC50-Werte - ### Klinischer Status / Forschungsstand

Bei typ: monographie kann ## Wissenschaftliche Beschreibung durch diese fachlichen H2-Abschnitte ersetzt werden (nicht nur ergänzt).

Der Relevanz-Abschnitt — Domänengerechte Titel

Jede Notiz hat genau einen Hauptrelevanz-Abschnitt. Der Titel richtet sich nach Kategorie:

Kategorien	Struktur	Titel	Kernfrage
01–18 (Anbau & Pflanze)	A	`## Anbau-Relevanz`	Was kann der Grower damit anfangen?
16 (Recht/Compliance)	A	`## Praktische Relevanz` / `## Rechtliche Relevanz`	Wie wirkt sich das auf den Grower aus?
19–21 (ECS, Cannabinoide, Terpene)	B	`## Pharmakologische Relevanz`	Wie funktioniert das im Körper?
22 (Extraktion)	A	`## Praktische Relevanz`	Welche Entscheidungen trifft der Extrakteur?
23 (Konsumformen)	A	`## Konsumrelevanz`	Wie wird es konsumiert, mit welchen Effekten?
24 (Medizin)	B	`## Klinische Relevanz`	Welche medizinischen Anwendungen?
25 (Sicherheit/Toxikologie)	A/B	`## Sicherheit & Regulierung`	Welche Risiken, welche Limits?

Bei Kombi-Themen ist Verbindung zulässig (z.B. ## Pharmakologische und Klinische Relevanz).

Optionaler Abschnitt: Forschungsstand

Bei unsicherer/lückenhafter Evidenzlage (häufig Kat 19–21) zulässig: ## Forschungsstand oder ## Forschungsstand und offene Fragen, direkt vor ## Verwandte Begriffe.

H1-Titel (optional)

Ein H1-Titel (# {Begriff}) ist optional — Obsidian zeigt den Dateinamen oder das begriff-Feld als Titel. Wenn vorhanden, muss H1 dem begriff entsprechen.

Status-Lifecycle — wann ist was erlaubt?

Status	Voraussetzung
`stub`	Datei existiert, Frontmatter angelegt, Body noch leer oder minimal
`draft`	Alle Pflichtabschnitte befüllt, Inhalt inhaltlich korrekt (ungeprüft)
`review`	Inhalt vollständig, mindestens eine Quelle mit DOI/PMID vorhanden, Wikilinks geprüft
`published`	Von Mensch reviewed, `last_updated` aktuell, in `glossary-index.md` aufgenommen, ins Online-Glossar portiert

Vollständigkeits-Checkliste

Vor dem Setzen auf review muss jeder Punkt erfüllt sein:

Frontmatter

[ ] begriff — ausgefüllt, korrekte Schreibweise
[ ] slug — identisch mit Dateiname (ohne .md)
[ ] kategorie und thema — zeichengenau = Ordner-/Unterordnername (NN_Name)
[ ] typ — spezifischer Wert aus der Typwert-Tabelle (nicht term, wenn ein spezifischerer passt)
[ ] synonyme — alle gängigen Synonyme eingetragen oder []
[ ] verwandt — mindestens 2 sinnvolle Wikilinks (Block-Liste), keine nackten Slugs
[ ] status — auf review gesetzt
[ ] laienrelevanz — bewusst gewählt (nicht blind auf mittel belassen)
[ ] quellen — mindestens eine Quelle mit DOI oder PMID
[ ] last_updated — heutiges Datum
[ ] biologische_wirkung — PFLICHT — ausgefüllt mit auslöser/stadium/molekular/sichtbar ODER komplett weggelassen (kein leerer Block)
[ ] kein UTF-8-BOM, YAML valide

Body

[ ] ## Kurzdefinition — genau ein Satz, laienverständlich
[ ] ## Wissenschaftliche Beschreibung (oder fachliche Unterabschnitte bei Monographien) — mind. 3 Sätze, mit Zahlen/Molekülen
[ ] [opt: ## Biologische Auswirkungen] — nur wenn biologische_wirkung gefüllt
[ ] Relevanz-Abschnitt — korrekt benannt für die Kategorie (siehe Tabelle), konkrete Praxis-/Pharma-/Rechts-Verbindung
[ ] H3-Subsections — mindestens 6 wo sinnvoll (fachliche Gliederung unter Wissenschaftliche Beschreibung / Pharmakog. Relevanz)
[ ] ## Verwandte Begriffe — mindestens 2 Einträge mit kurzer Beziehungserklärung (auch in Monographien Pflicht)
[ ] [opt: ## Forschungsstand] — für unsichere Evidenzlage
[ ] ## Quellen — mindestens eine formatierte Quellenangabe

Qualität

[ ] Keine defekten Wikilinks (slug verweist auf existierende Datei)
[ ] YAML ist valide (keine gemischten Listen-Formate in einer Datei)
[ ] Keine unbelegten Superlative oder Heilversprechen (besonders Kat 24 und 25)
[ ] Fachbegriffe beim ersten Vorkommen mit deutscher Erklärung
[ ] Struktur konsistent: Struktur A oder B durchgängig (kein Mischen)

Häufige Fehler

Slug ≠ Dateiname: Frontmatter-Slug muss exakt dem Dateinamen entsprechen.

verwandt als nackte Slug-Liste: verwandt: [cb1-rezeptor, gpr55] erzeugt keine Graph-Kanten. Immer - "cb1-rezeptor" (Block-Liste).

kategorie/thema als Freitext: Muss zeichengenau der Ordnername sein. &, Doppelpunkte und Leerzeichen in unquotierten Werten brechen YAML.

UTF-8-BOM vor dem Frontmatter: EF BB BF (Byte-Order-Mark) verhindert, dass Obsidian das Frontmatter als Properties erkennt. STRIKT VERBOTEN. Immer UTF-8 ohne BOM speichern. Besonders häufig in Kat. 22 (alle 22 Dateien hatten BOM — wird korrigiert).

Leerer biologische_wirkung-Block: biologische_wirkung: gefolgt von 0 Einträgen ist YAML-Fehler. PFLICHT: Entweder mit allen 4 Keys (auslöser/stadium/molekular/sichtbar) ausfüllen ODER das Feld komplett weglassen.

biologische_wirkung nicht gefüllt bei review: Struktur A + B erfordern jetzt dieses Feld. Keine leeren Werte.

Relevanz-Abschnitt falsch benannt: ## Anbau-Relevanz ist nicht für Kat. 19 (nutze ## Pharmakologische Relevanz). Falsche Benennung verwirrt Leser über die Zielgruppe.

H3-Subsections fehlen: Mindestens 6 wo sinnvoll. Eine einzelne Wissenschaftliche Beschreibung ohne H3-Struktur ist zu flach für review-Status.

quellen: [] bei review-Status: Mindestens eine Quelle mit DOI oder PMID erforderlich.

Zu allgemeine Kurzdefinition: Cannabis-spezifisch oder zumindest -relevant — nicht die Wikipedia-Definition kopieren.

Bezug zu anderen Vault-Dateien

Template: 99_Meta/templates/begriff.md — immer als Ausgangspunkt verwenden
Konventionen: 00_Roadmap/conventions.md — allgemeine Vault-Regeln (Sprache, Dateinamen)
Fortschritt: 00_Roadmap/master-roadmap.md — Status pro Kategorie
Recherche-Prompt: 99_Meta/prompts/begriff-recherche.md — Vorlage für /parallel-deep-research

Begriffsformat-Leitfaden

Begriffsformat-Leitfaden

Dateiort & Name

YAML-Frontmatter — Pflichtfelder

kategorie und thema — exakt = Ordnernamen

verwandt — immer Wikilinks

Typwerte erklärt

Laienrelevanz

Pflichtfeld: biologische_wirkung

Body-Struktur — Zwei Varianten

Struktur A: Anbau-fokussiert (Kat. 01–18, teils 22)

Struktur B: Pharmakog-fokussiert (Kat. 19–21)

Der Relevanz-Abschnitt — Domänengerechte Titel

Optionaler Abschnitt: Forschungsstand

H1-Titel (optional)

Status-Lifecycle — wann ist was erlaubt?

Vollständigkeits-Checkliste

Frontmatter

Body

Qualität

Häufige Fehler

Bezug zu anderen Vault-Dateien

`kategorie` und `thema` — exakt = Ordnernamen

`verwandt` — immer Wikilinks