# Portabilität: UNIVERSAL
# Version: 2.0.0
# Zuletzt validiert: 2026-05-17
# Nächste Prüfung: 2026-11-17

ATI - Advanced Tool Integration Agent

ATI (Agent für Technische Implementierung) ist der Tool-Integrations-Agent
von BACH. ATI = BATCHI - BACH (das Delta, was BACH noch fehlt).
Er bietet Daemon-Steuerung, Session-Management, Task-Verwaltung, Scanner,
Projekt-Bootstrapping, Code-Analyse und Build-Automatisierung.

BEFEHLE - DAEMON & SESSIONS
===========================

bach ati status                   ATI-Status und Daemon-Info anzeigen
bach ati start                    Headless Session-Daemon starten
bach ati stop                     Session-Daemon stoppen
bach ati session                  Manuelle Session starten
bach ati session --dry-run        Session-Trockenlauf (keine Änderungen)

BEFEHLE - TASK MANAGEMENT
=========================

bach ati task list                ATI-Tasks anzeigen
bach ati task add "TITEL"         Neuen ATI-Task hinzufügen
bach ati task done ID             Task als erledigt markieren
bach ati task depends ID DEP      Abhängigkeit zwischen Tasks setzen
bach ati task blocked             Blockierte Tasks anzeigen
bach ati check                    Between-Task-Checkliste anzeigen
bach ati problems                 Problems First - Fehler priorisiert anzeigen
bach ati context KEYWORD          Kontext-Trigger testen

BEFEHLE - SCANNER
=================

bach ati scan                     Software-Projekte scannen
bach ati scan status              Letzten Scan-Status anzeigen
bach ati scan tasks               Gescannte Tasks anzeigen
bach ati onboard PATH             Neues Projekt onboarden

BEFEHLE - TOOLS & PFADE
=======================

bach ati path NAME                Pfad zu einem Tool anzeigen
bach ati path --list              Alle Tool-Pfade auflisten

BEFEHLE - EXPORT & INSTALL
==========================

bach ati export                   ATI-Agent als ZIP exportieren
bach ati export --dry-run         Export-Trockenlauf (zeigt was exportiert wird)
bach ati install PFAD.zip         ATI-Export installieren

BEFEHLE - PROJEKT-BOOTSTRAPPING
===============================

bach ati bootstrap NAME --template TYPE  Neues Projekt mit Template erstellen
bach ati bootstrap my-tool --template python-cli
bach ati bootstrap my-skill --template llm-skill

BEFEHLE - PROJEKT-MIGRATION
===========================

bach ati migrate PATH --analyze           Bestehendes Projekt analysieren
bach ati migrate PATH --template TYPE     Projekt auf Template migrieren
bach ati migrate my-project --dry-run     Trockenlauf (keine Änderungen)

BEFEHLE - MODULE
================

bach ati modules list             Verfügbare Module auflisten

TEMPLATES
=========

python-cli     Python CLI-Anwendung mit setuptools/pyproject.toml
               Struktur: src/, tests/, docs/, _modules/, _policies/

llm-skill      LLM Skill für BACH/Claude
               Struktur: SKILL.md, _config/, _data/, _docs/

llm-agent      LLM Agent
               Struktur: AGENT.md, _skills/, _tools/

WIEDERVERWENDBARE MODULE
========================

_modules/ und modules/
├── path_healer.py       Pfad-Selbstheilung (von RecludOS/VFDistiller)
├── distribution.py      Tier-System, Siegel, Release-Management (modules/)
├── encoding.py          UTF-8, BOM-Handling, Encoding-Korrektur (modules/)
└── validation.py        Schema-Validierung (geplant)

BACH-POLICIES
=============

_policies/
├── naming_convention.md    Dateinamen-Konventionen
├── encoding_policy.md      UTF-8 Standard, keine BOM
└── path_rules.json         Relative Pfade, keine Hardcoded-Pfade

BEISPIELE
=========

# Daemon starten und Status prüfen
bach ati start
bach ati status

# Tasks verwalten
bach ati task list
bach ati task add "Feature X implementieren"
bach ati task done 1

# Projekt scannen und onboarden
bach ati scan
bach ati onboard C:\Projekte\neues-tool

# Neues Python-CLI-Projekt erstellen
bach ati bootstrap rechnungs-tool --template python-cli

# Bestehendes Projekt analysieren
bach ati migrate C:\Projekte\altes-tool --analyze

# Projekt auf BACH-Struktur migrieren (Dry-Run)
bach ati migrate C:\Projekte\altes-tool --template python-cli --dry-run

# ATI exportieren und woanders installieren
bach ati export
bach ati install C:\Downloads\ati_export.zip

MIGRATION-WORKFLOW
==================

1. Analyse:   bach ati migrate PATH --analyze
              Zeigt: Compliance-Score, fehlende Verzeichnisse, Probleme

2. Dry-Run:   bach ati migrate PATH --template TYPE --dry-run
              Zeigt was passieren würde ohne Änderungen

3. Migration: bach ati migrate PATH --template TYPE
              Führt Migration aus (erstellt Backup automatisch)

4. Verify:    bach ati migrate PATH --analyze
              Prüft neuen Compliance-Score

HINWEISE
========

- ATI nutzt project_bootstrapper.py (agents/ati/tools/)
- Templates liegen in agents/ati/templates/
- Module liegen in agents/ati/_modules/ und modules/
- Policies liegen in agents/ati/_policies/
- Scanner liegen in agents/ati/scanner/
- Session-Daemon liegt in agents/ati/session/
- Export liegt in agents/ati/export/
- Onboarding liegt in agents/ati/onboarding/
- Daten liegen in data/ati/ und data/bach.db
- Dokumentation: agents/ati/ATI.md
- Bootstrapping-Konzept: agents/ati/ATI_PROJECT_BOOTSTRAPPING.md

VERWANDT
========

bach --help builder        Build-Skill für Projekte
bach --help distribution   Distribution-System
bach --help coding         Coding-Konventionen
bach --help maintain       Wartungs-Tools (Pfadheilung)
