Enhance interview configuration and documentation for WP-26 integration
- Added the `Interview_Config_Guide.md` for comprehensive instructions on creating interview profiles and utilizing various note types. - Updated `00_Dokumentations_Index.md` to include links to the new guide and improved navigation for WP-26 related resources. - Enhanced `06_Konfigurationsdateien_Referenz.md` with references to the new guide and clarified YAML structure for interview configurations. - Introduced `audit_geburtsdatei.md` for detailed analysis of section connections and edge types, highlighting critical issues and recommendations for improvement. - Improved renderer tests to ensure proper handling of section types and edge generation, aligning with the new WP-26 features.
This commit is contained in:
1 parent
b99416b67d
commit
8186ca5ce0
13 files changed
+2805
-282
No files matched your search
@@ -19,13 +19,14 @@
|
||||
### Spezialisierte Referenzen
|
||||
|
||||
6. **[06_Konfigurationsdateien_Referenz.md](./06_Konfigurationsdateien_Referenz.md)** - Config-Dateien Format & Aufbau
|
||||
7. **[07_Event_Handler_Commands.md](./07_Event_Handler_Commands.md)** - Event Handler & Commands
|
||||
7. **[Interview_Config_Guide.md](./Interview_Config_Guide.md)** - Vollständige Anleitung für `interview_config.yaml` (inkl. WP-26 Features, GenAI-freundlich)
|
||||
8. **[07_Event_Handler_Commands.md](./07_Event_Handler_Commands.md)** - Event Handler & Commands
|
||||
|
||||
### WP-26 Integration (Section Types & Intra-Note-Edges)
|
||||
|
||||
8. **[06_LH_WP26_Plugin_Integration.md](./06_LH_WP26_Plugin_Integration.md)** - Lastenheft für WP-26 Plugin-Integration (vollständige Anforderungen)
|
||||
9. **[WP26_Plugin_Interface_Specification.md](./WP26_Plugin_Interface_Specification.md)** - Vollständige Schnittstellenspezifikation für Plugin-Entwicklung
|
||||
10. **[WP26_Implementation_Checklist.md](./WP26_Implementation_Checklist.md)** - Implementierungs-Checkliste mit Tasks und Phasen
|
||||
9. **[06_LH_WP26_Plugin_Integration.md](./06_LH_WP26_Plugin_Integration.md)** - Lastenheft für WP-26 Plugin-Integration (vollständige Anforderungen)
|
||||
10. **[WP26_Plugin_Interface_Specification.md](./WP26_Plugin_Interface_Specification.md)** - Vollständige Schnittstellenspezifikation für Plugin-Entwicklung
|
||||
11. **[WP26_Implementation_Checklist.md](./WP26_Implementation_Checklist.md)** - Implementierungs-Checkliste mit Tasks und Phasen
|
||||
|
||||
### Chain Inspector Reports
|
||||
|
||||
@@ -118,7 +119,7 @@
|
||||
|
||||
- [x] **edge_vocabulary.md** - Format, Parsing-Regeln, Beispiel
|
||||
- [x] **graph_schema.md** - Format, Parsing-Regeln, Beispiel
|
||||
- [x] **interview_config.yaml** - Format, Felder, Beispiel (Profile, Steps, Loops)
|
||||
- [x] **interview_config.yaml** - Format, Felder, Beispiel (Profile, Steps, Loops) - **Siehe auch:** [Interview_Config_Guide.md](./Interview_Config_Guide.md) für vollständige Anleitung
|
||||
- [x] **chain_roles.yaml** - Format, Felder, Beispiel (Roles, Edge Types)
|
||||
- [x] **chain_templates.yaml** - Format, Felder, Beispiel (Templates, Slots, Links, Defaults, Profiles)
|
||||
- [x] **analysis_policies.yaml** - Geplante Struktur (noch nicht vollständig implementiert)
|
||||
@@ -167,7 +168,8 @@
|
||||
|
||||
### Konfiguration
|
||||
→ [02_Administratorhandbuch.md](./02_Administratorhandbuch.md)
|
||||
→ [06_Konfigurationsdateien_Referenz.md](./06_Konfigurationsdateien_Referenz.md)
|
||||
→ [06_Konfigurationsdateien_Referenz.md](./06_Konfigurationsdateien_Referenz.md)
|
||||
→ [Interview_Config_Guide.md](./Interview_Config_Guide.md) - Interview-Profile erstellen (GenAI-freundlich)
|
||||
|
||||
### Nutzung
|
||||
→ [01_Benutzerhandbuch.md](./01_Benutzerhandbuch.md)
|
||||
|
||||
@@ -175,41 +175,22 @@ Definiert Profile, Steps, Loops für Note-Erstellung und Interviews.
|
||||
|
||||
**YAML-Datei** mit strukturierter Hierarchie.
|
||||
|
||||
### Struktur
|
||||
### Vollständige Dokumentation
|
||||
|
||||
```yaml
|
||||
version: "2.0"
|
||||
frontmatter_whitelist:
|
||||
- tags
|
||||
- status
|
||||
**→ [Interview_Config_Guide.md](./Interview_Config_Guide.md)** - Vollständige Anleitung mit:
|
||||
- Alle Step-Typen (`capture_frontmatter`, `capture_text`, `capture_text_line`, `loop`, `review`, etc.)
|
||||
- WP-26 Features (Section Types, Block-IDs, Referenzen)
|
||||
- Beispiele für verschiedene Note-Typen (experience, insight, decision, principle)
|
||||
- Best Practices & Patterns
|
||||
- GenAI-Prompt-Template
|
||||
|
||||
profiles:
|
||||
- key: experience_basic
|
||||
label: "Erfahrung (Basis)"
|
||||
note_type: experience
|
||||
description: "Basic experience profile"
|
||||
defaults:
|
||||
folder: "experiences"
|
||||
tags: ["experience"]
|
||||
steps:
|
||||
- id: context
|
||||
prompt: "Beschreibe den Kontext"
|
||||
input_type: textarea
|
||||
required: true
|
||||
- id: details
|
||||
prompt: "Weitere Details"
|
||||
input_type: textarea
|
||||
required: false
|
||||
post_run:
|
||||
edger: true
|
||||
```
|
||||
|
||||
### Felder
|
||||
### Kurzübersicht
|
||||
|
||||
#### Root-Level
|
||||
|
||||
- **`version`** (string, optional): Config-Version (Standard: "2.0")
|
||||
- **`frontmatter_whitelist`** (array of strings, optional): Erlaubte Frontmatter-Keys (zusätzlich zu Standard)
|
||||
- **`version`** (string, optional): Config-Version (aktuell: `3`)
|
||||
- **`frontmatter_whitelist`** (array of strings, optional): Erlaubte Frontmatter-Keys
|
||||
- **`ui_defaults`** (object, optional): Standard-UI-Einstellungen
|
||||
- **`profiles`** (array, required): Liste von Profilen
|
||||
|
||||
#### Profile
|
||||
@@ -217,72 +198,66 @@ profiles:
|
||||
- **`key`** (string, required): Eindeutiger Profil-Schlüssel
|
||||
- **`label`** (string, required): Anzeige-Name
|
||||
- **`note_type`** (string, required): Note-Type (z.B. `experience`, `insight`, `decision`)
|
||||
- **`description`** (string, optional): Beschreibung
|
||||
- **`defaults`** (object, optional): Standardwerte
|
||||
- **`folder`** (string, optional): Standard-Ordner
|
||||
- **`tags`** (array of strings, optional): Standard-Tags
|
||||
- Weitere Felder möglich
|
||||
- **`steps`** (array, optional): Interview-Steps
|
||||
- **`post_run`** (object, optional): Post-Run-Actions
|
||||
- **`edger`** (boolean, optional): Semantic Mapping Builder ausführen
|
||||
- **`group`** (string, optional): Gruppierung für UI
|
||||
- **`defaults`** (object, optional): Standardwerte (status, folder, chunking_profile, etc.)
|
||||
- **`edging`** (object, optional): Semantic Mapping Konfiguration (`mode`, `wrapperCalloutType`, etc.)
|
||||
- **`steps`** (array, required): Liste von Steps
|
||||
|
||||
#### Step
|
||||
#### Step-Typen
|
||||
|
||||
- **`id`** (string, required): Eindeutige Step-ID
|
||||
- **`prompt`** (string, required): Prompt-Text
|
||||
- **`input_type`** (string, required): Input-Typ (`text`, `textarea`, `select`, etc.)
|
||||
- **`required`** (boolean, optional): Ob Step erforderlich ist
|
||||
- **`default`** (string, optional): Standardwert
|
||||
- **`options`** (array, optional): Optionen für `select` Input-Type
|
||||
- **`loop`** (object, optional): Loop-Konfiguration
|
||||
- **`key`** (string, required): Loop-Key
|
||||
- **`prompt`** (string, required): Loop-Prompt
|
||||
- **`min_items`** (number, optional): Minimale Anzahl Items
|
||||
- **`max_items`** (number, optional): Maximale Anzahl Items
|
||||
- **`nested_loops`** (array, optional): Verschachtelte Loops
|
||||
- **`capture_frontmatter`**: Frontmatter-Feld erfassen
|
||||
- **`capture_text`**: Mehrzeiligen Text erfassen (mit Section-Header)
|
||||
- **`capture_text_line`**: Einzeiligen Text erfassen (optional mit Heading-Level)
|
||||
- **`loop`**: Wiederholbare Steps für Listen
|
||||
- **`review`**: Review & Apply Step
|
||||
- **`instruction`**: Anweisung anzeigen
|
||||
- **`llm_dialog`**: LLM-Dialog (experimentell)
|
||||
- **`entity_picker`**: Entity-Auswahl (experimentell)
|
||||
|
||||
#### WP-26 Features (nur für `capture_text` und `capture_text_line`)
|
||||
|
||||
- **`section_type`** (string, optional): Section-Type (überschreibt `note_type`)
|
||||
- **`block_id`** (string, optional): Explizite Block-ID
|
||||
- **`generate_block_id`** (boolean, optional): Automatische Block-ID-Generierung
|
||||
- **`references`** (array, optional): Explizite Referenzen zu vorherigen Sections
|
||||
|
||||
### Beispiel
|
||||
|
||||
```yaml
|
||||
version: "2.0"
|
||||
frontmatter_whitelist:
|
||||
- tags
|
||||
- status
|
||||
version: 3
|
||||
|
||||
profiles:
|
||||
- key: experience_basic
|
||||
group: experience
|
||||
label: "Erfahrung (Basis)"
|
||||
note_type: experience
|
||||
description: "Basic experience profile"
|
||||
defaults:
|
||||
folder: "experiences"
|
||||
tags: ["experience"]
|
||||
status: active
|
||||
folder: "03_experience"
|
||||
edging:
|
||||
mode: both
|
||||
steps:
|
||||
- id: context
|
||||
prompt: "Beschreibe den Kontext"
|
||||
input_type: textarea
|
||||
- id: title
|
||||
kind: capture_frontmatter
|
||||
field: title
|
||||
label: "Titel"
|
||||
required: true
|
||||
- id: events
|
||||
prompt: "Wichtige Ereignisse"
|
||||
input_type: textarea
|
||||
loop:
|
||||
key: events
|
||||
prompt: "Ereignis"
|
||||
min_items: 1
|
||||
max_items: 10
|
||||
post_run:
|
||||
edger: true
|
||||
|
||||
- key: insight_basic
|
||||
label: "Einsicht (Basis)"
|
||||
note_type: insight
|
||||
defaults:
|
||||
folder: "insights"
|
||||
steps:
|
||||
- id: insight
|
||||
prompt: "Beschreibe die Einsicht"
|
||||
input_type: textarea
|
||||
- id: context
|
||||
kind: capture_text
|
||||
section: "## 📖 Kontext"
|
||||
label: "Kontext"
|
||||
required: true
|
||||
prompt: "Beschreibe den Kontext"
|
||||
section_type: experience
|
||||
generate_block_id: true
|
||||
|
||||
- id: review
|
||||
kind: review
|
||||
label: "Review & Apply"
|
||||
checks:
|
||||
- lint_current_note
|
||||
- missing_targets
|
||||
```
|
||||
|
||||
### Verwendung
|
||||
@@ -290,7 +265,21 @@ profiles:
|
||||
- **Profil-Auswahl:** Profile werden in ProfileSelectionModal angezeigt
|
||||
- **Wizard:** Steps werden als Wizard-Steps angezeigt
|
||||
- **Frontmatter:** Frontmatter wird mit Whitelist generiert
|
||||
- **Post-Run:** Actions werden nach Wizard ausgeführt
|
||||
- **WP-26:** Section-Types und Block-IDs werden für Edge-Vorschläge verwendet
|
||||
|
||||
### Wann erscheint der Dialog „Verbindungen bearbeiten“ (Sektions-Links)?
|
||||
|
||||
Der Dialog zum **Ändern der Sektions-Verbindungen** (Section-Edges) erscheint beim Klick auf **„Apply & Finish“** im **Review**-Step – aber nur wenn **beides** erfüllt ist:
|
||||
|
||||
1. **Mindestens zwei Sections im Profil**
|
||||
Das gewählte Interview-Profil muss **mindestens zwei Steps** haben, die eine **Section** erzeugen:
|
||||
- **`capture_text`** mit Feld **`section`** (z. B. `section: "## 📖 Kontext"`).
|
||||
- **`capture_text_line`** mit **`heading_level.enabled: true`** und (**`block_id`** oder **`generate_block_id: true`**).
|
||||
|
||||
2. **Edge-Vocabulary geladen**
|
||||
Die Datei **`edge_vocabulary.md`** muss existieren und der Pfad in den Plugin-Einstellungen stimmen (z. B. `_system/dictionary/edge_vocabulary.md`).
|
||||
|
||||
**Beispiel:** Ein Profil mit drei `capture_text`-Steps mit je `section` (z. B. Kontext, Auslöser, Transformation) erzeugt drei Sections → der Dialog erscheint. Optional können Sie **`section_type`**, **`block_id`** oder **`generate_block_id`** setzen, damit Block-IDs und Edge-Vorschläge aus dem Graph-Schema genutzt werden.
|
||||
|
||||
---
|
||||
|
||||
|
||||
@@ -0,0 +1,857 @@
|
||||
# Interview Config Guide - Vollständige Anleitung für `interview_config.yaml`
|
||||
|
||||
> **Version:** 1.0.0
|
||||
> **Stand:** 2025-01-25
|
||||
> **Zielgruppe:** Administratoren, GenAI-Assistenten, Plugin-Entwickler
|
||||
> **Zweck:** Vollständige Dokumentation zur Erstellung von Interview-Profilen für verschiedene Note-Typen
|
||||
|
||||
---
|
||||
|
||||
## Inhaltsverzeichnis
|
||||
|
||||
1. [Überblick](#überblick)
|
||||
2. [Grundstruktur](#grundstruktur)
|
||||
3. [Root-Level Felder](#root-level-felder)
|
||||
4. [Profile-Definition](#profile-definition)
|
||||
5. [Step-Typen](#step-typen)
|
||||
6. [WP-26 Features (Section Types & Block-IDs)](#wp-26-features-section-types--block-ids)
|
||||
7. [Beispiele für verschiedene Note-Typen](#beispiele-für-verschiedene-note-typen)
|
||||
8. [Best Practices & Patterns](#best-practices--patterns)
|
||||
9. [Validierung & Fehlerbehandlung](#validierung--fehlerbehandlung)
|
||||
|
||||
---
|
||||
|
||||
## Überblick
|
||||
|
||||
Die `interview_config.yaml` definiert **Interview-Profile** für die strukturierte Erstellung von Notes im Obsidian Vault. Jedes Profil beschreibt einen **Wizard-Flow** mit mehreren **Steps**, die nacheinander durchlaufen werden, um eine Note zu erstellen.
|
||||
|
||||
### Wichtige Konzepte
|
||||
|
||||
- **Profile:** Ein Interview-Profil entspricht einem Note-Typ (z.B. `experience`, `insight`, `decision`)
|
||||
- **Steps:** Einzelne Schritte im Interview-Wizard (z.B. Text-Eingabe, Frontmatter-Feld, Loop)
|
||||
- **Loops:** Wiederholbare Steps für Listen von Items
|
||||
- **Section Types (WP-26):** Typisierung von Abschnitten innerhalb einer Note
|
||||
- **Block-IDs (WP-26):** Eindeutige Referenzpunkte für Intra-Note-Verlinkungen
|
||||
|
||||
---
|
||||
|
||||
## Grundstruktur
|
||||
|
||||
```yaml
|
||||
version: 3
|
||||
|
||||
frontmatter_whitelist:
|
||||
- id
|
||||
- title
|
||||
- type
|
||||
- status
|
||||
# ... weitere erlaubte Frontmatter-Keys
|
||||
|
||||
ui_defaults:
|
||||
modal:
|
||||
width: "clamp(720px, 88vw, 1100px)"
|
||||
height: "clamp(640px, 86vh, 920px)"
|
||||
editor:
|
||||
preview_toggle: true
|
||||
toolbar: true
|
||||
full_width_inputs: true
|
||||
|
||||
profiles:
|
||||
- key: profile_key
|
||||
label: "Anzeige-Name"
|
||||
note_type: experience
|
||||
# ... Profile-Definition
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Root-Level Felder
|
||||
|
||||
### `version` (string, optional)
|
||||
|
||||
**Standard:** `3`
|
||||
|
||||
Die Versionsnummer der Config-Datei. Aktuell wird Version `3` verwendet.
|
||||
|
||||
### `frontmatter_whitelist` (array of strings, optional)
|
||||
|
||||
Liste von Frontmatter-Keys, die im Wizard bearbeitet werden können.
|
||||
|
||||
**Standard-Keys (immer verfügbar):**
|
||||
- `id`
|
||||
- `title`
|
||||
- `type`
|
||||
- `status`
|
||||
- `retriever_weight`
|
||||
- `chunking_profile`
|
||||
- `tags`
|
||||
- `aliases`
|
||||
- `created`
|
||||
- `interview_profile`
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
frontmatter_whitelist:
|
||||
- custom_field
|
||||
- priority
|
||||
```
|
||||
|
||||
### `ui_defaults` (object, optional)
|
||||
|
||||
Standard-UI-Einstellungen für den Interview-Wizard.
|
||||
|
||||
**Felder:**
|
||||
- `modal.width` (string): CSS-Width für das Modal
|
||||
- `modal.height` (string): CSS-Height für das Modal
|
||||
- `editor.preview_toggle` (boolean): Preview-Toggle anzeigen
|
||||
- `editor.toolbar` (boolean): Toolbar anzeigen
|
||||
- `editor.full_width_inputs` (boolean): Volle Breite für Inputs
|
||||
|
||||
### `profiles` (array, **required**)
|
||||
|
||||
Liste von Interview-Profilen. Siehe [Profile-Definition](#profile-definition).
|
||||
|
||||
---
|
||||
|
||||
## Profile-Definition
|
||||
|
||||
Jedes Profil definiert einen vollständigen Interview-Wizard für einen Note-Typ.
|
||||
|
||||
### Pflichtfelder
|
||||
|
||||
- **`key`** (string, required): Eindeutiger Schlüssel für das Profil (z.B. `experience_cluster`)
|
||||
- **`label`** (string, required): Anzeige-Name im UI
|
||||
- **`note_type`** (string, required): Note-Typ (muss mit `types.yaml` übereinstimmen, z.B. `experience`, `insight`, `decision`)
|
||||
- **`steps`** (array, required): Liste von Steps (mindestens ein Step)
|
||||
|
||||
### Optionale Felder
|
||||
|
||||
- **`group`** (string, optional): Gruppierung für UI (z.B. `experience`, `insight`)
|
||||
- **`defaults`** (object, optional): Standardwerte für Frontmatter
|
||||
- `status` (string): Standard-Status (z.B. `active`, `stable`)
|
||||
- `folder` (string): Standard-Ordner für neue Notes
|
||||
- `chunking_profile` (string): Standard-Chunking-Profil
|
||||
- `retriever_weight` (number): Standard-Retriever-Weight
|
||||
- `tags` (array of strings): Standard-Tags
|
||||
- **`edging`** (object, optional): Semantic Mapping Konfiguration
|
||||
- `mode` (string): `"none"` | `"post_run"` | `"inline_micro"` | `"both"` (Standard: `"none"`)
|
||||
- `wrapperCalloutType` (string, optional): Override für Wrapper-Callout-Typ
|
||||
- `wrapperTitle` (string, optional): Override für Wrapper-Titel
|
||||
- `wrapperFolded` (boolean, optional): Override für Wrapper-Folded-State
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
profiles:
|
||||
- key: experience_basic
|
||||
group: experience
|
||||
label: "Erfahrung (Basis)"
|
||||
note_type: experience
|
||||
defaults:
|
||||
status: active
|
||||
folder: "03_experience"
|
||||
chunking_profile: timeline
|
||||
edging:
|
||||
mode: both
|
||||
steps:
|
||||
# ... Steps
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Step-Typen
|
||||
|
||||
### 1. `capture_frontmatter` - Frontmatter-Feld erfassen
|
||||
|
||||
Erfasst ein einzelnes Frontmatter-Feld.
|
||||
|
||||
**Felder:**
|
||||
- `id` (string, required): Eindeutige Step-ID
|
||||
- `kind` (string, required): `"capture_frontmatter"`
|
||||
- `field` (string, required): Frontmatter-Feld-Name (muss in `frontmatter_whitelist` sein)
|
||||
- `label` (string, optional): Anzeige-Name (Standard: `field`)
|
||||
- `required` (boolean, optional): Ob erforderlich (Standard: `false`)
|
||||
- `prompt` (string, optional): Prompt-Text für den Benutzer
|
||||
- `input.kind` (string, optional): Input-Typ (`text_line`, `number`, `select`, etc.)
|
||||
- `input.min` (number, optional): Min-Wert für `number`
|
||||
- `input.max` (number, optional): Max-Wert für `number`
|
||||
- `input.step` (number, optional): Step-Wert für `number`
|
||||
- `input.options` (array, optional): Optionen für `select`
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
- id: title
|
||||
kind: capture_frontmatter
|
||||
field: title
|
||||
label: "Titel"
|
||||
required: true
|
||||
prompt: "Gib einen Titel für die Note ein"
|
||||
|
||||
- id: retriever_weight
|
||||
kind: capture_frontmatter
|
||||
field: retriever_weight
|
||||
label: "Retriever Weight"
|
||||
required: false
|
||||
input:
|
||||
kind: number
|
||||
min: -3
|
||||
max: 3
|
||||
step: 1
|
||||
```
|
||||
|
||||
### 2. `capture_text` - Mehrzeiligen Text erfassen
|
||||
|
||||
Erfasst mehrzeiligen Text und erzeugt eine Section in der Note.
|
||||
|
||||
**Felder:**
|
||||
- `id` (string, required): Eindeutige Step-ID
|
||||
- `kind` (string, required): `"capture_text"`
|
||||
- `label` (string, optional): Anzeige-Name
|
||||
- `required` (boolean, optional): Ob erforderlich (Standard: `false`)
|
||||
- `prompt` (string, optional): Prompt-Text für den Benutzer
|
||||
- `section` (string, optional): Markdown-Section-Header (z.B. `"## 📖 Kontext"`)
|
||||
- Wenn leer (`""`), wird kein Section-Header erzeugt (z.B. in Loops)
|
||||
- **WP-26 Felder:** Siehe [WP-26 Features](#wp-26-features-section-types--block-ids)
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
- id: context
|
||||
kind: capture_text
|
||||
section: "## 📖 Kontext"
|
||||
label: "Kontext"
|
||||
required: true
|
||||
prompt: "Beschreibe den Kontext der Erfahrung"
|
||||
section_type: experience
|
||||
generate_block_id: true
|
||||
```
|
||||
|
||||
### 3. `capture_text_line` - Einzeiligen Text erfassen
|
||||
|
||||
Erfasst einzeiligen Text, optional mit Heading-Level.
|
||||
|
||||
**Felder:**
|
||||
- `id` (string, required): Eindeutige Step-ID
|
||||
- `kind` (string, required): `"capture_text_line"`
|
||||
- `label` (string, optional): Anzeige-Name
|
||||
- `required` (boolean, optional): Ob erforderlich (Standard: `false`)
|
||||
- `prompt` (string, optional): Prompt-Text für den Benutzer
|
||||
- `heading_level.enabled` (boolean, optional): Heading-Level-Selector anzeigen (Standard: `false`)
|
||||
- `heading_level.default` (number, optional): Standard-Heading-Level 1-6 (Standard: `2`)
|
||||
- **WP-26 Felder:** Siehe [WP-26 Features](#wp-26-features-section-types--block-ids)
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
- id: subtitle
|
||||
kind: capture_text_line
|
||||
label: "Untertitel"
|
||||
heading_level:
|
||||
enabled: true
|
||||
default: 1
|
||||
prompt: "Kurzer Untertitel"
|
||||
section_type: experience
|
||||
generate_block_id: true
|
||||
```
|
||||
|
||||
### 4. `loop` - Wiederholbare Steps
|
||||
|
||||
Erzeugt eine Liste von Items, die durch wiederholte Ausführung der Sub-Steps erzeugt werden.
|
||||
|
||||
**Felder:**
|
||||
- `id` (string, required): Eindeutige Step-ID
|
||||
- `kind` (string, required): `"loop"`
|
||||
- `label` (string, optional): Anzeige-Name für die Loop
|
||||
- `item_label` (string, optional): Anzeige-Name für einzelne Items (z.B. `"Erlebnis"`)
|
||||
- `min_items` (number, optional): Minimale Anzahl Items (Standard: `0`)
|
||||
- `max_items` (number, optional): Maximale Anzahl Items (kein Limit, wenn nicht gesetzt)
|
||||
- `steps` (array, required): Liste von Sub-Steps (werden für jedes Item ausgeführt)
|
||||
- `output.join` (string, optional): String zum Verbinden der Items (Standard: `"\n\n"`)
|
||||
- `ui.mode` (string, optional): UI-Modus (`subwizard` | `inline`, Standard: `inline`)
|
||||
- `ui.commit` (string, optional): Commit-Modus (`explicit_add` | `on_next`, Standard: `explicit_add`)
|
||||
- `ui.allow_edit` (boolean, optional): Bearbeitung erlauben (Standard: `false`)
|
||||
- `ui.allow_delete` (boolean, optional): Löschen erlauben (Standard: `false`)
|
||||
- `ui.allow_reorder` (boolean, optional): Neuordnen erlauben (Standard: `false`)
|
||||
- `ui.show_item_overview` (boolean, optional): Item-Übersicht anzeigen (Standard: `false`)
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
- id: actions
|
||||
kind: loop
|
||||
label: "Handlungen"
|
||||
item_label: "Handlung"
|
||||
min_items: 1
|
||||
steps:
|
||||
- id: action_heading
|
||||
kind: capture_text_line
|
||||
label: "Handlungsüberschrift"
|
||||
required: true
|
||||
heading_level:
|
||||
enabled: true
|
||||
default: 3
|
||||
section_type: decision
|
||||
generate_block_id: true
|
||||
- id: action_description
|
||||
kind: capture_text
|
||||
section: ""
|
||||
label: "Beschreibung"
|
||||
required: true
|
||||
```
|
||||
|
||||
**Verschachtelte Loops:**
|
||||
```yaml
|
||||
- id: groups
|
||||
kind: loop
|
||||
label: "Erlebnis-Gruppen"
|
||||
steps:
|
||||
- id: group_heading
|
||||
kind: capture_text_line
|
||||
label: "Überschrift"
|
||||
- id: entries
|
||||
kind: loop
|
||||
label: "Einträge"
|
||||
steps:
|
||||
- id: entry
|
||||
kind: capture_text_line
|
||||
label: "Listeneintrag"
|
||||
```
|
||||
|
||||
### 5. `review` - Review & Apply Step
|
||||
|
||||
Zeigt eine Vorschau der generierten Note und ermöglicht abschließende Checks.
|
||||
|
||||
**Felder:**
|
||||
- `id` (string, required): Eindeutige Step-ID
|
||||
- `kind` (string, required): `"review"`
|
||||
- `label` (string, optional): Anzeige-Name (Standard: `"Review & Apply"`)
|
||||
- `checks` (array of strings, optional): Liste von Checks
|
||||
- `lint_current_note`: Lint-Check für die generierte Note
|
||||
- `missing_targets`: Prüft auf fehlende Link-Targets
|
||||
- `missing_frontmatter_id`: Prüft auf fehlende Frontmatter-ID
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
- id: review
|
||||
kind: review
|
||||
label: "Review & Apply"
|
||||
checks:
|
||||
- lint_current_note
|
||||
- missing_targets
|
||||
- missing_frontmatter_id
|
||||
```
|
||||
|
||||
### 6. `instruction` - Anweisung anzeigen
|
||||
|
||||
Zeigt eine reine Anweisung ohne Input.
|
||||
|
||||
**Felder:**
|
||||
- `id` (string, required): Eindeutige Step-ID
|
||||
- `kind` (string, required): `"instruction"`
|
||||
- `label` (string, optional): Anzeige-Name
|
||||
- `content` (string, required): Markdown-Inhalt der Anweisung
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
- id: intro
|
||||
kind: instruction
|
||||
label: "Einführung"
|
||||
content: |
|
||||
# Willkommen zum Interview
|
||||
|
||||
Dieses Interview hilft dir, eine strukturierte Note zu erstellen.
|
||||
```
|
||||
|
||||
### 7. `llm_dialog` - LLM-Dialog (experimentell)
|
||||
|
||||
Öffnet einen LLM-Dialog für Text-Generierung oder -Verdichtung.
|
||||
|
||||
**Felder:**
|
||||
- `id` (string, required): Eindeutige Step-ID
|
||||
- `kind` (string, required): `"llm_dialog"`
|
||||
- `label` (string, optional): Anzeige-Name
|
||||
- `mode` (string, optional): `"manual"` | `"auto"` (Standard: `"manual"`)
|
||||
- `prompt_template` (string, required): Prompt-Template für den LLM
|
||||
- `output_target.kind` (string, required): Output-Ziel (`section_append` | `replace`)
|
||||
- `output_target.section` (string, optional): Section für `section_append`
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
- id: llm_refine
|
||||
kind: llm_dialog
|
||||
label: "LLM – Verdichtung"
|
||||
mode: manual
|
||||
prompt_template: |
|
||||
Verdichte die bisherigen Inhalte zu 3-5 Bulletpoints.
|
||||
Erfinde keine Fakten.
|
||||
output_target:
|
||||
kind: section_append
|
||||
section: "## 🧠 Verdichtung (LLM Vorschlag)"
|
||||
```
|
||||
|
||||
### 8. `entity_picker` - Entity-Auswahl (experimentell)
|
||||
|
||||
Ermöglicht die Auswahl einer bestehenden Note aus dem Vault.
|
||||
|
||||
**Felder:**
|
||||
- `id` (string, required): Eindeutige Step-ID
|
||||
- `kind` (string, required): `"entity_picker"`
|
||||
- `label` (string, optional): Anzeige-Name
|
||||
- `prompt` (string, optional): Prompt-Text
|
||||
- `required` (boolean, optional): Ob erforderlich (Standard: `false`)
|
||||
- `labelField` (string, optional): Feld-Key für Wikilink-Label
|
||||
|
||||
---
|
||||
|
||||
## WP-26 Features (Section Types & Block-IDs)
|
||||
|
||||
**Wichtig:** Diese Features sind nur für `capture_text` und `capture_text_line` Steps verfügbar.
|
||||
|
||||
### `section_type` (string, optional)
|
||||
|
||||
Definiert den **Section-Type** für diese Section. Überschreibt den `note_type` für diese Section.
|
||||
|
||||
**Verwendung:**
|
||||
- Für **Edge-Type-Vorschläge** basierend auf `graph_schema.md`
|
||||
- Für **Type-Boost-Scoring** im Retriever
|
||||
- Für **Agentic Validation** (Phase 3)
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
- id: insight
|
||||
kind: capture_text
|
||||
section: "## 💡 Einsicht"
|
||||
section_type: insight # Typ-Wechsel: experience -> insight
|
||||
```
|
||||
|
||||
**Fallback-Logik:**
|
||||
- Wenn `section_type` nicht gesetzt ist, wird der `note_type` des Profils verwendet
|
||||
- Bei verschachtelten Sections wird der Section-Type der übergeordneten Section verwendet (basierend auf Heading-Level)
|
||||
|
||||
### `block_id` (string, optional)
|
||||
|
||||
Definiert eine **explizite Block-ID** für diese Section. Die Block-ID wird als `^block-id` am Ende der Überschrift erzeugt.
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
- id: situation
|
||||
kind: capture_text
|
||||
section: "## ⚡ Situation"
|
||||
block_id: "sit" # Erzeugt: ## ⚡ Situation ^sit
|
||||
```
|
||||
|
||||
**Wichtig:** Block-IDs müssen **eindeutig** sein. In Loops werden automatisch Nummerierungen angehängt (z.B. `action_heading-1`, `action_heading-2`).
|
||||
|
||||
### `generate_block_id` (boolean, optional)
|
||||
|
||||
Wenn `true`, wird automatisch eine Block-ID aus der Step-ID generiert (slugified).
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
- id: context
|
||||
kind: capture_text
|
||||
section: "## 📖 Kontext"
|
||||
generate_block_id: true # Erzeugt: ## 📖 Kontext ^context
|
||||
```
|
||||
|
||||
**Regeln:**
|
||||
- Wenn sowohl `block_id` als auch `generate_block_id: true` gesetzt sind, hat `block_id` Priorität
|
||||
- In Loops wird automatisch eine Nummerierung angehängt (z.B. `context-1`, `context-2`)
|
||||
|
||||
### `references` (array, optional)
|
||||
|
||||
Definiert **explizite Referenzen** zu vorherigen Sections (Block-IDs).
|
||||
|
||||
**Struktur:**
|
||||
```yaml
|
||||
references:
|
||||
- block_id: <block_id_der_referenzierten_section>
|
||||
edge_type: <optional_vorgeschlagener_edge_type>
|
||||
```
|
||||
|
||||
**Beispiel:**
|
||||
```yaml
|
||||
- id: situation
|
||||
kind: capture_text
|
||||
section: "## ⚡ Situation"
|
||||
section_type: experience
|
||||
block_id: "sit"
|
||||
references:
|
||||
- block_id: context
|
||||
edge_type: derived_from # Explizite Referenz zu vorheriger Section
|
||||
```
|
||||
|
||||
**Verhalten:**
|
||||
- Referenzen werden als **Intra-Note-Edges** erzeugt (`is_internal: true`)
|
||||
- Der `edge_type` wird als **Vorschlag** verwendet (kann im `SectionEdgesOverviewModal` geändert werden)
|
||||
- Wenn kein `edge_type` angegeben ist, wird ein Typ aus `graph_schema.md` vorgeschlagen
|
||||
- **Automatische Rückwärts-Edges** werden in der Ziel-Section erzeugt (basierend auf dem inversen Edge-Type)
|
||||
|
||||
**Wichtig:** `block_id` muss auf eine **vorherige Section** verweisen (nicht auf zukünftige Sections).
|
||||
|
||||
---
|
||||
|
||||
## Beispiele für verschiedene Note-Typen
|
||||
|
||||
### Experience (Erfahrung)
|
||||
|
||||
```yaml
|
||||
- key: experience_single
|
||||
group: experience
|
||||
label: "Experience – Einzelereignis"
|
||||
note_type: experience
|
||||
defaults:
|
||||
status: active
|
||||
chunking_profile: timeline
|
||||
edging:
|
||||
mode: both
|
||||
steps:
|
||||
- id: title
|
||||
kind: capture_frontmatter
|
||||
field: title
|
||||
label: "Titel"
|
||||
required: true
|
||||
|
||||
- id: context
|
||||
kind: capture_text
|
||||
section: "## 📖 Kontext"
|
||||
label: "Kontext"
|
||||
required: true
|
||||
prompt: "In welchem Rahmen ist es passiert?"
|
||||
section_type: experience
|
||||
generate_block_id: true
|
||||
|
||||
- id: trigger
|
||||
kind: capture_text
|
||||
section: "## ⚡ Auslöser"
|
||||
label: "Auslöser"
|
||||
required: false
|
||||
prompt: "Was hat es ausgelöst?"
|
||||
section_type: experience
|
||||
generate_block_id: true
|
||||
references:
|
||||
- block_id: context
|
||||
edge_type: derived_from
|
||||
|
||||
- id: transformation
|
||||
kind: capture_text
|
||||
section: "## 🧠 Innere Transformation"
|
||||
label: "Innere Transformation"
|
||||
required: false
|
||||
prompt: "Was hat sich innerlich verändert?"
|
||||
section_type: insight # Typ-Wechsel
|
||||
generate_block_id: true
|
||||
|
||||
- id: review
|
||||
kind: review
|
||||
label: "Review & Apply"
|
||||
checks:
|
||||
- lint_current_note
|
||||
- missing_targets
|
||||
```
|
||||
|
||||
### Insight (Einsicht)
|
||||
|
||||
```yaml
|
||||
- key: insight_basic
|
||||
group: insight
|
||||
label: "Insight – Basis"
|
||||
note_type: insight
|
||||
defaults:
|
||||
status: active
|
||||
folder: "04_insight"
|
||||
edging:
|
||||
mode: both
|
||||
steps:
|
||||
- id: title
|
||||
kind: capture_frontmatter
|
||||
field: title
|
||||
label: "Titel"
|
||||
required: true
|
||||
|
||||
- id: insight
|
||||
kind: capture_text
|
||||
section: "## 💡 Einsicht"
|
||||
label: "Einsicht"
|
||||
required: true
|
||||
prompt: "Beschreibe die Einsicht"
|
||||
section_type: insight
|
||||
generate_block_id: true
|
||||
|
||||
- id: source
|
||||
kind: capture_text
|
||||
section: "## 📚 Quelle"
|
||||
label: "Quelle"
|
||||
required: false
|
||||
prompt: "Woher stammt diese Einsicht?"
|
||||
section_type: insight
|
||||
generate_block_id: true
|
||||
references:
|
||||
- block_id: insight
|
||||
edge_type: source_of
|
||||
|
||||
- id: application
|
||||
kind: capture_text
|
||||
section: "## 🎯 Anwendung"
|
||||
label: "Anwendung"
|
||||
required: false
|
||||
prompt: "Wie wird diese Einsicht angewendet?"
|
||||
section_type: decision # Typ-Wechsel
|
||||
generate_block_id: true
|
||||
references:
|
||||
- block_id: insight
|
||||
edge_type: foundation_for
|
||||
|
||||
- id: review
|
||||
kind: review
|
||||
label: "Review & Apply"
|
||||
checks:
|
||||
- lint_current_note
|
||||
```
|
||||
|
||||
### Decision (Entscheidung)
|
||||
|
||||
```yaml
|
||||
- key: decision_basic
|
||||
group: decision
|
||||
label: "Decision – Basis"
|
||||
note_type: decision
|
||||
defaults:
|
||||
status: active
|
||||
folder: "05_decision"
|
||||
edging:
|
||||
mode: both
|
||||
steps:
|
||||
- id: title
|
||||
kind: capture_frontmatter
|
||||
field: title
|
||||
label: "Titel"
|
||||
required: true
|
||||
|
||||
- id: context
|
||||
kind: capture_text
|
||||
section: "## 📖 Kontext"
|
||||
label: "Kontext"
|
||||
required: true
|
||||
prompt: "In welchem Kontext wurde die Entscheidung getroffen?"
|
||||
section_type: experience
|
||||
generate_block_id: true
|
||||
|
||||
- id: options
|
||||
kind: loop
|
||||
label: "Optionen"
|
||||
item_label: "Option"
|
||||
min_items: 2
|
||||
steps:
|
||||
- id: option_text
|
||||
kind: capture_text
|
||||
section: ""
|
||||
label: "Option"
|
||||
required: true
|
||||
prompt: "Beschreibe eine Option"
|
||||
|
||||
- id: decision
|
||||
kind: capture_text
|
||||
section: "## 🎯 Entscheidung"
|
||||
label: "Entscheidung"
|
||||
required: true
|
||||
prompt: "Welche Entscheidung wurde getroffen?"
|
||||
section_type: decision
|
||||
generate_block_id: true
|
||||
references:
|
||||
- block_id: context
|
||||
edge_type: derived_from
|
||||
|
||||
- id: rationale
|
||||
kind: capture_text
|
||||
section: "## 🧠 Begründung"
|
||||
label: "Begründung"
|
||||
required: false
|
||||
prompt: "Warum wurde diese Entscheidung getroffen?"
|
||||
section_type: insight
|
||||
generate_block_id: true
|
||||
references:
|
||||
- block_id: decision
|
||||
edge_type: based_on
|
||||
|
||||
- id: review
|
||||
kind: review
|
||||
label: "Review & Apply"
|
||||
checks:
|
||||
- lint_current_note
|
||||
- missing_targets
|
||||
```
|
||||
|
||||
### Principle (Prinzip)
|
||||
|
||||
```yaml
|
||||
- key: principle_basic
|
||||
group: principle
|
||||
label: "Principle – Basis"
|
||||
note_type: principle
|
||||
defaults:
|
||||
status: stable
|
||||
chunking_profile: principle_dense
|
||||
retriever_weight: 2
|
||||
steps:
|
||||
- id: title
|
||||
kind: capture_frontmatter
|
||||
field: title
|
||||
label: "Titel"
|
||||
required: true
|
||||
|
||||
- id: statement
|
||||
kind: capture_text
|
||||
section: "## 🧭 Prinzip"
|
||||
label: "Prinzip"
|
||||
required: true
|
||||
prompt: "Formuliere das Prinzip als klaren Satz."
|
||||
section_type: principle
|
||||
generate_block_id: true
|
||||
|
||||
- id: retriever_weight
|
||||
kind: capture_frontmatter
|
||||
field: retriever_weight
|
||||
label: "Retriever Weight"
|
||||
required: false
|
||||
input:
|
||||
kind: number
|
||||
min: -3
|
||||
max: 3
|
||||
step: 1
|
||||
|
||||
- id: review
|
||||
kind: review
|
||||
label: "Review & Apply"
|
||||
checks:
|
||||
- lint_current_note
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Best Practices & Patterns
|
||||
|
||||
### 1. Section-Type-Wechsel dokumentieren
|
||||
|
||||
Wenn ein Section-Type-Wechsel stattfindet, sollte dies im Kommentar dokumentiert werden:
|
||||
|
||||
```yaml
|
||||
- id: transformation
|
||||
kind: capture_text
|
||||
section: "## 🧠 Innere Transformation"
|
||||
section_type: insight # Typ-Wechsel: experience -> insight
|
||||
generate_block_id: true
|
||||
```
|
||||
|
||||
### 2. Block-IDs konsistent benennen
|
||||
|
||||
- Verwende **kurze, aussagekräftige** Block-IDs (z.B. `sit`, `ctx`, `ins`)
|
||||
- In Loops werden automatisch Nummerierungen angehängt
|
||||
- Vermeide **kollidierende** Block-IDs innerhalb eines Profils
|
||||
|
||||
### 3. Referenzen zu vorherigen Sections
|
||||
|
||||
- Referenzen müssen auf **vorherige Sections** verweisen (nicht zukünftige)
|
||||
- Verwende **explizite `edge_type`-Vorschläge**, wenn die Beziehung klar ist
|
||||
- Lasse `edge_type` weg, wenn das System aus `graph_schema.md` vorschlagen soll
|
||||
|
||||
### 4. Loops für Listen verwenden
|
||||
|
||||
- Verwende `loop` für **wiederholbare Items** (z.B. Handlungen, Optionen, Erlebnisse)
|
||||
- Setze `min_items` für **erforderliche Listen**
|
||||
- Verwende `section: ""` für Steps innerhalb von Loops, die keine eigene Section erzeugen sollen
|
||||
|
||||
### 5. Review-Step immer am Ende
|
||||
|
||||
- Jedes Profil sollte mit einem `review` Step enden
|
||||
- Aktiviere relevante Checks (`lint_current_note`, `missing_targets`, etc.)
|
||||
|
||||
### 6. Edging-Mode konfigurieren
|
||||
|
||||
- `mode: "both"` für vollständige Edge-Unterstützung (inline + post-run)
|
||||
- `mode: "inline_micro"` für nur Inline-Edge-Vorschläge
|
||||
- `mode: "post_run"` für nur Post-Run-Edge-Abfrage
|
||||
- `mode: "none"` für keine Edge-Unterstützung
|
||||
|
||||
### 7. Frontmatter-Felder dokumentieren
|
||||
|
||||
- Dokumentiere **Custom-Frontmatter-Felder** in `frontmatter_whitelist`
|
||||
- Verwende **sinnvolle Defaults** in `defaults` für bessere UX
|
||||
|
||||
---
|
||||
|
||||
## Validierung & Fehlerbehandlung
|
||||
|
||||
### YAML-Syntax-Fehler
|
||||
|
||||
- **Syntax-Fehler** werden beim Laden erkannt und geloggt
|
||||
- **Last-Known-Good:** Letzte gültige Config wird bei Fehlern verwendet
|
||||
- **Warnings:** Ungültige Felder werden als Warnings geloggt, nicht als Fehler
|
||||
|
||||
### Step-Validierung
|
||||
|
||||
- **Fehlende Pflichtfelder:** Werden als Fehler erkannt
|
||||
- **Ungültige Step-Kinds:** Werden als Warnings geloggt
|
||||
- **Ungültige Block-ID-Referenzen:** Werden zur Laufzeit erkannt (keine Validierung zur Config-Zeit)
|
||||
|
||||
### Live-Reload
|
||||
|
||||
- **Debounced:** 200ms Delay für Performance
|
||||
- **Automatisch:** Bei Dateiänderungen
|
||||
- **Manuell:** Über Commands möglich
|
||||
|
||||
---
|
||||
|
||||
## GenAI-Prompt-Template
|
||||
|
||||
Wenn du ein GenAI-Assistent bist und ein neues Interview-Profil erstellen sollst, verwende folgendes Template:
|
||||
|
||||
```
|
||||
Erstelle ein Interview-Profil für den Note-Typ "{note_type}" mit folgenden Anforderungen:
|
||||
|
||||
1. **Profil-Informationen:**
|
||||
- Key: {profile_key}
|
||||
- Label: {display_name}
|
||||
- Group: {group}
|
||||
- Note-Type: {note_type}
|
||||
|
||||
2. **Default-Werte:**
|
||||
- Status: {status}
|
||||
- Folder: {folder}
|
||||
- Chunking-Profile: {chunking_profile} (optional)
|
||||
- Retriever-Weight: {retriever_weight} (optional)
|
||||
|
||||
3. **Steps:**
|
||||
{step_descriptions}
|
||||
|
||||
4. **WP-26 Features:**
|
||||
- Section-Types: {section_types}
|
||||
- Block-IDs: {block_ids}
|
||||
- Referenzen: {references}
|
||||
|
||||
5. **Edging:**
|
||||
- Mode: {edging_mode}
|
||||
|
||||
6. **Review:**
|
||||
- Checks: {review_checks}
|
||||
|
||||
Nutze die Beispiele aus der Dokumentation als Vorlage und stelle sicher, dass:
|
||||
- Alle Pflichtfelder gesetzt sind
|
||||
- Block-IDs eindeutig sind
|
||||
- Referenzen auf vorherige Sections verweisen
|
||||
- Section-Types konsistent mit graph_schema.md sind
|
||||
- Ein Review-Step am Ende steht
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Zusammenfassung
|
||||
|
||||
Die `interview_config.yaml` ist eine mächtige Konfigurationsdatei für die strukturierte Erstellung von Notes. Mit WP-26 Features können Sections typisiert und referenziert werden, was zu besseren Edge-Vorschlägen und Retrieval-Ergebnissen führt.
|
||||
|
||||
**Wichtigste Punkte:**
|
||||
1. Jedes Profil benötigt `key`, `label`, `note_type` und `steps`
|
||||
2. WP-26 Features (`section_type`, `block_id`, `generate_block_id`, `references`) sind nur für `capture_text` und `capture_text_line` verfügbar
|
||||
3. Block-IDs müssen eindeutig sein (automatische Nummerierung in Loops)
|
||||
4. Referenzen müssen auf vorherige Sections verweisen
|
||||
5. Ein Review-Step sollte immer am Ende stehen
|
||||
|
||||
---
|
||||
|
||||
**Ende der Interview Config Guide**
|
||||
@@ -0,0 +1,146 @@
|
||||
# Audit: Geburt unserer Kinder Rouven und Rohan.md
|
||||
|
||||
## Datei-Analyse
|
||||
|
||||
### Section-Sequenz:
|
||||
1. **Kontext** (`experience`) - Block-ID: `context`
|
||||
2. **Situation** (`experience`) - Block-ID: `sit`
|
||||
3. **Emotionen** (`experience`) - Block-ID: `emotions`
|
||||
4. **Einsicht** (`insight`) - Block-ID: `insight`
|
||||
5. **Entscheidung** (`decision`) - Block-ID: `decision`
|
||||
6. **G1** (`decision`) - Block-ID: `action_heading-1` (Loop-Item)
|
||||
7. **G 2** (`decision`) - Block-ID: `action_heading-2` (Loop-Item)
|
||||
8. **Reflexion** (`insight`) - Block-ID: `reflection`
|
||||
|
||||
---
|
||||
|
||||
## Gefundene Probleme
|
||||
|
||||
### 1. ❌ FEHLENDE Forward-Edges zwischen Sections
|
||||
|
||||
**Problem:** Forward-Edges zwischen aufeinanderfolgenden Sections fehlen komplett.
|
||||
|
||||
**Erwartet:**
|
||||
- Situation sollte Forward-Edge von Kontext haben (`experience` → `experience`: `related_to` oder `references`)
|
||||
- Emotionen sollte Forward-Edge von Situation haben (`experience` → `experience`: `related_to` oder `references`)
|
||||
- Einsicht sollte Forward-Edge von Emotionen haben (`experience` → `insight`: `resulted_in`)
|
||||
- Entscheidung sollte Forward-Edge von Einsicht haben (`insight` → `decision`: `foundation_for`)
|
||||
- G1 sollte Forward-Edge von Entscheidung haben (`decision` → `decision`: `related_to` oder `references`)
|
||||
- G 2 sollte Forward-Edge von Entscheidung und G1 haben (`decision` → `decision`: `related_to` oder `references`)
|
||||
- Reflexion sollte Forward-Edge von Entscheidung haben (`decision` → `insight`: nicht explizit definiert, sollte `related_to` sein)
|
||||
|
||||
**Aktuell:** Keine automatischen Forward-Edges zwischen Sections vorhanden.
|
||||
|
||||
---
|
||||
|
||||
### 2. ❌ FEHLENDE Backward-Edges in Ziel-Sections
|
||||
|
||||
**Problem:** Backward-Edges fehlen komplett in den Ziel-Sections.
|
||||
|
||||
**Erwartet:**
|
||||
- Kontext sollte Backward-Edge von Situation haben (inverse von `related_to` = `related_to`)
|
||||
- Situation sollte Backward-Edge von Emotionen haben (inverse von `related_to` = `related_to`)
|
||||
- Emotionen sollte Backward-Edge von Einsicht haben (inverse von `resulted_in` = `caused_by`)
|
||||
- Einsicht sollte Backward-Edge von Entscheidung haben (inverse von `foundation_for` = `based_on`)
|
||||
- Entscheidung sollte Backward-Edge von G1 haben (inverse von `related_to` = `related_to`)
|
||||
- G1 sollte Backward-Edge von G 2 haben (inverse von `related_to` = `related_to`)
|
||||
- Entscheidung sollte Backward-Edge von Reflexion haben (inverse von `related_to` = `related_to`)
|
||||
|
||||
**Aktuell:** Keine automatischen Backward-Edges vorhanden.
|
||||
|
||||
---
|
||||
|
||||
### 3. ⚠️ FALSCHE Edge-Types in bestehenden Edges
|
||||
|
||||
**Problem:** Viele Edge-Types entsprechen nicht dem graph_schema.md.
|
||||
|
||||
#### Kontext-Section:
|
||||
- `referenced_by` → `decision`: ❌ Falsch, sollte `references` sein (experience → decision: `references` oder `related_to`)
|
||||
- `referenced_by` → `emotions`: ❌ Falsch, sollte `references` sein (experience → experience: `references` oder `related_to`)
|
||||
- `referenced_by` → `sit`: ❌ Falsch, sollte `references` sein (experience → experience: `references` oder `related_to`)
|
||||
- `caused_by` → `insight`: ❌ Falsch, sollte `resulted_in` sein (experience → insight: `resulted_in`)
|
||||
- `caused_by` → `reflection`: ❌ Falsch, sollte `resulted_in` sein (experience → insight: `resulted_in`)
|
||||
|
||||
#### Situation-Section:
|
||||
- `derived_from` → `context`: ✅ Korrekt (experience → experience: `references` oder `related_to`, `derived_from` ist akzeptabel)
|
||||
- `referenced_by` → `decision`: ❌ Falsch
|
||||
- `referenced_by` → `emotions`: ❌ Falsch
|
||||
- `caused_by` → `insight`: ❌ Falsch
|
||||
- `caused_by` → `reflection`: ❌ Falsch
|
||||
|
||||
#### Emotionen-Section:
|
||||
- `references` → `context`: ✅ Korrekt
|
||||
- `references` → `sit`: ✅ Korrekt
|
||||
- `referenced_by` → `decision`: ❌ Falsch
|
||||
- `caused_by` → `insight`: ❌ Falsch
|
||||
- `caused_by` → `reflection`: ❌ Falsch
|
||||
|
||||
#### Einsicht-Section:
|
||||
- `resulted_in` → `context`: ❌ Falsch, sollte `caused_by` sein (insight → experience: nicht explizit, aber `caused_by` ist logisch)
|
||||
- `resulted_in` → `emotions`: ❌ Falsch
|
||||
- `resulted_in` → `sit`: ❌ Falsch
|
||||
- `based_on` → `decision`: ✅ Korrekt (insight → decision: `foundation_for`, inverse = `based_on`)
|
||||
- `referenced_by` → `reflection`: ❌ Falsch
|
||||
|
||||
#### Entscheidung-Section:
|
||||
- `references` → `context`: ✅ Korrekt
|
||||
- `references` → `emotions`: ✅ Korrekt
|
||||
- `references` → `sit`: ✅ Korrekt
|
||||
- `foundation_for` → `insight`: ✅ Korrekt (decision → insight: nicht explizit, aber `foundation_for` ist logisch)
|
||||
- `resulted_in` → `reflection`: ❌ Falsch, sollte `foundation_for` sein (decision → insight: nicht explizit, aber `foundation_for` ist logischer)
|
||||
|
||||
#### G1-Section (Loop-Item):
|
||||
- `caused_by` → `action_heading`: ❌ Falsch, Block-ID `action_heading` existiert nicht (sollte `action_heading-1` oder `action_heading-2` sein)
|
||||
- `caused_by` → `decision`: ❌ Falsch, sollte `based_on` sein (decision → decision: `related_to` oder `references`)
|
||||
- `references` → `context`: ✅ Korrekt
|
||||
- `references` → `emotions`: ✅ Korrekt
|
||||
- `references` → `sit`: ✅ Korrekt
|
||||
- `foundation_for` → `insight`: ✅ Korrekt
|
||||
- `foundation_for` → `reflection`: ✅ Korrekt
|
||||
|
||||
#### G 2-Section (Loop-Item):
|
||||
- `caused_by` → `action_heading`: ❌ Falsch, Block-ID `action_heading` existiert nicht
|
||||
- `caused_by` → `action_heading-1`: ✅ Korrekt (decision → decision: `related_to` oder `references`)
|
||||
- `caused_by` → `decision`: ❌ Falsch, sollte `based_on` sein
|
||||
- `references` → `context`: ✅ Korrekt
|
||||
- `references` → `emotions`: ✅ Korrekt
|
||||
- `references` → `sit`: ✅ Korrekt
|
||||
- `foundation_for` → `insight`: ✅ Korrekt
|
||||
- `foundation_for` → `reflection`: ✅ Korrekt
|
||||
|
||||
#### Reflexion-Section:
|
||||
- `caused_by` → `action_heading`: ❌ Falsch, Block-ID `action_heading` existiert nicht
|
||||
- `caused_by` → `decision`: ❌ Falsch, sollte `based_on` sein (insight → decision: `foundation_for`, inverse = `based_on`)
|
||||
- `resulted_in` → `context`: ❌ Falsch
|
||||
- `resulted_in` → `emotions`: ❌ Falsch
|
||||
- `resulted_in` → `sit`: ❌ Falsch
|
||||
- `builds_on` → `insight`: ❌ Falsch, sollte `based_on` sein (insight → insight: nicht explizit, aber `based_on` ist logisch)
|
||||
|
||||
---
|
||||
|
||||
### 4. ❌ FEHLENDE Block-ID-Referenzen
|
||||
|
||||
**Problem:** Referenzen auf nicht-existierende Block-IDs:
|
||||
- `action_heading` wird referenziert, existiert aber nicht (sollte `action_heading-1` oder `action_heading-2` sein)
|
||||
|
||||
---
|
||||
|
||||
### 5. ✅ Abstract Wrapper vorhanden
|
||||
|
||||
**Status:** Alle Sections haben einen `> [!abstract]` Wrapper. ✅
|
||||
|
||||
---
|
||||
|
||||
## Zusammenfassung
|
||||
|
||||
### Kritische Probleme:
|
||||
1. ❌ **Keine automatischen Forward-Edges** zwischen aufeinanderfolgenden Sections
|
||||
2. ❌ **Keine automatischen Backward-Edges** in Ziel-Sections
|
||||
3. ❌ **Viele falsche Edge-Types** die nicht dem graph_schema.md entsprechen
|
||||
4. ❌ **Referenzen auf nicht-existierende Block-IDs** (`action_heading`)
|
||||
|
||||
### Empfehlungen:
|
||||
1. Interview-Wizard sollte automatisch Forward-Edges zwischen Sections generieren
|
||||
2. Interview-Wizard sollte automatisch Backward-Edges in Ziel-Sections generieren
|
||||
3. Edge-Types sollten gegen graph_schema.md validiert werden
|
||||
4. Block-ID-Referenzen sollten validiert werden
|
||||
Reference in new issue
Block a user