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

ENTWICKLUNGSMODUS (Dev-Zyklus)
==============================

BESCHREIBUNG
------------
BACH wird in einem 8-Phasen-Zyklus entwickelt. Jedes Feature durchläuft
den gleichen Ablauf: Von der Anforderung bis zum validierten Usecase.

DER ZYKLUS
----------

  Phase 1: Feature-Wünsche     Anforderungen funktional formulieren
  Phase 2: Ist-Stand prüfen    Was gibt es schon? Duplikate vermeiden
  Phase 3: Funktionale Planung  Workflows, Agenten, Experten, Skills, Services
  Phase 4: Functional Frontend  Skill-Dateien, Workflows, Agent-Profile erstellen
  Phase 5: Backend planen       CLI-Handler, DB-Schema, API-Endpoints
  Phase 6: Backend umsetzen     Python-Code, Tools, DB-Migrationen
  Phase 7: Technische Tests     B/O/E-Tests, Bugfix-Protokoll
  Phase 8: Usecases             End-to-End Validierung aus Nutzersicht

GRUNDPRINZIPIEN
---------------
  1. Systemisch First     Wiederverwendbar für jeden User
  2. CLI First            Alles über Terminal steuerbar
  3. dist_type Isolation  User-Daten getrennt (0/1/2/3)
  4. Functional First     Erst beschreiben, dann implementieren
  5. Usecases als Tests   Validierung UND Anforderungsquelle

DER KREISLAUF
-------------

  Usecases (Phase 8) generieren neue Anforderungen (Phase 1).
  Fehlgeschlagene Usecases werden zu Bugs oder Feature-Requests.
  Erfolgreiche Usecases validieren das System.

  Phase 8 -> Phase 1 -> Phase 2 -> ... -> Phase 8 (Kreislauf)

EBENEN DER PLANUNG (Phase 3)
-----------------------------

  Ebene      Frage                        Ort
  ---------  ---------------------------  -------------------------
  Workflow   WANN/WIE koordinieren?       skills/workflows/*.md
  Agent      WER führt aus?              agents/*.txt
  Experte    WER hat Fachwissen?          agents/_experts/*/
  Skill      WAS wird getan?              skills/_services/*.md
  Service    WIE technisch?               skills/_services/*/
  Tool       WOMIT wird gearbeitet?       tools/*.py

CHECKLISTE NEUER SERVICE (Phase 6)
-----------------------------------
  [ ] Funktioniert ohne User-Daten (leere DB)?
  [ ] CLI-Befehl vorhanden?
  [ ] Input aus Dateien/Ordnern?
  [ ] Output in strukturierte DB?
  [ ] dist_type automatisch gesetzt?
  [ ] Scan/Import wiederholbar (idempotent)?
  [ ] Kein Hardcoded-Pfad?
  [ ] Tool registriert?
  [ ] Help-Datei erstellt?

WORKFLOW-DATEI
--------------
  Detaillierter Ablauf: skills/workflows/dev-zyklus.md

SIEHE AUCH
----------
  bach --help usecase           Usecase-Dokumentation (Phase 8)
  bach --help test              Testverfahren (Phase 7)
  bach --help practices         Architektur-Prinzipien
  docs/_archive/WICHTIG_SYSTEMISCH_FIRST.md   Kernprinzip

---
Version: 1.0.0 | Erstellt: 2026-01-28
