Lars
77a6db7e92
All checks were successful
Deploy mindnet to llm-node / deploy (push) Successful in 4s
89 lines
4.2 KiB
Markdown
89 lines
4.2 KiB
Markdown
---
|
||
doc_type: reference
|
||
audience: author
|
||
status: active
|
||
context: "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`.
|
||
|
||
```markdown
|
||
## 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. |