# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-05-17
# Nächste Prüfung: 2026-11-17

ACTORS MODEL - 6-Kategorien Akteure-System
==========================================

BESCHREIBUNG
Das Actors-Model beschreibt die 6 Akteur-Kategorien die in BACH
zusammenarbeiten. Es ersetzt das alte 4-Akteure-Modell.

Version: 2.0.0

DIE 6 AKTEURE
=============

1. USER (Einer oder Mehrere)
----------------------------
Rolle: Entscheider, Auftraggeber, Feedback-Geber

Schnittstellen:
  - MessageBox/       Primaere Kommunikation
  - User/             Persönlicher Bereich
  - Workspace/        Aktiver Arbeitsbereich

Modi:
  - Single-User       Standard (aktuell)
  - Multi-User        Zukunft (Admin, Standard, Gast)

Interaktion:
  - Direkt via Chat (Claude.ai / API)
  - Asynchron via MessageBox (.txt/.md Dateien)
  - Manuell via Dateisystem


2. OPERATING AI - "Geist in der Flasche"
----------------------------------------
Rolle: Zentrale Intelligenz, Reasoning, Orchestrierung

Aktuell:      Claude (Anthropic)
Austauschbar: Ja - System ist AI-agnostisch designed

Aufgaben:
  - Reasoning und Entscheidungsfindung
  - Task-Orchestrierung und Delegation
  - Code-Generierung und Review
  - Dokumentation und Analyse
  - User-Kommunikation

Eigenschaften:
  - Token-Limit: ~190.000 pro Session
  - Kein persistentes Gedaechtnis
  - Zugriff auf Tools via MCP/Desktop Commander


3. WEITERE AIs/LLMs
-------------------
Rolle: Spezialisierte Aufgaben, Delegation, Token-Ersparnis

Verfügbar:
  - Ollama (lokal)    llama3.2, mistral, codellama
  - Gemini (extern)   Deep Research, lange Dokumente
  - Copilot           Office-Integration
  - GPT               Alternative (inaktiv)

Delegations-Trigger:
  - Token-Knappheit (>70%)
  - Bulk-Verarbeitung
  - Spezialisierte Tasks
  - Parallel-Verarbeitung


4. OPERATING SYSTEM
-------------------
Rolle: Grundlegende Infrastruktur und lokale Ausführung

Umfasst:
  - Windows/Linux OS
  - Installierte Software
  - Ollama Runtime
  - Python/Node.js
  - Dateisystem

Zugriff via:
  - Desktop Commander (MCP)
  - FileCommander (MCP)
  - Direkte Shell-Befehle


5. INTEGRIERTE TOOLS & SCRIPTE
------------------------------
Rolle: Eigenentwicklungen, Automatisierung, Spezialaufgaben

Kategorien:
  - Coding-Tools      c_encoding_fixer, c_json_repair, etc.
  - Steuer-Tools      steuer_scanner, steuer_sync, etc.
  - Agent-Scripts     agent_framework, entwickler_agent
  - Backup-Tools      backup_manager
  - Migration         migrate_connections

Verwaltung:
  bach tools list     Python-Scripts auflisten (Dateisystem)
  bach tools db       DB-registrierte Tools (CLI + externe KI)


6. ONLINE-TOOLS (ohne AI)
-------------------------
Rolle: Spezialisierte Web-Dienste

Kategorien:
  - Generatoren       PDF, QR-Codes, etc.
  - Datenbanken       APIs, Registries
  - Konverter         Format-Umwandlung
  - Recherche         Nicht-AI Suchmaschinen

Hinweis: Unterschied zu AI-Tools wie ChatGPT/Midjourney!


INTERAKTIONS-PRINZIPIEN
=======================

Hierarchie der Entscheidungen:
  1. User entscheidet bei kritischen Fragen
  2. Claude koordiniert und orchestriert
  3. Tools fuehren aus
  4. Andere AIs unterstützen bei Bedarf

Token-Bewusstsein:
  - Claude ist Token-limitiert
  - Delegation spart Tokens
  - Bulk-Ops an Ollama
  - Research an Gemini

Kommunikations-Kanaele:
  - Direkt:    Claude <-> User (Chat)
  - Async:     MessageBox (Dateien)
  - API:       MCP-Server, REST
  - Delegation: Inbox/Outbox System


VERBINDUNGS-MATRIX
==================

Operating AI (Claude):
  -> User (direkt, MessageBox)
  -> Ollama (API, Queue)
  -> Gemini (Drive Delegation)
  -> OS (Desktop Commander)
  -> Tools (direkte Ausführung)
  -> MCP-Server (PubMed, Canva, Drive)

User:
  -> Claude (Chat, MessageBox)
  -> OS (direkte Nutzung)
  -> Tools (manuelle Ausführung)

Ollama:
  <- Claude (Delegation)
  -> OS (lokale Ausführung)

Gemini:
  <- Claude (Drive Delegation)
  -> Cloud (externe Verarbeitung)


CLI-ZUGRIFF
===========
bach --connections list          Connections anzeigen
bach --connections db            Alias für list
bach --connections db --type ai  AI-Partner
bach --connections actors        Actors-Model anzeigen
bach --connections partners      Partner-Profile anzeigen
bach --help actors               Diese Hilfe


AGENTEN-SYSTEM
==============

Neben den 6 Akteuren gibt es ein hierarchisches Agenten-System:

Boss-Agenten (koordinieren):
  - Persönlicher Assistent (privat)
  - Gesundheitsassistent (privat)
  - Büroassistent (beruflich)

Experten (spezialisiert):
  - Haushaltsmanagement
  - Gesundheitsverwalter, Psycho-Berater
  - Steuer-Agent, Förderplaner

Mehr Infos: bach --help agents


SIEHE AUCH
----------
bach --connections list    Connections-Verwaltung
bach --connections actors  Actors-Model
bach --connections partners Partner-Profile
bach tools list            Tool-Verwaltung (Dateisystem)
bach tools db              Tool-Verwaltung (Datenbank)
bach --help agents         Agenten-System
