30eggis/walwal-harness

Was macht walwal-harness?

KI-Agenten-Harness-Engineering-Framework – 6-Agenten-Produktions-Harness mit Gotcha-Management, Playwright-MCP-Tests und SKILL.md-Architektur

Übersicht

Das walwal-harness ist ein speziell für den Produktionseinsatz entwickeltes Framework, das sechs KI-Agenten in einer kohärenten Harness-Umgebung orchestriert. Es bietet:

• Gotcha-Management: System zur Erkennung und Behandlung von unerwarteten Agentenantworten (Gotchas)
• Playwright-MCP-Tests: Automatisierte Tests mit Playwright unter Verwendung des Model Context Protocol
• SKILL.md-Architektur: Zentrales Konfigurationsdokument für Agentenfähigkeiten und -verhalten

Funktionen

Funktion	Beschreibung
6-Agenten-Harness	Orchestrierung von sechs spezialisierten KI-Agenten
Gotcha-Management	Erkennung und flexible Behandlung von Anomalien in Agentenantworten
Playwright-Tests	Browserbasierte Tests mit Playwright für MCP-Endpunkte
SKILL.md-Integration	Architektur zentral über eine SKILL.md-Datei gesteuert
Produktionsreif	Ausgelegt für den Einsatz in Live-Umgebungen mit hohen Anforderungen

Architektur

walwal-harness/
├── agents/           # Agentenkonfigurationen
├── gotcha/           # Gotcha-Management-Logik
├── tests/            # Playwright-MCP-Tests
├── skill.md          # Zentrales Steuerungsdokument
└── README.md         # Projektdokumentation

Agentenrollen

Der Harness definiert sechs spezifische Agentenrollen, die zusammenarbeiten:

1. Orchestrator: Koordiniert die Aufgabenverteilung
2. Analyzer: Analysiert und strukturiert Eingabedaten
3. Generator: Erzeugt Ausgaben basierend auf Agentenanfragen
4. Validator: Prüft die Konsistenz und Korrektheit von Antworten
5. Tester: Führt Playwright-MCP-Tests durch
6. Gotcha-Handler: Bearbeitet unerwartete Situationen und Fehler

Verwendung

Installation

npm install walwal-harness
# oder
pip install walwal-harness  # bei Python-Version

Grundkonfiguration

const harness = new WalwalHarness({
  agents: 6,
  gotchaManager: true,
  playwrightMcp: true
});

await harness.start();

Gotcha-Management-Beispiel

harness.on('gotcha', (event) => {
  console.log('Gotcha erkannt:', event);
  // Implementierung der Gotcha-Behandlung
});

Playwright-MCP-Test

import { test, expect } from '@playwright/test';

test('MCP-Agenten-Kommunikation', async ({ page }) => {
  await page.goto('http://localhost:3000/mcp');
  // Test der MCP-Interaktionen
  await expect(page.locator('#agent-status')).toHaveText('Aktiv');
});

Plattformunterstützung

Das walwal-harness ist mit folgenden Plattformen kompatibel:

• Claude Code – Vollständige Integration mit Claude Code-Workflows
• Cursor – Nahtlose Einbindung in Cursor-Entwicklungsumgebungen
• Codex – Unterstützung für Codex-basierte Agentensysteme
• Weitere MCP-kompatible Plattformen – Dank des standardkonformen Model Context Protocol

Lizenz

Dieses Projekt steht unter der MIT-Lizenz – siehe LICENSE-Datei für Details.

Beitragende

Beiträge sind willkommen! Bitte lesen Sie CONTRIBUTING.md für Richtlinien zur Teilnahme.