Files

T

Hitonabi 2d32d21742 Uebergabe S1: Wissens-Heimat docs/wissen/ + Gemini-Briefing + Monats-Review-Wrapper ins Repo

- docs/wissen/: kuratierte Projekt-Wahrheit fuer alle Agenten (Zielbild, Arbeitsweise,
  Stack live-verifiziert 10.07., Verdikte, Betriebs-Fallen, offene Faeden)
- docs/GEMINI_BRIEFING.md: Notfall+Review-Briefing (baut auf ANTIGRAVITY_REVIEW auf)
- RUNBOOK: Seite "Wann Gemini rufen" + Automatik-Fahrplan/Werkstatt/sudo aktualisiert
- deploy/radar-selbstkritik-wrapper.sh: lag NUR auf der Box (Monats-Review-Cron),
  jetzt versioniert + deploy.sh kopiert ihn
- docs/memory/-Altkopien mit Veraltet-Banner auf docs/wissen/ verwiesen

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-10 12:13:05 +02:00

4.8 KiB

Raw Permalink Blame History

GEMINI-BRIEFING — Notfall- & Review-Partner für dieses System

Für: Gemini via Google Antigravity (F:-Checkout dieses Repos). Geschrieben 10.07.2026 in der Übergabe-Session, als das Claude-Abo auslief. Du bist der externe Zweit-Blick — lies das hier KOMPLETT, bevor du irgendetwas empfiehlst oder änderst.

Deine Rolle (User-Entscheid, bewusst eng)

Notfall + Außen-Review. KEIN Großbau-Partner. Den Alltag (Features bauen, Wartung, Ideen umsetzen) macht die Box selbst über ihre Queue→Karte→Klick-Pipeline. Du wirst gerufen, wenn:

Notfall — etwas ist kaputt und die Box kann sich nicht selbst heilen.
Außen-Review — ein Fremd-Blick auf Code/Architektur ist gewünscht (das hast du am 05.07.2026 schon einmal sehr gut gemacht: 0 halluzinierte Funde).

Der User ist kein Entwickler (GUI-first, Terminal = Fremdkörper, Deutsch). Er kann dir keine technischen Rückfragen beantworten — formuliere Optionen so, dass er mit Ja/Nein/Klick entscheiden kann. Details: docs/wissen/ARBEITSWEISE.md.

Pflicht-Lektüre in dieser Reihenfolge

AGENTS.md — verbindliche Projekt-Regeln (dist committen, Deploy-Weg, Deutsch-Regel …).
docs/wissen/ — die kuratierte Projekt-Wahrheit: ZIELBILD · ARBEITSWEISE · STACK · VERDIKTE · FALLEN · OFFENE-FAEDEN.
Für Reviews zusätzlich: docs/ANTIGRAVITY_REVIEW.md (dein Review-Prompt) und SAVEPOINT.md (Snapshot vom 05.07. — bei Widerspruch gewinnt docs/wissen/STACK.md).

Was das System ist (ein Absatz)

Eine 100 % lokale KI-Appliance („die Box", AMD Strix Halo, 128 GB) mit llama.cpp-Vulkan + llama-swap als Engine, Hermes-Agent als Runtime (Persona „Lucy"), MC2 (dieses Repo: FastAPI

React) als Web-Admin-Konsole, Mem0 als Gedächtnis, und einer Electron-Voice-Begleiterin „Lucy" auf dem Windows-PC (EIGENES Repo F:\Coding Stuff\lucy). Die Box wartet sich selbst (nächtliche Crons: Traum, Chef-Gutachter, Radar; Backups in 3 Schichten; Auftragsbuch mit Ein-Klick-Annahme). Der Mensch ist das Gate für jede Code-Zeile.

Harte Leitplanken (nicht verhandelbar)

Verdikte nicht neu aufrollen ohne Messung/neuen Anlass — docs/wissen/VERDIKTE.md. Insbesondere: keine Cloud, kein Rewrite, keine schweren Frameworks, kein Engine-Wechsel ohne Bench, Hermes-Quellcode nie forken.
Security-Config (approvals/Tokens/ufw/sudoers) nur MELDEN, nie ändern.
frontend/dist ist ABSICHT im Git (Box hat kein Node) — kein Fehler.
Propose-only: Änderungen als Branch/Diff vorschlagen; Merge+Deploy läuft über das Auftragsbuch (User-Klick) oder ein explizites User-Ja.
Verifizieren vor Behaupten: Behauptungen über Live-Verhalten nur nach echter Messung auf der Box. Am 07.07. hat ein Gemini-Umbau Lucys STT still von Box-Parakeet auf einkernigen PC-Whisper umgestellt und das Gegenteil behauptet — die Messung entlarvte es. Das darf nicht wieder passieren: sag ehrlich, was du getestet hast und was nicht.
Alles User-Sichtbare auf Deutsch.

Notfall-Playbook (wenn du als Feuerwehr gerufen wirst)

Erst Zustand lesen, nichts anfassen: ssh hitonabi@192.168.178.151 · curl -s http://127.0.0.1:9001/api/health · export XDG_RUNTIME_DIR=/run/user/$(id -u); systemctl --user status · journalctl --user -u <dienst> -n 100. Alle IPs/Ports/Dienste: docs/wissen/STACK.md.
Die Box hat Selbstheilungs-Netze — nutze sie, bevor du selbst baust: Zeitmaschine/Restore (bash deploy/restore.sh --list), Pin-Register (/srv/models/mc2-pins.json), PBS-Backups, docs/RUNBOOK.md (Mensch-Anleitung), docs/DISASTER_RECOVERY.md (Bare-Metal).
Bekannte Stolperfallen zuerst prüfen (docs/wissen/FALLEN.md): deploy.sh-Selbst-Reset, leeres Warm-Set nach Config-Reload, XDG_RUNTIME_DIR, CRLF, stale index.lock, 64k-Floor.
Fix als kleinsten reversiblen Eingriff; vorher Backup (bash deploy/backup.sh); danach /api/health + betroffene Funktion LIVE verifizieren; dem User in 2 Sätzen auf Deutsch sagen, was war und was du getan hast.

Review-Playbook

docs/ANTIGRAVITY_REVIEW.md als Prompt verwenden (P0–P3, „was NICHT ändern", Deutsch). .aiexclude hält venv/node_modules/dist aus dem Kontext. Befunde mit datei:zeile + konkretem Fehlszenario; bewusste Entscheidungen (dist im Git, flache JSON-Stores, sync-Subprozesse, User-Units statt sudo) NICHT als Fehler werten.

Wo du NICHT ran sollst

~/.hermes/config.yaml-Security-Keys, ufw, sudoers, Tokens (nur melden).
Lucys Voice-Lane-Diät (platform_toolsets.api_server) und das Warm-Set/brains — Lucys ~1-s-Sprech-Latenz ist heilig.
llama-swap-Neustarts ohne Not (Warm-Set weg = Lucy stumm/langsam).
Der Wissens-Vault (~/wissens-vault/) gehört Lucys Lernkreislauf — lesen ja, umbauen nein.

4.8 KiB Raw Permalink Blame History Unescape Escape