| # 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. |
| |
