# BACH User Manual

**Version:** v3.7.0-waterfall
**Generiert:** 2026-03-04
**Lizenz:** MIT

---

BACH ist ein textbasiertes Betriebssystem
fuer KI-Assistenten. Es verbindet Mensch und KI durch eine persistente
Middleware mit Gedaechtnis, Werkzeugen, Workflows und Multi-LLM-Support.

Dieses Handbuch beschreibt Installation, Nutzung und Erweiterung von BACH.

---



---

## 2. Uebersicht


# BACH - Textbasiertes Betriebssystem für LLMs

**Version:** v3.7.0-waterfall
**Status:** Production-Ready
**Lizenz:** MIT

## Überblick

BACH ist ein textbasiertes Betriebssystem, das Large Language Models (LLMs) befähigt, eigenständig zu arbeiten, zu lernen und sich zu organisieren. Es bietet eine umfassende Infrastruktur für Task-Management, Wissensmanagement, Automatisierung und LLM-Orchestrierung.

### Kernfunktionen

- **🤖 5 Boss-Agenten + 15 Experten** - Spezialisierte Agenten für verschiedene Aufgabenbereiche
- **🛠️ 373+ Tools** - Umfangreiche Tool-Bibliothek für Dateiverarbeitung, Analyse, Automation (DB-registriert)
- **📚 932+ Skills** - Wiederverwendbare Workflows und Templates (DB-registriert)
- **🔄 54 Workflows** - Vorgefertigte Prozess-Protokolle
- **💾 Wissensspeicher** - 138 Lessons + 248 Facts

## Installation

```bash
# Repository klonen
git clone https://github.com/ellmos-ai/bach.git
cd bach

# Abhängigkeiten installieren und `bach` CLI verfügbar machen
pip install -e .

# Vollständige Installation (MCP-Server, Hooks, Secrets, User-Profil)
bach setup full-install
```

## Quick Start

```bash
# BACH starten
python bach.py --startup

# Task erstellen
python bach.py task add "Analysiere Projektstruktur"

# Wissen abrufen
python bach.py wiki search "Task Management"

# BACH beenden
python bach.py --shutdown
```

## Hauptkomponenten

### 1. Task-Management
Vollständiges GTD-System mit Priorisierung, Deadlines, Tags und Context-Tracking.

### 2. Wissenssystem
Strukturiertes Memory-System mit Facts, Lessons und automatischer Konsolidierung.

### 3. Agenten-Framework
Boss-Agenten orchestrieren Experten für komplexe Aufgaben (Büro, Gesundheit, Produktion, etc.).

### 4. Bridge-System
Connector-Framework für externe Services (Telegram, Email, WhatsApp, etc.).

### 5. Automatisierung
Scheduler für wiederkehrende Tasks und Event-basierte Workflows.

## Dokumentation

- **[Getting Started](docs/getting-started.md)** - Erste Schritte mit BACH
- **[API Reference](docs/reference/)** - Vollständige API-Dokumentation
- **[Skills Katalog](SKILLS.md)** - Alle verfügbaren Skills
- **[Agents Katalog](AGENTS.md)** - Alle verfügbaren Agenten

## Lizenz

MIT License - siehe [LICENSE](LICENSE) für Details.

## Support

- **Issues:** [GitHub Issues](https://github.com/ellmos-ai/bach/issues)
- **Discussions:** [GitHub Discussions](https://github.com/ellmos-ai/bach/discussions)

---

*Generiert mit `bach docs generate readme`*



---

## 3. Schnellstart


# BACH Quickstart Guide

**Version:** unknown

## 🚀 In 5 Minuten zu Ihrem ersten BACH-Workflow

### 1. Installation (2 Minuten)

```bash
# Repository klonen
git clone https://github.com/ellmos-ai/bach.git
cd bach

# Abhängigkeiten installieren und `bach` CLI verfügbar machen
pip install -e .

# Vollständige Installation (MCP-Server, Hooks, Secrets, User-Profil)
bach setup full-install
```

### 2. Erste Schritte (3 Minuten)

#### BACH starten

```bash
python bach.py --startup
```

#### Task erstellen und verwalten

```bash
# Neue Aufgabe anlegen
python bach.py task add "Erstes BACH-Experiment"

# Aufgaben anzeigen
python bach.py task list

# Aufgabe erledigen
python bach.py task done 1
```

#### Wissen speichern und abrufen

```bash
# Notiz ins Wiki schreiben
python bach.py wiki write "bash-tricks" "Nützliche Bash-Befehle sammeln"

# Wissen suchen
python bach.py wiki search "bash"
```

#### Memory-System nutzen

```bash
# Wichtigen Fakt speichern
python bach.py mem write fact "Projekt-Deadline: 2024-12-31"

# Facts abrufen
python bach.py mem read facts
```

#### BACH beenden

```bash
python bach.py --shutdown
```

---

## 📚 Wichtigste Kommandos

---

## 🎯 Nächste Schritte

1. **Dokumentation erkunden**
   ```bash
   python bach.py docs list
   ```

2. **Agenten kennenlernen**
   ```bash
   python bach.py agent list
   ```

3. **Skills durchsuchen**
   ```bash
   cat SKILLS.md
   ```

4. **Eigenen Workflow erstellen**
   - Siehe: [Skills/_workflows/](skills/_workflows/)
   - Beispiele für wiederkehrende Aufgaben

---

## 🔧 Konfiguration

BACH passt sich automatisch an, aber Sie können anpassen:

- **Partner konfigurieren:** `python bach.py partner register claude`
- **Settings ändern:** `python bach.py config list`
- **Connector einrichten:** `python bach.py connector list`

---

## 📖 Weiterführende Dokumentation

- **[README.md](README.md)** - Vollständige Übersicht
- **[API Reference](docs/reference/api.md)** - Programmier-Interface
- **[Skills Katalog](SKILLS.md)** - Alle verfügbaren Skills
- **[Agents Katalog](AGENTS.md)** - Alle verfügbaren Agenten

---

## 💡 Tipps

1. **Kontextuelles Arbeiten:** BACH merkt sich, woran Sie arbeiten
2. **Automatisierung:** Nutzen Sie Workflows für wiederkehrende Aufgaben
3. **Integration:** Verbinden Sie BACH mit Claude, Gemini oder Ollama
4. **Backup:** Regelmäßig `python bach.py backup create`

---

## ❓ Hilfe bekommen

```bash
# Allgemeine Hilfe
python bach.py --help

# Handler-spezifische Hilfe
python bach.py <handler> --help

# Dokumentation durchsuchen
python bach.py docs search "keyword"
```

---

*Generiert mit `bach docs generate quickstart`*

**Viel Erfolg mit BACH! 🎵**



---

## 4. Befehle & Handler


## Befehle & Handler

BACH verfuegt ueber 97 Handler:

- **bach abo** -- Abo Handler - Abonnement-Verwaltung (Expert Agent)
- **bach agents** -- Agents Handler - Agenten-Verwaltung
- **bach apibook** -- Copyright (c) 2026 BACH Contributors
- **bach ati** -- ATI Handler - Advanced Tool Integration Agent
- **bach bach_paths** -- Copyright (c) 2026 BACH Contributors
- **bach backup** -- Backup Handler - Backup-Verwaltung
- **bach bericht** -- bericht.py - Foerderbericht-Handler
- **bach calendar_handler** -- Copyright (c) 2026 BACH Contributors
- **bach chain** -- Chain Handler - Ausfuehrung von verketteten Tool-Befehlen
- **bach claude_bridge** -- Copyright (c) 2026 BACH Contributors
- **bach connections** -- Connections Handler - Verbindungen und Actors-Model
- **bach connector** -- Copyright (c) 2026 BACH Contributors
- **bach consolidation** -- Consolidation Handler - Memory-Konsolidierung
- **bach contact** -- ContactHandler - Kontaktverwaltung CLI
- **bach context** -- Context Handler - Kontext-Suche und Longterm-Memory
- **bach cookbook** -- Copyright (c) 2026 BACH Contributors
- **bach cv** -- Copyright (c) 2026 BACH Contributors
- **bach daemon** -- Daemon Handler - Daemon-Service Verwaltung
- **bach daily_agent** -- Copyright (c) 2026 BACH Contributors
- **bach data_analysis** -- BACH Data Analysis Handler
- **bach db** -- DB Handler - Datenbank-Operationen (ersetzt Supabase MCP)
- **bach db_sync** -- Copyright (c) 2026 BACH Contributors
- **bach denkarium** -- Denkarium Handler - Logbuch + Gedanken-Sammler
- **bach dist** -- BACH Distribution Handler
- **bach doc** -- Copyright (c) 2026 BACH Contributors
- **bach docs** -- Docs Handler - Hauptdokumentation (Markdown + Legacy)
- **bach docs_search** -- Copyright (c) 2026 BACH Contributors
- **bach email** -- Copyright (c) 2026 BACH Contributors
- **bach extensions** -- Copyright (c) 2026 BACH Contributors
- **bach folders** -- BACH Folders CLI Handler
- **bach fs** -- Copyright (c) 2026 BACH Contributors
- **bach gesundheit** -- GesundheitHandler - Gesundheitsassistent CLI
- **bach gui** -- GUI Handler - Web-Server Verwaltung
- **bach haushalt** -- HaushaltHandler - Haushaltsmanagement CLI
- **bach health** -- Copyright (c) 2026 BACH Contributors
- **bach help** -- Help Handler - Zeigt Hilfe-Texte aus .txt Dateien
- **bach hooks** -- Copyright (c) 2026 BACH Contributors
- **bach inbox** -- BACH Inbox Handler v1.0
- **bach inject** -- Inject Handler - Injektor-Steuerung und Aufgaben-Zuweisung
- **bach integration** -- Integration Handler - LLM-Partner-Brücke
- **bach lang** -- Copyright (c) 2026 BACH Contributors
- **bach lesson** -- Lesson Handler - Lessons Learned Management
- **bach logs** -- Logs Handler - Log-Verwaltung
- **bach maintain** -- BACH Maintain Handler
- **bach mem** -- Mem Handler - Memory-Verwaltung
- **bach memory** -- Memory Handler - DB-basiertes Memory-Management
- **bach messages** -- Messages Handler - Nachrichtensystem CLI
- **bach mount** -- BACH Mount Handler
- **bach multi_llm_protocol** -- Multi-LLM Protocol Handler - Koordination paralleler Agenten
- **bach news** -- Copyright (c) 2026 BACH Contributors
- **bach newspaper** -- Copyright (c) 2026 BACH Contributors
- **bach notify** -- Copyright (c) 2026 BACH Contributors
- **bach obsidian** -- Copyright (c) 2026 BACH Contributors
- **bach ollama** -- Ollama Handler - Lokale AI-Interaktion
- **bach partner** -- Partner Handler - Partner-Verwaltung
- **bach partner_config_manager** -- PartnerConfigManager - LLM-Partner-Konfiguration
- **bach path** -- Copyright (c) 2026 BACH Contributors
- **bach pipeline** -- Pipeline-Handler für BACH
- **bach plugins** -- Copyright (c) 2026 BACH Contributors
- **bach press** -- Copyright (c) 2026 BACH Contributors
- **bach profile** -- Copyright (c) 2026 BACH Contributors
- **bach profiler** -- Copyright (c) 2026 BACH Contributors
- **bach recurring** -- BACH Recurring Tasks Handler v1.0.0
- **bach reflection** -- Copyright (c) 2026 BACH Contributors
- **bach restore** -- File Restore Handler (SQ020/HQ6)
- **bach routine** -- RoutineHandler - Household Routine Management CLI
- **bach sandbox** -- Copyright (c) 2026 BACH Contributors
- **bach scan** -- Scan Handler - Scanner-Verwaltung
- **bach seal** -- Kernel Seal Handler (SQ021)
- **bach search** -- SearchHandler - Unified Search CLI for BACH
- **bach secrets** -- secrets_handler.py — Secrets-Management Handler (SQ076)
- **bach session** -- SessionHandler - Session-Verwaltung fuer BACH
- **bach settings** -- Settings Handler - Systemeinstellungen verwalten
- **bach shared_memory** -- Shared Memory Handler - Multi-Agent Memory-Verwaltung (SQ043
- **bach shutdown** -- Shutdown Handler - Session beenden (DB-basiert)
- **bach skills** -- Skills Handler - Skill-Verwaltung (v2.0 Architektur)
- **bach smarthome** -- Copyright (c) 2026 BACH Contributors
- **bach snapshot** -- Snapshot Handler - Session-Snapshot-Verwaltung
- **bach sources** -- Sources Handler - Kontextquellen-System
- **bach startup** -- Startup Handler - Session starten (DB-basiert)
- **bach status** -- Status Handler - Schnelle System-Uebersicht
- **bach steuer** -- Steuer Handler - Steuerbelegs-Verwaltung
- **bach sync** -- Sync Handler - Dateisystem zu DB Synchronisation
- **bach task** -- TaskHandler - Task-Verwaltung fuer BACH
- **bach test** -- BACH Test Handler
- **bach time** -- Time Handler - CLI fuer Zeit-System
- **bach tokens** -- Tokens Handler - Token-Tracking
- **bach tools** -- Tools Handler - Tool-Verwaltung
- **bach trash** -- BACH Trash Handler
- **bach tuev** -- TUeV Handler - Workflow-Qualitaetssicherung
- **bach update** -- Copyright (c) 2026 BACH Contributors
- **bach upgrade** -- Copyright (c) 2026 BACH Contributors
- **bach versicherung** -- Copyright (c) 2026 BACH Contributors
- **bach watcher** -- Copyright (c) 2026 BACH Contributors
- **bach web_parse** -- Copyright (c) 2026 BACH Contributors
- **bach web_scrape** -- Copyright (c) 2026 BACH Contributors
- **bach wiki** -- Wiki Handler - Wiki-Artikel aus wiki/ anzeigen


---

## 5. Skills & Protokolle


# BACH Skills-Katalog

**Anzahl:** 940 Skills
**Generiert:** Automatisch aus der Skills-Datenbank

## Übersicht

Dieser Katalog listet alle verfügbaren Skills auf, gruppiert nach Typ.

### Skills nach Typ

- **agent**: 24 Skills
- **definition**: 2 Skills
- **expert**: 28 Skills
- **extension**: 38 Skills
- **file**: 711 Skills
- **os**: 1 Skills
- **profile**: 9 Skills
- **protocol**: 25 Skills
- **service**: 48 Skills
- **skill**: 46 Skills
- **template**: 8 Skills

---

## AGENT (24)

### `agent/README`

### `agent/ati/ATI`
**Kategorie:** ati  
>

### `agent/ati/ATI_PROJECT_BOOTSTRAPPING`
**Kategorie:** ati  
>

### `agent/ati/README`
**Kategorie:** ati  

### `agent/ati/_policies/POLICIES_README`
**Kategorie:** ati  

### `agent/ati/modules/README`
**Kategorie:** ati  

### `agent/ati/prompt_templates/analysis_prompt`
**Kategorie:** ati  

### `agent/ati/prompt_templates/review_prompt`
**Kategorie:** ati  

### `agent/ati/prompt_templates/task_prompt`
**Kategorie:** ati  

### `agent/ati/session/DEPRECATED`
**Kategorie:** ati  

### `agent/bewerbungsexperte`
>

### `agent/bueroassistent`
>

### `agent/entwickler`
>

### `agent/förderplaner`
>

### `agent/gesundheitsassistent`
>

### `agent/haushaltsmanagement`

### `agent/persoenlicher-assistent`
>

### `agent/production`
>

### `agent/psycho-berater`

### `agent/research`

### `agent/steuer-agent`
>

### `agent/test-agent`

### `agent/versicherungen`
>

### `test-agent-x`
BACH agent: test-agent-x

---

## DEFINITION (2)

### `SKILL_AGENT_OS_DEFINITIONS`
**Kategorie:** core  
Core skill definition: SKILL_AGENT_OS_DEFINITIONS

### `SKILL_ANALYSE`
**Kategorie:** core  
Core skill definition: SKILL_ANALYSE

---

## EXPERT (28)

### `aboservice`
**Kategorie:** _experts  
aboservice

### `data-analysis`
**Kategorie:** _experts  
data-analysis

### `expert/_mediaproduction/musik`
**Kategorie:** _mediaproduction  

### `expert/_mediaproduction/podcast`
**Kategorie:** _mediaproduction  

### `expert/_mediaproduction/video`
**Kategorie:** _mediaproduction  

### `expert/_textproduction/pr`
**Kategorie:** _textproduction  

### `expert/_textproduction/storys`
**Kategorie:** _textproduction  

### `expert/_textproduction/text`
**Kategorie:** _textproduction  

### `expert/aboservice/CONCEPT`
**Kategorie:** aboservice  

### `expert/aboservice/README`
**Kategorie:** aboservice  

### `expert/data-analysis/CONCEPT`
**Kategorie:** data-analysis  

### `expert/financial_mail/CONCEPT`
**Kategorie:** financial_mail  

### `expert/foerderplaner/foerderplaner`
**Kategorie:** foerderplaner  
>

### `expert/gesundheitsverwalter/CONCEPT`
**Kategorie:** gesundheitsverwalter  

### `expert/haushaltsmanagement/CONCEPT`
**Kategorie:** haushaltsmanagement  

### `expert/haushaltsmanagement/aufgaben`
**Kategorie:** haushaltsmanagement  

### `expert/mr_tiktak/CONCEPT`
**Kategorie:** mr_tiktak  

### `expert/psycho-berater/CONCEPT`
**Kategorie:** psycho-berater  

### `expert/psycho-berater/rolle`
**Kategorie:** psycho-berater  

### `expert/report_generator/report_generator`
**Kategorie:** report_generator  
>

### `expert/steuer/steuer-agent`
**Kategorie:** steuer  
>

### `expert/wikiquizzer/CONCEPT`
**Kategorie:** wikiquizzer  

### `financial_mail`
**Kategorie:** _experts  
financial_mail

### `gesundheitsverwalter`
**Kategorie:** _experts  
gesundheitsverwalter

### `health_import`
**Kategorie:** _experts  
health_import

### `mr_tiktak`
**Kategorie:** _experts  
mr_tiktak

### `test-tool-demo`

*... (3483 weitere Zeilen, siehe SKILLS.md)*


---

## 6. Agenten & Experten


# BACH Agents & Experts

**Generiert:** 2026-02-22 13:53
**Quelle:** bach.db (bach_agents, bach_experts)
**Generator:** `bach export mirrors` oder `python tools/agents_export.py`

---

## Boss-Agenten (Orchestrierer)

Boss-Agenten orchestrieren komplexe Workflows und delegieren an Experten.

### Entwickler Agent (ATI)
- **Name:** ati
- **Typ:** Expert
- **Kategorie:** None
- **Pfad:** `None`
- **Status:** active
- **Version:** 1.2.0
- **Beschreibung:** Spezialisiert auf Tool-Ueberwachung und Software-Entwicklung.

### Bueroassistent
- **Name:** bueroassistent
- **Typ:** boss
- **Kategorie:** beruflich
- **Pfad:** `agents/bueroassistent.txt`
- **Status:** active
- **Version:** 1.0.0
- **Beschreibung:** Steuern, Foerderplanung, Dokumentation

### Finanzassistent
- **Name:** finanz-assistent
- **Typ:** assistant
- **Kategorie:** beruflich
- **Pfad:** `None`
- **Status:** active
- **Version:** 1.0.0
- **Beschreibung:** Financial Mails, Abos, Versicherungen

### Gesundheitsassistent
- **Name:** gesundheitsassistent
- **Typ:** boss
- **Kategorie:** privat
- **Pfad:** `agents/gesundheitsassistent.txt`
- **Status:** active
- **Version:** 1.0.0
- **Beschreibung:** Medizinische Dokumentation und Gesundheitsverwaltung

### Persoenlicher Assistent
- **Name:** persoenlicher-assistent
- **Typ:** boss
- **Kategorie:** privat
- **Pfad:** `agents/persoenlicher-assistent.txt`
- **Status:** active
- **Version:** 1.0.0
- **Beschreibung:** Terminverwaltung, Recherche, Organisation

---

## Experten (Spezialisierte Ausführer)

Experten führen spezifische Aufgaben aus und werden von Boss-Agenten delegiert.

### Abo-Service
- **Name:** aboservice
- **Domain:** finanzen
- **Pfad:** `None`
- **Status:** active
- **Version:** 1.0.0

### Bewerbungsexperte
- **Name:** bewerbungsexperte
- **Domain:** karriere
- **Pfad:** `None`
- **Status:** active
- **Version:** 1.0.0

### Daten-Analyse
- **Name:** data-analysis
- **Domain:** analytik
- **Pfad:** `None`
- **Status:** active
- **Version:** 1.0.0

### Decision-Briefing
- **Name:** decision-briefing
- **Domain:** None
- **Pfad:** `agents\_experts\decision-briefing\CONCEPT.md`
- **Status:** active
- **Version:** 1.0.0
- **Beschreibung:** Der Decision-Briefing-Experte ist das zentrale System für ausstehende Entscheidungen und User-Aufgaben in BACH. Er:

### Finanz-Mails
- **Name:** financial_mail
- **Domain:** finanzen
- **Pfad:** `None`
- **Status:** active
- **Version:** 1.0.0

### Foerderplaner
- **Name:** foerderplaner
- **Domain:** paedagogik
- **Pfad:** `agents/_experts/foerderplaner/`
- **Status:** active
- **Version:** 1.0.0
- **Beschreibung:** ICF-Foerderplanung, Material-Recherche

### Gesundheitsverwalter
- **Name:** gesundheitsverwalter
- **Domain:** gesundheit
- **Pfad:** `agents/_experts/gesundheitsverwalter/`
- **Status:** active
- **Version:** 1.0.0
- **Beschreibung:** Arztberichte, Laborwerte, Medikamente

### Haushaltsmanagement
- **Name:** haushaltsmanagement
- **Domain:** haushalt
- **Pfad:** `agents/_experts/haushaltsmanagement/`
- **Status:** active
- **Version:** 1.0.0
- **Beschreibung:** Haushaltsbuch, Inventar, Einkaufslisten

### Health-Import
- **Name:** health_import
- **Domain:** gesundheit
- **Pfad:** `None`
- **Status:** active
- **Version:** 1.0.0

### Termin-Optimierer
- **Name:** mr_tiktak
- **Domain:** zeit
- **Pfad:** `None`
- **Status:** active
- **Version:** 1.0.0

### Psycho-Berater
- **Name:** psycho-berater
- **Domain:** psychologie
- **Pfad:** `agents/_experts/psycho-berater/`
- **Status:** active
- **Version:** 1.0.0
- **Beschreibung:** Therapeutische Gespraeche, Sitzungsprotokolle

### Bericht-Generator
- **Name:** report_generator
- **Domain:** dokumentation
- **Pfad:** `None`
- **Status:** active
- **Version:** 1.0.0

### Steuer-Experte
- **Name:** steuer-agent
- **Domain:** finanzen
- **Pfad:** `agents/_experts/steuer/`
- **Status:** active
- **Version:** 1.0.0
- **Beschreibung:** Steuerbelege, Werbungskosten

### Transkriptions-Service
- **Name:** transkriptions-service
- **Domain:** medien
- **Pfad:** `agents/_experts/transkriptions-service/`
- **Status:** active
- **Version:** 1.0.0
- **Beschreibung:** Audiodateien und Gespraeche transkribieren, Sprecher erkennen, bereinigen, exportieren

### Wiki-Lernhilfe
- **Name:** wikiquizzer
- **Domain:** bildung
- **Pfad:** `None`
- **Status:** active
- **Version:** 1.0.0

---

## Status-Kategorien

- **FUNCTIONAL:** Voll funktionsfähig, produktionsbereit
- **PARTIAL:** Grundfunktionen vorhanden, aber unvollständig
- **SKELETON:** Struktur vorhanden, aber Implementierung fehlt weitgehend

---

## Charakter-Modell (ENT-41)

Jeder Boss-Agent hat eine `## Charakter` Section in seiner SKILL.md:
- **Ton:** Wie kommuniziert der Agent?
- **Schwerpunkt:** Woran orientiert er sich?
- **Haltung:** Welche Werte vertritt er?

Siehe: BACH_Dev/MASTERPLAN_PENDING.txt → SQ049 Agenten-Audit & Upgrade

---

## Arbeitsprinzipien

Alle Agenten folgen den globalen Arbeitsprinzipien aus Root-SKILL.md:
- Unterscheiden was eigen, was fremd
- Text ist Wahrheit
- Erst lesen, dann ändern
- Keine Duplikate erzeugen
- Flexibel auf User-Korrekturen reagieren

---

## Nutzung

```bash
# Boss-Agent starten (mit Partner-Delegation)
bach agent start bueroassistent --partner=claude-code

# Experten direkt aufrufen (falls erlaubt)
bach expert run bewerbungsexperte --task="Anschreiben für Stelle X"

# Agent-Liste anzeigen
bach agent list

# Expert-Liste anzeigen
bach expert list
```

---

## Datei-Synchronisation

Diese Datei wird automatisch generiert aus:
- `bach_agents` (Tabelle für Boss-Agenten)
- `bach_experts` (Tabelle für Experten)

**Trigger:**
- `bach --shutdown` (via finalize_on_idle)
- `bach export mirrors` (manuell)

**dist_type:** 1 (TEMPLATE) - resetbar, aber anpassbar

---

## Siehe auch

- **PARTNERS.md** - LLM-Partner und Delegation
- **USECASES.md** - Anwendungsfälle
- **WORKFLOWS.md** - 25 Protocol-Skills als Index
- **CHAINS.md** - Toolchains



---

## 7. LLM-Partner


# BACH Partners

Automatisch generiert aus der Datenbank (delegation_rules, partner_recognition, interaction_protocols).
Letzte Aktualisierung: 2026-02-22 13:53

## Delegation Rules

**Total:** 4 Regeln

### Zone: zone_1

- **zone_1_full_access** ⭐⭐⭐
  - Voller Zugang: Alle Partner verfuegbar, optimale Qualitaet
  - Preferred: Claude

### Zone: zone_2

- **zone_2_moderate** ⭐⭐⭐
  - Moderate Sparsamkeit: Bevorzuge kostenguenstige Partner
  - Preferred: Ollama

### Zone: zone_3

- **zone_3_conservative** ⭐⭐
  - Konservativ: Nur lokale Partner (Ollama) bevorzugt
  - Preferred: Ollama

### Zone: zone_4

- **zone_4_emergency** ⭐
  - Notfall: Nur Eskalation oder lokale Verarbeitung
  - Preferred: Human

## Partner Recognition

**Total:** 10 Partner

- **Claude** (api) ✓
  - Zone: zone_1 | Cost: $$$ | Priority: 100
  - Capabilities: ["general", "coding", "analysis", "writing"]

- **Ollama** (local) ✓
  - Zone: zone_3 | Cost: $ | Priority: 80
  - Capabilities: ["coding", "general"]

- **Gemini** (api) ✓
  - Zone: zone_1 | Cost: $$ | Priority: 70
  - Capabilities: ["general", "research", "coding"]

- **Copilot** (api) ✓
  - Zone: zone_2 | Cost: $$ | Priority: 60
  - Capabilities: ["coding", "completion"]

- **ChatGPT** (api) ✓
  - Zone: zone_1 | Cost: $$$ | Priority: 50
  - Capabilities: ["general", "writing"]

- **Perplexity** (api) ✓
  - Zone: zone_2 | Cost: $$ | Priority: 40
  - Capabilities: ["research", "search"]

- **Mistral** (api) ✓
  - Zone: zone_2 | Cost: $$ | Priority: 30
  - Capabilities: ["coding", "general"]

- **Anthropic-Local** (local) ✗
  - Zone: zone_4 | Cost: $ | Priority: 20
  - Capabilities: ["general"]

- **Custom-Agent** (local) ✗
  - Zone: zone_4 | Cost: $ | Priority: 10
  - Capabilities: ["custom"]

- **Human** (human) ✓
  - Zone: zone_4 | Cost: $ | Priority: 5
  - Capabilities: ["review", "decision", "escalation"]

## Interaction Protocols

**Total:** 10 Protokolle

### confirmation

#### receipt

Empfangsbestaetigung

- **Timeout:** 60s | **Retries:** 3 | **Priority:** 50

### delegation

#### task_delegation

Aufgabe an Partner delegieren

- **Timeout:** 300s | **Retries:** 3 | **Priority:** 90
- **Applicable Partners:** ["Claude", "Ollama", "Copilot"]

### discovery

#### compare

Vergleich: Was hat der Partner was ich nicht habe

- **Timeout:** 60s | **Retries:** 3 | **Priority:** 50

#### handshake

Gegenseitige Erkennung zwischen Instanzen

- **Timeout:** 60s | **Retries:** 3 | **Priority:** 50

### escalation

#### human_escalation

Eskalation an Benutzer

- **Timeout:** 60s | **Retries:** 3 | **Priority:** 50
- **Applicable Partners:** ["Human"]

### query

#### simple_query

Einfache Frage-Antwort

- **Timeout:** 30s | **Retries:** 2 | **Priority:** 100
- **Applicable Partners:** ["Claude", "Ollama", "Gemini", "ChatGPT", "Mistral"]

#### code_review

Code-Review anfordern

- **Timeout:** 120s | **Retries:** 2 | **Priority:** 80
- **Applicable Partners:** ["Claude", "Copilot", "ChatGPT"]

#### research_query

Recherche-Anfrage

- **Timeout:** 180s | **Retries:** 3 | **Priority:** 70
- **Applicable Partners:** ["Perplexity", "Claude", "Gemini"]

### transfer

#### request

Import-Anfrage an Partner

- **Timeout:** 60s | **Retries:** 3 | **Priority:** 50

#### transfer

Datenuebertragung zwischen Partnern

- **Timeout:** 60s | **Retries:** 3 | **Priority:** 50



---

## 8. Workflows


# BACH Workflows

Automatisch generiert aus dem Dateisystem (skills/workflows/).
Letzte Aktualisierung: 2026-02-22 13:53

**Total:** 29 Workflows

## Analysis

### Workflow: Dokumenten-Anforderungsanalyse

**Version:** 1.2.0

**Datei:** `skills/workflows/analysis\docs-analyse.md`

### Workflow: Help-Expert-Review

**Version:** 1.4.0

**Datei:** `skills/workflows/analysis\help-expert-review.md`

### Workflow: Help-Forensik

**Version:** 1.0.0

**Datei:** `skills/workflows/analysis\help-forensic.md`

### Skill-Abdeckungsanalyse Workflow

**Zweck:** Systematische Analyse der BACH Skill-Abdeckung im Vergleich zu Industrie-Standards.

**Datei:** `skills/workflows/analysis\skill-abdeckungsanalyse.md`

### Workflow: Wiki-Autoren

**Version:** 2.0.0

**Datei:** `skills/workflows/analysis\wiki-author.md`

## Dev

### Bugfix-Protokoll für Python/PyQt6 Projekte

> **Ziel:** Systematisches Vorgehen bei Bugs, um Zeit zu sparen und bekannte Probleme schnell zu erkennen.

**Datei:** `skills/workflows/dev\bugfix-protokoll.md`

### CLI-Änderungs-Checkliste

**Version:** 1.0

**Datei:** `skills/workflows/dev\cli-aenderung-checkliste.md`

### BACH Entwicklungszyklus (Dev-Zyklus)

> **Ziel:** Strukturierter Ablauf von Feature-Wunsch bis validiertem System.

**Datei:** `skills/workflows/dev\dev-zyklus.md`

### Workflow: Datei-Umbenennung mit Wrapper (Evolutionaere Migration)

**Version:** 1.0.0

**Datei:** `skills/workflows/dev\migrate-rename.md`

### MCP Server Release Protokoll (NPM + GitHub)

> **Ziel:** Strukturierter Ablauf fuer das Veroeffentlichen von BACH MCP Servern auf GitHub und NPM.

**Datei:** `skills/workflows/dev\npm-mcp-publish.md`

### Workflow: Ordner-Flattening

Ziel: Verschachtelte Ordnerstrukturen in eine flache, maschinenlesbare Struktur überführen.

**Datei:** `skills/workflows/dev\ordner-flattening.md`

### Self-Extension Workflow

> **Ziel:** BACH autonome Selbsterweiterung durch KI-Partner (Claude, Gemini, etc.)

**Datei:** `skills/workflows/dev\self-extension.md`

### Service/Agent Validator Workflow

Qualitätsprüfung für neue Services, Agents und Experts im BACH-System.

**Datei:** `skills/workflows/dev\service-agent-validator.md`

## Integration

### Agent/Skill Finder Workflow

Finde den passenden Agenten, Experten oder Skill für eine Benutzeranfrage.

**Datei:** `skills/workflows/integration\agent-skill-finder.md`

### Gemini Delegation Workflow

> **Delegiere ressourcenintensive Tasks an Google Gemini**

**Datei:** `skills/workflows/integration\gemini-delegation.md`

### Google Drive Delegation Workflow - SKILL v1.0

Multi-AI Kollaboration via Google Drive als Shared Workspace.

**Datei:** `skills/workflows/integration\google-drive.md`

## System

### Claude-Bach-Vernetzung

name: claude-bach-vernetzung

**Datei:** `skills/workflows/system\claude-bach-vernetzung.md`

### Cross-System-Sync

name: cross-system-sync

**Datei:** `skills/workflows/system\cross-system-sync.md`

### System-Anschlussanalyse: Integration & Konsistenz

**Version:** 1.0

**Datei:** `skills/workflows/system\system-anschlussanalyse.md`

### System-Aufräumen: Wartung und Archivierung

**Version:** 1.0

**Datei:** `skills/workflows/system\system-aufraeumen.md`

### System-Mapping: Kartographie und Feature-Erfassung

**Version:** 1.0

**Datei:** `skills/workflows/system\system-mapping.md`

### System-Synopse: Vergleichende Analyse

**Version:** 1.0

**Datei:** `skills/workflows/system\system-synopse.md`

### System-Testverfahren: B/O/E-Tests

**Version:** 1.0

**Datei:** `skills/workflows/system\system-testverfahren.md`

### Trampelpfadanalyse & Schwarm-Verfahren (Elephant Path / Swarm Ops)

**Version:** 2.0

**Datei:** `skills/workflows/system\trampelpfadanalyse.md`

## Workflows

### Cv-Generierung

name: cv-generierung

**Datei:** `skills/workflows/cv-generierung.md`

### 🧠 Model-Switching Strategie V2

> **Version:** 2.0.0

**Datei:** `skills/workflows/ing-strategie.md`

### Standardaufnahmeverfahren für neue Software-Projekte

**Version:** 1.0

**Datei:** `skills/workflows/projekt-aufnahme.md`

### Synthese-Workflow: Neues System aus Best-of

**Version:** 1.0

**Datei:** `skills/workflows/synthese.md`

### Batch-Übersetzung mit Haiku (EN/DE/Multi-Language)

> **Ziel:** Systematische Übersetzung von BACH-Komponenten (help, wiki, skills) in mehrere Sprachen mit Claude Haiku (kostengünstig, schnell).

**Datei:** `skills/workflows/translate_haiku.md`



---

## 9. Anwendungsfaelle


# BACH Usecases

Automatisch generiert aus der Datenbank (usecases).
Letzte Aktualisierung: 2026-02-22 13:53

**Total:** 50 Usecases

## ASSISTENT

### ○ Charaktersheet ueber User pflegen ⭐⭐⭐⭐

Lernende Praeferenzen, Eigenheiten, Beduerfnisse des Users dokumentieren und beruecksichtigen.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

### ○ Dossier oder Briefing erstellen ⭐⭐⭐⭐

Vor Meetings: Person/Thema recherchieren und strukturiert aufbereiten.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

### ○ Kalender fuehren ⭐⭐⭐⭐

Termine, Aufgaben, Orte, Personen, Buchungen verwalten und aktuell halten.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

### ○ Tagesablauf-Briefing Morgens ⭐⭐⭐⭐

Termine des Tages, offene Themen, wichtige Briefings bei besonderen Terminen praesentieren.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

### ○ Location Restaurant Hotel suchen ⭐⭐

Orte mit Kontaktdaten und Oeffnungszeiten finden. Passende Locations vorschlagen.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 50/100

### ○ Reiseroute planen ⭐⭐

Zugverbindungen, Hotels suchen und zusammenstellen. Buchungslinks bereitstellen.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 50/100

## CARE-MODUL

### ○ Arzttermine und Erinnerungen verwalten ⭐⭐⭐⭐

Termine bei Aerzten speichern und auf Nachfrage zurueckgeben. Erinnerungsfunktion.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

### ○ Medikamentenplan aktuell halten ⭐⭐⭐⭐

Aktueller Medikationsplan aus Berichten + User-Korrektur. Name, Wirkstoff, Menge, Tageszeit, Wirkung.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

### ○ Vorsorgeplan verwalten ⭐⭐⭐⭐

Vorsorgeuntersuchungen mit Status tracken: Hautscreening, Zahnarzt, Impfungen, Blutuntersuchung, Check-Up.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

## DATENMODUL

### ○ Diagnosen und Hypothesen verwalten ⭐⭐⭐⭐

Diagnosen kategorisieren: gesichert/Verdacht/Hypothese/widerlegt mit Belegen. Belegsammlungen fuehren.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

### ○ Medikamentationsverlauf fuehren ⭐⭐⭐⭐

Medikamente tracken: Start, Ende, Dosierung, Grund, Wirkung, Nebenwirkungen ueber Zeit.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

### ○ Untersuchungsplan erstellen ⭐⭐⭐⭐

Ausstehende/empfohlene Diagnostik aus Diagnosen und Verdachtsdiagnosen ableiten. Priorisiert nach Wichtigkeit.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

### ○ Symptomabdeckung analysieren ⭐⭐

Welche Diagnosen erklaeren welche Symptome? Ueberschneidungen? Rest-Symptome ohne Erklaerung? Prozentsatz.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 50/100

### ○ Symptomverlauf dokumentieren ⭐⭐

Symptome ueber Zeit tracken: Auftreten, Verschwinden, Verbesserung, Verschlechterung. Aktiv/Inaktiv Status.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 50/100

## DOKUMENTENMODUL

### ○ Medizin-Dokumentenverzeichnis aktualisieren ⭐⭐⭐⭐

Neue PDFs erkennen, kategorisieren (Wissen/Patient), ins Verzeichnis aufnehmen. Pruefen ob Dokumente hinzugekommen oder geloescht wurden.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

## FINANZEN

### ○ Wiederkehrende jaehrliche Kosten planen ⭐⭐⭐⭐

Monatliche Uebersicht irregularer jaehrlicher Kosten (KFZ, TUeV, Uni, Versicherungen, Rundfunk). Quelle: Wiederkehrende Kosten Uebersicht.docx

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

## GESUNDHEIT

### ○ Medikamente Uebersicht fuehren ⭐⭐⭐⭐

Aktuelle Medikation mit Dosierung, Einnahmezeit, Wirkung. Aus Arztberichten extrahieren. Quelle: Medikamente Uebersicht.pdf

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

## HAUSHALT

### ○ Haushaltsaufgaben nach Turnus verwalten ⭐⭐⭐⭐⭐

Taeglich/woechentlich/monatlich/vierteljaehrlich/halbjaehrlich/jaehrlich - Aufgaben tracken mit Status zuletzt erledigt. Quelle: Haushaltsaufgaben von taeglich bis jaehrlich.docx

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

## KARRIERE

### ○ Berufsziele und Kernkomplexe verfolgen ⭐⭐⭐⭐

3 Kernkomplexe: Lerntherapie-Praxis, Lehramt Sonderpaedagogik, Software-Nebenerwerb. Qualifikationswege tracken. Quelle: Berufsziele_Kernkomplexe.docx

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

### ○ Fortbildungen und Selbststudium dokumentieren ⭐⭐⭐⭐

Weiterbildungen, Zertifikate, Kurse mit Datum und Status erfassen. Quelle: Dokumentation Fortbildungen.docx

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

## SELBSTMANAGEMENT

### ○ ADHS-Strategien anwenden ⭐⭐⭐⭐⭐

Wiederverwendbare Listen, Body Doubling, Planungsphase verkuerzen. Quelle: adhs strategien.docx

**Letzter Test:** 2026-02-06T14:53:52.135262 | **Score:** 100/100

### ○ Lebenskreise-Bereiche Balance pruefen ⭐⭐⭐⭐

7 Lebensbereiche mit Aktivitaeten-Pool. Rotation statt Ueberforderung. Beruf vs Hobby Zuordnung. Quelle: Lebenskreise_Bereiche.docx

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

## SOFTWARE

### ○ FormBuilder Formulare erstellen ⭐⭐⭐⭐⭐

Mit A3 FormBuilder Formulare erstellen und exportieren.

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

### ○ HausLagerist Datenbank auslesen ⭐⭐⭐⭐⭐

Datenbank hauslagerist.db auslesen: Haushaltsgegenstaende, Lagerort, Inventar.

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

### ○ MediPlaner Datenbank nutzen ⭐⭐⭐⭐⭐

mediplaner.db auslesen: Medikamentenplaene, Einnahmezeiten, Dosierungen.

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

### ○ ProFiler Wissen indizieren ⭐⭐⭐⭐⭐

ProFiler komplett integrieren: PDFs scannen, OCR, Wissensindizierung, Datenbanken erstellen und nutzen.

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

### ○ RPG-Agent Spielleitung fuehren ⭐⭐⭐⭐⭐

RPG integrieren: Als Spielleiter in Rollenspielen fungieren, Welten verwalten, Sessions leiten.

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

### ○ MasterRoutine Datenbank nutzen ⭐⭐⭐⭐

routine_master.db auslesen: Routinen, Aufgaben, Turnus-basierte Erinnerungen.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

### ○ MetaWiki erstellen und exportieren ⭐⭐⭐

MetaWiki-Struktur (hierarchische Markdown-Wikis) erstellen und als Funktion in BACH exportieren.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 70/100

### ○ FinancialProof Dashboard integrieren ⭐⭐

Finanz-Analyse App mit KI-Tiefenanalysen (ARIMA, Monte Carlo, ML) als Dashboard im Finanzagenten bereitstellen.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 50/100

### ○ MediaBrain Datenbank nutzen ⭐⭐

media_brain.db auslesen: Medien-Sammlung, Kategorien, Metadaten.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 50/100

## THERAPIE

### ○ Arbeitsblaetter fuer Autismus-Foerderung erstellen ⭐⭐⭐

Aus Wissensdatenbank recherchieren, nach Klientenbeschreibung spezifische Arbeitsblaetter und Uebungen generieren.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 70/100

### ○ Arbeitsblaetter fuer psychologische Beratung erstellen ⭐⭐⭐

Wissen aus Datenbank fuer Beratung nutzen, Uebungen und Arbeitsblaetter erstellen.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 70/100

## WISSEN

### ○ Wissensdatenbank navigieren und nutzen ⭐⭐⭐⭐

Wissen aus Wissensdatenbank-Ordner abrufen, strukturieren, verknuepfen.

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

## docs-analyse

### ○ ASCII Lebenslauf erstellen ⭐⭐⭐⭐⭐

Claude erstelle mir einen aktuellen textbasierten ASCII Lebenslauf aus meinen Arbeitgeber-Dokumenten

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

### ○ Aerzte-Kontakte exportieren ⭐⭐⭐⭐⭐

Claude gib mir einen uebersichtlichen Textauszug aller Telefon und Mailadressen meiner hinterlegten Aerzte

**Letzter Test:** 2026-02-06T14:54:07.470400 | **Score:** 100/100

### ○ Wichtiges Dokument suchen ⭐⭐⭐⭐⭐

Claude suche mir das Dokument heraus indem meine Steuernummer steht

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

### ○ Arztberichte zusammenfassen ⭐⭐⭐⭐

Claude lese alle Berichte zum Thema Schilddruese. Gib mir ein Verzeichnis (Name, Fachrichtung, Arzt, Kontakt, Befund) und fasse zusammen

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

### ○ Meine Versicherungen auflisten ⭐⭐⭐⭐

Liste meiner abgeschlossenen Versicherungen mit Police, Tarif, Kosten, Kontakt, Abdeckungsanalyse

**Letzter Test:** 2026-02-21 22:53:52 | **Score:** 80/100

### ○ Versicherungs-Verzeichnis abfragen ⭐⭐⭐⭐

Was fuer Versicherungen gibt es? Regeln wann sinnvoll? Tabelle mit Uebersicht

**Letzter Test:** 2026-02-21 22:53:52 | **Score:** 80/100

### ○ Versicherungsberatung ⭐⭐⭐⭐

Claude sollte ich eine bestimmte Versicherung abschliessen? Analyse basierend auf vorhandenen Policen

**Letzter Test:** 2026-02-21 22:53:52 | **Score:** 80/100

## ordner-flattening

### ○ Office Lens Auto-Kategorisierung ⭐⭐⭐⭐

Automatisch neu fotografierte und hochgeladene Dokumente scannen, kategorisieren und auf Dateisystem oder User in BACH verteilen

**Letzter Test:** 2026-02-21 22:36:11 | **Score:** 80/100

## reflection_status

### ○ Reflection Status 

bach reflection status zeigt Performance-Report

**Letzter Test:** 2026-02-21T05:53:30.950266 | **Score:** 0/100

## system-synopse

### ○ Abo-Abgleich mit Mails ⭐⭐⭐⭐⭐

Vergleiche erkannte Financial-Mails mit hinterlegten Abos. Zeige Differenzen

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

### ○ Abo-Status aendern ⭐⭐⭐⭐⭐

Claude stelle Abo 1,3,5 auf inaktiv und 2 auf aktiv. Zeige erwartete Monatskosten

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

### ○ Abo-Uebersicht anzeigen ⭐⭐⭐⭐⭐

Claude gib mir eine Uebersicht meiner Abos und wiederkehrenden Kosten mit aktuellem Status

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

### ○ Irregulaere Kosten Vorschau ⭐⭐

Finanzagent bitte gib mir eine Uebersicht welche irregulaeren Kosten koennten mich naechsten Monat erwarten?

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 50/100

## system-testverfahren

### ○ Aufgaben als erledigt markieren ⭐⭐⭐⭐⭐

Aufgabe 1, 4, 5 habe ich erledigt - aktualisiere die Datenbank

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

### ○ Haushalts-Routine abfragen ⭐⭐⭐⭐⭐

Claude muss ich meine Bettwaesche wechseln? (Routine-Check basierend auf Turnus)

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100

### ○ Wochen-Aufgaben abfragen ⭐⭐⭐⭐⭐

Claude welche Aufgaben stehen diese Woche noch an? (aus Routinen: taeglich, woechentlich, monatlich)

**Letzter Test:** 2026-02-06 08:13:06 | **Score:** 100/100



---

## 10. Sicherheit


# Security Policy

## Reporting a Vulnerability

If you find a security vulnerability in BACH, please report it responsibly:

1. **Do NOT open a public issue**
2. Email: [tbd@example.com] or use GitHub's private vulnerability reporting
3. Include: description, steps to reproduce, potential impact

## Scope

BACH runs locally. The main attack surface is:
- Bridge/Connector endpoints (Telegram, Discord, etc.)
- GUI web server (FastAPI, localhost only by default)
- File system access (bach.db, user data)
- MCP server (localhost only)

## Response

As a solo project, response times may vary. Critical issues will be
prioritized. Please allow reasonable time before public disclosure.



---

## 11. Mitwirken


# Contributing to BACH

BACH is maintained as part of the ellmos project family. Contributions are welcome
but there's no guarantee of response time.

## How to contribute

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/my-feature`)
3. Make your changes
4. Run tests (`bach test` or `python -m pytest`)
5. Commit with clear message
6. Open a Pull Request

## Guidelines

- Keep changes focused (one feature/fix per PR)
- Follow existing code style (Python, PEP8-ish)
- Add/update tests if applicable
- Update docs if behavior changes
- Don't break existing functionality

## What gets merged?

- Bug fixes: Almost always welcome
- New features: Open an Issue first to discuss
- Refactoring: Only if it clearly improves something
- New agents/skills: Very welcome as separate modules

## What won't get merged?

- Breaking changes without discussion
- Large refactors without prior agreement
- Features that add complexity without clear benefit
- Changes to CORE (dist_type=2) without good reason

---

> **BACH is a personal project.** It's maintained by one person in their free time.
> There's no support team, no SLA, no guaranteed response time.
> If you like it, use it. If you want to improve it, contribute.
> If it doesn't fit your needs, fork it and make it yours.



---

## 12. Aenderungsprotokoll


# BACH Changelog

**Aktuelle Version:** unknown
**Generiert:** Automatisch aus dist_file_versions (Delta-Modus)

## Übersicht

Dieses Changelog zeigt **Änderungen** zwischen Versionen (Delta), nicht alle Dateien.

### Legende

- 🔴 **CORE** (dist_type=2) - Kernel-Dateien, kritisch für BACH
- 🟡 **TEMPLATE** (dist_type=1) - Anpassbare Vorlagen
- ⚪ **USER** (dist_type=0) - Benutzerdaten

---

## Versionshistorie

### v3.1.6

**Änderungen:** 234 Dateien (233 geändert, 1 hinzugefügt, 0 entfernt)

#### Geändert (233):

- ⚪ `AGENTS.md` (60d0df76) ← (3f3eb7b5)
- ⚪ `CHAINS.md` (aab8bef5) ← (23a1b56b)
- 🟡 `CHANGELOG.md` (425c2252) ← (d893d280)
- 🟡 `CLAUDE.md` (20411eca) ← (fa4ad3be)
- 🟡 `GEMINI.md` (13079ed6) ← (2ed4b7f2)
- 🟡 `MEMORY.md` (cfd45923) ← (590d73c2)
- 🟡 `OLLAMA.md` (c0dd177a) ← (1248ac62)
- ⚪ `PARTNERS.md` (85035efd) ← (04790b75)
- 🟡 `QUICKSTART.md` (7c6f80ff) ← (b66e6e14)
- 🟡 `QUICKSTART.pdf` (61166b3a) ← (60961281)
- 🟡 `README.md` (3e365688) ← (63bcfe1d)
- 🟡 `SKILLS.md` (04878ebf) ← (e72ed587)
- ⚪ `USECASES.md` (5a1692ba) ← (46d39315)
- ⚪ `WORKFLOWS.md` (c9f972ea) ← (82df479d)
- 🔴 `bach.py` (7c8fed1c) ← (7f0eeb88)
- ... und 218 weitere geänderte Dateien

#### Hinzugefügt (1):

- 🔴 `system/tools/memory_working_cleanup.py` (a3bb8be4)

---

### v3.1.3

**Änderungen:** 5 Dateien (5 geändert, 0 hinzugefügt, 0 entfernt)

#### Geändert (5):

- 🔴 `bach.py` (7f0eeb88) ← (3bf7277f)
- ⚪ `system/data/bach.db` (80157bad) ← (3e70d643)
- 🔴 `system/hub/pipeline.py` (03b25825) ← (5fe1f95f)
- 🔴 `system/hub/reflection.py` (f57b113a) ← (39efc250)
- 🔴 `system/tools/rezeptbuch.py` (e396a942) ← (a0f84b48)

---

### v3.1.2

**Änderungen:** 229 Dateien (228 geändert, 0 hinzugefügt, 1 entfernt)

#### Geändert (228):

- 🔴 `bach.py` (3bf7277f) ← (b30130f2)
- ⚪ `system/data/bach.db` (3e70d643) ← (87ece3f3)
- 🔴 `system/hub/_services/claude_bridge/__init__.py` (2e956ba8) ← (b7be3d17)
- 🔴 `system/hub/_services/claude_bridge/bridge_daemon.py` (a1ad98e6) ← (6c0dfa37)
- 🔴 `system/hub/_services/claude_bridge/bridge_fackel_wrapper.py` (346055ce) ← (c00c3ab2)
- 🔴 `system/hub/_services/claude_bridge/bridge_tray.py` (cd0dc7da) ← (4c0c6fdd)
- 🔴 `system/hub/_services/claude_bridge/fackel.py` (a0afb919) ← (3fc9b8c4)
- 🔴 `system/hub/_services/claude_bridge/security.py` (89e33e67) ← (64b64275)
- 🔴 `system/hub/_services/claude_bridge/setup_wizard.py` (6420f2ca) ← (d791aacc)
- 🔴 `system/hub/_services/claude_bridge/skill_loader.py` (3f6b89ce) ← (276ea6e2)
- 🔴 `system/hub/_services/claude_bridge/telegram_test.py` (9384707e) ← (2889cb4d)
- 🔴 `system/hub/_services/claude_bridge/test_skills_load.py` (b18a4e8a) ← (42dfd379)
- 🔴 `system/hub/_services/config.py` (ccf8828b) ← (b0343825)
- 🔴 `system/hub/_services/connector/__init__.py` (1b58d7e9) ← (334db53d)
- 🔴 `system/hub/_services/connector/queue_processor.py` (ad148b2d) ← (24646c15)
- ... und 213 weitere geänderte Dateien

#### Entfernt (1):

- 🔴 `system/tools/memory_working_cleanup.py` (2a330fe7)

---

### v2.6.0

**Änderungen:** 676 Dateien (0 geändert, 676 hinzugefügt, 0 entfernt)

#### Hinzugefügt (676):

- 🔴 `bach.py` (b30130f2)
- 🟡 `USER.md` (pending-)
- ⚪ `AGENTS.md` (8f8f8a52)
- ⚪ `CHAINS.md` (7e9f44bd)
- 🟡 `CHANGELOG.md` (f652adf7)
- 🟡 `CLAUDE.md` (b010d924)
- 🟡 `CONTRIBUTING.md` (f4c34afd)
- 🟡 `GEMINI.md` (e8ff0089)
- 🔴 `LICENSE` (9697c9d5)
- 🟡 `MEMORY.md` (b80b1262)
- 🟡 `OLLAMA.md` (6e25f14f)
- ⚪ `PARTNERS.md` (82303b39)
- 🟡 `QUICKSTART.md` (b66e6e14)
- 🟡 `QUICKSTART.pdf` (8fc97569)
- 🟡 `README.md` (d9915533)
- ... und 661 weitere hinzugefügte Dateien

---


## Format

Jeder Eintrag zeigt **Delta-Änderungen** seit der vorherigen Version:

- **Geändert**: Dateien mit neuem Hash (alter Hash → neuer Hash)
- **Hinzugefügt**: Neue Dateien in dieser Version
- **Entfernt**: Dateien die aus dieser Version entfernt wurden
- **Icon**: Dist-Type (CORE/TEMPLATE/USER)
- **Hash**: Kurz-Hash (erste 8 Zeichen)

## Vollständige Historie

Für vollständige Versionshistorie siehe `dist_file_versions` Tabelle:

```bash
bach db query "SELECT * FROM dist_file_versions ORDER BY version DESC"
```

---

*Generiert mit `bach docs generate changelog` (Delta-Modus seit v3.1.6)*



---

## 13. Lizenzen


# BACH - Third-Party Licenses
<!-- AUTO-GENERATED via SQ034 (2026-02-18) - update when dependencies change -->

This document lists all third-party Python packages used by BACH,
their versions (as tested), and their respective licenses.

> **SQ072/ENT-32 (2026-02-19):** PyMuPDF (fitz) wurde als Core-Dependency entfernt.
> Core PDF-Lesen nutzt jetzt pypdf (MIT) + pdfplumber (MIT).
> PyMuPDF bleibt als OPTIONALE Dependency fuer: PDF-Rendering fuer OCR,
> PDF-Schwaerzung (_vendor/), Redaction-Erkennung.
> Steuer-Agent-Dateien (dist_type=0) sind nicht Teil des Release.
> Damit ist BACH als MIT-Projekt publizierbar ohne AGPL-Infizierung durch PyMuPDF.

---

## Core Dependencies

| Package | Version | License | Notes |
|---------|---------|---------|-------|
| `requests` | 2.32.5 | Apache-2.0 | HTTP client |
| `httpx` | 0.28.1 | BSD-3-Clause | Async HTTP |
| `aiohttp` | 3.13.0 | Apache-2.0 AND MIT | Async HTTP sessions |
| `PyYAML` | 6.0.2 | MIT | YAML parsing |
| `toml` | 0.10.2 | MIT | TOML parsing |
| `python-dotenv` | 1.2.1 | BSD (see metadata) | .env file loading |
| `pydantic` | 2.12.5 | MIT (see metadata) | Data validation |
| `xmltodict` | 1.0.2 | MIT | XML ↔ dict |
| `defusedxml` | 0.7.1 | PSFL (Python SF License) | Secure XML parsing |
| `lxml` | 6.0.0 | BSD-3-Clause | XML/HTML processing |
| `emoji` | 2.15.0 | BSD | Emoji handling |
| `ftfy` | 6.3.1 | Apache-2.0 | Unicode/encoding repair |
| `rapidfuzz` | 3.14.3 | MIT (see metadata) | Fuzzy string matching |
| `markdown` | 3.10 | BSD (see metadata) | Markdown → HTML |
| `watchdog` | 6.0.0 | Apache-2.0 | File system monitoring |
| `psutil` | 7.0.0 | BSD-3-Clause | System/process info |
| `GitPython` | 3.1.46 | BSD-3-Clause | Git operations |
| `colorama` | 0.4.6 | BSD | ANSI terminal colors |
| `rich` | 14.2.0 | MIT | Rich terminal output |
| `click` | 8.2.1 | BSD (see metadata) | CLI argument parsing |
| `typer` | 0.21.1 | MIT (see metadata) | Typed CLI building |
| `tqdm` | 4.67.1 | MPL-2.0 AND MIT | Progress bars |
| `cryptography` | 45.0.5 | Apache-2.0 OR BSD-3-Clause | Encryption |
| `keyring` | 25.7.0 | MIT (see metadata) | OS keychain |
| `peewee` | 3.19.0 | MIT (see metadata) | Lightweight ORM |
| `pypdf` | 6.4.0 | MIT (see metadata) | PDF text extraction (core, replaces PyMuPDF for reading) |
| `pdfplumber` | 0.11.7 | MIT | PDF text/table extraction (core, fallback after pypdf) |
| `pikepdf` | 10.0.2 | MPL-2.0 (see metadata) | PDF low-level editing |
| `pyperclip` | 1.9.0 | BSD | Clipboard access |
| `pyautogui` | 0.9.54 | BSD | GUI automation |

---

## Optional Dependencies

### Document Processing

| Package | Version | License | Notes |
|---------|---------|---------|-------|
| `PyMuPDF` | 1.26.4 | **AGPL-3.0 OR Commercial** | ⚠️ OPTIONAL: PDF render/redact/OCR-render (fitz). SQ072/ENT-32: Core PDF reading replaced by pypdf+pdfplumber. Install only for OCR-rendering or redaction features. |
| `extract_msg` | 0.55.0 | **GPL** | ⚠️ OPTIONAL: Parse .msg Outlook files (report_generator). SQ072/ENT-32: Moved to optional due to GPL incompatibility with MIT. Install only if you need Outlook .msg parsing. |
| `pdf2image` | 1.17.0 | MIT | PDF → image (requires poppler) |
| `reportlab` | 4.4.5 | BSD | PDF generation |
| `fpdf2` | 2.8.3 | **LGPL-3.0** | Lightweight PDF creation |
| `weasyprint` | 68.1 | BSD | HTML/CSS → PDF |
| `Pillow` | 10.4.0 | HPND (PIL License) | Image processing |
| `pytesseract` | 0.3.13 | Apache-2.0 | OCR wrapper |
| `python-docx` | 1.2.0 | MIT | Word .docx files |
| `python-pptx` | 1.0.2 | MIT | PowerPoint .pptx files |
| `openpyxl` | 3.1.5 | MIT | Excel .xlsx files |

### AI / LLM Partners

| Package | Version | License | Notes |
|---------|---------|---------|-------|
| `anthropic` | 0.79.0 | MIT | Claude API (primary LLM) |
| `ollama` | 0.6.1 | MIT (see metadata) | Ollama local LLM |
| `openai-whisper` | 20250625 | MIT | Speech-to-text (Whisper) |

### Data Analysis / Market

| Package | Version | License | Notes |
|---------|---------|---------|-------|
| `numpy` | 2.3.1 | BSD | Numerical computing |
| `pandas` | 2.3.1 | BSD | Data analysis |
| `scipy` | 1.16.0 | BSD | Scientific computing |
| `matplotlib` | 3.10.6 | PSF License | Plotting |
| `yfinance` | 1.0 | Apache | Yahoo Finance data |

### Vector Database / RAG

| Package | Version | License | Notes |
|---------|---------|---------|-------|
| `chromadb` | 1.4.1 | Apache-2.0 | Embedded vector DB |

### GUI / Web Server

| Package | Version | License | Notes |
|---------|---------|---------|-------|
| `PyQt6` | 6.10.0 | GPL-3.0 (see metadata) | ⚠️ Qt GUI framework |
| `fastapi` | 0.128.0 | MIT (see metadata) | Web API framework |
| `uvicorn` | 0.40.0 | BSD (see metadata) | ASGI server |
| `starlette` | 0.50.0 | BSD (see metadata) | ASGI framework |
| `pystray` | 0.19.5 | LGPL-3.0 | System tray icon |
| `tkinterdnd2` | 0.4.3 | MIT | Drag & drop (Tk) |
| `selenium` | 4.38.0 | Apache-2.0 | Browser automation |

### Google Services

| Package | Version | License | Notes |
|---------|---------|---------|-------|
| `google-api-python-client` | 2.187.0 | Apache-2.0 | Google APIs |
| `google-auth-oauthlib` | 1.2.3 | Apache-2.0 | Google OAuth2 |

### Voice / Audio

| Package | Version | License | Notes |
|---------|---------|---------|-------|
| `pyttsx3` | 2.99 | MIT (see metadata) | Text-to-speech |

### Windows-Specific

| Package | Version | License | Notes |
|---------|---------|---------|-------|
| `pywin32` | 311 | PSF | Windows COM/API |

### Development / Testing

| Package | Version | License | Notes |
|---------|---------|---------|-------|
| `pytest` | 9.0.2 | MIT (see metadata) | Test runner |

---

## Packages Referenced But Not Installed

These are referenced in the source code but not currently installed
(planned integrations, optional features, or legacy code):

| Import name | PyPI package | Notes |
|-------------|-------------|-------|
| `fitz` | PyMuPDF | Already listed above (different import name) |
| `sklearn` | `scikit-learn` | ML market analysis models |
| `tensorflow` | `tensorflow` | Neural network (market analysis) |
| `statsmodels` | `statsmodels` | Statistical models (market analysis) |
| `playwright` | `playwright` | Web automation (testing examples only) |
| `html2text` | `html2text` | HTML → Markdown (web parse) |
| `croniter` | `croniter` | Cron expressions (GUI scheduler) |
| `google` | `google-generativeai` | Gemini API (planned) |
| `mcp` | `mcp` | MCP SDK (tools/mcp_server.py) |
| `pyaudio` | `pyaudio` | Audio I/O (voice STT) |
| `vosk` | `vosk` | Offline speech recognition |
| `openwakeword` | `openWakeWord` | Wake word detection |
| `piper` | `piper-tts` | Neural TTS (voice) |
| `whisper` | `openai-whisper` | Already listed above |
| `telegram` | `python-telegram-bot` | Telegram connector |
| `textract` | `textract` | Document text extraction |

---

## ⚠️ License Compatibility Notes

Critical items requiring attention before public release:

1. **PyMuPDF (AGPL-3.0):** ✅ RESOLVED by SQ072 (2026-02-19). Core PDF-Lesen
   migriert zu pypdf+pdfplumber (MIT). PyMuPDF ist jetzt NUR optional fuer
   Spezial-Features (OCR-Rendering, Schwaerzung). Steuer-Expert-Dateien
   (dist_type=0) sind vom Release ausgenommen. AGPL-Infizierung des
   MIT-Release ist damit beseitigt.

2. **extract_msg (GPL):** Used in 2 files for .msg email parsing.
   GPL is similarly restrictive. Can be made optional (only install
   if .msg parsing is needed).

3. **PyQt6 (GPL-3.0):** Used only in `gui/prompt_manager.py` and
   `pdf_schwaerzer_pro.py`. Both are optional/tool components.
   Can be classified as optional.

4. **fpdf2 (LGPL-3.0):** LGPL allows linking from non-GPL code
   without copyleft propagation. Generally compatible.

5. **pystray (LGPL-3.0):** Same as fpdf2, generally compatible.

**Recommended BACH license given the above:**
If retaining PyMuPDF and PyQt6: **GPL-3.0 or AGPL-3.0**
If replacing/making optional: **MIT or Apache-2.0** (preferred for open source)

---

*Generated: 2026-02-18 | BACH v2.6.0 (Vanilla) | Python 3.12*
*To regenerate: python BACH_Dev/tools/scan_imports.py (SQ034)*
