commit 7cd818c652866fd1f9c835fc358cbe9cd1d2c145 Author: orfelorfel23 Date: Fri Aug 28 21:15:24 2026 +0200 Initial spec: Mind-o-Mat Entwurf v0.1 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..58af5b5 --- /dev/null +++ b/.gitignore @@ -0,0 +1,25 @@ +# Obsidian +.obsidian/workspace.json +.obsidian/plugins/ +.obsidian/themes/ +.obsidian/appearance.json +.obsidian/hotkeys.json + +# Node +node_modules/ +*.log +npm-debug.log* + +# OS +.DS_Store +Thumbs.db +desktop.ini + +# QMD / Modell-Cache (downloadd ca. 3 GB) +.qmd/ +*.qmd-cache +models/ + +# System / Cache +99 System/.cache/ +99 System/logs/ diff --git a/10 Wiki/SPEC.md b/10 Wiki/SPEC.md new file mode 100644 index 0000000..51bad55 --- /dev/null +++ b/10 Wiki/SPEC.md @@ -0,0 +1,103 @@ +# Mind-o-Mat — Spezifikation v0.1 (Entwurf) + +> Stand: 2026-08-28 — Brainstorming-Phase, vor Implementierung. +> Noch nicht freigegeben. Offene Stellen sind mit ⚠️ markiert. + +## 1. Zweck + +Lokales Second-Brain-System für einen Obsidian-kompatiblen Markdown-Vault. Es nimmt drei Dinge ab: + +- **Wissen wiederfinden**, auch wenn das exakte Wort nicht mehr einfällt (Bedeutungssuche). +- **Dem Wissen vertrauen können**, weil Widersprüche, Duplikate und veraltete Stände sichtbar markiert werden. +- **Überblick behalten** über ein wachsendes Wissensgebilde über eine Graph-Ansicht mit Clustern und Verbindungen. + +## 2. Fähigkeiten (was das System können muss) + +| # | Fähigkeit | Was es konkret tut | +|---|---|---| +| 1 | **Finden** | Hybridsuche aus Stichwort + Bedeutung. Tolerant gegen ungenaue Erinnerung. | +| 2 | **Lesen** | Gefundene Notiz direkt im Vault öffnen, ohne App-Wechsel. | +| 3 | **Sauber bleiben** | Automatische Markierung von Widersprüchen, Duplikaten und veralteten Ständen. | +| 4 | **Überblick** | Graph-Ansicht der Wissenslandschaft mit erkennbaren Clustern und Verbindungen. | + +## 3. Was es NICHT tut ⚠️ _offen_ + +Für den Entwurf gelten diese minimalen Annahmen — sag, wenn was davon anders sein soll: + +- Kein Cloud-Sync. Vault bleibt strikt lokal. +- Kein Mobile-Client, keine Web-Notizerfassung. Nur Desktop-Vault + lokale CLI. +- Keine externen KI-APIs auf Notizinhalte. Anonymität/Datenschutz. +- Kein automatisches Generieren von Notizen. Du schreibst selbst, das System organisiert. + +## 4. Architektur (5 Bausteine) + +| # | Baustein | Zweck | KI drin? | +|---|---|---|---| +| 1 | **Vault** | Markdown-Dateien als Single Source of Truth. | nein | +| 2 | **Indexer** | Deterministisch: `readdir` → Frontmatter parsen → Wikilinks extrahieren → `landkarte.json` + `index.md`. | nein | +| 3 | **QMD** (lokale Hybridsuche) | Stichwort + Bedeutung, lokal, kein externer Aufruf. ⚠️ _Realität noch zu verifizieren — als npm-Paket/CLI verfügbar?_ | nein (lokale Embeddings) | +| 4 | **Wiki** (Karpathy-Pattern) | Claude pflegt Markdown-Seiten nach festen Regeln aus `10 Wiki/_schema.md`. | ja (Claude) | +| 5 | **Webapp** | Liest `landkarte.json` + QMD-Such-API, rendert Graph-Ansicht. | nein | + +## 5. Datenstruktur + +``` +C:\GitHub\Mind-o-Mat\ +├── 00 Inbox\ # Eingangskorb, unsortiert +├── 01 Daily\ # Tagesnotizen (YYYY-MM-DD.md) +├── 10 Wiki\ # von Claude gepflegt +│ ├── SPEC.md # diese Datei +│ ├── _schema.md # Wiki-Regeln (TODO) +│ ├── index.md # Wiki-Inhaltsverzeichnis (TODO) +│ └── Seiten\ # Wiki-Themenseiten (TODO) +├── 20 Projekte\ # aktive Initiativen +├── 90 Templates\ # Notiz-Vorlagen +├── 99 System\ +│ ├── scripts\ +│ │ ├── indexer.mjs # deterministisch (TODO) +│ │ └── ingest.mjs # ruft Claude für Wiki-Pflege (TODO) +│ ├── landkarte.json # vom Indexer erzeugt (TODO) +│ ├── index.md # Katalog, von Claude zuerst gelesen (TODO) +│ └── logs\ # Ingest-Protokolle +├── CLAUDE.md # Brain-First-Regelwerk (Suchleiter) (TODO) +├── package.json +├── .gitignore +└── README.md +``` + +⚠️ _Cluster-Inhalte offen — wurden bewusst noch nicht festgelegt._ + +## 6. Schlüssel-Flows + +### Flow A: Note rein → Wissen drin +1. Notiz in `00 Inbox\` ablegen (manuell oder Drag&Drop aus Obsidian). +2. `npm run ingest` ruft Claude mit Schema + Notiz auf. +3. Claude öffnet betroffene Wiki-Seiten, prüft Widersprüche, aktualisiert. +4. `npm run index` schreibt `landkarte.json` und `index.md` neu. +5. Konflikte erscheinen in `10 Wiki/index.md` als markierte Boxen. + +### Flow B: Suche (Brain-First) +1. User fragt: „Was wusste ich nochmal über X?" +2. Claude in `CLAUDE.md` programmiert: erst `99 System/index.md`, dann `10 Wiki/index.md`, dann QMD-Suche, dann genau eine Datei öffnen. +3. Antwort kommt mit Quellen, max. ~3.000 Tokens Kontext. + +### Flow C: Überblick +1. `npm run dev` startet lokale Webapp. +2. Lädt `landkarte.json`, zeigt Cluster + Verbindungen. +3. Hover über Knoten → Vorschau, Klick → volle Notiz. + +## 7. Erfolgskriterium + +**Phase 3 fertig** = du öffnest die Webapp, der Graph zeigt deine Wissenslandschaft so, dass du auf einen Blick siehst, was du weißt und was fehlt. Ab diesem Moment arbeitest du drin statt dran. + +## 8. Noch zu klären (vor Schritt 4: Plan) + +1. ⚠️ **QMD-Realität** — ist `qmd` als npm-Paket/CLI verfügbar, oder muss eine eigene Mini-Suche her? +2. ⚠️ **Cluster-Themen** — welche realen Themenbereiche soll die initiale Struktur haben? +3. ⚠️ **Mockup-Stil der Webapp** — Globus / Klaster / Ebenen / etwas anderes? +4. ⚠️ **Folder-Sprache** — DE oder EN für Datei-/Template-Namen? +5. ⚠️ **Tagesnotizen-Format** — Obsidian-Standard-YAML-Frontmatter oder eigenes Schema? + +--- + +*Erstellt im Brainstorming-Loop (Plan-Modus, vor jeder Code-Zeile).* diff --git a/README.md b/README.md new file mode 100644 index 0000000..591bd49 --- /dev/null +++ b/README.md @@ -0,0 +1,20 @@ +# Mind-o-Mat + +Lokales Second-Brain-System für einen Obsidian-kompatiblen Markdown-Vault. + +> **Status:** Brainstorming-Phase. Spezifikation v0.1 in `10 Wiki/SPEC.md` ist Entwurf, nicht freigegeben. + +## Was es mal können soll + +- **Wissen wiederfinden** auch wenn das exakte Wort fehlt (Bedeutungssuche). +- **Konflikte automatisch markieren** zwischen Notizen, die sich widersprechen. +- **Graph-Ansicht** deines gesamten Vaults mit erkennbaren Themen-Clustern. + +## Aktueller Stand + +- `10 Wiki/SPEC.md` — Entwurf der Spezifikation mit allen 5 Architektur-Bausteinen. +- Alles weitere ist TODO und wird in Iterationen aufgebaut. + +## Mitmachen + +Im Moment ist das Repo vor allem ein Ort, um die Idee festzuhalten, bevor irgendwas implementiert wird. Siehe `10 Wiki/SPEC.md` für die offenen Fragen und den aktuellen Stand der Planung.