Fünf Aufgaben, nur mit der Doku

Kann ein Agent, der hadley nie gesehen hat, an einer hadley-Site arbeiten, wenn er nichts hat als die Doku? So habe ich es im November 2026 gemessen, und das kam heraus.

Der Aufbau

• Die Site: neu, angelegt mit hadley init --language en,de und dem Theme hems, nichts verändert.
• Das Programm: hadley 0.3.0 für Linux, aus dem Release, anhand der zugehörigen SHA256SUMS geprüft.
• Der Agent: Codex mit dem Modell gpt-6.1-sol, in einer virtuellen Maschine ohne Zugang zum Web. Erreichbar war nur der Anbieter des Modells.
• Die Doku: eine Offline-Kopie der Nutzerdoku von hadley und der Seiten zu Markanto und Lima, rund 26.000 Tokens, gezählt als Bytes geteilt durch vier.

Die Aufgaben

1. Ein neuer Artikel, „A week in Porto“, auf Englisch und Deutsch, mit Datum, Beschreibung, zwei Tags und einem Bild als Titelbild.
2. Eine kurze Notiz, die auf hadleys Repository verweist.
3. Eine Autorin für den Artikel, Rosa Kessler, mit einer kurzen Biografie in beiden Sprachen.
4. Die Site dauerhaft dunkel, ohne den Knopf, der zwischen hell und dunkel umschaltet.
5. Kommentare eingeschaltet, für einen Dienst unter einer vorgegebenen Adresse.

Und am Ende musste sich die Site ohne Problem für die Veröffentlichung erzeugen lassen.

Das Ergebnis

Nach 3 Minuten 34 Sekunden waren alle fünf Aufgaben erledigt, und die Site ließ sich ohne Problem erzeugen. Der Agent las 9 der 15 Dateien der Doku. Ich habe sein Ergebnis selbst noch einmal gebaut und nachgesehen: der Artikel in beiden Sprachen mit Titelbild und Autorin, die Notiz, die deutsche Biografie, die Site dunkel ohne Knopf, das Kommentarformular mit der Adresse des Dienstes. Dazu hatte er eine Testdatei angelegt, die nicht zu den Aufgaben gehörte.

Ohne die Doku

Dieselben Aufgaben, derselbe Agent, dieselbe Site, aber keine Doku: auch hier alle fünf erledigt, nach 4 Minuten 3 Sekunden. Zurechtgefunden hat er sich über die Beispielinhalte der neuen Site, das README, das mit dem Programm kommt, und --help. Er änderte 12 Dateien statt 9, darunter auch die Vorlage der Startseite, obwohl das nicht verlangt war.

Die Doku hat den Agenten also schneller gemacht und dafür gesorgt, dass er bei den gestellten Aufgaben blieb. Und eine neue hadley-Site erklärt sich selbst so gut, dass ein Agent sich auch ohne sie zurechtfindet.

Was beide Läufe gefunden haben

Beide stießen auf dieselben zwei Lücken in hadleys eigenen Themes und schrieben dafür dieselben Korrekturen: hems und punch hatten keine Vorlage für Notizen, und die früher gewählte helle Darstellung eines Lesers konnte eine dunkel eingestellte Site überstimmen. Beides ist für hadley 0.4.0 behoben.

Was das nicht zeigt

Ein Agent, ein Modell, je ein Lauf, auf einem Rechner. Die Seiten wurden nicht im Browser geprüft, und es lief kein Kommentardienst. Es zeigt, dass die Doku für die alltägliche Arbeit reicht, nicht, wie jeder Agent damit zurechtkommt.