# Agent Harness Tutorial

Ein HAI-basiertes Tutorial fuer Codex, Claude Code, Hermes, OpenClaw,
OpenCode, Pi und Conductor.

Ziel: Das Harness so erklaeren, dass Mensch-Agent-Interaktion ueber mehrere
Tools hinweg kontrollierter, kleiner und besser verifizierbar wird.

## Lesereihenfolge

1. [index.html](index.html)  
   Interaktive visuelle Explainer-Website zum Multi-Tool-Harness.
2. [CODEX_APP_HARNESS_TUTORIAL.md](CODEX_APP_HARNESS_TUTORIAL.md)  
   Das vollstaendige Tutorial: Setup, Denkmodell, Workflow, Prompts, Gates,
   Verifikation und typische Fehler.
3. [MULTI_TOOL_HARNESS_TUTORIAL.md](MULTI_TOOL_HARNESS_TUTORIAL.md)  
   Die gleiche HAI-Harness-Struktur fuer Claude Code, Hermes, OpenClaw,
   OpenCode, Pi und Conductor.
4. [templates/OWNER_PACKET.md](templates/OWNER_PACKET.md)  
   Kompakte Entscheidungsseite fuer den Menschen.
5. [templates/DELEGATION_CARD.md](templates/DELEGATION_CARD.md)  
   Auftrag, Scope, erlaubte/verbotene Aktionen, Artefaktpflicht.
6. [templates/VERIFICATION_REPORT.md](templates/VERIFICATION_REPORT.md)  
   Belege statt Agenten-Selbstaussage.
7. [examples/ONE_SESSION_WALKTHROUGH.md](examples/ONE_SESSION_WALKTHROUGH.md)  
   Ein Ende-zu-Ende-Beispiel fuer eine Codex-Session.
8. [SOURCES.md](SOURCES.md)  
   Welche lokalen HAI-Artefakte und offiziellen Codex-Dokumente verwendet wurden.

## Was dieses Tutorial meint

Ein Harness ist hier nicht nur ein Eval-Script oder Test-Runner.

Ein Agent-Harness ist die Arbeitsform um ein Agenten-Tool herum:

- der richtige Projektordner
- ein klares `AGENTS.md`
- ein einzelner Thread pro Aufgabe
- ein Owner-Packet vor der Ausfuehrung
- eine Delegation Card fuer Codex
- Human Gates fuer Risiko, Scope und Freigabe
- konkrete Artefakte als Wahrheitsebene
- Verifikation vor jeder Done-Meldung
- ein Next Action Packet am Ende

Die visuelle Website enthaelt Profile fuer:

- Codex
- Claude Code
- Hermes
- OpenClaw
- OpenCode
- Pi
- Conductor

Kurz:

> Das Harness ist die Kontrollschicht zwischen menschlichem Wunsch und
> agentischer Arbeit.

## Schnellstart

Wenn du sofort arbeiten willst:

1. Oeffne [index.html](index.html) im Browser und gehe durch den visuellen Flow.
2. Lege im Zielrepo ein kurzes `AGENTS.md` an.
3. Fuell ein [Owner Packet](templates/OWNER_PACKET.md) fuer genau eine Aufgabe.
4. Uebersetze es in eine [Delegation Card](templates/DELEGATION_CARD.md).
5. Starte Codex mit dieser Delegation Card.
6. Akzeptiere kein `done`, bevor ein [Verification Report](templates/VERIFICATION_REPORT.md) Belege nennt.

## Plattformhinweis

Laut aktueller offizieller OpenAI-Dokumentation ist die Codex Desktop App fuer
macOS und Windows verfuegbar; die Codex CLI ist auch unter Linux unterstuetzt.
Auf Pop!_OS/COSMIC ist dieses Tutorial deshalb direkt fuer CLI/IDE/Cloud nutzbar
und auf die Desktop App uebertragbar, sobald sie in der eigenen Umgebung
verfuegbar ist.