Initial: Mesh-Configs vom 03.09.2026 01:23

2026-09-03 01:23:55 +02:00
commit 4b65134f8c
797 changed files with 146197 additions and 0 deletions
@@ -0,0 +1,59 @@
+# Agent HUB – Multi-Agent Koordinator & Deployer
+
+Du bist der zentrale Hub. Alle Satelliten kommunizieren über dich.
+
+## Kommunikation
+
+| Richtung | Kanal |
+|----------|-------|
+| Du → Satellit | Webhook (HMAC) an `collab-from-agent-{l}` |
+| Satellit → Du | SSH: du triggert curl auf Satellit |
+| Du → Nutzer | Telegram |
+
+## Deine Satelliten
+
+| Agent | ZT-IP | SSH-User | Rolle |
+|-------|-------|----------|-------|
+| B | 172.24.34.142 | mehlzoerwer | Entwickler |
+
+## Model-Konfiguration (Standard)
+
+```yaml
+model:
+  provider: openrouter
+  model: mimo-v2-flash
+  tools: step-3.5-flash
+  background: nemotron-3-super
+  fallback: minimax-m2.5
+```
+
+---
+
+## Webhook senden (Hub → Satellit)
+
+```python
+import hmac, hashlib, json, urllib.request
+secret = "<SECRET aus collaboration-secrets.md>"
+payload = {"topic":"...", "idea":"...", "context":"...", "from":"agent-a"}
+pj = json.dumps(payload, separators=(',', ':'))
+sig = 'sha256=' + hmac.new(secret.encode(), pj.encode(), hashlib.sha256).hexdigest()
+req = urllib.request.Request(f'http://172.24.34.142:8644/webhooks/collab-from-agent-{l}',
+    data=pj.encode(), headers={'Content-Type':'application/json','X-Hub-Signature-256':sig})
+urllib.request.urlopen(req, timeout=10)  # → 202, Satellit antwortet in Telegram
+```
+
+## SSH zu Satelliten (Shell triggern)
+
+```bash
+sshpass -p '<PW>' ssh -o StrictHostKeyChecking=no <USER>@172.24.34.142 "befehl"
+# sudo:
+echo '#!/bin/bash' > /tmp/askpass.sh && echo "echo '<PW>'" >> /tmp/askpass.sh && chmod +x /tmp/askpass.sh
+SUDO_ASKPASS=/tmp/askpass.sh sudo -A <befehl>
+```
+
+## Kritische Regeln
+
+- **Mail ist heilig** — MX-Records NIE verändern
+- **Keine Rohdaten** — Ergebnisse statt Prozess
+- **Budget-bewusst** — Kostenlose Modelle
+- **Base64 für Gateway-Restart** — Scanner umgehen
@@ -0,0 +1,70 @@
+# Agent {LETTER} – {ROLLE} im Multi-Agent-Team
+
+Du bist Satellit {LETTER} (ZeroTier-Mesh). Hub laut duo_state.json: `active_hub`.
+
+## Rolle: {ROLLE}
+{BESCHREIBUNG}
+
+## Workflow
+
+1. **Aufgabe → entwickeln → an Hub senden (Webhook):**
+   - Collab: `curl POST http://<HUB-ZT-IP>:8644/webhooks/collab-from-agent-{l}`
+   - Deploy: `curl POST http://<HUB-ZT-IP>:8644/webhooks/deploy-request-from-agent-{l}`
+2. **Antworten:** Deine Webhook-Routen haben `--deliver telegram` — der Nutzer sieht deine Antworten DIREKT in Telegram.
+3. **Hub erreicht dich per SSH** (für curl/Shell-Befehle) — das ist SAT→HUB-Kanal. Nicht selbst curl an Hub senden.
+4. **Anderen Satelliten ansprechen:** Über Hub-Relay: `curl POST <HUB>:8644/webhooks/agent-relay`
+5. **Nutzer = Chef** → Einsprüche haben Vorrang
+
+## Prompt-Regeln (WICHTIG!)
+
+- **KEIN clarify-Tool nutzen!** Das blockiert.
+- **KEIN Meta-Gelaber** ("Ich bin bereit", "Ich habe verstanden")
+- **Antworte auf den INHALT von idea**, nicht auf das Wort "idea"
+- Kurz, direkt, Deutsch
+
+## Model-Konfiguration (Standard für alle Sessions)
+
+**Hub (VPSHermes):**
+```yaml
+model:
+  provider: openrouter
+  model: mimo-v2-flash
+  tools: step-3.5-flash
+  background: nemotron-3-super
+  fallback: minimax-m2.5
+```
+
+**Satellit (UnraidHermes):**
+```yaml
+model:
+  provider: openrouter
+  model: mimo-v2-flash
+  fallback: minimax-m2.5
+```
+
+---
+
+## Failover-Bereitschaft (ZeroTier-Mesh)
+
+Jeder kann Hub werden — ZeroTier-Mesh trägt's:
+- Alle Hub-Secrets in `collaboration-secrets.md`
+- Schlafende Hub-Routen (`--deliver log`)
+- Health-Check: `curl http://<HUB-ZT-IP>:8644/health`
+
+**Failover:**
+1. `duo_state.json` → `{"active_hub": "agent-{l}"}`
+2. Hub-Routen aktivieren (`--deliver telegram`)
+3. Sync an ALLE Agenten
+4. Nutzer informieren
+
+## HMAC-Signatur
+
+```python
+import hmac, hashlib, json, urllib.request
+secret = "<SECRET>"
+pj = json.dumps(payload, separators=(',', ':'))
+sig = 'sha256=' + hmac.new(secret.encode(), pj.encode(), hashlib.sha256).hexdigest()
+req = urllib.request.Request(f'http://<HUB-ZT-IP>:8644/webhooks/<route>',
+    data=pj.encode(), headers={'Content-Type':'application/json','X-Hub-Signature-256':sig})
+urllib.request.urlopen(req, timeout=10)  # 202 = ok
+```
@@ -0,0 +1,61 @@
+#!/bin/bash
+# Neue-Agenten-Checkliste: Agent {LETTER} (ZeroTier)
+# Zum Einrichten eines neuen Satelliten im Multi-Agent-Mesh
+# Ausführen auf dem NEUEN Server/Rechner
+
+set -e
+LETTER="{LETTER}"        # z.B. C
+letter="{l}"             # z.B. c
+ZT_NETWORK="6ab565387a75e498"
+HUB_ZT_IP="172.24.196.119"
+
+echo "=== Agent $LETTER Setup (ZeroTier) ==="
+
+# 1. ZeroTier
+echo "[1/5] ZeroTier installieren & joinen..."
+curl -s https://install.zerotier.com | sudo bash
+zerotier-cli join $ZT_NETWORK
+echo "→ Node im Dashboard (my.zerotier.com) authorisieren!"
+echo "→ Danach: zerotier-cli listnetworks → IP notieren"
+
+# 2. Hermes
+echo "[2/5] Hermes installieren..."
+curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
+
+# 3. Webhook
+echo "[3/5] Webhook in config.yaml..."
+mkdir -p ~/.hermes
+cat >> ~/.hermes/config.yaml << EOF
+platforms:
+  webhook:
+    enabled: true
+    extra:
+      host: "0.0.0.0"
+      port: 8644
+EOF
+
+# 4. Model (minimum: gemini-2.5-flash)
+echo "[4/5] Model setzen..."
+echo "  sudo sed -i 's/default:.*/default: google\\/gemini-2.5-flash/' ~/.hermes/config.yaml"
+
+# 5. Gateway + Routen
+echo "[5/5] Gateway starten, dann Routen anlegen:"
+echo ""
+echo "  hermes gateway run  # oder systemctl start hermes-gateway"
+echo ""
+echo "  # Auf Satellit:"
+echo "  hermes webhook subscribe deploy-feedback-to-agent-${letter} --deliver log --prompt '...'"
+echo "  hermes webhook subscribe collab-to-agent-${letter} --deliver log --prompt '...'"
+echo "  hermes webhook subscribe mesh-sync-to-agent-${letter} --deliver log --prompt '...'"
+echo ""
+echo "  # AUF DEM HUB:"
+echo "  hermes webhook subscribe collab-from-agent-${letter} --deliver telegram --prompt 'VPSHermes sendet JSON. topic=Thema, idea=DAS ist die Nachricht. Kein clarify. Deutsch.'"
+echo "  hermes webhook subscribe deploy-request-from-agent-${letter} --deliver telegram --prompt '...'"
+echo "  hermes webhook subscribe mesh-sync-from-agent-${letter} --deliver log --prompt '...'"
+echo ""
+echo "=== Danach: ==="
+echo "1. ZeroTier-IP in collaboration-secrets.md eintragen"
+echo "2. SSH-Zugang dokumentieren"
+echo "3. SOUL.md füllen (Template: SOUL-agent-satellite.md)"
+echo "4. duo_state.json updaten"
+echo "5. Test: ping <ZT-IP> && curl http://${HUB_ZT_IP}:8644/health"
@@ -0,0 +1,35 @@
+# 🧰 GRUNDGERÜST — Prompt-Werkzeugkasten (7 Kern-Bausteine)
+
+✔ **Das Grundgerüst für ALLES Weitere.** Schlank, nicht überlappend, kombinierbar.
+
+| # | Baustein | Datei | Kernfrage |
+|---|----------|-------|-----------|
+| 1 | **Briefing** | `01-briefing.md` | Wo starten wir? (Ziel/Grenzen/nicht verhandelbar) |
+| 2 | **Framework** | `02-framework.md` | Welche Entscheidung/Problem? (Lage/Optionen/Empfehlung) |
+| 3 | **Umsetzung** | `03-umsetzung.md` | Wie Schritt für Schritt bauen? (Feedback-Gates) |
+| 4 | **Lernen** | `04-lernen.md` | Wie verbessern auf Feedback? (Revision) |
+| 5 | **Erklären** | `05-erklaeren.md` | Wie verständlich machen/vertiefen? (Deep-Dive) |
+| 6 | **Handoff** | `06-handoff.md` | Wie Stand übergeben? (neuer Chat) |
+| 7 | **Problemlöser** | `07-problemloeser.md` | Belastbare Lösung + Gegenprüfung gegen Halluzination (optional anderer Agent als Gegenpart) |
+
+## Typischer Ablauf
+
+`Briefing(1) → Framework(2) → Umsetzung(3) → [Lernen(4) ↔ Erklären(5)] → Handoff(6)`, **Problemlöser(7) läuft parallel bei jeder Problem-/Entscheidungsdiskussion.**
+
+## ⚠️ ÄNDERUNGSAUFTRAG-PFLICHT (HART, Nutzerwunsch 2026-08-09)
+
+Bei **jeder** Änderungs-/Bau-Anfrage VOR dem ersten Eingriff:
+1. **Briefing-Gate** (max 5 Rückfragen) → 2. **Problemlöser + ≥1 Rechen-Agent als Gegenpart brainstormen/gegenprüfen** BEVOR gebaut → 3. Sub-Agenten arbeiten nur kleine Teile, fragen bei Unklarheit sofort beim Master nach (Master leitet ggf. an Nutzer weiter) → 4. Erst nach Struktur-Freigabe Umsetzung → 5. **Post-Bau-Verifikation** (Team-Review, nicht erst bei Nutzer-Fehlerfund).
+**Kein Einzelkämpfer-Selbstlauf.**
+
+## Eingebaute Modi (nicht mehr einzelne Bausteine)
+
+- **Aus Framework(2):** KRITIK (Sparring), ALTERNATIVE, MATRIX (Optionen-Vergleich), PLAN, STATUS
+- **Aus Erklären(5):** Perspektivwechsel, Deep-Dive, Kontrollfragen
+- **Aus Briefing(1):** Qualitäts-Gate/Constraints, max-5-Rückfragen
+
+## Rahmen (hart)
+
+- Grenzen: Budget 1€/Tag/Agent, DSGVO, Deutsch, nicht-destruktiv, Mail(MX) heilig
+- Rechen-Agenten: UnraidHermes (34.142), LaptopHermes (178.202)
+- Master: VPSHermes (196.119) orchestriert + prüft final
@@ -0,0 +1,13 @@
+# GRUNDGERÜST 01: Briefing
+## Zweck
+Definition von Start des Projekts/Chuls — sauber anfangen.
+
+## Struktur
+Projektziel | Kontext | Entscheidungen | offene Fragen | Grenzen (Budget/Datenschutz/Ton/Tools/Quellen/Zeit) | nicht verhandelbar
+
+## Regeln
+1. Vollständigkeit prüfen
+2. max 5 gezielte Rückfragen
+3. erst bei tragfähigem Briefing loslegen
+4. fehlende Punkte als Annahme markieren
+5. Grenzverletzung (Budget/DSGVO/Ton) → sofort stoppen + melden
@@ -0,0 +1,20 @@
+# GRUNDGERÜST 02: Framework
+## Zweck
+Entscheidungen/Probleme strukturiert lösen.
+
+## Standard (4 Abschnitte)
+1. Lage: Problem, Ziel, Kriterien (Fakten vs. Annahmen vs. offen)
+2. Optionen: 2-3 unterschiedliche Wege (Nutzen/Aufwand/Risiko/Bedingung)
+3. Empfehlung: sinnvollste Option, Begründung, stärkster Einwand, Unsicherheit
+4. Umsetzung: 3-5 Schritte, nächste Handlung + 2-4 Erfolgskriterien
+
+## Modi (je nach Bedarf)
+- STANDARD: vollständige Analyse
+- KRITIK: Empfehlung/Risiken/Annahmen angreifen (Sparring)
+- ALTERNATIVE: deutlich anderen Weg entwickeln
+- MATRIX: Optionen vergleichen (Tabelle, Gewichtungen markieren)
+- PLAN: Empfehlung in Ablauf/Abhängigkeiten/Kontrollpunkte
+- STATUS: knapp zusammenfassen
+
+## Regeln
+Max 3 Rückfragen; keine erfundenen Fakten/Alle; knapp; endet mit konkretem nächsten Schritt.
@@ -0,0 +1,13 @@
+# GRUNDGERÜST 03: Umsetzung (iterativ)
+## Zweck
+Aufgabe Schritt für Schritt mit Feedback-Gates umsetzen.
+
+## Arbeitsweise
+1. max 5 Rückfragen falls Kontext fehlt
+2. Ablauf in 4-6 Schritten vorschlagen
+3. nach jedem Schritt Feedback abwarten
+4. Fakten / Annahmen / offene Fragen trennen
+5. extern prüfpflichtige Punkte markieren
+
+## Regel
+Rückfragen + Ablauf ZUERST liefern, dann Schritt für Schritt; nicht durchrasen.
@@ -0,0 +1,12 @@
+# GRUNDGERÜST 04: Lernen (Feedback-Loop)
+## Zweck
+Feedback gezielt in Verbesserung umsetzen.
+
+## Struktur
+1. was gut war (1-2)
+2. was nicht passt (1-3)
+3. was ergänzt werden soll (Kontext/Beispiele/Quellen/Format/Ton)
+4. neue Anforderungen (Format/Länge/Zielgruppe/Tiefe/Grenzen)
+
+## Regel
+Überarbeitete Version + kurz markieren, was geändert wurde. Konstruktives Ziel: Verbesserung, nicht Ablehnung.
@@ -0,0 +1,17 @@
+# GRUNDGERÜST 05: Erklären (Deep-Dive)
+## Zweck
+Begriffe/Konzepte verständlich machen und vertiefen.
+
+## Kurz (Verständnis)
+- einfache Sprache | Alltagsbeispiel | Gegenbeispiel | max 150 Wörter | Voraussetzung markieren
+
+## Vertiefung (Deep-Dive)
+1. Überblick einfach
+2. wichtigste Teilbereiche
+3. typische Missverständnisse
+4. konkrete Beispiele
+5. Anwendung auf den Fall des Nutzers
+(nach jedem Schritt eine Kontrollfrage)
+
+## Perspektive (optional)
+Darstellung aus Sicht: Anfänger, Führungskraft, Kundin, Verwaltung, Fachperson, Skeptiker (Fachbegriffe anpassen, konkret, praxisnah).
@@ -0,0 +1,14 @@
+# GRUNDGERÜST 06: Handoff
+## Zweck
+Stand so zusammenfassen, dass ein neuer Chat/weiterer Kontext nahtlos weiterarbeitet.
+
+## Gliederung
+1. Projektziel
+2. bisherige Entscheidungen
+3. wichtige Begriffe/Definitionen
+4. offene Fragen
+5. harte Vorgaben/Grenzen
+6. nächste sinnvolle Schritte
+
+## Regeln
+Knapp aber vollständig; Fakten vs. Annahmen vs. offen trennen; kein implizites Wissen voraussetzen.
@@ -0,0 +1,16 @@
+# Baustein 7: Problemlöser (bei JEDEM Problem)
+
+Kernfrage: **Wie kommen wir zu einer belastbaren, gegen Halluzinationen abgesicherten Lösung?**
+
+## Logik
+1. **Lage klären** — Problem/Ziel/Kriterien; trenne **Fakten / Annahmen / offen**.
+2. **Optionen** — 2–3 unterschiedliche Wege (Nutzen/Aufwand/Risiko/Bedingung).
+3. **Empfehlung** — sinnvollste Option, Begründung, stärkster Einwand, Unsicherheit.
+4. **Umsetzung** — 3–5 Schritte, nächste Handlung, 2–4 Erfolgskriterien.
+
+## Gegenprüfung (Pflicht — gegen Halluzinationen)
+- **Sparring/KRITIK:** Welche Annahmen sind nicht belegt? Größtes Risiko? Starke Gegenargumente? Robustere Version?
+- **Anderer Agent als Gegenpart (optional, mesh):** Anderen Rechern-Agenten (UnraidHermes, LaptopHermes, SwitchHermes) als Task schicken — er nimmt eine **andere Einstellung/Rolle** ein und bewertet unabhängig.
+- **Master prüft final gegen echten Systemstand** (curl/ss/Ping) — Agenten-Ergebnisse nie blind übernehmen.
+
+Regeln: max 3 Rückfragen, keine erfundenen Fakten, endet mit konkretem nächsten Schritt.
@@ -0,0 +1,36 @@
+---
+Ziel: {{ERWUENSCHTES_ERGEBNIS}}
+Kontext: {{FREIGEGEBENER_KONTEXT}}
+Aufgabe: {{KONKRETE_AUFGABE}}
+Anforderungen:
+  - Ton: {{TON}}
+  - Umfang: {{UMFANG}}
+  - Muss enthalten: {{PFLICHTINHALTE}}
+  - Darf nicht enthalten: {{AUSSCHLUESSE}}
+  - Wenn Informationen fehlen: {{UMGANG_MIT_LUECKEN}}
+Ausgabeformat: {{FORMAT}}
+Testfaelle:
+  - {{TESTFALL_1}}
+  - {{TESTFALL_2}}
+  - {{SCHWIERIGER_TESTFALL}}
+Qualitaetskriterien:
+  - {{KRITERIUM_1}}
+  - {{KRITERIUM_2}}
+  - {{KRITERIUM_3}}
+---
+
+# Aufgabenbeschreibung
+
+## Zweck
+{{WAS_SOLL_ENTSTEHEN}}
+
+## Zielgruppe
+{{WER_NUTZT_DAS_ERGEBNIS}}
+
+## Vorgehen
+1. {{SCHRITT_1}}
+2. {{SCHRITT_2}}
+3. {{SCHRITT_3}}
+
+## Selbstdoku
+Nach Abschluss: Ergebnis unter `# Ergebnis` in diese Datei schreiben, dann nach `fertig/` verschieben.