mindnet/docs/knowledge_design.md

# 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<string>                  | Taxonomische Tags (präfixiert, s. Abschnitt 4)                            |
| `aliases`          | list<string>                  | 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<string>                  | Beteiligte Personen/IDs                                                   |
| `depends_on`       | list<string>                  | 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
```yaml
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]