Update authoring guidelines in the user manual: Increment version to 1.2.0, refine key principles, and enhance clarity on knowledge structuring and emotional engagement. Revise sections on strategic control, vault architecture, and usability features to improve user experience and documentation coherence.

docs/01_User_Manual/01_authoring_guidelines.md

@@ -3,153 +3,138 @@ id: 01-authoring-guidelines
 title: Authoring Guidelines – Handbuch für den Digitalen Zwilling
 type: principle
 status: stable
-version: 1.1.0
-area: system_documentation
-tags: [handbuch, authoring, methodik, obsidian, mindnet, best-practice]
-retriever_weight: 2.0
----
-
-# Authoring Guidelines: Dein Werkzeug für den Digitalen Zwilling
-
-
-Dieses Handbuch ist dein primäres Werkzeug, um Wissen so zu strukturieren, dass Mindnet deine Persönlichkeit spiegelt, empathisch reagiert und dich strategisch berät.
-
----
-
-## ⚡ Die 6 Goldenen Regeln des Knowledge Designs
-
-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`, um der KI zu sagen, wie sie den Text verarbeiten soll (z. B. `insight` für Beobachtungen, `experience` für Erlebnisse).
-3. **Semantische Links:** Verknüpfe aktiv mit `[[rel:depends_on ...]]` oder `[[rel:based_on ...]]`. Sag dem System, *warum* Dinge zusammenhängen.
-4. **Werte & Ziele definieren:** Erstelle für jeden Nordstern und jeden Kernwert eine eigene Notiz. Ohne Maßstäbe kann der „Berater“ nicht entscheiden.
-5. **Emotionales Bridging:** Nutze Begriffe wie „Druck“, „Stolz“, „Euphorie“ oder „Hilflosigkeit“, um die Empathie-Ebene der KI zu aktivieren.
-6. **Narrative Tiefe (Fleisch am Knochen):** Dokumentiere das „Warum“ hinter einer Entscheidung. Fakten informieren, aber Erzählungen prägen den Charakter.
-
----
-
-## 1. Strategische Steuerung (Status & Gewicht)
-
-Du entscheidest über das Frontmatter, wie präsent eine Information im „Gedächtnis“ ist.
-
-### 1.1 Status-Logik
-* **`stable`**: Gold-Standard. Für finale Leitbild-Texte und Nordsterne. Erhält +20% Relevanz-Bonus.
-* **`active`**: Standard für laufende Projekte und aktuelle Beobachtungen.
-* **`draft`**: Brainstorming oder rohe Tages-Logs. Die KI nutzt diese nur nachrangig (50% Malus), um Rauschen zu vermeiden.
-* **`system`**: Rein technische Dateien (Templates, Guides). Werden im Chat ignoriert.
-
-### 1.2 Manuelle Gewichtung (`retriever_weight`)
-* **Boost (1.20):** Für hochrelevante Erkenntnisse. **Beispiel:** Beobachtungen zum Verhalten von Rohan werden als `insight` mit `1.20` markiert, damit sie bei Erziehungsfragen sofort präsent sind.
-* **Deboost (0.50 - 0.80):** Für tägliche Routine-Einträge („Heute 10 Min. meditiert“). Sie dienen der Chronik, sollen aber keine tiefen Analysen verfälschen.
-
----
-
-## 2. Das Kochbuch: Praktische Use-Cases
-
-### 2.1 Ein Erlebnis aufschreiben (`type: experience`)
-**Ziel:** Den „Spiegel“ (Empathy) mit deiner Biografie kalibrieren.
-
-**Struktur & Leitfragen:**
-- **Kontext:** Was ist passiert? (Sachlich kurz).
-- **Emotions-Check:** Wie habe ich mich in der Situation gefühlt? (Wichtig für Regel 5).
-- **Die Lektion:** Was habe ich über mich gelernt? (z. B. „Ich reagiere allergisch auf Ungerechtigkeit“).
-- **Deep-Edge:** Mit welcher Rolle ist das verknüpft? `[[rel:supports Meine Rollenlandkarte 2025#Vater]]`.
-
-### 2.2 Eine Beobachtung festhalten (`type: insight`)
-**Ziel:** Den „Berater“ (Decision) mit Mustern versorgen.
-
-**Beispiel Rohan-Beobachtung:**
-- **Beobachtung:** Rohan reagiert positiv auf „leise“ Impulse und 90/10 Coaching.
-- **Interpretation:** Direkte Konfrontation erzeugt Gegendruck; Fragen erzeugen Ownership.
-- **Konsequenz:** Prinzip P3a (Familienregeln) muss immer einen Bedürfnischeck vorausschicken.
-
-### 2.3 Ein Review durchführen (`type: journal` / `insight`)
-**Ziel:** Den Fortschritt steuern.
-- **Daily:** Rohes Log (Status `draft`).
-- **Weekly/Monthly:** Verdichtung der Erkenntnisse in eine `stable` Notiz. Frage: „Was war der größte Hebel diese Woche?“.
-
-### 2.4 Das Handlungsprinzip (`type: principle`)
-**Ziel:** Testbare Regeln für schwierige Entscheidungssituationen.
-
-**Struktur-Vorgabe:**---
-id: 01-authoring-guidelines
-title: Authoring Guidelines – Das Handbuch für den Digitalen Zwilling
-type: principle
-status: stable
 version: 1.2.0
 area: system_documentation
 tags: [handbuch, authoring, methodik, obsidian, mindnet, best-practice]
 retriever_weight: 2.0
 ---
 
-## 🕸️ Teil 3: Netzdesign (Hubs, Edges & Lücken)
+# Authoring Guidelines: Dein Werkzeug für den Digitalen Zwilling
+
+Dieses Handbuch ist dein primäres Werkzeug, um Wissen so zu strukturieren, dass Mindnet deine Persönlichkeit spiegelt, empathisch reagiert und dich sowie deine Nachkommen strategisch berät. Es dient als Brücke zwischen deiner menschlichen Navigation in Obsidian und der technischen Logik der Mindnet-Engine.
+
+---
+
+## ⚡ 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. 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)
+
+Der Vault ist in acht funktionale Domänen unterteilt, die direkt mit den internen Wissens-Streams korrespondieren.
+
+| Ordner | Domäne | Stream-Logik | Zweck |
+| :--- | :--- | :--- | :--- |
+| **00_Leitbild** | Verfassung | **Identity** | Chronik deiner Werte-Evolution über die Jahre. |
+| **01_Identify** | Kern-Identität | **Identity** | SSOT für Werte, Prinzipien, Rollen, Bedürfnisse und Glaubenssätze. |
+| **02_Projects** | Dynamik | **Action** | Aktive Vorhaben, Missionen und operative Aufgaben (Tasks). |
+| **03_Experiences** | Biografie | **History** | Speicherort für Erlebnisse (Experiences), Ereignisse (Events) und Zustände (States). |
+| **04_Insights** | Erkenntnisse | **History/Basis** | Fachwissen, Konzepte, Ideen und tiefe Musteranalysen. |
+| **05_Decisions** | Steuerung | **Action** | Dokumentation getroffener Entscheidungen (ADR-Logik). |
+| **06_Skills** | Kompetenz | **Action** | Fertigkeiten, Lernpfade und Meisterschaftsnachweise. |
+| **07_People** | Soziales Netz | **History/Basis** | Kontaktprofile, Rollen und soziale Vernetzung. |
+
+---
+
+## 3. Das Schicht-Modell: Cluster, Reflexion & Evidenz
+
+Innerhalb der Ordner (besonders in `03_Experiences`) nutzen wir eine dreistufige Schichtung, um Navigation und Präzision zu vereinen.
+
+* **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).
+
+---
+
+## 4. Das Kochbuch: Praktische Use-Cases
+
+### 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]]`.
+
+### 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?).
+
+---
+
+## 5. Netzdesign (Hubs, Edges & Lücken)
 
 Ein intelligentes Netz wächst durch strategische Verknüpfungen, nicht durch Textmenge.
 
-### 3.1 Wissens-Hubs (Zentralnotizen)
+### 5.1 Wissens-Hubs (Zentralnotizen)
-Hubs fungieren als Verteilerzentren im Graphen.
+Hubs fungieren als Verteilerzentren im Graphen. Nutze Überschriften (H2, H3) und verlinke präzise Abschnitte: `[[Rollenlandkarte#Vater]]`.
-* **Struktur:** Nutze Überschriften (H2, H3) und verlinke von dort auf Detailnotizen.
-* **Deep-Edges:** Verlinke präzise Abschnitte: `[[Rollenlandkarte#Vater]]`. Dies ermöglicht der KI, nur den relevanten Kontext zu laden.
 
-### 3.2 Forward-Mapping (Strategische Lücken)
+### 5.2 Semantisches Mapping (Kanten)
-Setze bewusst Links auf Dateien, die noch nicht existieren (z. B. `[[Die beste Version meiner selbst]]`).
+Nutze funktionale Relationen, um Kausalitäten zu klären:
-* **Zweck:** Du signalisierst dem System: „Hier entsteht ein wichtiges Konzept“.
+* `resulted_in`: Erlebnis führt zu Wert/Erkenntnis.
-* **Effekt:** Die KI erkennt diese Lücken und kann im Chat proaktiv Fragen stellen, um diese Felder mit dir gemeinsam zu füllen.
+* `based_on`: Prinzip basiert auf einem Wert.
+* `caused_by`: Dokumentiert Ursachen für Prägungen.
+* `part_of`: Bindet Details an einen Cluster/Hub.
+
+### 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.
 
 ---
 
-## 4. Obsidian Usability & Automatisierung
+## 6. Obsidian Usability & Automatisierung
 
-### 4.1 Templater-Integration
+### 6.1 Templater & Meta Bind
-Nutze Vorlagen, die bereits die **Leitfragen** und das richtige **Retriever-Weight** enthalten. Ein Klick auf „Neues Erlebnis“ sollte automatisch das Frontmatter mit `type: experience` und `weight: 1.1` füllen.
+* **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.
 
-### 4.2 Meta Bind Dashboards
+### 6.2 Deep-Edges & Verknüpfung
-Nutze **Meta Bind**, um Felder wie `status` oder `retriever_weight` über Schieberegler direkt in der Notiz zu steuern. Das macht die Gewichtung deines Wissens intuitiv und spielerisch.
+* Verlinke Erlebnisse konsequent mit Rollen oder Clustern.
+* Nutze `derived_from`, um Prinzipien an ihre Ursprungssituation zu binden.
 
 ---
 
-## 5. Vernetzung für die Mindnet-Personas
+## 7. Vernetzung für die Mindnet-Personas
 
 | Persona | Notiz-Fokus | Effekt im Dialog |
 | :--- | :--- | :--- |
-| **🪞 Spiegel (Empathy)** | Gefühle & Biografisches | „Ich verstehe deinen Frust, das war bei Projekt X ähnlich...“. |
+| **🪞 Spiegel (Empathy)** | `states`, `journal`, `experience` | „Ich verstehe deine Faszination, das war damals mit den Eidechsen ähnlich...“. |
-| **⚖️ Berater (Decision)** | Werte & Wächterfragen | „Option A ist nicht ratsam, da sie gegen dein Prinzip der Integrität verstößt“. |
+| **⚖️ Berater (Decision)** | `values`, `principles`, `decisions` | „Diese Option ist nicht ratsam, da sie gegen dein Prinzip der Integrität verstößt“. |
-| **📚 Bibliothekar (Facts)** | Struktur & Definitionen | „Deine Mission als Vater ist es, verlässliche Präsenz zu zeigen...“. |
+| **📚 Bibliothekar (Facts)** | `events`, `concepts`, `sources`, `people` | „Das Wochenendhaus wurde im Jahr X erworben, Klaus baute damals das Terrarium“. |
 
 ---
 
-> [!abstract] Fazit für den Autor
+## 8. Verbindungen von Notiztypen (Graphen-Logik)
-> Mindnet ist ein **Persönlichkeitsspiegel**. Dokumentiere weniger „Technik“ und mehr „Mensch“. Jede Notiz sollte die Frage beantworten: „Was sagt das über mich und meine Werte aus?“.
-- **3 Signale:** Woran merke ich im Alltag, dass ich das Prinzip lebe?.
-- **Wächterfrage:** Welche Frage stelle ich mir im Moment der Entscheidung?.
-
----
-
-## 6. Obsidian Workflow-Hacks
-
-### 6.1 Templater & Meta Bind
-- **Automatisierung:** Nutze das **Templater-Plugin**, um beim Erstellen einer Notiz sofort die passenden Leitfragen und das richtige `retriever_weight` einzufügen.
-- **Interaktive Steuerung:** Nutze **Meta Bind**, um Felder wie `status` oder `retriever_weight` über Buttons oder Slider direkt im Lesemodus zu ändern, ohne im YAML-Code zu tippen.
-
-### 6.2 Deep-Edges & Verknüpfung
-- Verknüpfe Erlebnisse immer mit der entsprechenden Rolle: `[[rel:supports Meine Rollenlandkarte 2025#Vater]]`.
-- Nutze `derived_from`, um Prinzipien an ihre Ursprungs-Session zu binden.
-
----
-
-## 7. Vernetzung für Mindnet Personas
-
-| Persona | Notiz-Fokus | Beispiel |
-| :--- | :--- | :--- |
-| **🪞 Spiegel (Empathy)** | Emotionen & Prägungen | „Ich fühlte mich hilflos, als...“. |
-| **⚖️ Berater (Decision)** | Kriterien & Abwägungen | „Option A verletzt Wert X, weil...“. |
-| **📚 Bibliothekar (Facts)** | Struktur & Definition | „Rollenmission Vater bedeutet...“. |
-
----
-
-> [!tip] Best Practice
-> Wenn du merkst, dass eine Notiz zu technisch wird: Halte inne und frage dich: „Was macht das mit mir als Mensch?“ Schreibe *das* auf. Das ist die Essenz für deinen KI-Zwilling.
-
-## 8. Verbindungen von Notiztypen
 
 ```mermaid
 graph TD
@@ -185,5 +170,4 @@ graph TD
 
     style V fill:#f9f,stroke:#333,stroke-width:2px
     style EX fill:#bbf,stroke:#333,stroke-width:2px
-    style P fill:#bfb,stroke:#333,stroke-width:2px
+    style P fill:#bfb,stroke:#333,stroke-width:2px
-