diff --git a/docs/01_User_Manual/01_knowledge_design.md b/docs/01_User_Manual/01_knowledge_design.md index b64615c..ccefe04 100644 --- a/docs/01_User_Manual/01_knowledge_design.md +++ b/docs/01_User_Manual/01_knowledge_design.md @@ -3,7 +3,7 @@ doc_type: user_manual audience: user, author scope: vault, markdown, schema status: active -version: 2.7.0 +version: 2.8.0 context: "Regelwerk für das Erstellen von Notizen im Vault. Die 'Source of Truth' für Autoren." --- @@ -20,7 +20,7 @@ Damit Mindnet als dein Digitaler Zwilling funktioniert, beachte beim Schreiben d 3. **Semantische Links:** Schreibe nicht nur `[[Link]]`, sondern `[[rel:depends_on Link]]`. Sag dem System *wie* Dinge zusammenhängen. 4. **Werte & Ziele definieren:** Damit die **Decision Engine** dich beraten kann, musst du deine Kriterien (`type: value`, `type: goal`) explizit als Notizen anlegen. 5. **Emotionales Bridging:** Damit die **Empathie** funktioniert, nutze in Erfahrungsberichten (`type: experience`) emotionale Schlüsselwörter ("Krise", "Freude", "Angst"). - +6. **[NEU] Narrative Tiefe (Fleisch am Knochen):** Fakten allein reichen für Sessions und Biografien nicht aus. Erhalte die "Warum"-Ebene und Coach-Interpretationen. Die Erzählebene sichert, dass die KI die *Intention* versteht und der Mensch die *Bedeutung* nachvollziehen kann. --- ## 1. Zweck & Scope @@ -46,7 +46,12 @@ tags: [ki, entwicklung] # Taxonomie --- ``` -### 2.1 Advanced Overrides: Die KI-Steuerung übernehmen +### **2.1 [NEU] Naming Convention: Intuitiv vs. Technisch** +Für die Benutzerfreundlichkeit und die intuitive Navigation in Obsidian wird die Nutzung von **menschenlesbaren Titeln** bevorzugt (z. B. `Mein Persönliches Leitbild 2025` statt `leitbild_identity`). +- Die technische Eindeutigkeit wird primär über die `id` im Frontmatter sichergestellt. +- Die KI nutzt die Semantik des Dateinamens als zusätzlichen Kontext-Vektor. + +### 2.2 Advanced Overrides: Die KI-Steuerung übernehmen In 95% der Fälle setzt der `type` (z.B. "concept") automatisch die richtigen Einstellungen. In Spezialfällen kannst du diese manuell im Frontmatter überschreiben, um das Verhalten der KI zu erzwingen. @@ -95,11 +100,14 @@ Wähle den Typ, der die **Rolle** der Notiz am besten beschreibt. Der Typ setzt | :--- | :--- | :--- | :--- | | **`concept`** | `sliding_smart_edges` | 0.60 | Fachbegriffe, Theorien. Zeitloses Wissen. | | **`project`** | `sliding_smart_edges` | 0.97 | Aktive Vorhaben mit Ziel und Status. | -| **`experience`**| `sliding_smart_edges` | 0.90 | Persönliche Lektionen (für Empathie). | +| **`experience`**| `sliding_smart_edges` | **1.10 [NEU]** | Biografische Lektionen & Prägungen. | +| **`insight` [NEU]** | `sliding_smart_edges` | **1.20** | Konkrete Beobachtungen/Erkenntnisse (z.B. Erziehung). | +| **`trait` [NEU]** | `structured_..._strict`| **1.10** | Persönliche Eigenschaften & Potenziale. | +| **`obstacle` [NEU]**| `structured_..._strict`| **1.00** | Ängste, Blockaden & Hindernisse. | | **`decision`** | **`structured_..._strict`** | **1.00** | Entscheidungen. Muss atomar getrennt sein (Optionen vs. Ergebnis). | | **`value`** | **`structured_..._strict`** | **1.00** | Werte/Prinzipien. | | **`principle`**| `structured_..._strict_L3`| 0.95 | Handlungsleitlinien (Trennt bis Ebene H3). | -| **`goal`** | `sliding_smart_edges` | 0.95 | Strategische Ziele. | +| **`goal`** | `sliding_smart_edges` | 0.95 | Strategische Ziele (Nordsterne). | | **`risk`** | `sliding_short` | 0.85 | Risiken (kurz und prägnant). | | **`journal`** | `sliding_standard` | 0.80 | Zeitbezogene Logs. | | **`source`** | `sliding_standard` | 0.50 | Externe Quellen (niedrig gewichtet). | @@ -123,6 +131,7 @@ Dies ist die **mächtigste** Methode. Du sagst dem System explizit, **wie** Ding * `similar_to`: Ähnelt / Ist vergleichbar mit. * `solves`: Löst (Problem). * `based_on`: Basiert auf (Fundament). +* **`prev` / `next` [NEU]**: Markiert chronologische oder evolutionäre Abfolgen (z.B. Leitbild-Evolution). ### 4.2 Callout-Edges Für Zusammenfassungen am Ende einer Notiz: @@ -141,15 +150,6 @@ Damit der **RAG-Chat** dich berät, musst du "Futter" für die Decision Engine l * **Ziel:** Das System soll abwägen: "Passt Tool X zu mir?" * **Vorgehen:** Erstelle Notizen mit `type: value` oder `type: goal`. -**Beispiel Notiz:** -```yaml ---- -type: value -title: Prinzip: Datensparsamkeit ---- -Wir speichern nur das Minimum an Daten. Cloud-Uploads persönlicher Daten sind verboten, es sei denn, sie sind E2E-verschlüsselt. -``` - * **Effekt:** Wenn du fragst "Soll ich Notion nutzen?", lädt die Engine diese Notiz und antwortet: *"Nein, Notion ist SaaS ohne E2E. Das verletzt dein Prinzip der Datensparsamkeit."* ### Szenario B: Empathie (`EMPATHY`) @@ -168,6 +168,16 @@ Ich habe gelernt: Das ist oft das Zeichen kurz vor dem Durchbruch. ``` * **Effekt:** Bei "Alles ist grau" findet das System diese Notiz und spiegelt die Lektion zurück. +### **Szenario C: Forward-Mapping (Lücken-Analyse) [NEU]** +* **Ziel:** Strategische Wissenslücken füllen. +* **Vorgehen:** Erstelle Hub-Notizen mit Forward-Links auf noch nicht existierende Dateien (z. B. `[[Besten Version meiner Selbst]]`). +* **Effekt:** Das System erkennt die semantische Bedeutung des geplanten Wissens und kann proaktiv Fragen stellen, um diese Lücken zu schließen. + +### **Szenario D: Narratives Gedächtnis (Intention) [NEU]** +* **Ziel:** Das System soll verstehen, *warum* eine Entscheidung getroffen wurde, um in ähnlichen künftigen Situationen konsistent zu beraten. +* **Vorgehen:** Nutze in `journal`- oder `experience`-Notizen Abschnitte für "Hintergrund" und "Interpretation". +* **Beispiel:** Statt "Wert: Disziplin" schreibe "Ich wähle Disziplin, weil ich in meiner Kindheit erlebt habe, wie Willkür schadet." +* **Effekt:** Die KI spiegelt nicht nur die Regel, sondern die Überzeugung dahinter. --- ## 6. Best Practices & Beispiele @@ -204,9 +214,6 @@ title: ADR: Wahl von Qdrant type: decision status: final tags: [architektur, db] -# OVERRIDES: Wir wollen diese Notiz extrem wichtig machen und strikt trennen. -# Da "strict" genutzt wird, landet "Alternativen" in einem eigenen Chunk -# und vermischt sich nicht mit der Entscheidung selbst. chunking_profile: structured_smart_edges_strict retriever_weight: 1.5 --- @@ -224,4 +231,4 @@ Wir haben auch [[rel:similar_to Pinecone]] und [[rel:similar_to Weaviate]] betra ## 7. Virtual Schema Layer Grundsätzlich gilt das Prinzip des **Virtual Schema Layers**. Die Logik (wie `chunk_size`) wird zentral in der `types.yaml` verwaltet. -**Aber:** Als Power-User hast du über die oben genannten Overrides (`chunking_profile`) jederzeit die Möglichkeit, aus diesem Standard auszubrechen, wenn eine spezifische Notiz eine Sonderbehandlung benötigt. \ No newline at end of file +**Aber:** Als Power-User hast du über die Overrides jederzeit die Möglichkeit, aus diesem Standard auszubrechen. \ No newline at end of file