mindnet_obsidian/docs/13_Erfassung_Causal_Ketten.md

# Handbuch: Erfassung & Causal-Ketten in Obsidian

> **Zielgruppe:** Du beim täglichen Erfassen (auch unterwegs)  
> **Plugin:** Mindnet Causal Assistant  
> **Stand:** August 2026  
> **Zweck:** Elemente so anlegen und vernetzen, dass kausale Ketten erkennbar, prüfbar und schließbar sind.

---

## 1. Was du erzeugst

Mindnet speichert Wissen als **Markdown im Vault**. Das Plugin hilft, daraus einen **kausalen Graphen** zu machen.

| Baustein | Bedeutung | Beispiel |
|----------|-----------|----------|
| **Note** | Eine Entität (Datei) mit Typ und `id` | Experience „Geburt der Kinder“ |
| **Section** | Abschnitt unter einer Überschrift; optional mit Typ | `## Learning ^learning` + `[!section] insight` |
| **Block-ID** | Anker hinter der Überschrift (`^…`) | `^learning`, `^next` |
| **Edge** | Gerichtete Beziehung mit Typ | `caused_by`, `guides`, `resulted_in` |
| **Kette** | Mehrere Notes/Sections + Edges in einem Muster | Experience → Insight → Decision |

**Merksatz:** Text allein reicht nicht. Ketten entstehen, wenn du **Rollen** (Typen) und **Kanten** (Edges) setzt.

### Urlaub / Weiterarbeit ohne Massen-Relink

Neue Notes so anlegen, dass sie später **nicht** umgeschrieben werden müssen. Alte Notes nicht anfassen, nur neue sauber schreiben.

| Immer so | Nie so (später teuer) |
|----------|------------------------|
| Überschrift mit Block-ID: `## Learning ^learning` | Überschrift ohne `^…` |
| Section-Typ: `> [!section] insight` | Nur Fließtext ohne Typ |
| Intra-Note: `[[#^learning]]` | `[[#Learning]]` ohne `^` |
| Cross-Note: `[[Note#Überschrift ^block]]` | `[[Note#Überschrift]]` ohne Block-ID |
| Kanten als `[!edge]` mit kanonischem Typ (`guides`, `caused_by`, `derived_from`) | Nur lose Wikilinks oder Alias-Typen wie `derives` |

**Create note from profile** und **Chain Workbench** schreiben diese Form jetzt selbst. Manuelle Obsidian-UI-Links (`[[Note#Überschrift Block]]` ohne `^`) vermeiden.

```mermaid
flowchart LR
  E[Experience / Situation] -->|causal / influences| I[Insight / Learning]
  I -->|guides / foundation_for| D[Decision / nächster Schritt]
  D -->|causal| E2[neue Experience / Feedback]
```

---

## 2. Die wichtigsten Commands

Command Palette: `Ctrl+P` (macOS: `Cmd+P`).

| Wann | Command |
|------|---------|
| Neu anfangen | **Mindnet: Create note from profile** |
| Links zu Edges machen | **Mindnet: Build semantic mapping blocks (by section)** |
| Edge-Typ wählen/ändern | **Mindnet: Edge-Type ändern** |
| Note prüfen | **Mindnet: Validate current note** |
| Ketten verstehen | **Mindnet: Inspect Chains (Current Section)** |
| Lücken schließen | **Mindnet: Chain Workbench (Current Section)** |
| Vault-weit Lücken finden | **Mindnet: Scan Vault for Chain Gaps** |
| Findings beheben | **Mindnet: Fix Findings (Current Section)** |

Einstellungen: **Mindnet: Einstellungen öffnen** (oder Plugin-Name in der linken Settings-Leiste).

---

## 3. Alltags-Workflow: von der Idee zur Kette

### Schritt A — Element anlegen

1. **Mindnet: Create note from profile**
2. Profil wählen, z. B.:
   - **Experience – Basis** → Erlebnis / Situation
   - **Insight – Basis** → Erkenntnis / Learning
   - weitere Profile je nach Vault-Config
3. Titel und Ordner setzen → Note öffnet sich
4. Interview-Wizard ausfüllen → **Review → Apply & Finish**

Ergebnis typischerweise:

- Frontmatter mit `id`, `title`, `type`, …
- Sections mit Überschriften
- oft schon `[!section] …` und `^block-id` (WP-26)

> **Tipp:** **Mindnet: Create note from profile** startet den Wizard immer. Für eine schon offene Note: **Mindnet: Interview für aktuelle Note starten**.

### Schritt B — Verbindungen setzen (während oder nach dem Schreiben)

**Variante 1 – im Text verlinken, dann mappen**

1. Im Fließtext oder am Section-Ende Wikilinks setzen, z. B. `[[Meine Einsicht]]`
2. Cursor in die Section
3. **Mindnet: Edge-Type ändern** → passenden Typ wählen  
   oder zuerst Links setzen und danach **Build semantic mapping blocks**
4. Mapping-Block prüfen:

```markdown
> [!abstract] 🕸️ Semantic Mapping
>
> > [!edge] caused_by
> > [[Früheres Erlebnis]]
>
> > [!edge] guides
> > [[Nächster Schritt ^next]]
```

**Variante 2 – fehlende Note aus einem Link erzeugen**

1. `[[Noch nicht existierende Note]]` schreiben
2. Link anklicken (Reading View: Klick; Editor oft `Ctrl`+Klick)
3. Profil wählen → Note (+ optional Wizard)

**Variante 3 – Intra-Note (innerhalb einer Datei)**

Sections derselben Note verbinden, bevorzugt mit Block-ID:

```markdown
## Situation ^sit
> [!section] experience

…

## Learning ^learning
> [!section] insight

> [!edge] derived_from
> [[#^sit]]

## Nächster Schritt ^next
> [!section] decision

> [!edge] guides
> [[#^learning]]
```

**Link-Empfehlung für zuverlässiges Matching:**

| Form | Nutzen |
|------|--------|
| `[[Note#Überschrift ^block]]` oder `[[#^block]]` | zuverlässig für Chain Inspector / Workbench |
| `[[Note#Überschrift]]` | oft vom Interview erzeugt; springt in Obsidian nicht immer zur Überschrift |
| Obsidian-UI ohne `^` (`…#Überschrift Block`) | gut zum Navigieren, Matching kann schwächer sein |

### Schritt C — Kette prüfen

1. Cursor in die relevante Section stellen
2. **Mindnet: Chain Workbench (Current Section)** öffnen
3. Matches und Status lesen (siehe Abschnitt 5)
4. Todos abarbeiten: fehlende Edges, fehlende Notes, falsche Typen
5. Optional: **Inspect Chains** für den textuellen Report (Console / Report)

### Schritt D — Qualität sichern

1. **Validate current note** → keine Errors
2. Bei Bedarf **Fix Findings**
3. Speichern — Obsidian Sync übernimmt den Vault

---

## 4. Welche Kette willst du erzählen?

Das Plugin matcht gegen **Chain Templates** (Datei `chain_templates.yaml`). Du musst sie nicht auswendig kennen — aber die Kernmuster helfen beim Erfassen:

### 4.1 Trigger → Transformation → Outcome

**Frage:** Was hat mich verändert, und was folgte daraus?

| Slot | Typische Typen | Deine Rolle beim Erfassen |
|------|----------------|---------------------------|
| trigger | experience, event, obstacle, risk, state | Auslöser / Situation |
| transformation | insight, belief, value, principle, … | innere Veränderung |
| outcome | decision, project, habit, goal | Folge / Handlung |

Edges zwischen den Slots: eher **causal**, **influences**, **provenance** (`foundation_for` u. ä.).

### 4.2 Learning Loop

**Frage:** Erlebnis → Lernen → Verhalten → neues Erlebnis?

| Slot | Typische Typen |
|------|----------------|
| experience | experience, event, situation |
| learning | insight, principle, value, … |
| behavior | habit, decision, task |
| feedback | experience, journal, event, state |

Viele Experience-Interviews legen genau diese Abschnitte nahe (Situation → Learning → Nächster Schritt).

### 4.3 Decision Logic

**Frage:** Was treibt die Entscheidung, was begrenzt sie, was entsteht?

driver + constraint → decision → outcome

### 4.4 Weitere Muster (kurz)

- **constraint_to_adaptation** — Problem → Anpassung → Stabilisierung  
- **person_influence** — Person → inneres Modell → Entscheidung/Outcome  
- **state_trigger_response** — Zustand → Auslöser → Reaktion → neuer Zustand  

**Praxisregel:** Beim Schreiben eine dieser Geschichten im Kopf behalten und die fehlenden Glieder als Notes/Sections + Edges nachziehen — nicht „irgendwelche Links“.

---

## 5. Workbench lesen: Status & Todos

| Status | Bedeutung | Typische Aktion |
|--------|-----------|-----------------|
| **complete** | Slots und geforderte Links passen | fertig / nur noch Feinschliff |
| **near_complete** | fast vollständig | 1–2 Todos (Edge oder Slot) |
| **partial** | mehrere Lücken | gezielt fehlende Glieder anlegen |
| **weak** | schwache/unsichere Zuordnung | Typen und Edges prüfen, Template evtl. falsch |

Häufige Todos:

- **missing_slot** — fehlendes Glied der Kette (Note oder Section anlegen)
- **missing_link** — Verbindung zwischen vorhandenen Gliedern fehlt → Edge einfügen
- **dangling_target** — Link zeigt ins Leere → Note/Heading erzeugen oder Link retargeten

**Arbeitsweise:** Immer zuerst **near_complete** schließen — dort ist der Erkenntnisgewinn pro Klick am höchsten. Vault-weit: **Scan Vault for Chain Gaps**.

---

## 6. Section Types & Effective Type

Innerhalb einer Note können Abschnitte **eigene Typen** haben:

```markdown
---
type: experience
---

## Learning ^learning
> [!section] insight

Was ich daraus lerne …
```

- Ohne `[!section]` gilt der **Note-Type** (`experience`).
- Mit `[!section] insight` zählt die Section als **insight** fürs Template-Matching (**effective type**).
- So kann eine Experience-Note intern schon die Learning-Loop abbilden, ohne sofort drei Dateien anzulegen.

**Wann eigene Datei, wann Section?**

| Situation | Empfehlung |
|-----------|------------|
| Ein Erlebnis mit Situation / Reaktion / Learning / nächstem Schritt | eine Note, Sections + Intra-Note-Edges |
| Learning soll später vielen Experiences gehören | eigene Insight-Note + Cross-Note-Edge |
| Entscheidung betrifft mehrere Projekte | eigene Decision-Note |

---

## 7. Mini-Checkliste pro Erfassungs-Session

Vor dem Schließen der Note:

- [ ] Frontmatter hat `id` und sinnvollen `type`
- [ ] Wichtige Abschnitte haben Überschrift (+ idealerweise `^block-id`)
- [ ] Wo nötig: `[!section] …` gesetzt
- [ ] Beziehungen liegen als `[!edge]` (Mapping-Block) vor — nicht nur lose Wikilinks
- [ ] Mindestens eine erkennbare Ketten-Idee (z. B. Learning Loop oder Trigger→Outcome)
- [ ] **Validate** ohne Errors
- [ ] Bei Ambition: Workbench zeigt **near_complete** oder **complete** für das Haupt-Template

---

## 8. Typischer Tagesablauf (Urlaub / unterwegs)

1. **Erfassen** — 1–3 Experiences oder Insights über Profile + Interview  
2. **Verknüpfen** — Edges zu bestehenden Notes/Sections (Mapping / Edge-Type)  
3. **Ketten schließen** — Workbench auf der wichtigsten Section, 5–15 Minuten Todos  
4. **Optional Scan** — einmal am Tag/Woche Vault Gap Scan, nahe Lücken priorisieren  

Obsidian Sync speichert den Vault zentral. Plugin-Updates (`main.js`) synct nur, wenn Community-Plugins in Sync aktiviert sind — sonst nach Build manuell in `.obsidian/plugins/mindnet-causal-assistant/` legen.

---

## 9. Häufige Stolpersteine

| Problem | Was tun |
|---------|---------|
| Keine Profile beim Create | Config-Pfad `_system/dictionary/interview_config.yaml` / Sync prüfen |
| Workbench „Chain Roles/Templates nicht geladen“ | Pfade in Plugin-Settings prüfen |
| Kette wird nicht erkannt | Edge-Typ zu generisch/falsch; Section-Type fehlt; Link ohne treffendes Heading/`^block` |
| Link springt nicht zur Section | Form mit Block-ID nutzen (`[[#^id]]` oder Heading+`^block`) |
| Mapping an falscher Stelle | Cursor in die richtige Section; Mapping erneut bauen |

---

## 10. Kurz-Rezept: „Ich will eine Learning-Loop sauber machen“

1. Experience-Note aus Profil **Experience – Basis**  
2. Interview: Situation, Reaktion, Learning, Nächster Schritt ausfüllen  
3. Prüfen: Sections haben Block-IDs; Learning = `[!section] insight` (falls vorgesehen)  
4. Edges setzen, z. B. Learning ← Situation, Nächster Schritt ← Learning (`guides` / passende Rolle)  
5. Cursor auf Learning-Section → **Chain Workbench** → Template `loop_learning` / verwandte Matches  
6. Todos bis **near_complete** oder **complete**  
7. Validate → speichern  

---

## Siehe auch

- [01_Benutzerhandbuch](01_Benutzerhandbuch.md) — Commands & Settings im Detail  
- [07_Event_Handler_Commands](07_Event_Handler_Commands.md) — vollständige Command-Referenz  
- [12_Heading_Block_Link_Recommendation](12_Heading_Block_Link_Recommendation.md) — Link-Formen & Matching  
- [Interview_Config_Guide](Interview_Config_Guide.md) — Profile anpassen (Admin)  
- [02_concepts/03_chain_identification_and_matching](02_concepts/03_chain_identification_and_matching.md) — Matching-Technik  

**Tipp:** Diese Datei nach `_system/docs/` (oder ähnlich) im Vault kopieren, dann liegt sie über Obsidian Sync auf allen Geräten.