Knowledge Ingest

Knowledge Ingest

Ordne eine Note systematisch in das bestehende Wissensnetz ein. Bei PDFs und Dokumenten: Erstelle eine vollstaendige Markdown-Repraesentation als Quellen-Note. Befolge diese Schritte IN DER REIHENFOLGE. Ueberspringe keine Schritte.

Step 0: QUELLE ODER NOTE? (Weiche stellen)

Bestimme was du vor dir hast:

• PDF/Office-Dokument (im Chat als Attachment, oder als Datei im Vault) → Gehe zu Pfad A: Quellen-Ingest
• Bestehende Markdown-Note → Gehe zu Pfad B: Note einordnen

---

Pfad A: Quellen-Ingest (PDF/Dokument → Markdown-Note)

Das Ziel: Eine vollstaendige Markdown-Repraesentation der Quelle im Vault. Die PDF selbst wird NICHT im Vault gespeichert -- die Markdown-Note IST die Vault-Repraesentation.

A1: LESEN UND VERSTEHEN

Lies das Dokument:

• Vault-Datei: read_document
• Chat-Attachment: Der Inhalt ist bereits im Kontext (als ``)

Pruefe die Attribute des `` Tags:

• vault_path → Datei liegt im Vault. Diesen Pfad als Quelle im Frontmatter verwenden.
• source_path → Datei liegt ausserhalb des Vaults (z.B. OneDrive, Downloads). Diesen Pfad als Quelle im Frontmatter verwenden.
• Keines von beiden → User nach dem Speicherort fragen

Extrahiere:

• Metadaten: Autor(en), Jahr, Titel, URL/DOI/ISBN (aus Inhalt, Kopfzeile, oder User-Angabe)
• Struktur: Kapitel, Abschnitte, Ueberschriften
• Kernaussagen: Was sind die 3-5 wichtigsten Punkte?
• Entitaeten: Themen, Konzepte, Personen (wie bei Note-Ingest)

A2: BESTEHENDE ENTITAETEN SUCHEN

Fuer JEDE erkannte Entitaet: semantic_search im Vault.

KRITISCH: Bevorzuge IMMER bestehende Notes. Suche gruendlich bevor du neue Entitaeten vorschlaegst. Wenige starke Hub-Themen sind besser als viele schwache.

A3: VORSCHLAG PRAESENTIEREN (und STOP)

Zeige dem User:

Quellen-Note fuer "[Titel]":

**Dateiname:** Autor-Jahr_Titel.md
**Ordner:** [Quellen-Ordner im Vault, falls erkennbar]

**Frontmatter:**
- Autor: [Name(n)]
- Jahr: [YYYY]
- Titel: [Vollstaendiger Titel]
- Quelle: [Pfad oder URL zur Original-Datei]
- Zusammenfassung: "[1 Satz, max 25 Woerter]"
- Kategorie: Quelle
- Themen: ["[[Thema A]]", "[[Thema B]]"]
- Konzepte: ["[[Konzept X]]"]
- tags: [keyword-1, keyword-2, ...]

**Neue Entitaeten** (noch keine Note im Vault):
- Konzept "Z" -- Stub-Note erstellen? [JA/NEIN]
- Person "W" -- Stub-Note erstellen? [JA/NEIN]

Soll ich die Note so erstellen?

STOP. Warte auf Antwort des Users.

A4: NOTE ERSTELLEN (nach Bestaetigung)

PFLICHT: Nutze ingest_document -- NICHT write_file. Nur ingest_document kann den vollstaendigen Originaltext anhaengen.

Du schreibst NUR den header_content (Frontmatter + Ueberblick + Kernaussagen). Das Tool haengt den vollstaendigen Originaltext AUTOMATISCH an -- du musst ihn NICHT selbst ausgeben.

Parameter:

• output_path: IMMER in Inbox/ schreiben (z.B. "Inbox/Webb-2026_Convergence-Outlook.md")
• header_content: Dein Frontmatter + Ueberblick (siehe unten)
• source_path: Wenn die PDF im Vault liegt (z.B. "Attachements/report.pdf")
• attachment_index: Wenn die PDF als Chat-Attachment hinzugefuegt wurde (0 fuer das erste Attachment)

Der header_content hat diese Struktur:

---
Zusammenfassung: "[1 Satz]"
Autor: [Name(n)]
Jahr: [YYYY]
Titel: [Vollstaendiger Titel]
Quelle: "[Pfad oder URL]"
Kategorie:
  - Quelle
Themen: ["[[Thema A]]", "[[Thema B]]"]
Konzepte: ["[[Konzept X]]"]
tags: [keyword-1, keyword-2, keyword-3]
---

## Ueberblick

[3-5 Absaetze: Zentrale These, wichtigste Erkenntnisse, Argumentation, Relevanz.
 Ermoeglicht schnellen Einstieg ohne den gesamten Text zu lesen.]

## Kernaussagen

- [Kernaussage 1]: [Kurze Erlaeuterung]
- [Kernaussage 2]: [Kurze Erlaeuterung]
- [Kernaussage 3]: [Kurze Erlaeuterung]

WICHTIG: Schreibe KEINEN ## Originaltext Abschnitt. Das ingest_document Tool fuegt den vollstaendigen Originaltext automatisch an. Du musst ihn NICHT ausgeben -- das spart Tokens und umgeht Output-Limits.

STRIKTE REGELN fuer Wikilinks im Body

1. KEIN Wikilink ohne existierende Note oder Stub-Note. Wenn du [[Konzept X]] im Text schreibst, MUSS entweder eine bestehende Note existieren ODER du erstellst eine Stub-Note dafuer in Step A5.
2. Wikilinks NUR fuer Entitaeten (Themen, Konzepte, Personen, Organisationen, Projekte). NICHT fuer generische Begriffe.
3. Bestehende Notes verwenden: Wenn semantic_search eine passende Note findet, verwende deren exakten Dateinamen als Wikilink.

A5: VERNETZUNG UND STUB-NOTES (PFLICHT)

Dieser Schritt ist NICHT optional. Fuer JEDE Entitaet die im Frontmatter oder Body als Wikilink referenziert wird:

1. Existiert bereits? → Nichts zu tun
2. Existiert nicht? → Stub-Note erstellen (siehe Pfad B, Step 4b)

Das bedeutet: Wenn du 10 Konzepte im Frontmatter listest und 5 davon nicht als Notes existieren, erstellst du 5 Stub-Notes. KEINE dangling Wikilinks hinterlassen.

Abschliessend:

• Frage: "Soll ich die PDF-Datei umbenennen? Vorschlag: Autor-Jahr_Titel.pdf"

(User muss das extern machen wenn die PDF nicht im Vault liegt)

---

Pfad B: Note einordnen (bestehende Markdown-Note)

B1: ANALYSE (lies und verstehe)

Lies die Note mit read_file.

Erkenne im Text:

• Themen: Uebergeordnete Wissensgebiete (z.B. Philosophie, KI, Projektmanagement)
• Konzepte: Spezifische Ideen oder Theorien (z.B. Kategorischer Imperativ, Prompt Injection)
• Personen: Erwaehnte oder referenzierte Personen
• Projekte: Referenzierte Projekte oder Initiativen
• Organisationen: Firmen, Institutionen, Teams

Pruefe das bestehende Frontmatter: Welche Properties sind schon gesetzt? Welche fehlen oder sind leer?

B2: BESTEHENDE ENTITAETEN SUCHEN (immer zuerst!)

Fuer jede erkannte Entitaet: semantic_search im Vault.

KRITISCH: Bevorzuge IMMER bestehende Notes. Suche gruendlich bevor du neue Entitaeten vorschlaegst.

• Gibt es schon eine Note zu dieser Person/Thema/Konzept? → Verwende den exakten Dateinamen als [[Wikilink]]
• Gibt es aehnliche Themen die zusammengehoeren? → Nutze das bestehende Thema statt ein neues zu erstellen
• Die semantic_search zeigt auch "Related concepts (via ontology)" -- nutze diese fuer transitive Entdeckungen

Themen-Disziplin: Wenige starke Hub-Themen sind besser als viele schwache. Erstelle KEIN neues Thema wenn ein bestehendes passt.

B3: VORSCHLAEGE PRAESENTIEREN (und STOP)

Zeige dem User alle Vorschlaege gesammelt. Warte auf Bestaetigung.

Vorschlaege fuer "[Note-Titel]":

**Properties:**
- Themen: ["[[Thema A]]", "[[Thema B]]"]  (alle mit Kategorie: Thema)
- Konzepte: ["[[Konzept X]]"]              (alle mit Kategorie: Konzept)
- Personen: ["[[Person Y]]"]
- Zusammenfassung: "Ein Satz mit max 25 Woertern."
- tags: [keyword-1, keyword-2, keyword-3, ...]

**Neue Entitaeten** (noch keine Note im Vault):
- Konzept "Z" -- Stub-Note erstellen? [JA/NEIN]
- Person "W" -- Stub-Note erstellen? [JA/NEIN]

Moechtest du die Vorschlaege uebernehmen? (Einzelne koennen geaendert oder entfernt werden.)

STOP. Warte auf Antwort des Users.

B4: AUSFUEHRUNG (nach Bestaetigung)

4a: Properties setzen

Nutze update_frontmatter fuer die Note:

• Setze nur Properties die der User bestaetigt hat
• NIEMALS bestehende Werte ueberschreiben -- nur leere Properties befuellen
• Wikilinks in Properties als Array: ["[[Thema A]]", "[[Thema B]]"]

4b: Stub-Notes erstellen (PFLICHT fuer jede bestaetigte neue Entitaet)

Fuer jede neue Entitaet: write_file mit passendem Inhalt.

Stub-Note Struktur:

---
Zusammenfassung: "[1 Satz Erklaerung]"
[Kategorie-spezifische Properties aus dem Vault-Schema]
Kategorie:
  - [Thema/Konzept/Person/Projekt]
tags: [relevante-keywords]
Permanent: false
---

[2-3 Absaetze: Was ist das? Warum ist es relevant?]

## Aspekte und Teilbereiche

- [Aspekt 1]: [Kurze Erklaerung]
- [Aspekt 2]: [Kurze Erklaerung]
- [Aspekt 3]: [Kurze Erklaerung]

## Verbindungen

- Verlinkt von: [[Ausloesende Note]]
- Verwandte Konzepte: [[...]]

Die Stub-Note soll inhaltlich nuetzlich sein (Agent-Wissen + Vault-Kontext), nicht leer.

4c: Vertiefen oder spaeter?

Frage fuer jede neue Stub-Note:

• Jetzt vertiefen? → Agent hilft beim Ausarbeiten
• Spaeter? → Task anlegen (wenn TaskNotes-Plugin installiert)

---

Regeln (IMMER einhalten)

KRITISCHE REGELN (Verstoss = fehlerhafter Ingest)

1. Quellen-Ingest MUSS ingest_document nutzen -- NIEMALS write_file fuer Pfad A. Nur ingest_document haengt den Originaltext an.
2. Neue Notes IMMER nach Inbox/ -- NICHT nach Notes/. Der User sortiert Notes selbst von Inbox nach Notes.
3. KEINE bestehenden Notes verschieben -- NIEMALS move_file waehrend eines Ingest. Notes dort lassen wo sie sind.
4. KEINE bestehenden Notes inhaltlich aendern -- Nur Backlinks/Callouts zu neuen Quellen-Notes ergaenzen (via edit_file), niemals den Kern-Inhalt veraendern.
5. KEINE dangling Wikilinks -- Jeder [[Wikilink]] im Body oder Frontmatter MUSS auf eine existierende Note zeigen. Wenn die Note nicht existiert, Stub-Note erstellen oder den Wikilink weglassen.
6. KEIN PDF-Embed als Ersatz -- NIEMALS ![[datei.pdf]] statt Originaltext verwenden.
7. Themen und Konzepte sind disjunkte Property-Slots:

• Themen: enthaelt ausschliesslich Wikilinks auf Notes mit Kategorie: Thema (breit/generisch, Hub-Note, z.B. [[Agentic AI]]).
• Konzepte: enthaelt ausschliesslich Wikilinks auf Notes mit Kategorie: Konzept (spezifisch/abgegrenzt, z.B. [[AI Agents]]).
• Niemals einen Themen-Hub unter Konzepte listen, niemals ein Konzept unter Themen. Im Zweifel read_file auf die Ziel-Note und ihr Kategorie:-Feld pruefen.

1. Properties mit Wikilink-Werten IMMER als YAML-Liste schreiben, niemals als String:

• Richtig (Block-Form):

```yaml Themen:

• "[[Agentic AI]]"
• "[[Wissensmanagement]]"

Konzepte:

• "[[AI Agents]]"

```

• Auch richtig (Flow-Form): Themen: ["[[Agentic AI]]", "[[Wissensmanagement]]"]
• Falsch: Themen: [[Agentic AI]], [[Wissensmanagement]] (komma-getrennter String -- Obsidian parsed das nicht als Liste).
• Falsch: Themen: "[[Agentic AI]]" (Einzelwert als String -- spaetere Ergaenzungen muessten den Type wechseln).
• Auch bei genau einem Wert bleibt es eine Liste mit einem Element.

ALLGEMEINE REGELN

1. NIEMALS Properties ueberschreiben die bereits einen Wert haben
2. IMMER bestehende Entitaeten bevorzugen (Vault durchsuchen bevor neue erstellt werden)
3. Zusammenfassung: Genau 1 Satz, max 25 Woerter, in der Sprache der Note
4. Keywords/Tags: 5-10 Stueck, deutsch + englisch, Bindestrich-Schreibweise (max 2 Woerter verbunden)
5. Themen: Restriktiv -- wenige starke Hub-Themen, nicht fuer jede Nuance ein neues Thema
6. Stub-Notes: Inhaltlich angereichert mit Erklaerung und Aspekten, NICHT leer. Auch Stub-Notes nach Inbox/.
7. Thema vs. Konzept: Wenn du eine neue Entitaet erstellen musst, unterscheide:

• Thema = Wissensgebiet, Fachbereich. Man kann darin navigieren und entdecken. Beispiele: Philosophie, Agentic AI, Organisationsentwicklung
• Konzept = Idee, Prinzip, Modell. Man kann es in 2-3 Saetzen erklaeren. Beispiele: Kategorischer Imperativ, MCP Protocol, Zettelkasten-Methode
• Im Zweifel: Frage den User ob Thema oder Konzept

1. Sprache: Properties und Inhalte in der Sprache des bestehenden Vault
2. Bestaetigung: Alle Aenderungen MUESSEN vom User bestaetigt werden bevor sie geschrieben werden
3. Kategorie-Property: Den im Vault verwendeten Property-Namen nutzen (z.B. "Kategorie", "Category", "Type"). Beim Quellen-Ingest immer den Wert "Quelle" (bzw. "Source" in englischen Vaults) setzen
4. Frontmatter sauber halten: Genau ein --- am Anfang, genau ein --- am Ende. KEIN doppelter Separator. Keine leeren Properties ohne Wert (lieber weglassen als ISBN: ohne Wert).

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: pssah4
• Source: pssah4/vault-operator
• License: Apache-2.0
• Homepage: https://pssah4.github.io/vault-operator/

Install and usage instructions live in the source repository linked above.