# BACH - Der kleine Fluss

> **B**est-of **A**us **CH**IAH, BATCH und RecludOS
> Ein textbasiertes Betriebssystem fuer KI-Agenten

```
     ╭─────────────────────────────────────────╮
     │                                         │
     │   ░█▀▄░█▀█░█▀▀░█░█                     │
     │   ░█▀▄░█▀█░█░░░█▀█                     │
     │   ░▀▀░░▀░▀░▀▀▀░▀░▀                     │
     │                                         │
     │   Textbasiertes OS fuer LLM-Agenten    │
     │                                         │
     ╰─────────────────────────────────────────╯
```

---

## Was ist BACH?

BACH ist ein **Framework fuer KI-Assistenten** wie Claude, Gemini oder lokale LLMs.
Es bietet Struktur, Gedaechtnis und Werkzeuge fuer produktive Zusammenarbeit.

```
  ┌─────────────────────────────────────────────────────────┐
  │                      NUTZER                              │
  │                        │                                 │
  │                        ▼                                 │
  │  ┌─────────────────────────────────────────────────┐    │
  │  │              BACH FRAMEWORK                      │    │
  │  │  ┌─────────┐  ┌─────────┐  ┌─────────┐         │    │
  │  │  │ Memory  │  │  Tasks  │  │  Help   │         │    │
  │  │  │ System  │  │ System  │  │ System  │         │    │
  │  │  └────┬────┘  └────┬────┘  └────┬────┘         │    │
  │  │       └────────────┴────────────┘               │    │
  │  │                    │                            │    │
  │  │              ┌─────┴─────┐                      │    │
  │  │              │  bach.db  │                      │    │
  │  │              │(SQLite DB)│                      │    │
  │  │              └───────────┘                      │    │
  │  └─────────────────────────────────────────────────┘    │
  │                        │                                 │
  │           ┌────────────┼────────────┐                   │
  │           ▼            ▼            ▼                   │
  │      ┌────────┐  ┌──────────┐  ┌─────────┐             │
  │      │ Claude │  │  Gemini  │  │ Ollama  │             │
  │      └────────┘  └──────────┘  └─────────┘             │
  │      └────────┘  └──────────┘  └─────────┘             │
  └─────────────────────────────────────────────────────────┘
```

---

## Schnellstart

### 1. Session starten
```bash
python bach.py --startup
```

### 2. Aufgabe bearbeiten
```bash
# Task erstellen
bach task add "Feature X implementieren"

# Hilfe holen
bach --help tasks
```

### 3. Session beenden
```bash
python bach.py --shutdown "Was gemacht wurde"
```

---

## Die wichtigsten Befehle

```
╔═══════════════════════════════════════════════════════════╗
║  BEFEHL                  │  BESCHREIBUNG                  ║
╠═══════════════════════════════════════════════════════════╣
║  bach --startup          │  Session starten               ║
║  bach --shutdown         │  Session beenden               ║
║  bach --status           │  Aktueller Systemstatus        ║
║  bach --help [thema]     │  Hilfe anzeigen                ║
╠───────────────────────────────────────────────────────────╣
║  bach task add "..."     │  Neue Aufgabe                  ║
║  bach task list          │  Alle Aufgaben                 ║
║  bach task done ID       │  Aufgabe erledigt              ║
╠───────────────────────────────────────────────────────────╣
║  bach mem write "..."    │  Notiz speichern               ║
║  bach mem read           │  Notizen lesen                 ║
║  bach --memory search    │  Durchsuchen                   ║
╠───────────────────────────────────────────────────────────╣
║  bach wiki list          │  Wiki-Artikel                  ║
║  bach backup create      │  Backup erstellen              ║
║  bach gui start          │  Web-Dashboard                 ║
╚═══════════════════════════════════════════════════════════╝
```

---

## Ordnerstruktur (fuer Menschen)

```
BACH/
│
├── 📄 bach.py              # Hauptprogramm
├── 📄 SKILL.md             # KI-Referenz (technisch)
├── 📄 ROADMAP.md           # Entwicklungsplan
│
├── 📁 data/
│   └── bach.db             # Zentrale Datenbank (SQLite)
│
├── 📁 docs/help/                # Dokumentation (fuer KI)
│   ├── *.txt               # Befehls-Dokumentation
│   └── wiki/               # Hintergrundwissen
│
├── 📁 user/                # DEIN Bereich
│   ├── README.md           # Diese Datei (MIGRIERT nach wiki/handbuch.txt)
│   ├── data-analysis/      # Datenanalyse-Projekte
│   └── steuer/             # Steuer-Verwaltung
│
├── 📁 skills/              # Agenten & Faehigkeiten
│   ├── _agents/            # KI-Agenten (z.B. ATI)
│   ├── _experts/           # Experten-Wissen
│   └── _workflows/         # Arbeitsablaeufe
│
└── 📁 docs/                # Entwickler-Dokumentation
    └── ARCHITECTURE.md     # System-Architektur
```

---

## Dokumentationssystem

BACH hat drei Ebenen der Dokumentation:

```
┌───────────────────────────────────────────────────────────┐
│  DOKUMENT           │  FUER WEN?     │  WO?              │
├───────────────────────────────────────────────────────────┤
│  user/README.md     │  Menschen      │  Diese Datei      │
│  (Bedienungsanleitung)               │                   │
├───────────────────────────────────────────────────────────┤
│  docs/ARCHITECTURE  │  Entwickler    │  docs/            │
│  (Systemaufbau)                      │                   │
├───────────────────────────────────────────────────────────┤
│  docs/help/*.txt         │  KI-Agenten    │  docs/help/            │
│  (Operative Befehle)                 │                   │
├───────────────────────────────────────────────────────────┤
│  wiki/*.txt    │  Alle          │  wiki/       │
│  (Hintergrundwissen)                 │                   │
└───────────────────────────────────────────────────────────┘
```

**Zugriff:**
```bash
bach --help <thema>      # Befehls-Hilfe
bach wiki <artikel>      # Hintergrundwissen
```

---

## Das Memory-System

BACH merkt sich Dinge - auch ueber Sessions hinweg:

```
┌─────────────────────────────────────────────────────────┐
│                    MEMORY SYSTEM                         │
├─────────────────────────────────────────────────────────┤
│                                                          │
│  ┌─────────────┐     Kurzzeit-Notizen                   │
│  │   Working   │     "Morgen Meeting um 10"             │
│  │   Memory    │     bach mem write "..."               │
│  └─────────────┘                                        │
│                                                          │
│  ┌─────────────┐     Dauerhafte Fakten                  │
│  │    Facts    │     "email:max@example.com"            │
│  │   Memory    │     bach --memory fact "..."           │
│  └─────────────┘                                        │
│                                                          │
│  ┌─────────────┐     Erkenntnisse & Loesungen           │
│  │   Lessons   │     "Encoding: UTF-8 verwenden"        │
│  │   Learned   │     bach lesson add "..."              │
│  └─────────────┘                                        │
│                                                          │
│  ┌─────────────┐     Session-Zusammenfassungen          │
│  │  Sessions   │     "2026-01-24: Feature X gebaut"     │
│  │  Archive    │     bach --memory sessions             │
│  └─────────────┘                                        │
│                                                          │
└─────────────────────────────────────────────────────────┘
```

---

## Typischer Arbeitsablauf

```
1. SESSION STARTEN
   ┌────────────────────────────────────────────┐
   │  $ bach --startup                          │
   │                                            │
   │  [TOKEN-ZONE]  Zone 1 (Safe)              │
   │  [MESSAGES]    2 neue Nachrichten          │
   │  [TASKS]       5 offene Tasks              │
   └────────────────────────────────────────────┘
                      │
                      ▼
2. AUFGABE WAEHLEN
   ┌────────────────────────────────────────────┐
   │  $ bach task list                          │
   │                                            │
   │  [42] P2 Feature X implementieren          │
   │  [43] P3 Bug in Y fixen                    │
   └────────────────────────────────────────────┘
                      │
                      ▼
3. ARBEITEN
   ┌────────────────────────────────────────────┐
   │  Code schreiben, testen, dokumentieren...  │
   │                                            │
   │  $ bach mem write "Loesung gefunden"       │
   │  $ bach --help <befehl>                    │
   └────────────────────────────────────────────┘
                      │
                      ▼
4. SESSION BEENDEN
   ┌────────────────────────────────────────────┐
   │  $ bach --shutdown "Feature X fertig"      │
   │                                            │
   │  [TASKS]     2 erstellt, 1 erledigt       │
   │  [SNAPSHOT]  Auto-Backup erstellt          │
   └────────────────────────────────────────────┘
```

---

## Partner-System

BACH kann mit anderen KI-Assistenten zusammenarbeiten:

```
┌─────────────────────────────────────────────────────────┐
│  PARTNER       │  STAERKE              │  BEFEHL        │
├─────────────────────────────────────────────────────────┤
│  Gemini        │  Web-Recherche        │  bach partner  │
│  Ollama        │  Lokal, Offline       │  delegate      │
│  Copilot       │  Code-Completion      │  --to <name>   │
│  Perplexity    │  Quellen-Suche        │                │
└─────────────────────────────────────────────────────────┘
```

---

## Hilfe bekommen

```bash
# Alle Hilfe-Themen anzeigen
bach --help list

# Hilfe zu einem Thema
bach --help tasks
bach --help memory
bach --help backup

# Wiki-Artikel (Hintergrundwissen)
bach wiki list
bach wiki icf
```

---

## Weiterführende Dokumentation

| Dokument | Beschreibung |
|----------|--------------|
| `docs/ARCHITECTURE.md` | Technische Systemarchitektur |
| `SKILL.md` | KI-optimierte Befehlsreferenz |
| `ROADMAP.md` | Entwicklungsplan |
| `CHANGELOG.md` | Aenderungshistorie |

---

## Entwickelt von

Ein Gemeinschaftsprojekt von Mensch und KI.

```
  "Ein Bach ist ein kleiner Fluss.
   Viele Baeche werden zu einem Strom."
```

---

*Version 1.1.50 | Stand: 2026-01-24*
*Migriert aus user/README.md*
