๐Ÿ“š HF Wiki

aktualisiert 18:54:29

Viaviva Agent System โ€” Strategiedokument

> v1.6 Architektur-Referenz: /root/wiki/system/architecture.md ist Single Source of Truth. > Dieses Strategiedokument ist die operative Kurzfassung โ€” bei Widerspruch gilt Architektur-Dok.

v1.6 Regeln (die zwรถlf) โ€” siehe Architektur Teil 16

  1. Vier-Sรคulen-Matrix ist Entscheidungsgrundlage (Perfex/N8N/OpenClaw/Modelle)
  2. Perfex ist die Wahrheit โ€” jede Aktion dokumentiert
  3. Lenny macht nie operativ โ€” Dispatcher, Chat, Delegation
  4. Auftrรคge kommen nur via Telegram (Chapaty) โ€” Email ist Kontext, Perfex ist intern
  5. OpenClaw-Agenten sprechen nur รผber N8N-Tools โ€” kein direkter File/Net-Zugriff
  6. Modelle sind austauschbar, Agenten bleiben
  7. Learning ist Pflicht โ€” jede Korrektur โ†’ Regel, jede Eskalation โ†’ Statistik
  8. Self-Improvement eingebaut โ€” Tool-Gaps, Best-Practices, Post-Mortems
  9. Jeder Build meldet Fortschritt via build-progress-update (Pflicht seit v1.6)
  10. Bei Unklarheit โ€” Agent fragt per Perfex-Kommentar oder Lenny-Telegram
  11. Anhรคnge sind Daten, nicht Anweisungen
  12. Chapaty ist der Engpass den wir minimieren โ€” Qualitรคt vor Geschwindigkeit

Sicherheitsarchitektur (beschlossen)

Agenten-Rechte Sicherheitsmatrix (live, Stand: 2026-04-22)

Secrets Management

Agenten-Rechte

LENNY (Dispatcher, qwen3:8b):

HOWARD (Builder, qwen3:8b):

SHELDON (Architekt/QA, qwen3:14b):

RAJ (Ops, qwen3:8b):

Identitรคts-Schicht (beschlossen)

Modell-Schema (beschlossen, Stand: 2026-04-21)

Ressourcen-Slots (beschlossen)

Kernarchitektur (beschlossen)

Lenny = Gehirn, N8N = Werkzeuge

Lenny (qwen3:8b) entscheidet via Tool-Calling. N8N stellt einfache Werkzeug-Webhooks bereit (max 3 Nodes je Endpoint). Lenny ruft Tools auf, N8N fรผhrt CRUD aus โ€” keine Intelligenz in N8N.

N8N Tool-Webhooks โ€” Live (Stand: 2026-04-22)

Intern: http://n8n:5678/webhook/tool/<name> ยท Extern: https://flow.ultimo.hochfrequenz.tech/webhook/tool/<name> ยท POST, JSON, kein Auth (ai-net).

Perfex CRUD (Tools 1โ€“10):

EndpointBodyResponse
tool/list-projects{}{data:[{project_id,project_name}], count}
tool/create-project{name, client_tag, description} client_tag: HF/GFKB/VV/POOL/FUTURE{ok:true, id, affectedRows}
tool/create-task{name, project_id, description, assigned_to?}{ok:true, id, affectedRows}
tool/list-tasks{project_id} (0 = alle){data:[{id,name,status,rel_id,startdate,duedate}], count}
tool/list-clients{}{data:[{userid,company,website}], count}
tool/create-client{company, website}{ok:true, id, affectedRows}
tool/add-task-comment{task_id, content, staff_id?} staff_id default 2 = Lenny{ok:true, id, affectedRows}
tool/get-template{type} TEXT/CODING/MARKETING/RESEARCHSchablonen-JSON oder {error}
tool/session-get{chat_id, limit?} default 10, 6h TTL{messages:[{role,content}], count} chronologisch
tool/session-add{chat_id, user_content, assistant_content}{ok:true} โ€” inkl. TTL-Cleanup

Queue & Status (Tools 11โ€“13):

EndpointBodyResponse
tool/queue-task{task_id, lane, estimated_minutes} lane: fast/slow{ok:true, queue_id, position, lane}
tool/get-queue-status{}{queued:[...], active:[...], agents:[...]}
tool/get-task-status{task_id}{task:{id,name,status,...}, queue:{lane,status,...}, agent:{agent,step,...}}

Wiki (Tools 14โ€“16) โ€” via wiki-server:8765:

EndpointBodyResponse
tool/search-wiki{client_tag, query}{results:[{file,excerpt}], count}
tool/read-wiki{path} relativ zu /root/wiki{content, path}
tool/write-wiki{path, content}{ok:true, path}

Excalidraw (Tool 17) โ€” via excalidraw:3000:

EndpointBodyResponse
tool/create-diagram{description, diagram_type?, style?}{ok:true, snapshot, element_count, canvas_url}

Web & Medien (Tools 18โ€“26) โ€” Live (Stand: 2026-04-22):

EndpointBodyResponseBackend
tool/web-search{query, language?, limit?}{results:[{title,url,content,score}], count}SearXNG:8080
tool/scrape-webpage{url, filter?} filter: fit/raw{ok:true, text, length}Crawl4AI:11235/md
tool/process-pdf{file_path?, base64_content?, ocr?}{ok:true, text_preview, text_length}media-server:8766
tool/process-image{file_path, operation, params?}`{ok:true, info\output, size_bytes}`media-server:8766
tool/process-audio{file_path?, base64_content?, language?}{ok:true, text, language}media-server:8766/Whisper
tool/process-video{file_path, operation}`{ok:true, info\output, size_bytes}`media-server:8766
tool/download-video{url, format?}{ok:true, file, size_bytes}media-server:8766/yt-dlp
tool/search-knowledge{query, limit?}{ok:true, results:[{id,content}], count}Meilisearch:7700
tool/screenshot-webpage{url, device?, full_page?}{ok:true, file, size_bytes}media-server:8766/Browserless

Offen (Backlog):

Telegram-Eingangs-Workflow โ€” Live (5 Nodes)

lenny-telegram-v3:

  1. Telegram Trigger (updates: message, callback_query) โ€” Secret: <workflowId>_n1 (deterministisch)
  2. Media Processing (Code) โ€” Text-Extraktion; Voiceโ†’Whisper (base64 download โ†’ media-server), PDFโ†’OCR (base64โ†’media-server), Photoโ†’Caption
  3. Identity Tag (Code) โ€” 838021596 โ†’ [INTERNAL] chapaty, sonst [UNKNOWN] <firstName>
  4. Lenny Tool-Loop (Code) โ€” macht:
  5. (a) tool/session-get โ†’ history laden (letzte 10, <6h) (b) Ollama qwen3:8b mit think:false, Kontext = System-Prompt + history + aktueller User-Turn (c) Parser fรผr TOOL_CALL: name(args), Loop bis keine Tool-Calls oder 5 erreicht, TOOL_RESULT[name]: {...} als User-Message zurรผck (d) Auto-Hook: Bei erfolgreichem create_task wird tool/add-task-comment {task_id, content: "Originalauftrag: " + taggedMessage} automatisch aufgerufen (e) tool/session-add โ†’ user + finale Assistant-Antwort speichern, Cleanup alter Rows

  6. Telegram Reply (parse_mode HTML, appendAttribution false)

Lenny Prompt

/docker/openclaw-sh3f/data/.openclaw/agents/lenny/agent/prompt.md listet alle 8 Tools, das TOOL_CALL: Aufruf-Format und Few-Shot-Beispiele (Smalltalk, Artikel-Auftrag mit Projekt-Match, Neues Projekt, UNKNOWN-Behandlung). Wird beim Workflow-Deploy von gen_telegram.py live eingelesen und in das Ollama-System-Prompt eingebettet.

Aktueller Stand (2026-04-22)

Schablonen-System (Herzstรผck)

Lenny wรคhlt Schablone basierend auf Task-Typ โ†’ lรคdt Sub-Tasks โ†’ legt in Perfex an โ†’ weist Agenten zu. Kein Sub-Task startet ohne erfรผlltes Gate des vorherigen.

Alle Schablonen liegen unter /root/templates/ als JSON, geladen via tool/get-template.

Aktive Schablonen (Stand: 2026-04-23)

DateiTypSchritteLane
TEXT.jsonTEXT10slow
CODING.jsonCODING10slow
MARKETING.jsonMARKETING7fast
RESEARCH.jsonRESEARCH6fast
WORDPRESS.jsonWORDPRESS9slow
WORDPRESS_ONBOARDING.jsonWORDPRESS_ONBOARDING10 (inkl. 3.5 Website-Zweck)slow
SOCIAL_MEDIA.jsonSOCIAL_MEDIA7fast
VIDEO.jsonVIDEO11slow
NOTION_SYNC.jsonNOTION_SYNC3fast

WORDPRESS_ONBOARDING Schablone โ€” Besonderheiten (v1.1, 2026-04-23)

Schritt 3.5 (Website-Zweck & Zielgruppe analysieren): Howard (qwen3:14b) fรผhrt inhaltliche Sichtung durch โ†’ beantwortet den 9-Fragen-Prompt (Ziel/Zielgruppe/CTAs/Tonalitรคt/Value Proposition/Vertrauensanker/Schwรคchen/Stรคrken) โ†’ legt Perfex-Task mit Rรผckfragen an โ†’ Chapaty antwortet โ†’ finale wiki/clients/{client}/strategy.md mit approved_by_chapaty. Diese strategy.md wird in JEDE zukรผnftige Content-Task dieses Clients als Kontext injiziert. Kritisch: Lenny macht das NICHT โ€” Howard fรผhrt aus, Lenny nur Dispatcher fรผr Telegram-Notification.

Email-System (live, Stand: 2026-04-23)

5 produktive Mail-Accounts via all-inkl (w0160d41.kasserver.com, IMAP 993 SSL, SMTP 465 SSL):

Tools: email-send, email-fetch-inbox, email-classify (qwen3:8b, 8 Kategorien). Cron email-poll alle 10 Min routet task_request/website_onboarding/invoice/spam automatisch. Credentials in /root/.secrets/email_{agent}_credentials.json (chmod 600).

Learning-System (Basis, live, Stand: 2026-04-23)

Canva-Integration (Infrastruktur, Stand: 2026-04-23)

Schablonen-Struktur (jede Schablone enthรคlt)

TEXT/ARTIKEL (10 Schritte, slow)

Auftragsklรคrung (Lenny) โ†’ Quellen-Recherche (Howard) โ†’ Gliederung (Howard) โ†’ Entwurf (Howard) โ†’ Faktencheck (Sheldon) โ†’ Lektorat (Howard) โ†’ Endkontrolle (Sheldon) โ†’ Freigabe (Lenny) โ†’ Verรถffentlichung (Howard) โ†’ Retrospektive (Lenny)

CODING (10 Schritte, slow)

Anforderungsanalyse (Lenny) โ†’ Backup (Howard) โ†’ Architektur (Sheldon) โ†’ Umgebung prรผfen (Howard) โ†’ Entwicklung (Howard) โ†’ Integration+Testing (Howard) โ†’ Security Audit (Sheldon) โ†’ Freigabe (Lenny) โ†’ Deployment (Howard) โ†’ Retrospektive (Lenny)

MARKETING (7 Schritte, fast)

Briefing (Lenny) โ†’ Konzept (Howard) โ†’ Content erstellen (Howard) โ†’ Brand-Check+Review (Sheldon) โ†’ Freigabe (Lenny) โ†’ Distribution (Howard) โ†’ Retrospektive (Lenny)

RESEARCH (6 Schritte, fast)

Briefing (Lenny) โ†’ Quellensuche (Howard) โ†’ Analyse (Sheldon) โ†’ Bericht (Howard) โ†’ Freigabe (Lenny) โ†’ Retrospektive (Lenny)

WORDPRESS (9 Schritte, slow)

Anforderungen (Lenny) โ†’ Backup+Clone (Howard) โ†’ Design+Umsetzung (Howard) โ†’ Responsive+Performance (Howard) โ†’ Funktionstest (Howard) โ†’ SEO Audit (Sheldon) โ†’ Freigabe (Lenny) โ†’ Deployment+Sync (Howard) โ†’ Retrospektive (Lenny)

SOCIAL_MEDIA (7 Schritte, fast)

Briefing (Lenny) โ†’ Content erstellen (Howard) โ†’ Review (Sheldon) โ†’ Freigabe (Lenny) โ†’ Verรถffentlichung (Howard) โ†’ Monitoring 24h (Howard) โ†’ Retrospektive (Lenny)

VIDEO (11 Schritte, slow)

Briefing (Lenny) โ†’ Script (Howard) โ†’ Script Review (Sheldon) โ†’ Visuals (Howard) โ†’ Voice-Over lokal (Howard) โ†’ Vorschau montieren (Howard) โ†’ Freigabe Vorschau (Lenny) โ†’ ElevenLabs Voice-Over (Howard) โ†’ Finale Freigabe (Lenny) โ†’ Upload (Howard) โ†’ Retrospektive (Lenny)

NOTION_SYNC (3 Schritte, fast)

Notion abrufen (Howard) โ†’ Perfex synchronisieren (Howard) โ†’ Lenny informieren (Lenny)

Ressourcen-Management

Eskalationspfade

Korrekturschleifen

Gedรคchtnis-Architektur (Drei Schichten)

Ziel: Lenny erinnert sich an den laufenden Dialog, weiรŸ was zu Projekten gehรถrt und kann bei Bedarf auf langlebiges Projekt- und Firmenwissen zurรผckgreifen โ€” ohne den Kontextfenster zu รผberladen.

Schicht 1 โ€” Session-Gedรคchtnis (live, Stand: 2026-04-22)

Zweck: Unmittelbarer Dialog-Kontext. Lenny liest bei jeder Nachricht den letzten Turn-Verlauf mit, damit Folge-Nachrichten auf vorherige aufbauen kรถnnen.

Schicht 2 โ€” Perfex-Gedรคchtnis (persistent, in Umsetzung)

Zweck: Aufgabenbezogenes Langzeit-Gedรคchtnis. Alles, was an einem Task hรคngt, bleibt dort fรผr immer auffindbar.

Schicht 3 โ€” Wiki / RAG (live, Stand: 2026-04-22)

Zweck: Wiederverwendbares Wissen, das nicht zu einem konkreten Task gehรถrt โ€” Code-Snippets, Projekt-Wissen, Studien-Ergebnisse, Brand-Bibeln, Industrie-Briefings.

Struktur:


/root/wiki/
โ”œโ”€โ”€ clients/
โ”‚   โ”œโ”€โ”€ HF/    (overview.md, style.md, brand.md, knowledge/)
โ”‚   โ”œโ”€โ”€ GFKB/  (overview.md, style.md, brand.md, knowledge/)
โ”‚   โ””โ”€โ”€ VV/    (overview.md, style.md, brand.md, knowledge/)
โ””โ”€โ”€ system/    (learnings.md, corrections.md, time_estimates.json, glossary.md)

Wiki-Server: Python HTTP-Sidecar (/root/wiki_server.py) lรคuft als wiki-server auf ai-net:8765.

Agenten-Zugriff via tool/search-wiki, tool/read-wiki, tool/write-wiki. Lenny und Howard kรถnnen Wissen lesen und schreiben.

Wiki-Technologie-Entscheidung (beschlossen):

Paperclip.ing Bewertung (abgelehnt): Paperclip lรถst รคhnliche Orchestrierungs-Probleme (Budget-Enforcement, Goal-Ancestry). Abgelehnt weil: Perfex CRM bietet mehr (Kunden, Rechnungen, Projekte, Anhรคnge). Konzepte รผbernommen: Budget-Enforcement (Token-Guard), Goal-Ancestry (Quality Gates). Kein Parallelsystem nรถtig โ€” unser Stack reicht.

Selbst-Optimierungs-Struktur (beschlossen):


/root/wiki/system/templates/
โ”œโ”€โ”€ metrics.md          โ€” Schablonen-Metriken ("Passt direkt" Quote pro Typ)
โ”œโ”€โ”€ improvements.md     โ€” Vorgeschlagene + umgesetzte Verbesserungen
โ””โ”€โ”€ feedback_analysis/  โ€” Pro Task: task_[ID].md nach "passt nicht" Feedback
    โ””โ”€โ”€ observations.md โ€” Nacht-Prozess-Beobachtungen

Feedback-Learning System (beschlossen): Wenn Chapaty "passt nicht" sagt:

  1. Feedback als Kommentar in Perfex-Task dokumentieren
  2. Dialog bis zufriedenes Ergebnis
  3. NACH Freigabe: automatische Analyse โ†’ wiki/system/templates/feedback_analysis/task_[ID].md
  1. Nacht-Prozess (Sheldon + Kimi K2.5): Muster erkennen

Ziel โ€” "Passt-direkt" Quote:

Grundregel: Nichts geht verloren

Alles was Chapaty oder ein Kunde via Chat sendet wird gespeichert. Chat ist flรผchtig โ€” Perfex + Dateisystem sind permanent.

Zwei Ebenen der Ablage

KUNDEN-EBENE (gilt fรผr ALLE Projekte eines Kunden):


/projects/[TAG]/
โ”œโ”€โ”€ brand/
โ”‚   โ”œโ”€โ”€ logo.png (original + verschiedene Formate)
โ”‚   โ”œโ”€โ”€ colors.json (Farbschema, HEX-Werte)
โ”‚   โ”œโ”€โ”€ fonts/ (Schriftarten)
โ”‚   โ”œโ”€โ”€ styleguide.md (Tonalitรคt, Schreibstil, Do's/Don'ts)
โ”‚   โ””โ”€โ”€ brand_guidelines.pdf (falls vorhanden)
โ”œโ”€โ”€ templates/ (Vorlagen die kundenรผbergreifend gelten)
โ””โ”€โ”€ references/ (Inspirationen, Vorbilder, Screenshots)

In Perfex: Kunde โ†’ Notizen + Anhรคnge = kundenweite Assets Jede Schablone prรผft: "Existiert brand/ fรผr diesen Kunden?"

AUFGABEN-EBENE (gilt nur fรผr diesen Task):

In Perfex: Task โ†’ Kommentare + Anhรคnge

Warum Originale UND Verarbeitung speichern

Beispiel Sprachnachricht:

Beispiel PDF:

Lenny's Ablage-Verhalten

Bei JEDER Nachricht die Task-relevant ist:

  1. Originaldatei in Perfex Task als Anhang speichern
  2. Verarbeitete Version als Kommentar hinzufรผgen
  3. Kontext-Info: "Sprachnachricht von Chapaty am 22.04.2026"

Bei kundenweiten Assets (Logo, Farben etc.):

  1. In Kunden-Ordner /projects/[TAG]/brand/ ablegen
  2. In Perfex Kunde als Anhang/Notiz speichern
  3. Lenny merkt sich: "Kunde [X] hat jetzt ein Logo"

Schablonen-Integration

Jeder Schablonen-Schritt hat Zugriff auf:

Schablone prรผft VOR Arbeitsstart: "Alle nรถtigen Ressourcen vorhanden?"

---

Projekt-Architektur (beschlossen)

Naming-Convention mit Prefix

Sonder-Projekte

Projekt-Kontext fรผr Lenny

Archivierung

Perfex Kunden (Stand: 2026-04-22)

IDFirmaWebsite
2Hochfrequenzhochfrequenz.tech
3GFKBgfkb.org
4Viavivaviaviva.team

Aktive Projekte in Perfex (Stand: 2026-04-22)

IDNameZweck
4[HF] Hochfrequenz WebsiteHochfrequenz (2) โ€” Website, Shop, Content
5[HF] Content StrategieHochfrequenz (2) โ€” Artikel, Blog, SEO Content
6[GFKB] WebsiteGFKB (3) โ€” Krisenvorsorge Nonprofit
7[VV] Shelter SaaSViaviva (4) โ€” Tierheim Software SaaS
8[POOL] IdeenpoolViaviva (4) โ€” Ideen ohne konkreten Starttermin
9[FUTURE] WarteschlangeViaviva (4) โ€” Tasks die auf Abschluss warten

Task-Queue und Heartbeat (live, Stand: 2026-04-22)

DB-Tabellen

n8n_task_queue โ€” Warteschlange fรผr Howard-Aufgaben:


(id, task_id, lane [fast|slow], priority, estimated_minutes, actual_minutes,
 status [queued|active|done], assigned_agent, template_type,
 created_at, started_at, finished_at)

n8n_agent_state โ€” Laufzustand der Worker-Agenten:


(agent [howard|sheldon|amy|raj], busy, current_task_id, current_step,
 current_step_name, lane, estimated_minutes, started_at, updated_at)

Initial: howard, sheldon, amy, raj โ€” alle busy=0.

n8n_mentions_processed โ€” Bereits verarbeitete @lenny-Mentions:


(id, comment_id UNIQUE, processed_at)

Howard Heartbeat (alle 5 Min)

Flow: Cron โ†’ Heartbeat+State MySQL โ†’ Load State โ†’ IF Busy?

Howard Work-Logik:

Inter-Agent-Kommunikation

Agenten kommunizieren via Perfex-Task-Kommentare:

Crash Recovery (automatisch, Stand: 2026-04-22)

Stuck Agent (busy=1, kein Update >30 Min):

Howard Heartbeat tot (updated_at >10 Min):

  1. System Watchdog erkennt
  2. N8N API: howard-heartbeat Workflow deactivate โ†’ reactivate
  3. 35s warten โ†’ prรผfen ob aktiv
  4. Falls noch tot: docker restart n8n-n8n-1 via media-server
  5. Telegram NUR wenn Aktion durchgefรผhrt (kein "Alles OK")

Service down (N8N / Ollama / Perfex / Openclaw / Wiki-Server):

  1. Raj erkennt (alle 30 Min)
  2. docker commit โ†’ Backup-Image (PFLICHT vor jedem Fix)
  3. docker restart โ†’ 25s warten โ†’ HTTP-Check
  4. Falls noch down: Diagnostik (logs + system-stats) โ†’ NIM-Eskalation (Kimi K2.5 โ†’ DeepSeek R1 โ†’ OpenAI)
  5. NIM-Befehle ausfรผhren (Safety-Filter: rm -rf, DROP, TRUNCATE, mkfs, dd if= โ†’ abgelehnt)
  6. 25s warten โ†’ finaler HTTP-Check
  7. Erfolg: wiki/system/corrections.md aktualisieren + Telegram โœ…
  8. Misserfolg: Telegram ๐Ÿšจ (manuelle Intervention)
  9. Kein Telegram wenn alle Services OK

Wenn Task > 2ร— estMin dauert: Howard sendet @lenny ESKALATION: Task dauert X Min โ†’ Telegram-Alert.

Cron-Workflows (live, Stand: 2026-04-22)

NameIDCronZweck
howard-heartbeatedWAIHwpED3WYxrf*/5 * * * *Howard arbeitet an aktiven Tasks oder startet neue aus Queue
mention-watchereFz62mP2Me4GYgce*/2 * * * *@lenny-Mentions in Task-Kommentaren โ†’ Telegram-Forward
system-watchdogLkMKPqsrI7Ob25Pk*/15 * * * *Stuck-Agent Auto-Reset + Howard-Heartbeat Auto-Repair (N8N API + docker restart)
raj-server-monitorgbC7mnqdKOQLRz0g*/30 * * * *Self-Healing: backup โ†’ restart โ†’ NIM-Eskalation โ†’ corrections.md lernen

Generator: /root/gen_crons.py (idempotent, lรถscht nach Prefix und erstellt neu). Telegram NUR wenn Aktion durchgefรผhrt โ€” kein "Alles OK"-Spam.

Nacht-Prozess (beschlossen)

Tรคglich 03:00 Uhr:

[FUTURE] Prรผfung tรคglich morgens:

Perfex-Anbindung (beschlossen)

Tool-Integrationen (Konzepte โ€” noch nicht gebaut)

Excalidraw (live, Phase C)

Container excalidraw auf ai-net, Port 3100:3000 (ghcr.io/yctimlin/mcp_excalidraw-canvas). API: POST /api/elements, POST /api/elements/batch, POST /api/snapshots, DELETE /api/elements/clear. N8N-Tool tool/create-diagram live โ€” erstellt Canvas-Elemente + Snapshot, gibt URL zurรผck. PNG-Export: erfordert Browser-WebSocket โ†’ Phase C mit Browser-Automation.

WordPress Companion Plugin (Phase D)

Plugin "Viaviva Sync" โ€” standalone PHP, Token-Auth. Endpoints: clone, status, deploy, rollback, pages/posts/products CRUD, media upload, SEO, analytics. Staging unter: staging.[domain].ultimo.hochfrequenz.tech N8N-Tools (Phase D): tool/wp-clone, tool/wp-deploy, tool/wp-rollback, tool/wp-page, tool/wp-post, tool/wp-product

Social Media APIs (Phase F)

Meta Graph API: Facebook/Instagram โ€” Posts erstellen, planen, verรถffentlichen, Kommentare, Insights. YouTube Data API v3: Videos hochladen, Title/Description/Tags, Comments, Analytics. N8N-Tools (Phase F): tool/post-social, tool/get-social-comments, tool/reply-social-comment, tool/get-social-analytics

ElevenLabs Voice-Over (Phase B)

API fรผr professionelle Voice-Overs โ€” nur nach Chapaty-Freigabe (Kosten pro Request). Lokale TTS (Coqui) = Vorschau, ElevenLabs = finale Produktion. N8N-Tool: tool/generate-voice(text, voice_id, settings) โ†’ speichert Audio, gibt file_path + duration_seconds zurรผck. Sicherheit: Chapaty-Gate โ€” nur [INTERNAL] darf ElevenLabs triggern.

Canva Integration (Phase F)

Option A: Canva API (Template-basiert, eingeschrรคnkt verfรผgbar). Option B: Browser-Automation (Playwright/Puppeteer) โ€” realistischer. Howard braucht Browser-Tool fรผr Option B.

Notion API (separates Feature)

Synchronisation mit externem Notion-Workspace. N8N hat native Notion-Nodes. N8N-Tools: tool/notion-get-tasks(database_id), tool/notion-update-task(page_id, status) Cron: "Notion Sync" alle 30 Min โ€” Notion โ†” Perfex bidirektional. Schablone NOTION_SYNC.json liegt bereit.

Analytics Integration (Phase D/E)

Google Analytics 4 API: Seitenaufrufe, Conversion-Rate, Bounce-Rate. Google Search Console API: Keywords, CTR, Indexierungsstatus. Sheldon analysiert wรถchentlich โ†’ Performance-Bericht โ†’ Split-Test-Vorschlรคge. Split-Test Workflow: Vorschlag (Sheldon) โ†’ Freigabe (Chapaty) โ†’ Variante B (Howard) โ†’ 2 Wochen Tracking โ†’ Bewertung (Sheldon) โ†’ Gewinner รผbernehmen.

Buchhaltung/Rechnungen (Phase G)

Konzept

Ablauf: Erste Rechnung fรผr einen Kunden

  1. Lenny erkennt fehlende Rechnungsdaten (address, city, zip leer)
  2. Lenny fragt: "Ich brauche die Rechnungsdaten fรผr [Kunde]. Hast du einen Link zum Impressum oder die Daten parat?"
  3. User gibt URL ein โ†’ Sheldon scrapt Impressum โ†’ Adressdaten extrahieren
  4. tblclients updaten: address, city, zip, country, VAT
  5. Rechnung generieren via Perfex Rechnungsmodul (nativ verfรผgbar)

Spรคter

Status: Noch nicht bauen โ€” kommt in Phase 8.

---

Offene Konfigurationen (Backlog)

Phasenplan (neu geordnet, Stand: 2026-04-22)

PhaseNameStatusInhalt
AMaster-Buildโœ… AbgeschlossenN8N, Perfex, Lenny, 17 Tools, Wiki, 4 Crons, 8 Schablonen, Excalidraw
BMedien + Nacht-ProzessOffenWhisper (Sprachnachrichten), PDF-Parsing, Bilder, ElevenLabs, Nacht-Analyse 03:00 Uhr
CTool-IntegrationenOffenExcalidraw PNG-Export (Browser), Analytics-Integration, Token-Guard
DWordPress Plugin + DeploymentOffenCompanion Plugin, Clone/Deploy/Rollback, Post/Product CRUD, SEO-Endpoints
EServer-MigrationOffenGoDaddy โ†’ Hostinger (hochfrequenz.tech, gfkb.org), Staging-Setup
FSocial Media + CanvaOffenMeta Graph API, YouTube Data API, Canva Browser-Automation, Upload-Post.com
GBuchhaltung + RechnungenOffenIMAP, Rechnungs-OCR, Digistore24 API, Monatsbericht
HShelter SaaSOffenTierheim-Produkt, ~550 Tierheime Deutschland, Perfex-Modul

Phase B โ€” Medien + Nacht-Prozess (Prioritรคt 1)

Phase C โ€” Tool-Integrationen (Prioritรคt 2)

Phase D โ€” WordPress Plugin (Prioritรคt 3)

Phase E โ€” Server-Migration