Files
mission-control-v2/docs/GEMINI_BRIEFING.md
T
HitonabiandClaude Fable 5.1 479fecd2c6
Ampel / ampel (push) Failing after 24s
Auftragsbuch ausgebaut: Karten-Annahme, Bagatell-Annahme, Lucy-Annahme raus — Gate ist Ampel + User-Merge
Die Vorschlags-Inbox (routers/services auftragsbuch, AuftragsbuchView, /auftraege, Cockpit-
Kachel + Handlungsbedarf-Eintrag, deploy/auftrag-annehmen.sh, lucy-annahme.sh, bagatell-
annahme.sh, docs/AUFTRAGSBUCH.md) war seit 02.08.2026 ungenutzt: Kanban-Tools seit 21.08. aus,
v3-Umbau lief ueber Branch -> Ampel -> Merge -> deploy.sh, PC-Executor-IP in Box und Config
veraltet. Doku behauptete den Karten-Weg trotzdem als Standard.

Jetzt:
- Cockpit: Kachel "Ideen" (offen/haengend) statt "Auftragsbuch"; Handlungsbedarf zeigt haengende
  Ideen und springt in die Ideen-Ansicht.
- Guide/Schaubild: Kreislauf Idee -> Ideen-Queue -> IDE am PC -> Ampel -> DEIN Merge -> Live.
- events.py: kein Auftragsbuch-Fingerprint mehr; config.py: PC_EXECUTOR_URL-Default auf .22.
- Skills/Skripte: selbst-inventur ohne Karten-Abschnitt, morning-report nennt offene Branches,
  konzept-fliessband verweist auf die Ideen-Ansicht.
- Doku: STACK "Deploy & Pipeline" = Branch -> Ampel -> User-Merge -> deploy.sh (einziger Weg),
  GRENZEN/ARBEITSWEISE/FALLEN/README/BEDIENUNG/RUNBOOK/GEMINI_BRIEFING/gitea-workflow angepasst,
  ZIELBILD Punkt 9, OFFENE-FAEDEN + RAPHAEL.md: erledigt.
- Bewusst geblieben: werkstatt-SOUL/projektstart-SOUL (Werkstatt-Persona, eigener Faden),
  Chronik-Kategorie "auftragsbuch" fuer historische Eintraege.
Auf der Box bereits erledigt (Hand): mc2-bagatell.timer deaktiviert + Units archiviert,
PC-Executor-URL in ~/.hermes/config.yaml auf .22.

Baut auf wartung/lucy-stimme-proxy-raphael auf (Proxy /api/lucy/stimme/*).
Gates: eslint 0 Fehler, vitest 59/59, tsc + vite build gruen, frontend/dist committet,
py_compile gruen.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-04 16:25:05 +02:00

4.8 KiB
Raw 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 Ideen-Queue und Branch→Ampel→Merge-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 · ARBEITSWEISE · STACK · VERDIKTE · FALLEN · OFFENE-FAEDEN.
  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). 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 macht nur der User (Ampel grün, dann deploy.sh).
  • 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 (P0P3, „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.