mindnet/docs/knowledge_design.md
Lars e672eade8b
Some checks failed
Deploy mindnet to llm-node / deploy (push) Failing after 2s
docs/knowledge_design.md aktualisiert
2025-09-09 12:22:26 +02:00

4.6 KiB
Raw Blame History

mindnet Knowledge Design

1. Gesamtziel, Anspruch & Nutzen

Ziel ist eine persönliche Wissensbasis, die langfristig tragfähig ist (eigene Gedanken, Erfahrungen, Pläne, Erlebnisse) und ist zugleich so strukturiert, dass Tools (Obsidian, Dataview, Parser, Vektorsuche/Qdrant, Agenten) es maschinenlesbar nutzen können.

Anspruch an die Struktur:

  • Stabil: robuste IDs, deterministische Dateinamen, konsistente Feldnamen
  • Atomar: ein Kerninhalt pro Datei (keine Sammelcontainer)
  • Erweiterbar: neue Typen (z. B. milestone, manifesto) jederzeit möglich
  • Portabel: reines Markdown + YAML → funktioniert in Obsidian, Git und Parsern
  • Vernetzbar: systematische Links/Backlinks erzeugen ein sinnvoll navigierbares Netz
  • Parser-freundlich: wiederkehrende Abschnittsüberschriften; Felder/Enums klar definiert

Späterer Nutzen / Einsatzzwecke:

  • Schnelles Wiederfinden: Dataview-Abfragen, Filter, Dashboards
  • LLM-gestütztes Arbeiten: Frage-Antwort mit Kontext-Zitaten aus den Chunks
  • Agenten: Vorschläge für neue Verbindungen/Strukturierung; Auflösen von „unresolved links“
  • Projektnavigation: Aufgabenbeziehungen, Abhängigkeiten (leichtes PM)
  • Lebenslaufende Struktur: persönliche Werte, Wendepunkte, Kinderentwicklung, Lernpfade
  • Automatisierung: Vektor-Index (Qdrant), Embeddings, LLM-Q&A, Agenten-Workflows
  • Langfristiges Gedächtnis: eigene Lebens-/Projektchronik reproduzierbar pflegen
  • Aufgaben-/Projektsteuerung: im selben System, vernetzt mit Kontextwissen

2. YAML-Frontmatter-Schema

Pflichtfelder: title, id, type, status, created, tags
Empfohlen: updated, area, project, priority, aliases (u. a.)

2.1 Feldübersicht

Feld Typ Bedeutung
title string Menschlich lesbarer Titel
id string (slug/identifier) Stabile ID; referenzierbar über Wikilinks
type enum Notiz-Typ (concept, thought, experience, task, project, journal, …)
status enum draft | active | done | archived
created date Erstellungsdatum (ISO)
updated date Letzte Änderung (ISO)
area string Themen-/Lebensbereich
project string Projekt-/Arbeitskontext
tags list Taxonomische Tags (präfixiert, s. Abschnitt 4)
aliases list Alternative IDs/Titel (Slug-Resolver)
lang string Sprache, optional
priority enum/int Priorität, optional
due, effort_min date/int Für Aufgaben/Projekte
people list Beteiligte Personen/IDs
depends_on list Abhängigkeiten auf andere IDs
source string Quelle (Artikel, Buch, Video, …)

2.2 Konventionen

  • id ist menschenlesbar (Slug), eindeutig im Vault; aliases dienen als Fallback für Resolver.
  • Datumsformat ISO YYYY-MM-DD.
  • Keine duplizierten Tags; Präfixe nutzen (area/…, type/…, topic/…).

2.3 Minimalbeispiel Frontmatter

title: "Gedanke: YAML-Standards"
id: thought-yaml-standards
type: thought
status: draft
created: 2025-09-02
updated: 2025-09-02
area: mindnet
project: project-mindnet
tags: [area/mindnet, type/thought, topic/yaml]
aliases: [yaml-gedanken]