From e7f143823e06c13a0b26421f2e72963f8a0238f1 Mon Sep 17 00:00:00 2001 From: Hitonabi Date: Mon, 13 Jul 2026 21:29:33 +0200 Subject: [PATCH] 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 --- deploy/agent-hooks/box-steckbrief-inject.sh | 2 +- docs/wissen/ARBEITSWEISE.md | 4 ++ docs/wissen/GRENZEN.md | 43 +++++++++++++++++++++ docs/wissen/README.md | 1 + 4 files changed, 49 insertions(+), 1 deletion(-) create mode 100644 docs/wissen/GRENZEN.md diff --git a/deploy/agent-hooks/box-steckbrief-inject.sh b/deploy/agent-hooks/box-steckbrief-inject.sh index d752027..4bac8ad 100644 --- a/deploy/agent-hooks/box-steckbrief-inject.sh +++ b/deploy/agent-hooks/box-steckbrief-inject.sh @@ -30,7 +30,7 @@ hint="" # Stabile Anti-Flail-Orientierung: WER bin ich, WO laufen die Modelle, WAS ist tabu. ctx="$(cat <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](../GEMINI_BRIEFING.md). +**Bevor du ein Feature baust: [GRENZEN.md](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. diff --git a/docs/wissen/GRENZEN.md b/docs/wissen/GRENZEN.md new file mode 100644 index 0000000..45325fb --- /dev/null +++ b/docs/wissen/GRENZEN.md @@ -0,0 +1,43 @@ +# Grenzen-Landkarte — was gehört wohin + +_Angelegt 13.07.2026 (Faden 6). Für JEDEN Agenten, der hier baut: bevor du ein Feature +umsetzt, kläre WOHIN es gehört. Das System hat mehrere Flächen mit klaren Aufgaben — eine +Funktion an der falschen Fläche ist Murks, auch wenn sie „funktioniert"._ + +**Der Kern in einem Satz:** **MC2 = Steuerpult** (verwalten, klicken, zusehen) · +**Lucy = Chat & Stimme** (reden, begleiten) · **Hermes = das Agenten-Fundament darunter +(Quelle TABU)** · **Telegram = mobil melden/freigeben** · **Hermes Desktop = am PC arbeiten**. + +## Die Flächen — was gehört hin, was NICHT + +| Fläche | Code/Ort | ✅ Gehört hierhin | ❌ Gehört NICHT hierhin | +|---|---|---|---| +| **MC2 – Steuerpult** | `~/mission-control-v2` (backend Py + frontend React) `:9001` | Verwaltung, Auftragsbuch/Karten-Klicks, Chronik/Zeitmaschine, Wissens-Tab, Modelle/Rollen, System-Status/Logs, Ideen-Queue-**Eingabe**, Wartung/Updates | **Ein Chat-/Gesprächsfenster** oder ein Konversations-Assistent — dafür ist Lucy/Telegram/Hermes-Desktop da. MC2 wird angeschaut und geklickt, nicht „zugetextet". | +| **Lucy – Chat & Stimme** | eigenes Repo `F:\Coding Stuff\lucy` (Electron, `lucy-desktop/`+`lucy-tts/`) | Voice/Zuruf, Gespräch, Avatar/Animation, proaktive Meldungen, Wake-Word/Barge-in, Zettelkasten | **Verwaltungs-/Wartungs-Oberfläche** (Update-Knöpfe, Karten-Verwaltung, System-Logs) — das ist MC2. Lucy bleibt schlank (~1-s-Sprech-Latenz schützen). | +| **Hermes – Agenten-Fundament** | `~/.hermes/hermes-agent` (Framework), `~/.hermes/config.yaml`, `SOUL.md`, `skills/`, `agent-hooks/`, `mcp/` | Agenten-VERHALTEN ändern: über **Config, SOUL, Skills, Hooks, MCP-Server, Plugins** | **Quellcode patchen/forken — NIEMALS.** Kein Edit in `~/.hermes/hermes-agent/`. Fehlt ein Feature nativ → Config/Skill/Hook/MCP drumherum, nicht die Engine ändern. | +| **Telegram** | Hermes-Platform-Lane | mobil: Meldungen empfangen, Freigaben/Zurufe, Alarmkette, Cron-Delivery | Kein Bau-Ziel für UIs. Ist ein Kanal, keine App. | +| **Hermes Desktop** | PC-Hermes, Profil `pc`, Hirn = Box `:9001/v1` | Arbeit am PC: Projekte, Coding, Review, lange Threads. Faustregel „Repo oder >2 Min → Desktop". | Nicht mit Lucy verwechseln (Zuruf/Voice) — Desktop ist die Werkbank. | + +## „Ich will X bauen — wohin?" (Schnell-Entscheid) + +- **Etwas verwalten/anzeigen/klicken (Status, Karten, Logs, Modelle, Backups, Updates)** → **MC2** (backend + frontend). +- **Reden/hören/begleiten (Sprache, Gespräch, Avatar, proaktiv melden)** → **Lucy** (eigenes Repo). +- **Wie der Agent SICH VERHÄLT (Routing, Prompts, neue Fähigkeit, Werkzeug, Guardrail)** → + **Hermes drumherum**: `config.yaml` / `SOUL.md` / ein **Skill** / ein **Hook** (`agent-hooks/`) / + ein **MCP-Server** (`mcp/`). **Nie** die Hermes-Quelle. (Beispiel Faden 5: Box-Wissen kam per + `pre_llm_call`-Hook — `deploy/agent-hooks/box-steckbrief-inject.sh` — in jeden Worker, nicht per Engine-Patch.) +- **Etwas mobil melden/freigeben** → **Telegram**-Lane (Kanal, keine neue UI). +- **Wissen/Doku ablegen** → `docs/wissen/` (Projekt-Wahrheit) oder `~/wissens-vault/` (Lucys + Lernschicht). **Nicht** ins Mem0/Live-Gedächtnis (das ist auto-lernend, kein Ablageort). + +## Häufige Grenz-Verwechslungen (die roten Linien) + +- ❌ **Chat-UI/Assistent in MC2** → gehört zu Lucy/Telegram/Hermes-Desktop. MC2 ist Steuerpult. +- ❌ **Verwaltungs-/Update-Buttons in Lucy** → gehören ins MC2-Steuerpult. +- ❌ **Hermes-Quellcode ändern** (`~/.hermes/hermes-agent/…`) → nur Config/SOUL/Skill/Hook/MCP. +- ❌ **Am Live-Checkout `~/mission-control-v2` schreiben/committen** → immer frischer Klon im + Task-Workspace (siehe [FALLEN.md](FALLEN.md), werkstatt-SOUL). +- ❌ **Doku ins Mem0 kippen** → `docs/wissen/` oder Vault. + +Verwandt: [ARBEITSWEISE.md](ARBEITSWEISE.md) (Rollen-Abgrenzung der Türen), [STACK.md](STACK.md) +(Dienste/Ports), [VERDIKTE.md](VERDIKTE.md) (Hermes-first, kein Fork). diff --git a/docs/wissen/README.md b/docs/wissen/README.md index c5e5ffa..a9a9b11 100644 --- a/docs/wissen/README.md +++ b/docs/wissen/README.md @@ -15,6 +15,7 @@ hier liegt das kuratierte PROJEKT-Wissen. |---|---|---| | [ZIELBILD.md](ZIELBILD.md) | Richtungs-Entscheid 10.07.: Box übernimmt alles, 4-Session-Paket | Immer zuerst — das ist der Kurs | | [ARBEITSWEISE.md](ARBEITSWEISE.md) | Wer der User ist + die nicht verhandelbaren Arbeitsregeln | Vor JEDER Arbeit | +| [GRENZEN.md](GRENZEN.md) | Was gehört wohin (MC2=Steuerpult, Lucy=Chat, Hermes-Quelle tabu) | Bevor man ein Feature baut — wohin? | | [STACK.md](STACK.md) | IPs, Ports, Dienste, Modelle, Backups, Security (live verifiziert) | Vor SSH/Deploy/Config | | [VERDIKTE.md](VERDIKTE.md) | Finale Technik-Entscheide mit Warum — NICHT neu aufrollen | Bevor man etwas "Besseres" vorschlägt | | [FALLEN.md](FALLEN.md) | Hart erarbeitete Betriebs-Fallen (Git, Deploy, llama-swap, Hermes, Mem0, PC) | Bevor man in eine davon läuft |