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

HELP - Das BACH Hilfe-System
=============================

BESCHREIBUNG
Das help-System bietet kontextbezogene Dokumentation für alle BACH-Komponenten.
Jedes Thema hat eine eigene .txt Datei im docs/help/-Verzeichnis.

CLI-BEFEHLE
-----------
bach --help                 Alle verfügbaren Themen anzeigen
bach --help [thema]         Hilfe zu einem bestimmten Thema
bach --help tasks           Beispiel: Hilfe zum Task-System
bach --help steuer          Beispiel: Hilfe zum Steuer-Agenten
bach --help tools/name      Beispiel: Hilfe aus Unterordner
bach --help tool_name       Beispiel: Tool-Info aus Datenbank

VERFÜGBARE THEMEN
------------------
System:         startup, shutdown, architecture, features
Tasks:          tasks, between-tasks, planning, workflow
Memory:         memory, lessons, logs, sources
Agenten:        agents, actors, communicate, partners
Tools:          tools, maintain, backup, distribution
Daten:          dirscan, trash
GUI:            gui, wartung, prompt-generator, recurring
Spezial:        steuer, coding, bugfix, injectors
Extern:         vendor, cookbooks
Sonstiges:      identity, naming, practices, formats, emoji

STRUKTUR EINER HELP-DATEI
-------------------------
1. TITEL - Name in Grossbuchstaben
2. BESCHREIBUNG - Was macht diese Komponente?
3. CLI-BEFEHLE - Welche Befehle gibt es?
4. WEITERE SEKTIONEN - Konzepte, Beispiele, Tipps

NEUE HELP-DATEI ERSTELLEN
-------------------------
1. Datei unter docs/help/[thema].txt anlegen
2. Format von bestehender Datei übernehmen
3. Mindestens: Titel, Beschreibung, CLI-Befehle
4. Registrierung in bach --help automatisch

HELP-DATEIEN VS ANDERE DOCS
---------------------------
docs/help/*.txt      CLI-Referenz, schnelle Nachschau
skills/*.md     Agenten-Profile, komplexe Konzepte
docs/*.md       Entwickler-Dokumentation, Konzepte
SKILL.md        Haupt-Einstiegspunkt

BEST PRACTICES
--------------
- Kurz und praegnant halten (unter 100 Zeilen)
- CLI-Befehle immer zuerst dokumentieren
- Beispiele sind hilfreicher als Theorie
- Bei Änderungen: help-Datei mitaktualisieren

WIKI & ERWEITERUNGEN
--------------------
Das wiki/-Unterverzeichnis enthält erweiterte Dokumentation:
wiki/*.txt

Unterordner-Zugriff:
  bach --help tools/python_cli_editor
  bach --help wiki/antigravity

Tool-Datenbank-Zugriff (NEU v1.1.38):
  bach --help path_healer     Tool-Info aus bach.db
  bach --help tool_scanner    Zeigt Typ, Pfad, Capabilities

Skill-Aliase (NEU v1.1.85):
  bach --help agent/ati       Zeigt agents/ati/ATI.md
  bach --help workflow/bugfix Zeigt skills/workflows/bugfix-protokoll.md
  bach --help expert/steuer   Zeigt agents/_experts/steuer/STEUER.md

SIEHE AUCH
----------
bach --help tasks           Task-System
bach --help memory          Memory-System
bach --help agents          Agenten-System
SKILL.md                    Hauptdokumentation
