HitonabiandClaude Opus 5.5
45048c60b7
- STACK.md: Instanz-Rolle box, Partner noch nicht eingerichtet; 62 /api-Routen; Waechter prueft
die Partner-Instanz, sobald es sie gibt.
- OFFENE-FAEDEN.md: Phase 2 begonnen (2a auf main: backend/kern/, /api/partner,
Partner-Pruefung, Telegram-Zweitweg); die Homelab-Instanz selbst in Phase 3 (User-OK).
Punkt "Waechter prueft die schlafende Spracherkennung" gestrichen - auf main behoben (99ba6a7).
- VERDIKTE.md: eine Codebasis, zwei Rollen (MC_ROLLE); zweiter Weg zu Telegram direkt ueber die
Bot-API.
- FALLEN.md: schlafgelegte Dienste auch in den HTTP-Proben ausnehmen (Fehlalarm 24.09. 14:56).
- ARBEITSWEISE.md, README.md: Homelab-Instanz ab Phase 3, Partner-Pruefung "sobald eingerichtet".
Pruefungen: git grep auf Altbegriffe ausserhalb docs/archiv trifft nur noch die Tabelle
"Ueberholt (mit Datum)" in VERDIKTE.md; 0 tote Links in 15 Dateien; keine zerrissenen Tabellen.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
5.3 KiB
5.3 KiB
Arbeitsweise — wer der User ist, wie hier gearbeitet wird, was wohin gehört
Stand 24.09.2026. Gilt für jeden Agenten, der an diesem System arbeitet (Claude Code, OpenChamber/OpenCode, Lucy auf der Box). Enthält seit 24.09. auch die frühere Grenzen-Landkarte.
Der User (Hitonabi, „Commander")
- Kein Software-Entwickler. Er fasst keine Konsole an und macht keine Updates von Hand. Alles muss ohne ihn laufen oder per Knopf, Lucy oder Telegram bedienbar sein.
- GUI-first: klickbare Oberflächen statt Terminal. Sein Wunsch-Erlebnis: Aufträge verteilen, zusehen, Ergebnisse abnicken.
- Produkt-Instinkt ernst nehmen: Seine einfachen Fragen treffen oft den Kern. Vorschläge ernsthaft prüfen, nie abtun.
- Sprache: Deutsch, locker, direkt. Er schreibt oft roh und knapp. Lucy nennt ihn „Commander".
- Nordstern (wörtlich): „Das komplette System muss AUTONOM funktionieren — in 6 Monaten ohne Claude darf nichts brachliegen." Robustheit und Autonomie schlagen Features.
Die Regeln
- Verifizieren vor Behaupten. Vor jeder Aussage oder Änderung an der Box messen (SSH, Logs,
curl, Messlauf), statt aus Doku, Gedächtnis oder Web zu schließen. Der Erzählung eines Agenten (auch der eigenen) nie glauben: Protokolle, Git-Stand und Messwerte sind Beweise. - Scope challengen. Ein Technik-Vorschlag (auch vom User) ist kein Bauauftrag: erst den Zweck klären, bei einer erkennbaren Fehlannahme kurz stoppen und warnen. Lehrbuch-Praxis ist nicht automatisch unser Fall.
- Branch, Prüftor, dann Merge. Nie direkt auf
mainarbeiten.bash deploy/pruefen.shmuss grün sein. Claude darf bei grünen Prüfläufen selbst mergen und deployen (User-Entscheid 23./24.09.). Ein Direkt-Push aufmainohne Branch braucht ein ausdrückliches Ja. - Security-Config nie ohne ausdrückliches User-Ja (approvals, Tokens, ufw, sudoers, command_allowlist).
- Endgültig löschen nur per User-Klick (Modelle, Dateien und Reste auf der Box). Vorschlagen ja, selbst löschen nein.
- Hermes-first vor Eigenbau. Vor jedem Neubau prüfen, ob Hermes es kann (
hermes --help, Config, Plugins). Hermes-Quellcode wird nie gepatcht oder geforkt. - Alles reversibel: Branch, Sicherung, Festhalten (Pin-Register). Nichts bauen, was Lucys Sprech-Latenz oder das warme Hirn gefährdet.
- Deutsch für alles, was der User sieht (Oberfläche, Meldungen, Skills, Zusammenfassungen, Commit-Messages). Die erste Zeile einer Meldung sagt am besten, ob er etwas tun muss.
- Doku folgt dem Code. Wer Verhalten ändert, zieht README,
docs/unddeploy/jobs/README.mdim selben Branch nach (Pflegeregeln: docs/README.md).
Die Flächen — was gehört wohin
Kern in einem Satz: Box-Wart = Steuerpult (anschauen, klicken) · Lucy = Stimme und Gespräch · Hermes = das Agenten-Fundament darunter (Quelle tabu) · Telegram = mobil melden · OpenChamber = Coding am PC.
| Fläche | Ort | Gehört hierhin | Gehört nicht hierhin |
|---|---|---|---|
| Box-Wart (MC2) | dieses Repo, :9001 |
Updates, Wächter-Hinweise, Modelle, Radar, Aufräumen, Dienste und Protokolle, Sicherungen, Einstellungen | ein Chat- oder Gesprächsfenster |
| Homelab-Teil (eigene Instanz ab Phase 3) | gleiche Software als Container auf dem Proxmox-PC, Rolle homelab |
Homelab-Geräte, deren Updates per Knopf, Erreichbarkeit | Dinge der KI-Box (die bleiben beim Box-Wart) |
| Lucy (Desktop-App) | Repo F:\Coding Stuff\lucy (Electron) |
Sprache, Gespräch, proaktive Meldungen aus dem Briefkasten | Verwaltungs- und Update-Knöpfe |
| Hermes (Agent „Lucy" auf der Box) | ~/.hermes/ |
Verhalten über config.yaml, SOUL.md, Skills, Plugins, MCP-Server |
Änderungen am Quellcode in ~/.hermes/hermes-agent/ |
| Telegram | Hermes-Plattform | Meldungen empfangen, mit Lucy schreiben | eigene Oberflächen |
| OpenChamber | PC, Dateien unter F:\Coding Stuff\… |
Coding; Modelle kommen von der Box über :9001/v1 |
Box-Verwaltung |
| Android-App (Phase 5) | noch offen | Push, Cockpit, Updates freigeben, Lucy per Sprache | – |
Schnell-Entscheid „Ich will X bauen":
- etwas anzeigen, verwalten, per Knopf auslösen → Box-Wart (Backend-Router dünn, Logik in
backend/services/). - reden, hören, proaktiv melden → Lucy.
- wie der Agent sich verhält (Werkzeug, Prompt, Fähigkeit) → Hermes-Config,
SOUL.md, Skill, Plugin oder MCP-Server. - etwas mobil melden →
deploy/notify.sh(Telegram und Briefkasten in einem Aufruf). - Wissen oder Doku ablegen →
docs/in diesem Repo.
Rote Linien:
- Kein Chat im Box-Wart. Keine Update-Knöpfe in Lucy.
- Nie den Hermes-Quellcode ändern.
- Nie im Box-Checkout
~/mission-control-v2von Hand ändern oder committen; neuer Code kommt nur über Gitea unddeploy/deploy.sh. - Keine Doku in Lucys Gedächtnis kippen: Es lernt selbst und ist kein Ablageort.
Wissens-Orte
docs/in diesem Repo = kuratierte Projekt-Wahrheit für alle Agenten (Index: docs/README.md).AGENTS.md(hier und im Lucy-Repo) = verbindliche Bau-Regeln; OpenCode und Claude Code lesen sie selbst.~/.hermes/memories/= Lucys Gedächtnis; Hermes führt es selbst.- Das Claude-Gedächtnis am PC = Arbeitsnotizen der Claude-Sitzungen, nicht verbindlich. Was bleiben soll, gehört hierher.