Hitonabi
2d32d21742
- 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>
85 lines
4.8 KiB
Markdown
85 lines
4.8 KiB
Markdown
# 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:
|
||
|
||
1. **Notfall** — etwas ist kaputt und die Box kann sich nicht selbst heilen.
|
||
2. **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
|
||
|
||
1. `AGENTS.md` — verbindliche Projekt-Regeln (dist committen, Deploy-Weg, Deutsch-Regel …).
|
||
2. `docs/wissen/` — die kuratierte Projekt-Wahrheit:
|
||
[ZIELBILD](wissen/ZIELBILD.md) · [ARBEITSWEISE](wissen/ARBEITSWEISE.md) ·
|
||
[STACK](wissen/STACK.md) · [VERDIKTE](wissen/VERDIKTE.md) ·
|
||
[FALLEN](wissen/FALLEN.md) · [OFFENE-FAEDEN](wissen/OFFENE-FAEDEN.md).
|
||
3. 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)
|
||
|
||
1. **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`.
|
||
2. **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).
|
||
3. **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.
|
||
4. 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.
|