Files
Hitonabi e7f143823e Faden 6: Grenzen-Landkarte (was gehoert wohin) + Worker-Hinweis
Verhindert das "Chat-in-MC2"-Muster und Ebenen-Verwechslungen: neue
docs/wissen/GRENZEN.md mappt die fuenf Flaechen (MC2=Steuerpult,
Lucy=Chat/Stimme, Hermes=Fundament/Quelle-tabu, Telegram, Hermes-Desktop)
mit "gehoert hin / gehoert NICHT hin", den Code-Ebenen-Grenzen und einer
"ich will X bauen - wohin?"-Entscheidungshilfe + roten Linien.

Eingewoben: README-Lesereihenfolge, ARBEITSWEISE (Rollen-Abgrenzung zeigt
auf GRENZEN + "MC2 = Steuerpult, kein Chat"), und der pre_llm_call-Worker-
Hook (box-steckbrief-inject.sh) gibt jedem Worker die Kurz-Grenzen inline
(MC2=Steuerpult/kein Chat-UI, Lucy=Chat, Hermes-Quelle tabu) + Zeiger auf
GRENZEN.md. Verifiziert: Hook injiziert 1236 Z inkl. Grenzen, Lucy-UUID No-op.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-13 21:29:33 +02:00

4.2 KiB

Arbeitsweise — wer der User ist und wie hier gearbeitet wird

Kuratiert 10.07.2026. Gilt für JEDEN Agenten, der an diesem System arbeitet (Box-Hermes, Hermes Desktop, Gemini/Antigravity, künftige).

Der User (Hitonabi / „Commander")

  • Kein Software-Entwickler. Selbstbild: „ich mache keine Updates". Er fasst keine Konsole an und drückt keine Update-Knöpfe — alles muss ohne ihn funktionieren oder per Knopf/Lucy/Telegram bedienbar sein.
  • GUI-first / „klicki bunti": visuelle, klickbare Oberflächen sind sein Geschmack; Terminal-Lösungen sind Fremdkörper. Sein Referenz-Erlebnis ist der Antigravity-Agent-Manager-Stil: Aufträge verteilen, Agenten zuschauen, Diffs abnicken.
  • Produkt-Instinkt ernst nehmen: seine „naiven" Fragen treffen oft den Kern (Marketing-Filter → Fan-out-Kritiker; „alles autonom" → Appliance-Prinzip; „Update verpassen?" → Radar). Vorschläge ernsthaft prüfen, nie abtun.
  • Sprache: Deutsch, locker, direkt. Lucy nennt ihn „Commander".
  • Nordstern (wörtlich): „Das komplette System muss AUTONOM funktionieren — in 6 Monaten ohne Claude darf nichts brachliegen." Robustheit/Autonomie schlägt Features.

Die nicht verhandelbaren Regeln

  1. Verifizieren vor Behaupten. Vor jeder Aussage/Änderung auf der Box messen (SSH, Logs, curl, bench) statt aus Doku/Memory/Web zu schließen. Der Agenten-Erzählung (auch der eigenen) nie glauben — Transcripts, worker.log, git-Status sind Beweise. Mehrere erste Befunde kippten erst bei sauberer Gegenprobe.
  2. Scope challengen. Ein Tool-/Technik-Vorschlag (auch vom User) ist kein Umsetzungsbefehl: erst Use-Case klären, bei erkennbarer Fehlannahme kurz stoppen und warnen. Lehrbuch-Best-Practice ≠ unser Use-Case (Beispiele: LobeChat, Tool Search).
  3. Propose-only + Mensch-Gate. Jede Code-Zeile ist Klick-pflichtig (Auftragsbuch-Karte). Merge/Deploy NIE ohne grünes Gate. Bagatell-Klassen ohne Klick sind ausschließlich: Doku/Wiki/Vault/Chronik/tote Dateien — nichts mit Code-Logik, immer Morgenlage-Bericht.
  4. Security-Config NIE ohne explizites User-Ja (approvals, Tokens, ufw, sudoers, command_allowlist). Direkt-Push auf main braucht ebenfalls ein explizites Ja.
  5. Fremd-Modell-Kritiker als Korrektiv. Wer baut, benotet nicht selbst. Zwei-Kritiker-Gate (Coder-Next + GLM), Urteil nach der Regel REPRODUZIERT-ODER-ABGELEHNT — Freispruch nur mit belegtem Vorher/Nachher.
  6. Hermes-first vor Eigenbau. Vor jedem Neubau prüfen, ob Hermes es nativ kann (Eigenbau-Landkarte im Vault → hermes --help); Befund in den Vorschlag schreiben. Hermes-Quellcode wird NIE gepatcht/geforkt.
  7. Alles reversibel: Branch + Backup + Zeitmaschine + Pin-Register. Nichts bauen, was Lucys ~1-s-Sprech-Latenz oder das Warm-Set gefährdet.
  8. Deutsch für alles User-Sichtbare (Meldungen, Skills, Summaries, Karten). Erste Zeile von Meldungen idealerweise: „Musst du etwas tun? NEIN/JA: …"

Rollen-Abgrenzung der Türen

  • Lucy (Electron-App) = Zuruf, Voice, Begleitung — schlanke api_server-Lane, nicht mästen.
  • Hermes Desktop = Arbeit: Projekte, Coding, Review, lange Threads (cli-Lane). Faustregel: „Repo oder >2 Minuten → Desktop".
  • Telegram = mobil + Melde-/Freigabe-Kanal (Alarmkette, Cron-Delivery).
  • MC2-Web-UI = Verwaltung, Auftragsbuch (Karten-Klicks), Chronik/Zeitmaschine, Wissen. Steuerpult, kein Chat — Gesprächs-/Voice-Funktionen gehören zu Lucy/Telegram, nicht in MC2.
  • Gemini/Antigravity = Notfall + Außen-Review, siehe GEMINI_BRIEFING.

Bevor du ein Feature baust: GRENZEN.md — die volle „was gehört wohin"-Landkarte inkl. Code-Ebenen (MC2 vs. Lucy vs. Hermes-Config/Skill/Hook, Quelle tabu) und der roten Linien.

Wissens-Orte

  • docs/wissen/ (dieses Verzeichnis) = kuratierte Projekt-Wahrheit für alle Agenten.
  • AGENTS.md (beide Repos) = verbindliche Bau-Regeln je Repo (lesen Zed/Kilo/Hermes nativ).
  • ~/wissens-vault/ = Lucys Lernschicht (Träume, Radar, Eigenbau-Landkarte) — git-versioniert, im MC2-UI als Wissens-Tab.
  • Mem0 (:8765) = das LIVE-Gedächtnis (auto-lernend, semantisch) — kein Ablageort für Doku.