2025-12-08 06:59:40 +01:00
# mindnet v2.2 — Programmplan
2025-12-09 17:11:03 +01:00
**Version:** 2.3.1 (Post-WP06 Decision Engine)
**Stand:** 2025-12-09
2025-12-08 06:59:40 +01:00
**Status:** Aktiv
2025-12-06 10:35:27 +01:00
2025-12-09 17:11:03 +01:00
---
- [mindnet v2.2 — Programmplan ](#mindnet-v22--programmplan )
- [1. Programmauftrag ](#1-programmauftrag )
- [2. Vision ](#2-vision )
- [3. Programmziele ](#3-programmziele )
- [3.1 Kurzfristig (Abgeschlossen / Laufend) ](#31-kurzfristig-abgeschlossen--laufend )
- [3.2 Mittelfristig (Nächste Schritte) ](#32-mittelfristig-nächste-schritte )
- [3.3 Langfristig ](#33-langfristig )
- [4. Architekturprinzipien ](#4-architekturprinzipien )
- [5. Programmstruktur (Phasenmodell) ](#5-programmstruktur-phasenmodell )
- [6. Workpackages – detaillierte Übersicht ](#6-workpackages--detaillierte-übersicht )
- [Legende Aufwand / Komplexität ](#legende-aufwand--komplexität )
- [WP-01 – Wissensdesign (abgeschlossen) ](#wp-01--wissensdesign-abgeschlossen )
- [WP-02 – Chunking \& Hash-Strategie (abgeschlossen) ](#wp-02--chunking--hash-strategie-abgeschlossen )
- [WP-03 – Import-Pipeline \& Edge-System v2 (abgeschlossen) ](#wp-03--import-pipeline--edge-system-v2-abgeschlossen )
- [WP-04a – Retriever \& Graph-Scoring (abgeschlossen) ](#wp-04a--retriever--graph-scoring-abgeschlossen )
- [WP-04b – Explanation Layer ("Why-Layer") (abgeschlossen) ](#wp-04b--explanation-layer-why-layer-abgeschlossen )
- [WP-04c – Feedback Logging \& Bewertungsdaten (abgeschlossen) ](#wp-04c--feedback-logging--bewertungsdaten-abgeschlossen )
- [WP-05 – Persönlichkeitsmodell \& RAG-Chat (abgeschlossen) ](#wp-05--persönlichkeitsmodell--rag-chat-abgeschlossen )
- [WP-05b – Advanced Chat (Optional) ](#wp-05b--advanced-chat-optional )
- [WP-06 – Decision Engine \& Hybrid Router (abgeschlossen) ](#wp-06--decision-engine--hybrid-router-abgeschlossen )
- [WP-07 – Interview-Assistent (geplant) ](#wp-07--interview-assistent-geplant )
- [WP-08 – Self-Tuning v1/v2 (geplant) ](#wp-08--self-tuning-v1v2-geplant )
- [WP-09 – Vault-Onboarding \& Migration (geplant) ](#wp-09--vault-onboarding--migration-geplant )
- [WP-10 – Chat-Interface \& Writeback (geplant) ](#wp-10--chat-interface--writeback-geplant )
- [WP-11 – Knowledge-Builder \& Vernetzungs-Assistent (geplant) ](#wp-11--knowledge-builder--vernetzungs-assistent-geplant )
- [WP-12 – Knowledge Rewriter (Soft Mode, geplant) ](#wp-12--knowledge-rewriter-soft-mode-geplant )
- [WP-13 – MCP-Integration \& Agenten-Layer (geplant) ](#wp-13--mcp-integration--agenten-layer-geplant )
- [WP-14 – Review / Refactoring / Dokumentation (geplant) ](#wp-14--review--refactoring--dokumentation-geplant )
- [7. Abhängigkeiten (vereinfacht, aktualisiert) ](#7-abhängigkeiten-vereinfacht-aktualisiert )
- [8. Laufzeit- \& Komplexitätsindikatoren (aktualisiert) ](#8-laufzeit---komplexitätsindikatoren-aktualisiert )
- [9. Programmfortschritt (Ampel, aktualisiert) ](#9-programmfortschritt-ampel-aktualisiert )
- [10. Governance \& Versionierung ](#10-governance--versionierung )
- [11. Executive Summary ](#11-executive-summary )
2025-12-06 10:35:27 +01:00
---
## 1. Programmauftrag
2025-12-08 06:59:40 +01:00
mindnet v2.2 entwickelt ein persönliches, wachsendes KI-Gedächtnis, das:
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
- Wissen, Erfahrungen, Werte und Entscheidungen speichert,
- diese Informationen semantisch verknüpft und rekonstruierbar macht,
- einen KI-Zwilling aufbaut, der ähnlich argumentiert, entscheidet und reflektiert wie du,
2025-12-06 10:35:27 +01:00
- über mehrere Kanäle gefüttert wird:
- Obsidian-Markdown (primäre Quelle),
2025-12-09 17:11:03 +01:00
- Chat-basierter Agent (Decision Engine & RAG-Chat aktiv),
2025-12-08 06:59:40 +01:00
- später: Interview-Assistent (strukturierte Dialogerfassung),
- automatisch neue Zusammenhänge erkennt und vernetzt (Edges, Typen, Hinweise),
2025-12-06 10:35:27 +01:00
- sich durch Rückmeldungen (Feedback) selbst verbessert (Self-Tuning).
2025-12-08 06:59:40 +01:00
Langfristig soll mindnet als **digitales Gegenüber** funktionieren, das:
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
- dich versteht,
- deine Denkweise reflektiert,
- deine Werte kennt und verwendet,
- Entscheidungen begründen kann („Warum?“),
- Erinnerungen einordnet,
2025-12-06 10:35:27 +01:00
- und für deine Nachkommen als dialogfähiger Gesprächspartner zur Verfügung steht.
mindnet ist **kein statisches Wissensarchiv** , sondern ein **lebendes, lernendes Gedächtnismodell** mit Fokus auf:
2025-12-08 06:59:40 +01:00
- persönliche Perspektive,
2025-12-08 16:14:52 +01:00
- erklärbare Begründungspfade (Why-Layer),
2025-12-08 06:59:40 +01:00
- kontinuierliche Erweiterbarkeit,
- robuste technische Basis (lokal, nachvollziehbar, versioniert).
2025-12-06 10:35:27 +01:00
---
## 2. Vision
2025-12-08 06:59:40 +01:00
> „Ein persönliches semantisches Gedächtnis, das mit mir wächst, meine Persönlichkeit spiegelt und mir als intelligenter, erklärbarer, lernender Begleiter dient.“
2025-12-06 10:35:27 +01:00
Kernprinzipien der Vision:
2025-12-08 06:59:40 +01:00
- **Erklärbarkeit:**
2025-12-08 16:14:52 +01:00
Jede Antwort muss über Edges, Scores, Werte-Bezüge und Herkunftsnotizen begründbar sein. Das System kann Entscheidungen auf zugrundeliegende `[DECISION]` -Notizen zurückführen.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
- **Wachstum:**
Das System arbeitet von Anfang an mit unvollständigen Daten, kann aber schrittweise dichter werden, ohne dass alte Notizen massenhaft manuell angepasst werden müssen.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
- **Flexibilität (Late Binding):**
2025-12-09 17:11:03 +01:00
Semantik wird überwiegend in Konfiguration (z. B. `types.yaml` , `prompts.yaml` , `decision_engine.yaml` , Policies) festgelegt. Die Persönlichkeit entsteht durch das Config-Design, nicht durch Hardcoding.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
- **Autonomie & Self-Healing:**
mindnet schlägt fehlende Typen, Relationen und Edges vor (z. B. aus Inline-Relationen, Edge-Defaults, Ähnlichkeitsbeziehungen) und baut damit einen „self-healing graph“ auf.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
- **Lernen & Self-Tuning:**
Feedback zu Antworten (gut/schlecht, relevant/nicht relevant) fließt in Score-Gewichte, Policies und ggf. Edge-Struktur ein.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
- **Persönlichkeit:**
2025-12-09 17:11:03 +01:00
Entscheidungen werden wert- und erfahrungsbasiert begründet; das System agiert als KI-Zwilling durch Nutzung lokaler LLMs (z.B. Phi-3/Mistral) und eines Intent-Routers.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
- **Incremental Growth:**
Das System muss mit wenigen, heterogenen Notizen starten und sich fortlaufend verdichten können – ohne Retro-Massenmigrationen im Vault.
2025-12-06 10:35:27 +01:00
---
## 3. Programmziele
2025-12-08 16:14:52 +01:00
### 3.1 Kurzfristig (Abgeschlossen / Laufend)
2025-12-06 10:35:27 +01:00
2025-12-08 16:14:52 +01:00
- Automatische Sammlung von Wissen aus Markdown-Vault.
2025-12-08 06:59:40 +01:00
- Aufbau eines stabilen Graph-Speichers in Qdrant (`*_notes`, `*_chunks` , `*_edges` ).
- Semantischer und graphbasierter Retriever (WP-04a abgeschlossen).
- **Erklärbarkeit:** Why-Layer liefert Begründungen zu Treffern (WP-04b abgeschlossen).
- **Feedback-Loop:** Systematisches Logging von Suche und Bewertung (WP-04c abgeschlossen).
2025-12-08 16:14:52 +01:00
- **RAG-Chat:** KI antwortet in natürlicher Sprache auf Basis von Wissen und Persönlichkeit (WP-05 abgeschlossen).
2025-12-09 17:11:03 +01:00
- **Decision Engine:** System erkennt Intent (Fakt vs. Entscheidung) und wägt Werte ab (WP-06 abgeschlossen).
- **Multi-Persona:** System wechselt den Tonfall (Empathisch vs. Analytisch) situativ (WP-06 abgeschlossen).
2025-12-08 16:14:52 +01:00
- Technische Basis: FastAPI, Qdrant, Ollama (Local LLM).
2025-12-06 10:35:27 +01:00
- Automatisierte Erkennung von Beziehungen:
2025-12-08 06:59:40 +01:00
- Wikilinks, Inline-Relationen, Callout-Edges, Typ-Defaults.
2025-12-06 10:35:27 +01:00
- „Mitwachsendes“ Schema ohne Obsidian-Umstrukturierungen:
- Neues Wissen kann sofort erfasst werden,
2025-12-08 06:59:40 +01:00
- bestehende Notizen bleiben gültig (Virtual Schema Layer).
2025-12-06 10:35:27 +01:00
2025-12-08 16:14:52 +01:00
### 3.2 Mittelfristig (Nächste Schritte)
2025-12-06 10:35:27 +01:00
2025-12-08 16:14:52 +01:00
- **Chat Interface (WP-10):** Ablösung der Terminal-Interaktion durch ein Web-Frontend (Streamlit/React) für bessere UX und einfacheres Feedback-Geben.
2025-12-08 06:59:40 +01:00
- Interview-Assistent erstellt neue Notes automatisch (strukturierte Dialoge → Markdown).
- mindnet erzeugt Vorschläge für neue Notes & Edges und bietet einen „Vernetzungs-Assistenten“ für manuell angelegte Notizen.
2025-12-08 16:14:52 +01:00
- Agenten können über MCP-Tools (`mindnet_query`, `mindnet_chat` ) auf mindnet zugreifen.
2025-12-06 10:35:27 +01:00
### 3.3 Langfristig
2025-12-08 06:59:40 +01:00
- KI-Zwilling, der deinen Stil, deine Werte und deine typische Denkweise repräsentiert.
- Weitgehend autonomes Self-Tuning der Wissensstruktur (auf Basis gespeicherter Feedback-Daten & Policies).
2025-12-06 10:35:27 +01:00
- Lebenslanges Gedächtnis, das
2025-12-08 06:59:40 +01:00
- konsistent bleibt,
- wächst,
- sich weiterentwickelt,
- und deine Geschichte für deine Nachkommen erzählbar und erlebbar macht.
2025-12-06 10:35:27 +01:00
---
## 4. Architekturprinzipien
2025-12-08 06:59:40 +01:00
Die folgenden Prinzipien steuern alle Workpackages und Entscheidungen:
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
1. **Late Binding (späte Semantik)**
2025-12-09 17:11:03 +01:00
- Struktur und Interpretation werden in Konfigurationen (z. B. `types.yaml` , `prompts.yaml` , `decision_engine.yaml` ) definiert, nicht direkt in den Vault-Dateien.
2025-12-08 16:14:52 +01:00
- Die "Persönlichkeit" des Chats ist ein Prompt-Template, kein Code.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
2. **Virtual Schema Layer**
2025-12-08 16:14:52 +01:00
- Typen, Regeln, Policies, Edge-Defaults werden im Schema-Layer beschrieben.
2025-12-06 10:35:27 +01:00
- Markdown-Dateien benötigen nur minimale, robuste Angaben (Titel, Typ, optionale Properties).
2025-12-08 06:59:40 +01:00
3. **Self-Healing Graph**
- Der Graph wird regelmäßig analysiert (Edges, Centrality, fehlende Links).
2025-12-08 16:14:52 +01:00
- Automatisierte Jobs ergänzen fehlende Kanten.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
4. **Deterministische IDs**
2025-12-08 16:14:52 +01:00
- Notes, Chunks und Edges erhalten stabile IDs (z. B. UUIDv5).
2025-12-08 06:59:40 +01:00
- Der Graph ist jederzeit wiederaufbaubar (Import-Pipeline idempotent).
2025-12-06 10:35:27 +01:00
2025-12-08 16:14:52 +01:00
5. **Full Explainability & Context Enrichment**
- Jeder Score, jede Beziehung muss nachvollziehbar sein.
- Dem LLM werden Metadaten (`[DECISION]`, `[PROJECT]` ) injiziert, um Halluzinationen zu vermeiden und logische Schlüsse zu ermöglichen.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
6. **Persistence First**
- Obsidian bleibt die primäre Quelle der Wahrheit.
2025-12-08 16:14:52 +01:00
- mindnet ergänzt, schlägt Änderungen vor, schreibt aber nur kontrolliert.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
7. **Minimalinvasives Schreiben**
- Automatische Veränderungen an Markdown-Dateien erfolgen ausschließlich nach expliziter Zustimmung.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
8. **Incremental Growth & Early Value**
2025-12-08 16:14:52 +01:00
- Das System muss bereits mit wenigen Notizen und einem kleinen Vault sinnvolle Antworten liefern.
- Feedback-Mechanismen werden früh eingeführt.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
9. **Observability & Testbarkeit**
2025-12-08 16:14:52 +01:00
- Jeder Importlauf, jede Retriever-Anfrage und jede Policy-Änderung soll prüfbar sein.
10. **Local First & Privacy**
- Nutzung lokaler LLMs (Ollama/Phi-3) für Inference. Keine Daten verlassen den Server.
2025-12-06 10:35:27 +01:00
---
## 5. Programmstruktur (Phasenmodell)
2025-12-08 16:14:52 +01:00
Phase A – Fundament & Import (Fertig)
Phase B – Semantik, Graph & Lernen (Fertig)
2025-12-09 17:11:03 +01:00
Phase C – Persönlichkeitsmodell & KI-Zwilling (Fertig)
2025-12-08 16:14:52 +01:00
Phase D – Agenten, MCP & Interaktion (Startend)
2025-12-08 06:59:40 +01:00
Phase E – Review, Refactoring, Dokumentation
2025-12-06 10:35:27 +01:00
2025-12-09 17:11:03 +01:00
Alle Workpackages sind einer Phase zugeordnet. WP-01 bis WP-06 sind bereits erfolgreich abgeschlossen.
2025-12-06 10:35:27 +01:00
---
## 6. Workpackages – detaillierte Übersicht
### Legende Aufwand / Komplexität
2025-12-08 06:59:40 +01:00
- Aufwand: Niedrig / Mittel / Hoch
- Komplexität: Niedrig / Mittel / Hoch
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
Die Status-Ampel zeigt den aktuellen Stand gemäß Programmfortschritt.
2025-12-06 10:35:27 +01:00
---
### WP-01 – Wissensdesign (abgeschlossen)
2025-12-08 06:59:40 +01:00
**Phase:** A
**Status:** 🟢 abgeschlossen
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
Grundlegendes Schema für mindnet festlegen (`knowledge_design.md`), inkl.:
- Note-Typen (z. B. `concept` , `experience` , `project` , `decision` , `value` ).
- Standard-Properties und Grundstruktur von Edges.
- Abbildung zentraler Lebens-Bereiche.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Erreichte Ergebnisse:**
- `knowledge_design.md` und `types.yaml` definieren die Zielarchitektur.
2025-12-06 10:35:27 +01:00
---
### WP-02 – Chunking & Hash-Strategie (abgeschlossen)
2025-12-08 06:59:40 +01:00
**Phase:** A
**Status:** 🟢 abgeschlossen
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
Festlegen und implementieren einer robusten Chunking-Strategie und einer Hash-Logik zur Änderungserkennung.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Erreichte Ergebnisse:**
- Implementierte Chunker-Logik mit Overlap.
- Stabile Hash-Strategie zur sicheren Änderungserkennung.
2025-12-06 10:35:27 +01:00
---
### WP-03 – Import-Pipeline & Edge-System v2 (abgeschlossen)
2025-12-08 06:59:40 +01:00
**Phase:** A/B
**Status:** 🟢 abgeschlossen
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
Durchgängige Import-Pipeline von Markdown → Notes/Chunks/Edges in Qdrant mit deterministischen IDs.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Erreichte Ergebnisse:**
- Vollständige E2E-Import-Pipeline.
- Vollständiges Edge-Modell (Strukturkanten, Wikilinks, Inline-Relationen).
2025-12-06 10:35:27 +01:00
---
### WP-04a – Retriever & Graph-Scoring (abgeschlossen)
2025-12-08 06:59:40 +01:00
**Phase:** B
**Status:** 🟢 abgeschlossen
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
Aufbau eines hybriden Retrievers, der Semantik, Typwissen und Graph-Informationen kombiniert.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Erreichte Ergebnisse:**
- Hybrides Scoring-Modell (Semantic + Edge + Centrality).
- Konfiguration über `retriever.yaml` .
- `/query` Endpoint aktiv.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
---
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
### WP-04b – Explanation Layer ("Why-Layer") (abgeschlossen)
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Phase:** B
2025-12-08 16:14:52 +01:00
**Status:** 🟢 abgeschlossen
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
Treffererklärungen liefern, die verständlich machen, warum ein Ergebnis gewählt wurde.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Erreichte Ergebnisse:**
- **DTO-Erweiterung:** `QueryHit` enthält `explanation` , `breakdown` und `reason` .
- **Logic:** Graph-Adapter unterstützt `incoming_edges` (Reverse Lookup) für Authority-Erklärungen.
- **Output:** `/query` Endpoint liefert auf Wunsch (`explain: true`) menschenlesbare Begründungen ("Verweist auf...").
2025-12-06 10:35:27 +01:00
---
2025-12-08 06:59:40 +01:00
### WP-04c – Feedback Logging & Bewertungsdaten (abgeschlossen)
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Phase:** B
2025-12-08 16:14:52 +01:00
**Status:** 🟢 abgeschlossen
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
Grundlage für Self-Tuning schaffen durch systematisches Logging.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Erreichte Ergebnisse:**
- **Data Flywheel:** Logging von Queries und User-Feedback in lokalen JSONL-Dateien.
- **Search Log:** Speichert Query + Score-Snapshot in `data/logs/search_history.jsonl` .
- **Feedback Log:** Speichert User-Ratings in `data/logs/feedback.jsonl` .
- **Traceability:** Durchgängige `query_id` von Request bis Feedback.
2025-12-06 10:35:27 +01:00
---
2025-12-08 16:14:52 +01:00
### WP-05 – Persönlichkeitsmodell & RAG-Chat (abgeschlossen)
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Phase:** C
2025-12-08 16:14:52 +01:00
**Status:** 🟢 abgeschlossen
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
2025-12-08 16:14:52 +01:00
Aufbau eines RAG-Systems, das in natürlicher Sprache antwortet und Kontext versteht.
2025-12-06 10:35:27 +01:00
2025-12-08 16:14:52 +01:00
**Erreichte Ergebnisse:**
- **Infrastruktur:** Integration von Ollama (Phi-3 Mini) in den Service-Layer.
- **Router:** `/chat` Endpoint mit "Hybrid Retrieval Enforcement".
- **Context Enrichment:** Injection von Metadaten (`[TYPE]`, `[SCORE]` ) in den Prompt, damit kleine Modelle (SLMs) komplexe Zusammenhänge ("Warum?") verstehen.
- **Config:** `prompts.yaml` steuert System-Prompt und RAG-Template.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Aufwand / Komplexität:**
- Aufwand: Mittel
- Komplexität: Mittel
2025-12-06 10:35:27 +01:00
---
2025-12-08 16:14:52 +01:00
### WP-05b – Advanced Chat (Optional)
**Phase:** C
**Status:** ⚪ optional
**Ziel:**
Erweiterung des Chats um Gedächtnis (History) und einfache Tools.
**Umfang:**
- Implementierung von `ChatHistory` (vergangene Nachrichten in den Kontext).
- Einfache Tool-Nutzung (z.B. "Suche in Web").
---
2025-12-09 17:11:03 +01:00
### WP-06 – Decision Engine & Hybrid Router (abgeschlossen)
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Phase:** C
2025-12-09 17:11:03 +01:00
**Status:** 🟢 abgeschlossen
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
2025-12-09 17:11:03 +01:00
Transformation vom reinen Wissens-Abrufer zum strategischen Entscheidungspartner durch Intent-Erkennung.
2025-12-06 10:35:27 +01:00
2025-12-09 17:11:03 +01:00
**Erreichte Ergebnisse:**
- **Hybrid Intent Router:** Kombination aus schnellem Keyword-Matching und intelligentem LLM-Fallback zur Erkennung der Absicht (`DECISION`, `EMPATHY` , `FACT` , `CODING` ).
- **Strategic Retrieval:** Gezieltes Nachladen von Werten (`value`), Zielen (`goal`) oder Erfahrungen (`experience`) basierend auf dem Intent.
- **Multi-Persona:** Dynamische Anpassung des Tonfalls (Berater vs. Spiegel vs. Techniker) durch `prompts.yaml` .
- **Late Binding:** Vollständige Konfiguration via `decision_engine.yaml` .
- **Robustheit:** Konfigurierbare Timeouts für CPU-Inference.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Aufwand / Komplexität:**
- Aufwand: Mittel
- Komplexität: Hoch
2025-12-06 10:35:27 +01:00
---
### WP-07 – Interview-Assistent (geplant)
2025-12-08 06:59:40 +01:00
**Phase:** C
**Status:** 🟡 geplant
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
Dialogbasierter Erfassungs-Assistent, der strukturierte Interviews führt und daraus konsistente Markdown-Notizen generiert.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Umfang:**
- Design von Interview-Flows.
- Konvertierung von Dialogtranskripten in typisierte Notes.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Aufwand / Komplexität:**
- Aufwand: Niedrig/Mittel
- Komplexität: Mittel
2025-12-06 10:35:27 +01:00
---
### WP-08 – Self-Tuning v1/v2 (geplant)
2025-12-08 06:59:40 +01:00
**Phase:** B/C
**Status:** 🟡 geplant
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
Aufbau eines Self-Tuning-Mechanismus, der auf Basis von Feedback-Daten (WP-04c) Vorschläge für Retriever- und Policy-Anpassungen macht.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Umfang:**
- Auswertung der JSONL-Feedback-Daten.
- Regel-basierte Anpassungs-Vorschläge für `retriever.yaml` und Typ-Prioritäten.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Aufwand / Komplexität:**
- Aufwand: Hoch
- Komplexität: Hoch
2025-12-06 10:35:27 +01:00
---
### WP-09 – Vault-Onboarding & Migration (geplant)
2025-12-08 06:59:40 +01:00
**Phase:** B
**Status:** 🟡 geplant
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
Sicherstellen, dass bestehende und neue Obsidian-Vaults schrittweise in mindnet integriert werden können – ohne Massenumbau.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Umfang:**
- Tools zur Analyse des Vault-Status.
- Empfehlungen für minimale Anpassungen.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Aufwand / Komplexität:**
- Aufwand: Mittel
- Komplexität: Niedrig/Mittel
2025-12-06 10:35:27 +01:00
---
### WP-10 – Chat-Interface & Writeback (geplant)
2025-12-08 06:59:40 +01:00
**Phase:** D
2025-12-08 16:14:52 +01:00
**Status:** 🟡 geplant (Priorität B - "Quick Win")
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
2025-12-08 16:14:52 +01:00
Ablösung der Terminal-Interaktion durch ein grafisches Interface.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Umfang:**
2025-12-08 16:14:52 +01:00
- Technologie: Streamlit oder einfaches HTML/JS Frontend.
- Funktionen: Chat-Verlauf, Anzeige der Quellen (mit Scores), Daumen-hoch/runter für WP-04c Feedback.
2025-12-08 06:59:40 +01:00
- Funktionen für Q& A sowie Vorschlag neuer Notes/Edges.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Aufwand / Komplexität:**
2025-12-08 16:14:52 +01:00
- Aufwand: Hoch (durch Writeback) / Mittel (für reines Frontend)
2025-12-08 06:59:40 +01:00
- Komplexität: Hoch
2025-12-06 10:35:27 +01:00
---
### WP-11 – Knowledge-Builder & Vernetzungs-Assistent (geplant)
2025-12-08 06:59:40 +01:00
**Phase:** D
**Status:** 🟡 geplant
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
Assistent, der manuell erstellte oder importierte Notizen analysiert und Vorschläge für Typen, Edges und Einordnung macht.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Aufwand / Komplexität:**
- Aufwand: Hoch
- Komplexität: Hoch
2025-12-06 10:35:27 +01:00
---
### WP-12 – Knowledge Rewriter (Soft Mode, geplant)
2025-12-08 06:59:40 +01:00
**Phase:** C/D
**Status:** 🟡 geplant
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
Optionaler Assistent, der vorhandene Notes „aufräumt“, zusammenfasst oder reorganisiert – ausschließlich mit expliziter Freigabe.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Aufwand / Komplexität:**
- Aufwand: Niedrig/Mittel
- Komplexität: Mittel
2025-12-06 10:35:27 +01:00
---
### WP-13 – MCP-Integration & Agenten-Layer (geplant)
2025-12-08 06:59:40 +01:00
**Phase:** D
**Status:** 🟡 geplant
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
mindnet als MCP-Server bereitstellen, damit Agenten/LLMs standardisierte Tools nutzen können.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Umfang:**
- MCP-Server mit Tools (`mindnet_query`, `mindnet_explain` , etc.).
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Aufwand / Komplexität:**
- Aufwand: Mittel
- Komplexität: Mittel
2025-12-06 10:35:27 +01:00
---
### WP-14 – Review / Refactoring / Dokumentation (geplant)
2025-12-08 06:59:40 +01:00
**Phase:** E
**Status:** 🟡 geplant
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Ziel:**
Aufräumen, dokumentieren, stabilisieren – insbesondere für Onboarding Dritter und Langfrist-Betrieb.
2025-12-06 10:35:27 +01:00
2025-12-08 06:59:40 +01:00
**Aufwand / Komplexität:**
- Aufwand: Mittel
- Komplexität: Niedrig/Mittel
2025-12-06 10:35:27 +01:00
---
## 7. Abhängigkeiten (vereinfacht, aktualisiert)
WP01 → WP02 → WP03 → WP04a
WP04a → WP04b → WP04c → WP08
WP03 → WP05 → WP06 → WP07
WP03 → WP09
WP01/WP03 → WP10 → WP11 → WP12
WP03/WP04 → WP13
2025-12-08 06:59:40 +01:00
Alles → WP14
2025-12-06 10:35:27 +01:00
---
2025-12-08 06:59:40 +01:00
## 8. Laufzeit- & Komplexitätsindikatoren (aktualisiert)
2025-12-06 10:35:27 +01:00
| WP | Aufwand | Komplexität |
|-------|----------------|------------------|
| WP04b | Mittel | Hoch |
| WP04c | Mittel | Mittel/Hoch |
| WP05 | Mittel | Mittel |
| WP06 | Mittel | Hoch |
| WP07 | Niedrig/Mittel | Mittel |
| WP08 | Hoch | Hoch |
| WP09 | Mittel | Niedrig/Mittel |
| WP10 | Hoch | Hoch |
| WP11 | Hoch | Hoch |
| WP12 | Niedrig/Mittel | Mittel |
| WP13 | Mittel | Mittel |
2025-12-08 06:59:40 +01:00
| WP14 | Mittel | Niedrig/Mittel |
2025-12-06 10:35:27 +01:00
---
## 9. Programmfortschritt (Ampel, aktualisiert)
| WP | Status |
|-------|--------|
| WP01 | 🟢 |
| WP02 | 🟢 |
| WP03 | 🟢 |
| WP04a | 🟢 |
2025-12-08 06:59:40 +01:00
| WP04b | 🟢 |
| WP04c | 🟢 |
2025-12-08 16:14:52 +01:00
| WP05 | 🟢 |
| WP05b | ⚪ |
2025-12-09 17:11:03 +01:00
| WP06 | 🟢 |
2025-12-06 10:35:27 +01:00
| WP07 | 🟡 |
| WP08 | 🟡 |
| WP09 | 🟡 |
| WP10 | 🟡 |
| WP11 | 🟡 |
| WP12 | 🟡 |
| WP13 | 🟡 |
2025-12-08 06:59:40 +01:00
| WP14 | 🟡 |
2025-12-06 10:35:27 +01:00
---
## 10. Governance & Versionierung
2025-12-08 06:59:40 +01:00
- Versionierung über Gitea (Branches, Tags, Releases).
- Feature-Branch Workflow mit "Sync First" Strategie.
- Jede wesentliche Änderung an Architektur/Schema erhält einen eigenen Commit.
- Jedes Workpackage erhält ein eigenes Chat-Fenster mit dediziertem Prompt (WP-Hand-Over).
- Programmleitung verantwortet Konsistenz und Priorisierung.
2025-12-08 16:14:52 +01:00
- **Modell-Governance:** Das verwendete LLM (z.B. `phi3:mini` ) wird in der `.env` und `config.py` festgeschrieben. Updates erfordern Tests gegen die "Why-Layer" Referenzfragen.
2025-12-06 10:35:27 +01:00
---
2025-12-08 06:59:40 +01:00
## 11. Executive Summary
2025-12-06 10:35:27 +01:00
mindnet v2.2 ist so aufgesetzt, dass:
2025-12-08 06:59:40 +01:00
- du **schrittweise** Wissen erfassen kannst (Obsidian + Chat + später Interview-Assistent),
- die Struktur **mitwächst** , ohne Retro-Massenarbeit im Vault,
- ein **hybrider Retriever** qualitativ hochwertige, erklärbare Antworten liefert,
- ein **Self-Healing- und Self-Tuning-Mechanismus** vorbereitet ist (durch WP-04c Feedback-Daten),
2025-12-09 17:11:03 +01:00
- ein **Persönlichkeitsmodell** (Decision Engine, Empathie) existiert und den Tonfall situativ anpasst,
2025-12-08 06:59:40 +01:00
- langfristig ein **KI-Zwilling** aufgebaut wird, der deine Werte, Erfahrungen und Denkweise spiegelt,
- die technische Architektur (FastAPI, Qdrant, YAML-Policies, MCP-Integration) lokal, nachvollziehbar und erweiterbar bleibt.
2025-12-06 10:35:27 +01:00
2025-12-09 17:11:03 +01:00
Dieser Programmplan bildet die konsolidierte Grundlage (v2.3.1) für alle weiteren Arbeiten.