Update authoring guidelines in the user manual: Increment version to 1.3.0, refine principles for knowledge structuring, and introduce new H3-Hub-Pairing for enhanced clarity. Revise sections on strategic control, vault architecture, and usability features to improve documentation coherence and user experience.
All checks were successful
Deploy mindnet to llm-node / deploy (push) Successful in 4s
All checks were successful
Deploy mindnet to llm-node / deploy (push) Successful in 4s
This commit is contained in:
parent
13f0a0c9bc
commit
745352ff3f
|
|
@ -3,7 +3,7 @@ id: 01-authoring-guidelines
|
|||
title: Authoring Guidelines – Handbuch für den Digitalen Zwilling
|
||||
type: principle
|
||||
status: stable
|
||||
version: 1.2.0
|
||||
version: 1.3.0
|
||||
area: system_documentation
|
||||
tags: [handbuch, authoring, methodik, obsidian, mindnet, best-practice]
|
||||
retriever_weight: 2.0
|
||||
|
|
@ -17,33 +17,16 @@ Dieses Handbuch ist dein primäres Werkzeug, um Wissen so zu strukturieren, dass
|
|||
|
||||
## ⚡ Die 6 Goldenen Regeln (TL;DR)
|
||||
|
||||
1. **Atomare Gedanken:** Eine Notiz = Ein Thema. Trenne z. B. „Meditation“ von „Mobility“, auch wenn beides Ich-Pflege ist.
|
||||
2. **Explizite Typen:** Nutze den `type` im Frontmatter, um der KI zu sagen, wie sie den Text verarbeiten soll (z. B. `insight` für Beobachtungen, `experience` für Erlebnisse).
|
||||
3. **Hub-Logik:** Nutze Zentralnotizen (Hubs) als „Kapitel“ für Themen oder Lebensphasen, um atomare Notizen (Events, States) zu Clustern zu binden.
|
||||
4. **Werte & Ziele definieren:** Erstelle für jeden Nordstern und jeden Kernwert eine eigene Notiz (`type: value`). Ohne Maßstäbe kann die Decision Engine nicht in deinem Sinne abwägen.
|
||||
5. **Emotionales Bridging:** Nutze Begriffe wie „Druck“, „Stolz“, „Euphorie“ oder „Hilflosigkeit“, um die Empathie-Ebene (Spiegel-Persona) der KI zu aktivieren.
|
||||
6. **Narrative Tiefe (Fleisch am Knochen):** Dokumentiere das „Warum“ hinter einer Entscheidung. Fakten informieren, aber Erzählungen prägen deinen Charakter für die Nachwelt.
|
||||
1. **Atomare Gedanken:** Eine Notiz = Ein Thema. Trenne z. B. „Meditation“ von „Mobility“.
|
||||
2. **Explizite Typen:** Nutze den `type` im Frontmatter (z. B. `insight`, `experience`, `value`), um die mathematische Gewichtung zu steuern.
|
||||
3. **H3-Hub-Pairing (NEU):** Nutze H3-Überschriften in Hubs, um spezifische Links und ihre Bedeutung (Edges) in isolierten Chunks für die KI zu fixieren, ohne die Obsidian-Graphen-Logik zu brechen.
|
||||
4. **Werte & Ziele definieren:** Erstelle für jeden Kernwert eine eigene Notiz (`type: value`). Ohne explizite Maßstäbe kann die Decision Engine nicht in deinem Sinne abwägen.
|
||||
5. **Emotionales Bridging:** Nutze Begriffe wie „Druck“, „Faszination“ oder „Angst“, um die Empathie-Ebene der KI zu aktivieren.
|
||||
6. **Narrative Tiefe (Fleisch am Knochen):** Dokumentiere das „Warum“ hinter einer Entscheidung. Erzählungen prägen deinen Charakter für die Nachwelt mehr als reine Fakten.
|
||||
|
||||
---
|
||||
|
||||
## 1. Strategische Steuerung (Status & Gewicht)
|
||||
|
||||
Du entscheidest über das Frontmatter, wie präsent eine Information im „Gedächtnis“ des Systems ist.
|
||||
|
||||
### 1.1 Status-Logik
|
||||
* **`stable`**: Gold-Standard. Für finale Leitbild-Texte und Nordsterne. Erhält einen Relevanz-Bonus (ca. +20%).
|
||||
* **`active`**: Standard für laufende Projekte, aktuelle Beobachtungen und verifizierte Erlebnisse.
|
||||
* **`draft`**: Brainstorming oder rohe Tages-Logs. Die KI nutzt diese nur nachrangig (Malus), um Rauschen zu vermeiden.
|
||||
* **`system`**: Rein technische Dateien (Templates, Guides). Werden im Chat ignoriert.
|
||||
|
||||
### 1.2 Manuelle Gewichtung (`retriever_weight`)
|
||||
* **Boost (1.20 - 2.0):** Für hochrelevante Erkenntnisse oder Kernprinzipien.
|
||||
* **Standard (1.0 - 1.1):** Normale Wichtigkeit für Erfahrungen und Konzepte.
|
||||
* **Deboost (0.50 - 0.80):** Für tägliche Routine-Einträge oder reine Datensammlungen, die keine Analysen verfälschen sollen.
|
||||
|
||||
---
|
||||
|
||||
## 2. Die Vault-Architektur (Stream-Mapping)
|
||||
## 1. Die Vault-Architektur (Stream-Mapping)
|
||||
|
||||
Der Vault ist in acht funktionale Domänen unterteilt, die direkt mit den internen Wissens-Streams korrespondieren.
|
||||
|
||||
|
|
@ -60,66 +43,74 @@ Der Vault ist in acht funktionale Domänen unterteilt, die direkt mit den intern
|
|||
|
||||
---
|
||||
|
||||
## 3. Das Schicht-Modell: Cluster, Reflexion & Evidenz
|
||||
## 2. Das Schicht-Modell & Hub-Design
|
||||
|
||||
Innerhalb der Ordner (besonders in `03_Experiences`) nutzen wir eine dreistufige Schichtung, um Navigation und Präzision zu vereinen.
|
||||
In Hub-Notizen (z. B. „Wendepunkte“) nutzen wir eine hierarchische Schichtung, um Präzision für die KI und Übersicht für den Menschen zu garantieren.
|
||||
|
||||
* **Ebene 1: Cluster-Ebene (Der Hub / Das Kapitel)**
|
||||
* **Typ:** `insight` oder `experience`.
|
||||
* **Zweck:** Fasst ein Thema (z. B. "Wemlighausen") oder eine Lebensphase zusammen. Dient als primärer Einstiegspunkt (Hohes Gewicht, Status `stable`).
|
||||
* **Ebene 2: Reflexionsebene (Die Perle / Das Erlebnis)**
|
||||
* **Typ:** `experience`.
|
||||
* **Zweck:** Die bewusste Aufarbeitung eines Ereignisses inklusive emotionaler Einordnung und gelernter Lektion.
|
||||
* **Ebene 3: Evidenzebene (Die Basis / Das Faktum)**
|
||||
* **Typ:** `event` oder `state`.
|
||||
* **Zweck:** Liefert Rohdaten (Wer, Wann, Wo) und die emotionale Intensität des Augenblicks (Momentaufnahmen).
|
||||
### 2.1 Die H3-Regel für präzises Pairing
|
||||
Um Kausalitäten (z. B. Ereignis A führte zu Gefühl B) ohne proprietäre Syntax abzubilden, wird jedes Hauptelement eines Hubs in eine **H3-Sektion** gefasst.
|
||||
* **Technischer Effekt:** Das System nutzt für Hubs das Profil `structured_smart_edges_strict_L3` und schneidet an jeder H3-Ebene einen sauberen Chunk.
|
||||
* **Vorteil:** Callouts innerhalb dieser Sektion beziehen sich ausschließlich auf diesen Kontext, was die Antwortqualität massiv erhöht.
|
||||
|
||||
### 2.2 Die 3 Schichten im Detail
|
||||
* **Ebene 1: Cluster (Hub)**: Der Navigator (`type: insight`, `status: stable`). Fasst Lebensphasen oder Themenwelten zusammen.
|
||||
* **Ebene 2: Reflexion (Erlebnis)**: Die `experience`-Notiz. Die bewusste Aufarbeitung mit „Emotions-Check“ und „Lektion“.
|
||||
* **Ebene 3: Evidenz (Faktum)**: `event` oder `state`-Notizen. Die atomaren Rohdaten und Gefühle des Augenblicks (Momentaufnahmen).
|
||||
|
||||
---
|
||||
|
||||
## 4. Das Kochbuch: Praktische Use-Cases
|
||||
## 3. Strategische Steuerung (Status & Gewicht)
|
||||
|
||||
### 4.1 Ein Erlebnis aufschreiben (`type: experience`)
|
||||
**Ziel:** Den „Spiegel“ (Empathy) mit deiner Biografie kalibrieren.
|
||||
* **Struktur:** Kontext (Was ist passiert?), Emotions-Check (Gefühle?), Lektion (Was gelernt?).
|
||||
* **Deep-Edge:** Verknüpfe es mit einer Rolle: `[[rel:supports Meine Rollen#Vater]]`.
|
||||
Du entscheidest über das Frontmatter, wie präsent eine Information im „Gedächtnis“ des Systems ist.
|
||||
|
||||
### 4.2 Eine Beobachtung festhalten (`type: insight`)
|
||||
**Ziel:** Den „Berater“ (Decision) mit Mustern versorgen.
|
||||
* **Beispiel:** "Rohan reagiert positiv auf leise Impulse" -> Konsequenz: Prinzip Bedürfnischeck.
|
||||
|
||||
### 4.3 Das Handlungsprinzip (`type: principle`)
|
||||
**Ziel:** Testbare Regeln für schwierige Situationen.
|
||||
* **Struktur:** Das Prinzip, Anwendung & Beispiele, Wächterfrage (Was frage ich mich im Moment der Entscheidung?).
|
||||
* **`status: stable`**: Gold-Standard (+20% Relevanz-Bonus). Für finales Leitbild-Wissen und Kernwerte.
|
||||
* **`status: active`**: Standard für laufende Projekte und verifizierte Erlebnisse.
|
||||
* **`status: draft`**: Brainstorming oder rohe Tages-Logs. Erhält einen Malus (50%), um Rauschen zu vermeiden.
|
||||
* **`retriever_weight`**: Nutze `1.2` für Hubs und `1.1` für prägende Erlebnisse.
|
||||
|
||||
---
|
||||
|
||||
## 5. Netzdesign (Hubs, Edges & Lücken)
|
||||
## 4. Netzdesign & Semantic Mapping
|
||||
|
||||
Ein intelligentes Netz wächst durch strategische Verknüpfungen, nicht durch Textmenge.
|
||||
|
||||
### 5.1 Wissens-Hubs (Zentralnotizen)
|
||||
Hubs fungieren als Verteilerzentren im Graphen. Nutze Überschriften (H2, H3) und verlinke präzise Abschnitte: `[[Rollenlandkarte#Vater]]`.
|
||||
### 4.1 Zentrale Kanten (Edges)
|
||||
Nutze das kanonische Vokabular in `[!edge]` Callouts innerhalb der H3-Sektionen:
|
||||
* **`resulted_in` / `erzeugt`**: Verbindung zu einem daraus entstandenen Wert oder Gefühl.
|
||||
* **`caused_by` / `wegen`**: Dokumentiert die Ursache einer emotionalen Prägung oder Entscheidung.
|
||||
* **`part_of` / `gehört_zu`**: Bindet Details an einen übergeordneten Cluster oder Hub.
|
||||
* **`guides` / `steuert`**: Prinzipien oder Werte, die eine Sektion oder ein Vorhaben leiten.
|
||||
|
||||
### 5.2 Semantisches Mapping (Kanten)
|
||||
Nutze funktionale Relationen, um Kausalitäten zu klären:
|
||||
* `resulted_in`: Erlebnis führt zu Wert/Erkenntnis.
|
||||
* `based_on`: Prinzip basiert auf einem Wert.
|
||||
* `caused_by`: Dokumentiert Ursachen für Prägungen.
|
||||
* `part_of`: Bindet Details an einen Cluster/Hub.
|
||||
### 4.2 Forward-Mapping (Strategische Lücken)
|
||||
Setze bewusst Links auf Dateien, die noch nicht existieren (z. B. `[[Die beste Version meiner selbst]]`). Die KI erkennt diese Lücken und stellt proaktiv Fragen, um diese Felder gemeinsam mit dir zu füllen.
|
||||
|
||||
### 5.3 Forward-Mapping (Strategische Lücken)
|
||||
Setze Links auf Dateien, die noch nicht existieren (z. B. `[[Die beste Version meiner selbst]]`). Die KI erkennt diese Lücken und stellt proaktiv Fragen.
|
||||
---
|
||||
|
||||
## 5. Das Kochbuch: Praktische Use-Cases
|
||||
|
||||
### 5.1 Ein Erlebnis aufschreiben (`type: experience`)
|
||||
**Ziel:** Den „Spiegel“ (Empathy) mit deiner Biografie kalibrieren.
|
||||
* **Struktur:** Kontext (Was ist passiert?), Emotions-Check (Gefühle?), Lektion (Was gelernt?).
|
||||
* **Deep-Edge:** Verknüpfe es immer mit einer Rolle: `[[rel:supports Meine Rollenlandkarte 2025#Vater]]`.
|
||||
|
||||
### 5.2 Eine Beobachtung festhalten (`type: insight`)
|
||||
**Ziel:** Den „Berater“ (Decision) mit Mustern versorgen.
|
||||
* **Beispiel:** "Beobachtung: Rohan reagiert positiv auf leise Impulse" -> Konsequenz: Prinzip Bedürfnischeck.
|
||||
|
||||
### 5.3 Das Handlungsprinzip (`type: principle`)
|
||||
**Ziel:** Testbare Regeln für schwierige Situationen.
|
||||
* **Struktur:** Das Prinzip, Anwendung & Beispiele, Wächterfrage (Was frage ich mich im Moment der Entscheidung?).
|
||||
|
||||
---
|
||||
|
||||
## 6. Obsidian Usability & Automatisierung
|
||||
|
||||
### 6.1 Templater & Meta Bind
|
||||
* **Automatisierung:** Nutze Vorlagen, die bereits Leitfragen und das richtige `retriever_weight` enthalten.
|
||||
* **Interaktive Steuerung:** Nutze Meta Bind, um `status` oder `retriever_weight` direkt in der Notiz über Schieberegler zu steuern.
|
||||
* **Automatisierung:** Nutze Vorlagen, die bereits die Leitfragen und das richtige `retriever_weight` enthalten.
|
||||
* **Interaktive Steuerung:** Nutze Meta Bind, um Felder wie `status` oder `retriever_weight` über Schieberegler direkt in der Notiz zu steuern.
|
||||
|
||||
### 6.2 Deep-Edges & Verknüpfung
|
||||
* Verlinke Erlebnisse konsequent mit Rollen oder Clustern.
|
||||
* Verlinke Erlebnisse konsequent mit Rollen, Personen oder Clustern.
|
||||
* Nutze `derived_from`, um Prinzipien an ihre Ursprungssituation zu binden.
|
||||
|
||||
---
|
||||
|
|
@ -128,9 +119,9 @@ Setze Links auf Dateien, die noch nicht existieren (z. B. `[[Die beste Version m
|
|||
|
||||
| Persona | Notiz-Fokus | Effekt im Dialog |
|
||||
| :--- | :--- | :--- |
|
||||
| **🪞 Spiegel (Empathy)** | `states`, `journal`, `experience` | „Ich verstehe deine Faszination, das war damals mit den Eidechsen ähnlich...“. |
|
||||
| **⚖️ Berater (Decision)** | `values`, `principles`, `decisions` | „Diese Option ist nicht ratsam, da sie gegen dein Prinzip der Integrität verstößt“. |
|
||||
| **📚 Bibliothekar (Facts)** | `events`, `concepts`, `sources`, `people` | „Das Wochenendhaus wurde im Jahr X erworben, Klaus baute damals das Terrarium“. |
|
||||
| **🪞 Spiegel (Empathy)** | `states`, `journal`, `experience` | Erzeugt Resonanz durch Nachempfinden deiner Gefühle. |
|
||||
| **⚖️ Berater (Decision)** | `values`, `principles`, `decisions` | Wägt aktuelle Fragen gegen deine lebenslangen Maßstäbe ab. |
|
||||
| **📚 Bibliothekar (Facts)** | `events`, `concepts`, `sources`, `person` | Liefert präzise Fakten, historische Daten und soziale Kontexte. |
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue
Block a user