Hitonabi
e7f143823e
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>
3.9 KiB
3.9 KiB
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 perpre_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-v2schreiben/committen → immer frischer Klon im Task-Workspace (siehe FALLEN.md, werkstatt-SOUL). - ❌ Doku ins Mem0 kippen →
docs/wissen/oder Vault.
Verwandt: ARBEITSWEISE.md (Rollen-Abgrenzung der Türen), STACK.md (Dienste/Ports), VERDIKTE.md (Hermes-first, kein Fork).