From d9dbbb8ebd49337a0540226dc3d8de116b8954ef Mon Sep 17 00:00:00 2001 From: Librarian Date: Mon, 6 Jul 2026 07:13:20 +0000 Subject: [PATCH] README: verstaendliche Funktionserklaerung (8 Schritte) --- README.md | 38 ++++++++++++++++++++++++++++++-------- 1 file changed, 30 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index cc4c0c7..cc1fddb 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,36 @@ Nebeltal, der Tourismusverband, alle Personen, Firmen und Termine sind erfunden. **➜ Live ausprobieren: https://brain-demo.friedemann-schuetz.de** (ohne Login — Fragen stellen, Notizen einwerfen, Governance-Entscheidungen treffen) +## Wie funktioniert das Ganze? (in einfachen Worten) + +Stell dir eine unermüdliche Bibliothekarin vor, die alles liest, was im Arbeitsalltag +anfällt — und daraus ein aufgeräumtes, belegtes Nachschlagewerk pflegt: + +1. **Etwas kommt rein.** Eine E-Mail, ein Meeting-Mitschnitt, eine Notiz, ein PDF. +2. **Der „Librarian" liest es** und entscheidet: Was davon ist wissenswert? Zu welcher + Person, Firma oder welchem Projekt gehört es? Gibt es dazu schon eine Datei, wird sie + **aktualisiert statt dupliziert**. +3. **Jede Aussage bekommt einen Beleg.** Quelle und wörtliches Zitat werden in der Datei + mitgespeichert („Provenance") — nichts steht hier ohne Herkunftsnachweis. +4. **Heikles wird angehalten.** Bewerbungen, Gehälter, Zugangsdaten schreibt das System + **nie** automatisch in den Speicher. Sie landen in einer Decision-Inbox, wo ein + Mensch entscheidet: freigeben (anonymisiert) oder verwerfen. +5. **Alles ist versioniert.** Nach jedem Lauf macht das System einen git-Commit — genau + die Historie, die du hier oben unter „Commits" durchblättern kannst. +6. **Nachts wird geprüft** („Dream"): Widersprechen sich zwei Dateien? Gibt es Duplikate + oder fehlende Verknüpfungen? Nur Funde mit wörtlichem Zitat als Beweis bleiben stehen — + der Rest wird verworfen. Menschen entscheiden, was übernommen wird. +7. **Fragen beantwortet das System nur mit Belegen** („Ask"): Ein Agent liest die + relevanten Dateien wirklich und zitiert sie. Was nicht im Speicher steht, wird ehrlich + als unbekannt benannt — keine Halluzinationen. +8. **Montags kommt ein Wochenbericht** („Digest"): was verarbeitet wurde, was sich + geändert hat, was auf Entscheidung wartet. + +Das Besondere: **keine Datenbank, keine Vektor-Magie** — nur Markdown-Dateien in einem +git-Repository. Alles bleibt ohne das System lesbar, durchsuchbar und mitnehmbar +(z. B. in Obsidian). Die gesamte Logik dahinter sind **25 n8n-Workflows** — visuell +inspizierbar, ohne eine Zeile eigenen Backend-Code. + ## Was du hier siehst - **Markdown + YAML-Frontmatter (OKF)**: jedes Konzept eine Datei, mit Typ, Trust-Level, @@ -18,12 +48,4 @@ Fragen stellen, Notizen einwerfen, Governance-Entscheidungen treffen) - Der Stand entspricht dem kuratierten Seed — die Live-Demo wird jede Nacht um 4:00 darauf zurückgesetzt und hierher gespiegelt -## Wie es entsteht - -Quellen (Mail, Meeting-Bot, Notiz, PDF) → **Librarian** (LLM-Pipeline in n8n) → -Konzepte mit Belegen → git-Commit. Sensibles (Bewerbungen, Gehälter, API-Keys) landet -NIE direkt im Vault, sondern in einer **Decision-Inbox** zur menschlichen Freigabe. -Nachts prüft ein **Dream-Workflow** den Bestand auf Widersprüche und Duplikate — -jedes Finding muss ein wörtliches Zitat als Beleg haben. - *Das produktive System läuft identisch — nur mit echten Daten und Zugängen.*