AgenticWorkflow: Universelle Agentische Fähigkeit & Ausführungswerkzeugkette
Ein pluripotentes Stammzell-Framework und eine Multi-Agenten-Ausführungs-Engine, die komplexe Aufgaben in deterministische, selbstverifizierende autonome Workflows verwandelt.
Ausführungsinvariante
$$\text{Intent} \xrightarrow{\text{Recherche}} \text{Plan (SOT state.yaml)} \xrightarrow{\text{Implementierung}} \text{4-Schichten-Qualitätsgates} \xrightarrow{\text{pACS Delta}} \text{Verifiziertes Ergebnis}$$
⚡ Dynamischer Modus-Router
Erkenne den gewünschten Modus aus dem Kontext oder expliziten Flags:
| Modus | Auslösephrasen | Kernausführungsablauf |
|---|---|---|
| 1. DESIGN | "Workflow entwerfen", "neue Pipeline", "workflow.md" | Recherche → Planung → Implementierung 3-stufige Blaupausengenerierung |
| 2. EXECUTE | "Workflow ausführen", "Pipeline starten", "Schritt starten" | SOT-Zustandsmaschinentreiber mit schrittweiser Ergebnisgenerierung |
| 3. AUTOPILOT | "Autopilot", "vollautomatisch", "ohne Eingriff" | Automatische Genehmigung von (human)-Kontrollpunkten mit Entscheidungsprotokollen; Sicherheitshaken erzwingen |
| 4. ULW | "ulw", "ultrawork", "maximale Strenge" | 3 Verstärker: Sisyphus-Persistenz, obligatorische Zerlegung, Wiederholungseskalation |
| 5. VERIFY | "Schritt verifizieren", "Qualitätsgates", "pacs ausführen" | L0 Anti-Skip → L1 Verifikation → L1.5 pACS → L2 Adversarielle Überprüfung |
| 6. OPTIMIZE | "Workflow optimieren", "Zykluszeit reduzieren", "optimieren" | Schlanke Engpassanalyse, Automatisierungsbewertung, Zykluszeitkomprimierung |
3 Absolute Kriterien (Verfassungskanon)
Jeder Workflow, jedes Werkzeug und jeder Unteragent, der durch diese Fähigkeit erstellt oder gesteuert wird, erbt strikt die 3 Absoluten Kriterien:
- Absolutes Kriterium 1: Qualität des Endergebnisses
Geschwindigkeit, Token-Kosten, Arbeitsaufwand und Längenbeschränkungen werden völlig ignoriert. Das alleinige Kriterium für jede Entscheidung ist die Qualität des Endergebnisses.
- Absolutes Kriterium 2: Single-File SOT + Hierarchisches Gedächtnis
Der gesamte gemeinsame Zustand wird in einer einzigen Datei (
state.yaml) konzentriert. Die SOT-Schreibberechtigung gehört ausschließlich dem Orchestrator / Teamleiter. Parallele Agenten mutieren niemals gleichzeitig gemeinsame Dateien. - Absolutes Kriterium 3: Code-Änderungsprotokoll (CCP)
Vor dem Schreiben, Ändern, Hinzufügen oder Löschen von Code, intern ausführen: Schritt 1 (Absicht verstehen) → Schritt 2 (Auswirkungsanalyse) → Schritt 3 (Änderungsplan). Gesteuert durch Coding Anchor Points (CAP-1~4).
4-Schichten-Qualitätssicherungsstapel
flowchart TD
StepStart["Schritt-Ausführung"] --> L0["L0: Anti-Skip Physische Wächter (Datei existiert & >= 100 Bytes)"]
L0 -->|BESTANDEN| L1["L1: Verifikations-Gate (100% funktionale Zielerreichung)"]
L0 -->|FEHLGESCHLAGEN| Diag["Abduktive Diagnose"]
L1 -->|BESTANDEN| L15["L1.5: pACS Selbstbewertung (F/C/L Pre-Mortem Bewertung)"]
L1 -->|FEHLGESCHLAGEN| Diag
L15 -->|ROT: <50| Diag
L15 -->|GRÜN / GELB| L2["L2: Adversarielle Überprüfung (@reviewer + @fact-checker)"]
L2 -->|BESTANDEN| SOT["SOT fortschreiten (current_step + 1)"]
L2 -->|FEHLGESCHLAGEN| Diag
Diag --> Retry["Wiederholen mit alternativer Hypothese (Max 3)"]
- L0 Anti-Skip Guard: Überprüft deterministisch, ob das Ergebnis auf der Festplatte existiert und nicht leer ist (
MIN_OUTPUT_SIZE >= 100 Bytes). - L1 Verifikations-Gate: Semantische Überprüfung, ob alle Akzeptanzkriterien zu 100% erreicht sind.
- L1.5 pACS (Predicted Agent Confidence Score): Pre-Mortem-Bewertung in den Bereichen Faithfulness (Zuverlässigkeit), Completeness (Vollständigkeit), Logic (Logik). $pACS = \min(F, C, L)$.
GRÜN (>= 70): Automatischer Fortschritt.GELB (50 - 69): Schwache Dimension im Entscheidungsprotokoll markieren und fortfahren.ROT (< 50): Anhalten und Nacharbeit auslösen.
- L2 Adversarielle Überprüfung: Unabhängige Generator-Kritiker-Bewertung durch
@reviewerund@fact-checker.
Workflow-Optimierungs-Engine (Lean & Automatisierung)
Bei der Analyse oder Optimierung von Workflows:
- Engpass-Schweregrad: Bewerte Engpässe von 1 bis 5.
- Automatisierungspotenzial: Quantifiziere manuelle Aufgaben für die agentische Delegation.
- Fehlerreduzierung: Implementiere Qualitätsgates an den Grundursachen, bevor Fehler sich ausbreiten.
- Zykluszeitreduzierung: Ziel >= 40% Zykluszeitreduzierung bei gleichzeitiger Erhöhung der Ergebnisqualität.
Autonomer Selbstversorgungsmotor & Schutzschalter
Das System arbeitet als durchgängige autonome Engine mit integrierter Energiemanagement:
- Selbstversorgung & Energie-Loop: Dynamische Überwachung des Token- und Kontextspielraums mit automatischer RLM-Zustandskompakticrung und Wiederauffüllungs-Kontrollpunkten vor Kontexterschöpfung.
- Fable-Schutzschalter: Zustandsübergänge
GESCHLOSSEN→OFFEN→HALB_OFFEN. Stoppt automatisch spekulative Überlastung, wenn aufeinanderfolgende Fehlschlagserie $ \ge 2$ ist, isoliert Grundursachen mittels Abduktiver Diagnose (diagnose_context.py) und führt eine strukturierte Wiederherstellung durch. - Sauberer Code Guard: Automatisierte AST-Guard-Prüfung der 24 Clean-Code-Imperative (kleine Funktionen, absichtsverratende Namen, maximal 4 Parameter, keine geschluckten Ausnahmen, keine Fake-Success-Mocks).
- KI-Engineering-Bewertung: Integrierter Vier-Fünftel-Disparate-Impact-Test ($\ge 0.80$), PSI-Verteilungsdrift-Überwachung und adversarielle Prompt-Injection-Sanitisierung.
CLI & Werkzeugkette-Integration
# Starte autonomen durchgängigen Autopilot-Workflow mit Selbstversorgung & Energiemanagement
agentic-workflow autopilot --title "Produktionspipeline" --goal "Autonome Lieferung"
# Führe Sauberer-Code-Guard-Prüfung durch (SOLID, 24 Imperative, KI-Fehlermodi)
agentic-workflow guard [Verzeichnis]
# Führe KI-Engineering-Fairness-, Drift- und Prompt-Injection-Bewertungsgates durch
agentic-workflow eval
# Frage Multi-Agenten-beobachtbare Ablaufverfolgungsprotokolle und Spans ab
agentic-workflow traces
# Initialisiere Infrastruktur, SOT-Laufzeitverzeichnisse und Gesundheitschecks
agentic-workflow init
# Validiere Workflow-Schema, SOT-Integrität und pACS-Protokolle
agentic-workflow validate
# Überprüfe Live-Workflow-Dashboard und Beobachtbarkeitsmetriken
agentic-workflow status
# Führe die vollständige automatisierte Testsuite aus (Sicherheit, Guard, MAS, Evaluator)
agentic-workflow test
Referenzkarte
- Architektur & DNA:
soul.md,AGENTICWORKFLOW-ARCHITECTURE-AND-PHILOSOPHY.md - Betriebsanleitung:
AGENTICWORKFLOW-USER-MANUAL.md - Gemeinsame Direktive:
AGENTS.md,CLAUDE.md,GEMINI.md - Protokolle:
docs/protocols/(autopilot-execution, quality-gates, ulw-mode, code-change-protocol, context-preservation-detail) - Unteragenten:
.claude/agents/(reviewer, fact-checker, translator) - Skripte:
.claude/hooks/scripts/(context_guard, validate_pacs, validate_review, etc.)