Communitygithub.com

AgenticWorkflow: Universelle Agentische Fähigkeit & Ausführungs…

Ein pluripotentes Stammzell-Framework und eine universelle agentische Werkzeugkette für autonome Multi-Agenten-Workflows.

Was ist AgenticWorkflow: Universelle Agentische Fähigkeit & Ausführungs…?

AgenticWorkflow ist ein hochmodernes Framework und eine Ausführungs-Engine für autonome Multi-Agenten-Workflows. Es wandelt komplexe Aufgaben in deterministische, selbstverifizierende Abläufe um, die nach einem strengen vierstufigen Qualitätssicherungsprozess arbeiten. Das System unterstützt verschiedene Betriebsmodi wie Design, Ausführung, Autopilot, Ultra-Work, Verifikation und Optimierung und passt sich dynamisch an den Kontext des Benutzers an. Es integriert eine Reihe von leistungsstarken Funktionen, darunter eine selbstversorgende Energieverwaltung, einen Fable-Schutzschalter zur Verhinderung von Endlosschleifen, eine Sauberer-Code-Überwachung mittels AST-Prüfung und eine KI-Engineering-Bewertung zur Sicherstellung von Fairness, Verteilungsstabilität und Prompt-Injection-Resilienz. Die Plattform ist mit verschiedenen KI-Assistenten wie Claude, Cursor und Codex kompatibel und bietet eine umfassende CLI-Werkzeugkette für Workflow-Initialisierung, Validierung, Überwachung und Tests. Das Framework folgt drei absoluten Kriterien: Qualität des Endprodukts, Single-File-Zustandsverwaltung (SOT) und ein strenges Code-Änderungsprotokoll. Dies stellt sicher, dass alle Workflows, Werkzeuge und Unteragenten deterministisch, überprüfbar und von höchster Qualität sind.

Funktioniert mit✓Claude Code~Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add imMamdouhaboammar/agentic-workflow

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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:

ModusAuslösephrasenKernausfü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:

  1. 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.

  2. 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.

  3. 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)"]
  1. L0 Anti-Skip Guard: Überprüft deterministisch, ob das Ergebnis auf der Festplatte existiert und nicht leer ist (MIN_OUTPUT_SIZE >= 100 Bytes).
  2. L1 Verifikations-Gate: Semantische Überprüfung, ob alle Akzeptanzkriterien zu 100% erreicht sind.
  3. 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.
  4. L2 Adversarielle Überprüfung: Unabhängige Generator-Kritiker-Bewertung durch @reviewer und @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:

  1. Selbstversorgung & Energie-Loop: Dynamische Überwachung des Token- und Kontextspielraums mit automatischer RLM-Zustandskompakticrung und Wiederauffüllungs-Kontrollpunkten vor Kontexterschöpfung.
  2. 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.
  3. 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).
  4. 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.)

Verwandte Skills