Harness Engineering: wie Sie einen zuverlässigen KI-Agenten bauen
Artikel: 8
Harness Engineering ist die Disziplin, um ein Sprachmodell herum eine Umgebung zu bauen, in der ein KI-Agent zuverlässig echte Arbeit erledigt. Die Formel des Themas lautet: Agent = Modell + Harness. Dasselbe Modell arbeitet in einem Projekt wie ein erfahrener Entwickler, in einem anderen verliert es den Kontext und meldet ein defektes Feature als fertig. Der Unterschied liegt fast immer im Harness, nicht im Modell.
Dieser Leitfaden ist eine Landkarte des Themas. Hier sind die zentralen Begriffe und die Reihenfolge gesammelt, in der sie sich am besten lernen lassen. Jedes Thema wird in einem eigenen Artikel ausführlich behandelt.
Die fünf Teilsysteme des Harness
- Anweisungen — die Dateien CLAUDE.md und AGENTS.md, Themendokumente und Skills: was der Agent über das Projekt weiß.
- Werkzeuge — Shell, Dateibearbeitung, Browser, MCP-Server: wie der Agent handelt.
- Umgebung — Sandbox, Container, eine isolierte Arbeitskopie: wo der Agent Befehle ausführt.
- Zustand — Planungs- und Fortschrittsdateien, Git-Historie: Gedächtnis zwischen Sitzungen.
- Rückmeldung — Tests, Linter, Hooks, ein unabhängiger Prüfer: wie der Agent von seinen Fehlern erfährt.
Die Teilsysteme bilden einen geschlossenen Kreislauf. Entfernt man eines, bricht der Kreislauf: Ohne Prüfungen sieht der Agent seine Fehler nicht, ohne Zustand beginnt jede Sitzung bei null.
Womit man anfängt
Wenn Ihnen das Thema neu ist, beginnen Sie mit dem Artikel darüber, was Harness Engineering ist und wie es sich von Prompt- und Context-Engineering unterscheidet. Eine kurze Definition mit Beispiel finden Sie im Artikel zum Agent-Harness.
Gehen Sie dann zur Praxis über. Die erste Datei, mit der jeder zu tun hat, sind die Projektanweisungen: was in CLAUDE.md und AGENTS.md steht, was nicht hineingehört und warum der Agent eine Regel ignoriert, die ausdrücklich in der Datei steht.
Wenn der Agent bereits im Projekt arbeitet, stellt sich die Frage der Zuverlässigkeit. Ein Schritt-für-Schritt-Plan führt vom Fehlerprotokoll und den Kennzahlen MTBF und MTTR über günstigen Rollback, Rückkopplungsschleifen und Gedächtnis in Dateien bis zum autonomen Zyklus, in dem der Agent stundenlang ohne Aufsicht arbeitet.
Grundprinzipien
- Der Agent ist nicht kaputt — kaputt ist die Umgebung. Suchen Sie zuerst die Lücke im Harness, nicht ein anderes Modell.
- Beginnen Sie mit der Rückmeldung: Ein Prüfbefehl bringt mehr als eine Seite Anweisungen.
- Anweisungen sind eine Landkarte, kein Lehrbuch: eine kurze Einstiegsdatei und Details auf Abruf.
- Was zählt, lebt in Dateien, nicht im Kontextfenster.
- Messen Sie: ein Fehlerprotokoll statt Gefühl.
Alle Teilsysteme und der Aufbau des Harness als Ganzes werden im Kurs zum Harness Engineering praktisch behandelt.