Easy-T/claude-ai-native-harness

Was macht claude-ai-native-harness?

Globales ~/.claude/-Harness – Erzwingt RPI-Zyklen (Recherche → Plan → Umsetzung → Abschluss), deterministisches Projekt-Bootstrap und KI-Fehlerverfolgung mittels 5 Hooks + 4 Orchestrator-Fähigkeiten + 3 Wrapper-Sub-Agenten. Plattformübergreifend (Windows/WSL/Linux).

Überblick

Dieses Harness wurde entwickelt, um KI-Agenten (insbesondere Claude Code) einen strukturierten Arbeitsablauf zu geben. Statt improvisiertem Handeln durchläuft der Agent den RPI-Zyklus:

1. Recherche: Analyse der Anforderungen, bestehender Codebasis und möglicher Lösungen.
2. Plan: Erstellung eines detaillierten Planes mit Aufgaben, Schritten und erwarteten Ergebnissen.
3. Umsetzung: Schrittweise Implementierung des Plans mit Code-Änderungen und Tests.
4. Abschluss: Überprüfung, Testausführung, Fehlerprotokoll und Zusammenfassung.

Hooks (5)

Hook	Beschreibung
pre-init	Wird vor der Projektinitialisierung ausgeführt (z. B. Überprüfung der Umgebungsvariablen).
post-init	Nach erfolgreicher Initialisierung (z. B. Willkommensnachricht, Abhängigkeitsinstallation).
pre-change	Vor jeder Codeänderung (z. B. Backup des aktuellen Zustands).
post-change	Nach jeder Codeänderung (z. B. Linting, automatisierte Tests ausführen).
closeout	Während des Abschlusszyklus (z. B. Git-Commit erstellen, Metriken protokollieren).

Orchestrator-Fähigkeiten (4)

1. plan_generator: Erstellt einen Plan basierend auf der Recherche.
2. task_scheduler: Definiert die Ausführungsreihenfolge der Aufgaben.
3. failure_tracker: Protokolliert und kategorisiert fehlgeschlagene Schritte.
4. summary_builder: Erzeugt eine Zusammenfassung des gesamten Zyklus.

Wrapper-Sub-Agenten (3)

1. code_reviewer: Analysiert Codeänderungen auf Qualität, Sicherheit und Konsistenz.
2. test_runner: Führt Testsets aus und meldet Ergebnisse.
3. doc_writer: Aktualisiert Dokumentation basierend auf Änderungen.

Installation

Das Harness wird global in ~/.claude/ installiert.

Voraussetzungen:

• Node.js ≥ 18 (für Windows/WSL benötigen Sie Node.js unter Windows).
• Git ≥ 2.x (optional für Versionskontrolle).
• Claude Code CLI (oder ein anderer kompatibler AI-Agent).

# Repository klonen
cd ~/.claude

git clone https://github.com/Easy-T/claude-ai-native-harness.git

# Abhängigkeiten installieren
npm install

Konfiguration

Die Konfiguration erfolgt über eine harness.config.json-Datei im Projektstamm. Beispiel:

{
  "hooks": {
    "pre-init": "hooks/pre-init.js",
    "post-init": "hooks/post-init.sh",
    "pre-change": "hooks/pre-change.py",
    "post-change": "hooks/post-change.sh",
    "closeout": "hooks/closeout.js"
  },
  "orchestrators": ["plan_generator", "failure_tracker"],
  "wrappers": ["code_reviewer", "test_runner"]
}

Verwendung

# Normales Bootstrap
claude init

# Mit RPI-Zyklus
claude rpi

# Fehlerprotokoll anzeigen
claude failures

Plattformkompatibilität

Plattform	Status
Linux	✅ Vollständig
Windows	✅ Vollständig (mit PowerShell/Node)
WSL	✅ Vollständig

Lizenz

MIT © Easy-T

Mitwirken

Pull-Requests sind willkommen. Bitte lesen Sie die CONTRIBUTING.md für Details.

Support

Bei Fragen oder Problemen öffnen Sie bitte ein Issue im Repository.