# Portabilität: UNIVERSAL
# Version: 1.0.1
# Zuletzt validiert: 2026-02-08
# Nächste Prüfung: 2026-08-08

BACH DOKUMENTATION - Übersicht
================================

Zentrale Anlaufstelle für alle BACH-Dokumentation.

KERN-DOKUMENTE
--------------

Root-Ebene:
  SKILL.md              Master-Kontext, Identitaet, Verhaltensregeln
  README.md             Projekt-Übersicht

system/:
  ARCHITECTURE.md       Technische Architektur, Komponenten
  ROADMAP.md            Entwicklungsplan, Meilensteine
  CHANGELOG.md          Versionshistorie, Änderungen

HELP-SYSTEM (system/docs/help/)
--------------------------

Aufruf: python bach.py --help <topic>

KONZEPTE:
  --help core            Kern-Konzept (Agent/Workflow/Skills/Tools)
  --help memory          Memory-System (5 kognitive Typen + Lernkreislauf)
  --help injectors       Injektor-System (automatische Hinweise)
  --help consolidation   Konsolidierung (Komprimierung, Decay, Boost)
  --help startup         Startup-Protokoll

SYSTEM:
  --help tasks           Task-Management
  --help lessons         Lessons Learned System
  --help partner         Partner-System (Multi-LLM)
  --help daemon          Daemon-Service

ZEIT:
  --help clock           Uhrzeit-Anzeige
  --help timer           Stoppuhr
  --help countdown       Countdown mit Trigger
  --help between         Between-Checks
  --help beat            Unified Zeit-System

ENTWICKLUNG:
  --help dev             Entwicklungs-Workflow
  --help usecase         Usecase-Tests
  --help bugfix          Bugfix-Protokoll
  --help coding          Coding-Standards

VERZEICHNISSE:
  --help list            Alle verfügbaren Themen

FEATURES (seit v1.1.85):
  --help agent/<name>    Agent-Dokumente (z.B. --help agent/ati)
  --help workflow/<name> Workflow-Dokumente
  --help expert/<name>   Experten-Dokumente
  --help <tool_name>     Tool-Informationen aus DB

SKILLS-HIERARCHIE (system/skills/)
-----------------------------------

  agents/        Agent-Profile (Rollen)
  skills/workflows/     Workflow-Definitionen (22 Workflows)
  agents/_experts/       Experten-Konfigurationen
  skills/_services/      Service-Beschreibungen
  skills/_templates/     Vorlagen
  partners/      Partner-LLM Konfigurationen
  connectors/    Externe Verbindungen
  skills/_os/            OS-spezifische Konfigurationen

DOCS-ORDNER (docs/)
-------------------

  docs/                  Aktuelle Konzepte und Analysen
  docs/_archive/         Archivierte/erledigte Konzepte
  docs/_ideas/           Ideen für die Zukunft
  docs/_test_and_reports/ Test-Ergebnisse und Berichte
  docs/analyse/          Analytische Dokumente
  docs/reference/        Externe Referenzen (cookbooks, etc.)

CODE-DOKUMENTATION
------------------

  system/bach.py         Haupt-Entry-Point (v2.0 Registry-Based)
  system/bach_api.py     Library-API (task, memory, backup, etc.)
  system/core/           Kern-Module (registry, app, db, base)
  system/hub/*.py        Handler-Implementierungen (Auto-Discovery)
  system/tools/*.py      Tool-Scripts

DATENBANK-SCHEMA
----------------

  system/db/schema.sql   Vollständiges DB-Schema (210+ Tabellen)
  system/data/bach.db    SQLite-Datenbank

CLI-Zugriff:
  python bach.py --db schema       Zeigt DB-Schema
  python bach.py --db tables       Zeigt alle Tabellen

QUICK REFERENCE
---------------

  Was ist BACH?          --help wiki/was_ist_bach
  Wie starte ich?        --help startup
  Wie beende ich?        --help shutdown
  Task erstellen?        --help tasks
  Lesson speichern?      --help lessons
  Memory nutzen?         --help memory

DOKUMENTATIONS-HIERARCHIE
-------------------------

```
SKILL.md                 <- Master-Kontext (liest LLM immer)
    │
    ├── ARCHITECTURE.md  <- Technische Details
    │
    ├── docs/help/            <- Operative Anleitungen
    │   ├── core.txt     <- Kern-Konzept
    │   ├── memory.txt   <- Memory-System
    │   └── ...
    │
    ├── skills/          <- Funktionale Definitionen
    │   ├── _agents/
    │   ├── _workflows/
    │   └── ...
    │
    └── docs/            <- Konzepte, Analysen
        ├── CONCEPT_*.md
        └── archive/
```

HANDLER-ARCHITEKTUR
-------------------

Help Handler:      system/hub/help.py
  - Zeigt .txt Dateien aus system/docs/help/
  - Unterstützt Unterordner (tools/, wiki/)
  - Alias-System für agents, workflows, _experts
  - Tool-Direktzugriff aus DB (v1.1.38+)

Docs Handler:      system/hub/docs.py
  - Listet/durchsucht docs/ Ordner
  - Gruppiert nach KONZEPTE, ANALYSEN, SCHEMATA, SONSTIGE
  - Operationen: list, show, search

---
Version: 1.0.1 | Erstellt: 2026-01-30 | Aktualisiert: 2026-02-08
