mindnet/docs/01_User_Manual/01_edge_vocabulary.md

doc_type	audience	status	context
reference	author	active	Zentrales Wörterbuch für Kanten-Bezeichner (Edges). Referenz für Autoren zur Wahl des richtigen Verbindungstyps.

Edge Vocabulary & Semantik

Standort: 01_User_Manual/01_edge_vocabulary.md Zweck: Damit Mindnet "verstehen" kann, was eine Verbindung bedeutet (z.B. für "Warum"-Fragen), nutzen wir konsistente Begriffe.

Die Goldene Regel: Nutze bevorzugt den System-Typ (linke Spalte). Wenn dieser sprachlich nicht passt, nutze einen der erlaubten Aliasse (und bleibe dabei konsistent).

---

1. Kausalität & Logik ("Warum?")

Verbindungen, die Gründe, Ursachen oder Herleitungen beschreiben.

System-Typ (Canonical)	Erlaubte Aliasse (User)	Wann nutzen?
caused_by	ausgelöst_durch, wegen, ursache_ist	Wenn A der direkte Auslöser für B ist. (Technisch/Faktisch)
derived_from	abgeleitet_von, quelle, inspiriert_durch	Wenn eine Idee/Prinzip aus einer Quelle stammt (z.B. Buch, Zitat).
based_on	basiert_auf, fundament, grundlage	Wenn B nicht existieren könnte ohne das fundamentale Konzept A (z.B. Werte).
solves	löst, beantwortet, fix_für	Wenn A eine Lösung für das Problem B ist.

2. Struktur & Hierarchie ("Wo gehört es hin?")

Verbindungen, die Ordnung schaffen.

System-Typ (Canonical)	Erlaubte Aliasse (User)	Wann nutzen?
part_of	teil_von, gehört_zu, cluster	Harte Hierarchie. Projekt A ist Teil von Programm B.
belongs_to	(System-Intern)	Automatisch generiert (Chunk -> Note). Nicht manuell nutzen.

3. Abhängigkeit & Einfluss ("Was brauche ich?")

Verbindungen, die Blockaden oder Voraussetzungen definieren.

System-Typ (Canonical)	Erlaubte Aliasse (User)	Wann nutzen?
depends_on	hängt_ab_von, braucht, requires, enforced_by	Harte Abhängigkeit. Ohne A kann B nicht starten/existieren.
blocks	blockiert, verhindert, risiko_für	Wenn A ein aktives Hindernis für B ist.
uses	nutzt, verwendet, tool	Wenn A ein Werkzeug/Methode B einsetzt (z.B. Projekt nutzt Python).
guides	steuert, leitet, orientierung	(Alias für depends_on oder related_to) Weiche Abhängigkeit, z.B. Prinzipien steuern Verhalten.

4. Zeit & Prozess ("Was kommt dann?")

Verbindungen für Abläufe zwischen verschiedenen Notizen.

System-Typ (Canonical)	Erlaubte Aliasse (User)	Wann nutzen?
next	danach, folgt, nachfolger, followed_by	Manuell: Wenn Notiz A logisch vor Notiz B kommt (Prozesskette: A -> B).
prev	davor, vorgänger, preceded_by	Manuell: Der vorherige Prozessschritt (B -> A).

5. Assoziation ("Was ist ähnlich?")

Lose Verbindungen für Entdeckungen.

System-Typ (Canonical)	Erlaubte Aliasse (User)	Wann nutzen?
related_to	siehe_auch, kontext, thematisch	Wenn zwei Dinge etwas miteinander zu tun haben, ohne strikte Logik.
similar_to	ähnlich_wie, vergleichbar	Wenn A und B fast das Gleiche sind (z.B. Synonyme, Alternativen).
references	(Kein Alias)	Standard für "erwähnt einfach nur". (Niedrigste Prio).

---

Best Practices für Autoren

A. Der "Callout"-Standard (Footer)

Sammle Verbindungen, die für die ganze Notiz gelten, am Ende der Datei in einem Bereich ## Kontext & Verbindungen.

## Kontext & Verbindungen

> [!edge] derived_from
> [[Buch der Weisen]]

> [!edge] part_of
> [[Leitbild – Identity Core]]

B. Der "Inline"-Standard (Präzision)

Nutze Inline-Kanten nur, wenn du im Fließtext eine spezifische Aussage triffst, die im Graph sichtbar sein soll.

• Schlecht: "Das rel:related_to Projekt ist wichtig." (Wenig Aussagekraft)
• Gut: "Dieser Fehler wird rel:caused_by Systemabsturz verursacht." (Starke Kausalität)

C. Konsistenz-Check

Bevor du ein neues Wort (z.B. ermöglicht) nutzt:

1. Prüfe diese Liste: Passt solves oder depends_on?
2. Falls nein: Schreibe ermöglicht in die Spalte "Erlaubte Aliasse" oben und ordne es einem System-Typ zu.