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.

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:

> [!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:

## 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:

---
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 — Commands & Settings im Detail
• 07_Event_Handler_Commands — vollständige Command-Referenz
• 12_Heading_Block_Link_Recommendation — Link-Formen & Matching
• Interview_Config_Guide — Profile anpassen (Admin)
• 02_concepts/03_chain_identification_and_matching — Matching-Technik

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