File size: 2,873 Bytes
7005700 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 | # 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.
|