Extension · moselwal/ai-workflows

ai-workflows — KI-Pipelines als YAML, nicht als Custom-Code.

Mehrstufige KI-Operationen als deklarative YAML-Pipelines: Steps, Bedingungen, Blocking/Resume, Expression-Resolution und pluggable Notifiers. Die Engine für alles, was nicht in eine einzelne Prompt passt — und nicht im Custom-PHP-Code verschwinden soll.

Composer-Repo einbinden →
Das Problem

Mehrstufige KI-Logik landet sonst verteilt im Code.

Mit ai-workflows

  • Workflow als YAML-Datei — versionierbar, reviewbar, kopierbar
  • Blocking-Steps für Human-in-the-Loop, sauber wiederaufnehmbar
  • Expression-Resolution für Inputs/Outputs zwischen Steps
  • Eigene Step-Typen registrierbar (extensible Step-Architektur)
  • Pluggable Notifiers (Slack/E-Mail/Webhooks)
  • DDD-Architektur mit deptrac-Enforcement

Bisher

  • KI-Multi-Step-Logik verteilt sich auf mehrere Custom-Klassen
  • Pausen/Reviews als Hand-Hack mit Status-Feldern
  • Keine Wiederverwendbarkeit zwischen Use Cases
  • Kein zentrales Tracing, keine Pipeline-Sicht

Vier Bausteine

Pluggable Notifiers

Eigene Notification-Provider (Slack, Teams, E-Mail, Webhook) über Interface registrierbar — zentrales Notify-Layer für alle Workflows.

Expression-Resolution

Outputs eines Steps stehen für nachfolgende Steps via Expression-Syntax zur Verfügung. Verzweigungen und Bedingungen ohne PHP-Code.

Blocking/Resume

Workflows können pausieren — z.B. für menschliche Freigabe — und sauber wiederaufgenommen werden, ohne State zu verlieren.

YAML-Workflows

Workflows als deklarative YAML-Files. Jeder Step hat einen Typ, Input/Output-Definition und optionale Bedingungen.

Installation: composer require moselwal/ai-workflows

TYPO3: 14.0+ · PHP: 8.2+ · Erforderlich: symfony/yaml · Optional: moselwal/content-intelligence, moselwal/semantic-delivery

Composer-Repository unter gitlab.moselwal.io einbinden, dann composer require moselwal/ai-workflows.

Architektur

Classes/
├── Domain/          # Value-Objects, Enums, Contracts (Interfaces)
├── Application/     # Orchestrierungs-Services
├── Infrastructure/  # Steps, Adapter, Persistenz
└── Presentation/    # Controller, Event-Listener

 

Layer-Abhängigkeiten werden über deptrac erzwungen — Domain hat null externe Abhängigkeiten, Application hängt nur an Domain, Infrastructure und Presentation dürfen Framework-Klassen verwenden.

Extension Points

  1. Interface in Domain/Contract/ definieren
  2. Implementierung in Infrastructure/ anlegen
  3. Auto-Discovery über _instanceof-Tags in der Services.yaml

Konfiguration & Abhängigkeiten

Workflows werden als YAML-Dateien definiert und über das TYPO3-Konfigurationssystem registriert. Jeder Workflow besteht aus geordneten Steps mit optionalen Bedingungen und Expressions.

Abhängigkeiten

PaketTypZweck
symfony/yamlRequiredYAML-Workflow-Parsing
moselwal/content-intelligenceOptionalAnbindung Content-Quality-Analyse
moselwal/semantic-deliveryOptionalAnbindung Multi-Channel-Delivery
moselwal/devDevGeteiltes QA-Tooling

Quellcode & Doku

TYPO3 Extension Repository

Nicht im offiziellen TER — Installation ausschließlich über Composer.

Composer-Package

moselwal/ai-workflows via Moselwal-Composer-Repo.

Composer-Repo öffnen

GitLab (Source of Truth)

Primäres Repository inkl. CI/CD und Composer-Package-Registry.

gitlab.moselwal.io

GitHub

Mirror auf GitHub (Platzhalter — vor Publish verifizieren).

github.com/moselwal/ai-workflows
Nächster Schritt

Erster Workflow zusammen aufsetzen?

ai-workflows ist Open Source. Wenn Sie den ersten produktiven Workflow gemeinsam mit uns aufsetzen wollen — inklusive Step-Typen, Notifier-Anbindung und Eval-Setup — sprechen Sie uns an.

Workflow-Begleitung anfragen →

Oder direkt schreiben: kontakt@moselwal.de