Enhance interview configuration and documentation for WP-26 integration
Node.js build / build (20.x) (push) Waiting to run
Node.js build / build (22.x) (push) Waiting to run

- 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:
Lars committed 2026-01-30 12:37:06 +01:00
1 parent b99416b67d
commit 8186ca5ce0
13 files changed
+2805 -282

No files matched your search

+8 -6
View File
@@ -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)
+70 -81
View File
@@ -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.
---
+857
View File
@@ -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**
+146
View File
@@ -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