smlflg/harness-tutorials

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
   Interaktive visuelle Explainer-Website zum Multi-Tool-Harness.
2. CODEX_APP_HARNESS_TUTORIAL.md
   Das vollstaendige Tutorial: Setup, Denkmodell, Workflow, Prompts, Gates, Verifikation und typische Fehler.
3. MULTI_TOOL_HARNESS_TUTORIAL.md
   Die gleiche HAI-Harness-Struktur fuer Claude Code, Hermes, OpenClaw, OpenCode, Pi und Conductor.
4. templates/OWNER_PACKET.md
   Kompakte Entscheidungsseite fuer den Menschen.
5. templates/DELEGATION_CARD.md
   Auftrag, Scope, erlaubte/verbotene Aktionen, Artefaktpflicht.
6. templates/VERIFICATION_REPORT.md
   Belege statt Agenten-Selbstaussage.
7. examples/ONE_SESSION_WALKTHROUGH.md
   Ein Ende-zu-Ende-Beispiel fuer eine Codex-Session.
8. 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 im Browser und gehe durch den visuellen Flow.
2. Lege im Zielrepo ein kurzes AGENTS.md an.
3. Fuell ein Owner Packet fuer genau eine Aufgabe.
4. Uebersetze es in eine Delegation Card.
5. Starte Codex mit dieser Delegation Card.
6. Akzeptiere kein done, bevor ein Verification Report 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.