harness-books: Zwei Bücher über die Konstruktionsentscheidungen hinter Claude Code und Codex

Ein Dokumentationsprojekt, kein Werkzeug

Der Name legt eine Bibliothek nahe. Das Repository enthält sie nicht. Laut README handelt es sich um zwei Bücher, die online unter harness-books.agentway.dev lesbar sind und zusätzlich als PDF unter exported/book1-claude-code-en.pdf und exported/book2-comparing-en.pdf zum Herunterladen bereitstehen. Die Primärsprache ist Python, was in einem Buchprojekt vor allem auf Werkzeuge zum Rendern oder Exportieren hindeutet. Der Inhalt selbst liegt als Markdown unter book1-claude-code/locales/en/ und book2-comparing/locales/en/, mit einem chinesischen README als Verweis. Wer eine Abhängigkeit in eine pyproject.toml eintragen will, wird in dieser Struktur nichts finden. Der Nutzen liegt ausschließlich im Lesen.

Die Ausgangsfrage: Folgen statt Antwortqualität

Die Bücher verfolgen eine gemeinsame Frage, die das README so formuliert: Was hält das Gesamtsystem begrenzt, kontinuierlich und rechenschaftsfähig, sobald ein schreibendes Modell in Terminals, Repositories, Berechtigungssysteme und Teamabläufe gesetzt wird. Die Kernthese lautet, dass die Antwortqualität nach diesem Schritt nicht mehr das Hauptproblem ist, sondern die Verhaltensfolgen. Adressiert sind damit nicht Einsteiger, die einen Prompt verbessern wollen. Adressiert sind Personen, die entscheiden müssen, wo in einem Agentensystem Ordnung verankert wird: in der Laufzeit, in einer Kontrollschicht, in Berechtigungen oder in Teamregeln. Das ist ein Zuschnitt für Architektur und Betrieb, nicht für Prompt-Basteln.

Aufbau von Buch 1: neun Kapitel plus Anhänge

Das Inhaltsverzeichnis von Buch 1 ist im README vollständig sichtbar und folgt einer klaren Reihenfolge. Nach Vorwort und Einleitung behandelt Kapitel 2 die Aussage, dass ein Prompt keine Persönlichkeit ist, sondern die Kontrollschicht. Kapitel 3 widmet sich der Query Loop als Herzschlag, Kapitel 4 den Werkzeugen, Berechtigungen und Unterbrechungen. Kapitel 5 rahmt Kontextverwaltung, CLAUDE.md und Compact als Budgetregime. Kapitel 6 behandelt Fehler und Wiederaufsetzen, Kapitel 7 Multi-Agenten-Arbeit und Verifikation, Kapitel 8 die Überführung in Teampraxis. Kapitel 9 fasst zehn Prinzipien zusammen. Drei Anhänge ergänzen das: Checklisten, Diagramme und ein Source Map, der laut Beschreibung angibt, welche Dateien die jeweiligen Kapitel belegen. Dieser Source Map ist für die Bewertung des Materials wichtiger als die Prosa, weil er Aussagen an konkrete Dateien bindet.

Buch 2 vergleicht, wo Ordnung platziert wird

Das zweite Buch stellt Claude Code und Codex nebeneinander und fragt, wo jeweils Ordnung entsteht. Das README beschreibt zwei Pfade: der eine beginnt bei Laufzeitdisziplin, der andere bei einer stärker strukturierten Kontrollschicht. Beide Systeme könnten funktionieren, verteilten Autorität aber unterschiedlich. Die angekündigten Themen sind die größte Divergenz in der Kontrollschicht, die Abstimmung der Rollen von Query Loops, Threads, Rollouts und Zustand, die Governance-Rollen von Berechtigungen, Sandboxes und Policy-Sprachen sowie die Frage, wie Skills, Hooks und lokale Regeln organisatorische Gewohnheiten in das System einschreiben. Wer ein eigenes Harness baut, soll hier erfahren, bei welchem System und welcher Schicht das Studium beginnen sollte. Das ist eine Vergleichsachse auf Architekturebene, keine Feature-Tabelle.

Lesepfade und die Abkürzung über zwei Kapitel

Das README nennt drei Pfade. Wer den vollständigen Rahmen will, liest Buch 1 und danach Buch 2. Wer Coding-Agenten bereits kennt und direkt die architektonische Trennung sucht, beginnt mit Buch 2. Wer nur die Schlussfolgerungen will, liest Kapitel 9 aus Buch 1 zusammen mit Kapitel 7 aus Buch 2. Diese dritte Route ist die einzige, die das Material selbst als Verdichtung anbietet, und sie ist der ehrlichste Einstieg für Leser, die eine Stunde investieren können statt eines Wochenendes. Auffällig ist, dass es keine Release-Einträge gibt. Der letzte Push liegt laut Repository-Metadaten im April 2026. Versionierung oder ein Änderungsprotokoll sind im vorliegenden Material nicht sichtbar, was für ein Buch weniger schwer wiegt als für eine Bibliothek, aber die Nachvollziehbarkeit von Änderungen erschwert.

Was das Material nicht liefert

Die Lizenz ist im vorliegenden Material nicht angegeben. Wer Kapitel in interne Schulungsunterlagen übernehmen oder übersetzen will, muss das vorab klären, weil ohne Lizenzangabe keine Nutzungsrechte eingeräumt sind. Auch fehlt jede Angabe zu ausführbarem Code, Tests oder Beispielprojekten. Das README betont ausdrücklich, dass die Bücher den Quellcode nicht Zeile für Zeile durchgehen. Wer eine überprüfbare Implementierung sucht, wird enttäuscht. Ein weiterer Vorbehalt betrifft den Gegenstand selbst: Beide Systeme entwickeln sich schnell, und ein Buch, das Laufzeitstrukturen beschreibt, altert mit jeder Änderung an Query Loop, Berechtigungsmodell oder Kontextverwaltung. Ohne sichtbare Versionsangabe pro Kapitel lässt sich nicht einschätzen, welcher Stand beschrieben wird. Das ist die größte Schwäche des Projekts.

Alternative: Primärquellen statt Sekundärliteratur

Die naheliegende Alternative ist, direkt die Dokumentation und den Quellcode von Claude Code und Codex zu lesen. Der Unterschied liegt im Zugang: Primärquellen sind aktuell und autoritativ, aber sie erklären nicht, warum eine Kontrollschicht überhaupt entsteht und welche Rolle Kontextbudget oder Wiederaufsetzen im Gesamtbild spielen. harness-books liefert genau diese Einordnung und den Vergleich zweier Philosophien, zahlt dafür aber mit einem Stand, der nicht datiert ist. Für Architekturentscheidungen ist die Reihenfolge daher sinnvoll: erst die Einordnung aus Buch 2, dann die Prüfung der konkreten Mechanismen in der Primärdokumentation. Wer nur eine der beiden Quellen nutzt, bekommt entweder ein veraltetes Bild oder eine Sammlung von Details ohne Ordnungsrahmen.

Redaktionelles Fazit

Wer Coding-Agenten nicht als Werkzeug, sondern als Laufzeitsystem mit Berechtigungen, Kontextbudget und Wiederaufsetzpunkten begreifen will, findet in harness-books eine strukturierte Lesefolge, die sich an Kapitel 9 von Buch 1 und Kapitel 7 von Buch 2 abkürzen lässt. Wer ausführbaren Code, Benchmarks oder eine Bibliothek zum Einbinden sucht, ist hier falsch. Vor dem Weiterverwenden der Kapitel lohnt ein Blick in Appendix C, den Source Map von Buch 1: er ordnet jeder Aussage eine Datei zu, und die Lizenzangabe des Repositories ist vor einer Übernahme in eigene Unterlagen zu klären.

Offizielle Quellen

1. Issues
2. Project website
3. README
4. wquguru/harness-books on GitHub