# Portabilität: UNIVERSAL
# Version: 1.0.0
# Zuletzt validiert: 2026-03-04

EXPORTS - DB-zu-Markdown Export-Scripts
=======================================

BESCHREIBUNG
============

BACH exportiert Datenbank-Inhalte als Markdown-Dateien für einfache
Lesbarkeit und Versionierung. Die Export-Scripts lesen aus bach.db und
erzeugen strukturierte .md-Dateien im data/-Verzeichnis. Zusätzlich
gibt es den Skill-Export für Standalone-Pakete.

Alle Scripts liegen in tools/ und sind direkt ausführbar.


ÜBERSICHT
==========

  Script                  Erzeugt                   Quelle (DB-Tabellen)
  ----------------------  ------------------------  -------------------------
  agents_export.py        data/AGENTS.md            agents, agent_synergies
  chains_export.py        data/CHAINS.md            toolchains (bach.db)
  partners_export.py      data/PARTNERS.md          delegation_rules,
                                                    partner_recognition
  workflows_export.py     data/WORKFLOWS.md         skills/workflows/ (Scan)
  usecases_export.py      data/USECASES.md          usecases (bach.db)
  skill_export.py         ZIP-Paket                 skills/ (Dateisystem)


EINZELBESCHREIBUNGEN
====================

AGENTS_EXPORT
-------------
Exportiert alle registrierten Agenten mit Synergien. Liest aus der
agents-Tabelle und agent_synergies, erzeugt eine formatierte Übersicht
mit Name, Typ, Status und Synergie-Beziehungen.

  python tools/agents_export.py
  Ausgabe: data/AGENTS.md

CHAINS_EXPORT
-------------
Exportiert Toolchains (verkettete Tool-Aufrufe). Liest aus der
toolchains-Tabelle, zeigt Ketten-Definition, Trigger und
Ausführungshistorie.

  python tools/chains_export.py
  Ausgabe: data/CHAINS.md

PARTNERS_EXPORT
---------------
Exportiert Multi-LLM-Partner-Konfiguration. Liest delegation_rules
und partner_recognition aus der DB. Zeigt Partner-Profile, Stärken,
Delegations-Regeln und Erkennungsmuster.

  python tools/partners_export.py
  Ausgabe: data/PARTNERS.md

WORKFLOWS_EXPORT
----------------
Scannt skills/workflows/ nach Workflow-Dateien (.md) und erstellt eine
Übersicht. Extrahiert Metadaten (Titel, Ziel, Schritte) per Regex
aus dem Dateiinhalt.

  python tools/workflows_export.py
  Ausgabe: data/WORKFLOWS.md

USECASES_EXPORT
---------------
Exportiert Use-Cases aus der usecases-Tabelle. Zeigt Szenario-Name,
Beschreibung, beteiligte Handler und Erfolgsquote.

  python tools/usecases_export.py
  Ausgabe: data/USECASES.md

SKILL_EXPORT
------------
Exportiert einen einzelnen Skill als Standalone-ZIP-Paket mit
Abhängigkeitsauflösung. Kopiert SKILL.md, Tools, Workflows und
erzeugt eine requirements.txt.

  python tools/skill_export.py <skill-name> [--output <pfad.zip>]
  Ausgabe: ZIP-Datei mit vollständiger Skill-Struktur

  Hinweis: Für umfangreichere Exports (Agent, OS) siehe exporter.py
  und builder.txt (bach help builder).


BEISPIELE
=========

# Alle DB-Exports auf einmal aktualisieren
python tools/agents_export.py
python tools/chains_export.py
python tools/partners_export.py
python tools/workflows_export.py
python tools/usecases_export.py

# Einzelnen Skill exportieren
python tools/skill_export.py recherche --output recherche_v1.zip

# Exportierte Markdown-Dateien prüfen
ls data/*.md


DATEIEN
=======

tools/agents_export.py      Agent-Export
tools/chains_export.py      Toolchain-Export
tools/partners_export.py    Partner-Export
tools/workflows_export.py   Workflow-Export
tools/usecases_export.py    Use-Case-Export
tools/skill_export.py       Skill-Standalone-Export

data/AGENTS.md              Generierte Agent-Übersicht
data/CHAINS.md              Generierte Toolchain-Übersicht
data/PARTNERS.md            Generierte Partner-Übersicht
data/WORKFLOWS.md           Generierte Workflow-Übersicht
data/USECASES.md            Generierte Use-Case-Übersicht


SIEHE AUCH
==========

builder          Skill/Agent-Erstellung & Export (bach help builder)
tools/exporter   Erweiterter Export: skill, agent, os-fresh, os-reset
dist             Distribution-System
sync             DB-Synchronisation (Dateien -> DB, umgekehrte Richtung)
