diff --git a/docs/01_User_Manual/01_authoring_guidelines.md b/docs/01_User_Manual/01_authoring_guidelines.md index acaf226..b05820d 100644 --- a/docs/01_User_Manual/01_authoring_guidelines.md +++ b/docs/01_User_Manual/01_authoring_guidelines.md @@ -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. | ---