Initial spec: Mind-o-Mat Entwurf v0.1

.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/

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).*

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.