So entsteht kopfwelt.com: vom Issue zur Freigabe mit KI-Agenten
Ein Fallbericht mit Zahlen aus gut einem Jahr Entwicklung, Stand 22. November 2026
Inhalt
Im Alltag sieht eine Agentic Software Factory so aus: Ein Mensch beschreibt eine Aufgabe, und ein KI-Agent setzt sie in einem eigenen Branch um. Jede Änderung kommt als Pull Request mit automatischen Tests und einer Vorschau-Adresse. Ein Mensch prüft und gibt frei. So entsteht kopfwelt.com seit Oktober 2025.
Die Zahlen dazu stammen aus dem Repository dieser Website, erhoben am 22. November 2026: 355 Commits auf dem Hauptzweig, 286 zusammengeführte Pull Requests, 122 Testdateien und eine Regeldatei für die Agenten mit 1.070 Zeilen. Der typische Pull Request war neun Minuten nach dem Öffnen zusammengeführt. Was diese Zahl bedeutet und was nicht, steht weiter unten.
Ich beschreibe hier keinen Versuch an einem Nachmittag, sondern den laufenden Betrieb. Die Website selbst ist das Ergebnis, und sie ist öffentlich. Wie der Ablauf grundsätzlich aufgebaut ist, erklärt der Überblick zur Agentic Software Factory.
Der Fall: eine Website, an der seit einem Jahr Agenten mitarbeiten
kopfwelt.com ist eine Next.js-Anwendung. Die Inhalte kommen aus Storyblok, einem Headless CMS, gehostet wird bei Vercel. Zur Website gehören mehr als Seiten. Es gibt Übergänge zwischen Teasern und Detailseiten, eine Fassung jeder Seite in Markdown für KI-Agenten und strukturierte Daten. Ein Webhook leert nach jeder Veröffentlichung gezielt den Cache.
Der Code liegt in einem privaten Git-Repository auf GitHub. Gearbeitet wird mit Claude Code, dem Coding-Agenten von Anthropic. Fast alle Commits stehen unter meinem Namen: 342 von 355. Dazu kommen 12 automatische Abhängigkeits-Updates und ein Commit eines anderen Werkzeugs. 192 Commits tragen den Vermerk Co-Authored-By: Claude, 94 der zusammengeführten Pull Requests kamen aus Branches, die der Agent angelegt hat.
Öffentlich prüfen lässt sich nicht der Code, aber das Ergebnis. Jede Seite antwortet mit Markdown, wenn eine Anfrage Accept: text/markdown mitschickt. Sitemap und llms.txt liegen an den üblichen Adressen. Und die Ladezeit der Startseite misst jeder selbst mit PageSpeed Insights.
Die Zahlen: 355 Commits, 286 Pull Requests, 122 Testdateien
Alle Werte gelten für den Stand vom 22. November 2026 und wurden mit den genannten Befehlen im Repository erhoben.
Kennzahl | Wert | Befehl |
|---|---|---|
Erster Commit | 26.10.2025 |
|
Letzter Commit auf main | 19.11.2026 |
|
Commits auf main | 355, davon 64 Merge-Commits |
|
Tage mit mindestens einem Commit | 70 |
|
Zusammengeführte Pull Requests | 286 |
|
davon in main (ohne automatische Updates) | 187 | ebenso, gefiltert |
davon Releases von main nach production | 85 | ebenso, gefiltert |
Offene und verworfene Pull Requests | 22 offen, 15 geschlossen |
|
Testdateien in | 122, dazu 2 Browsertests in |
|
Regeldatei | 1.070 Zeilen, 13.248 Wörter |
|
Die Arbeit verteilt sich ungleich über das Jahr. Auf einen Start im November 2025 folgten ruhige Monate. Seit August 2026 entstehen jeden Monat zwischen 39 und 78 Commits.
Monat | Commits auf main |
|---|---|
Oktober 2025 | 6 |
November 2025 | 47 |
Dezember 2025 bis Juli 2026 | 60 |
August 2026 | 74 |
September 2026 | 51 |
Oktober 2026 | 39 |
November 2026 (bis 19.11.) | 78 |
Ein typischer Pull Request in main fügt 222 Zeilen hinzu und entfernt 18 (Median). Die Commit-Zahl unterschätzt die Arbeit: Viele Pull Requests werden beim Zusammenführen zu einem Commit zusammengefasst.
Neun Minuten bis zum Merge, und was die Zahl nicht sagt
Von den 187 Pull Requests in main war die Hälfte nach höchstens neun Minuten zusammengeführt. Ein Viertel brauchte keine zwei Minuten, drei Viertel weniger als eine Stunde. 13 lagen länger als einen Tag offen.
Das klingt nach Tempo, misst aber etwas Bestimmtes. Der Agent öffnet den Pull Request erst, wenn er die Aufgabe für erledigt hält und Tests, Typprüfung und Linter durchgelaufen sind. Die neun Minuten sind also die Zeit für Vorschau, Prüfung und Freigabe, nicht für die Umsetzung. Die eigentliche Arbeit liegt davor: Aufgabe beschreiben, Zwischenstände lesen, nachsteuern, im Browser nachsehen.
Wie viele Stunden ein Mensch insgesamt dafür aufwendet, lässt sich aus dem Repository nicht ablesen.
Die Live-Website wird vom Zweig production gebaut. Jedes Release von main dorthin ist ein eigener Pull Request. 84 von 85 waren in weniger als einer Stunde zusammengeführt, meist innerhalb einer Minute. Das ist der bewusste zweite Schritt: Was in main steht, ist geprüft. Was in production steht, ist live.
Ein Fall von Befund bis Freigabe: die Ladezeit der Startseite
Am 16. November 2026 zeigte Lighthouse für die mobile Startseite ein Largest Contentful Paint (LCP) von 4,7 Sekunden. Das LCP misst, wann das größte sichtbare Element steht. 87 Prozent davon waren Render-Verzögerung: Der Einleitungstext war bis zur Hydration unsichtbar und blendete danach ein.
Ein erster Pull Request (#326) behob das und ging am 17. November früh live. Die Messung danach zeigte für die Startseite noch 3,3 bis 3,8 Sekunden. Der zweite Durchgang, Pull Request #330, lief so ab. Die Uhrzeiten sind Berliner Zeit.
Uhrzeit | Schritt |
|---|---|
08:32 | Der Agent committet die Änderung und öffnet den Pull Request mit Befund, Änderungen und Prüfergebnissen. |
08:33 | Vercel meldet die Vorschau-Adresse für genau diesen Stand. |
08:34 | PageSpeed-Messung der Vorschau als Kommentar: Score 100, LCP 1,3 Sekunden, gegenüber 89 und 3,6 bis 3,8 Sekunden auf kopfwelt.com. |
08:41 | Kommentar zum Inhaltsschritt: Eine Einstellung in Storyblok liegt als Entwurf bereit, mit dem Hinweis, sie erst nach dem Release zu veröffentlichen. |
08:43 | Freigabe und Merge in main. |
08:44 | Release-Pull-Request #331 nach |
Der Befund im Pull Request benennt die Ursache genau: Die Überschrift der Startseite war gar nicht animiert. Gebremst hat sie eine Einblendung auf dem Container, der jede Seite umschließt. Geprüft wurde mit 1.437 grünen Tests, Typprüfung, Linter und einem Production-Build, den der Agent mit Playwright bei 390 Pixeln Breite durchgeklickt hat. Dieselbe Änderung trägt die Regel in die CLAUDE.md ein und ergänzt einen Test, der sie festhält.
Knapp zwölf Minuten zwischen Pull Request und Live-Gang sind nur möglich, weil die Prüfung vorher feststeht. Die Messgröße stand im ersten Satz des Pull Requests: LCP der Startseite auf Mobil unter 2,5 Sekunden. Ob das stimmt, zeigte die Vorschau, bevor jemand auf „Merge“ klickte. Die Felddaten aus dem Chrome User Experience Report kommen erst nach etwa 28 Tagen. Das steht als Vorbehalt im Pull Request.
Was die Arbeit trägt: Regeldatei, Tests, Vorschau, Freigabe
Vier Dinge machen den Ablauf verlässlich. Keines davon ist neu, neu ist nur, wer die meiste Arbeit dazwischen erledigt.
Die Regeldatei.
CLAUDE.mdliegt im Repository und wird zu Beginn jeder Sitzung gelesen. Sie beschreibt Aufbau, Befehle und vor allem Regeln mit ihrem Grund, oft mit Datum des Vorfalls, aus dem sie entstanden sind. Mehr dazu im Artikel zu Context Engineering und AGENTS.md.Tests, die frühere Fehler festhalten. Die meisten der 122 Testdateien sichern einen bestimmten Fehler ab, der schon einmal passiert ist. Der Kopfkommentar sagt, welcher. So repariert der Agent keinen Test, dessen Grund er nicht kennt.
Eine Vorschau je Änderung. Jeder Pull Request bekommt bei Vercel eine eigene Adresse. Messen, klicken und vergleichen passiert dort, nicht auf der Live-Website.
Die Freigabe durch einen Menschen. Zusammengeführt wird erst, wenn ein Mensch den Pull Request und die Vorschau geprüft hat. Inhalte in Storyblok legt der Agent höchstens als Entwurf an. Wie das abgegrenzt ist, beschreibt der Artikel zu Human in the Loop.
Dazu kommt, dass die Agenten parallel arbeiten können, jeder in seinem eigenen Arbeitsverzeichnis. Wie das mit Git-Worktrees und Claude Code aussieht, steht in einem eigenen Artikel.
Was nicht funktioniert hat
Ein Fallbericht ohne Fehler wäre keiner. Drei Beispiele stehen mit Datum in der Regeldatei.
Am 25. Oktober 2026 wurde der Storyblok-Space gesperrt, weil das monatliche Kontingent an API-Anfragen aufgebraucht war. Zwei Wiederholungsschleifen bei Fehlern hatten sich gestapelt, eine im eigenen Code und eine in der Bibliothek von Storyblok. Zusammen mit rund 100 Builds bei Vercel und lokalen Builds kostete eine einzige Anfrage unter Last bis zu 50 gezählte Anfragen. Kein Test hatte das gezeigt, sichtbar wurde es erst mit der Sperre.
Am 10. November 2026 brach der Production-Build ab, obwohl der Build gegen Entwurfsinhalte durchgelaufen war. Ein Inhaltsblock verwies auf unveröffentlichte Einträge, die nur im Entwurfsmodus aufgelöst werden. Seitdem steht in der Regeldatei, vor einem solchen Release gegen veröffentlichte Inhalte zu bauen.
Und die Regeldatei selbst ist zu lang. Die Dokumentation von Claude Code empfiehlt weniger als 200 Zeilen je Datei, weil längere Dateien mehr Kontext verbrauchen und weniger zuverlässig befolgt werden. Unsere hat 1.070. Sie funktioniert, aber sie aufzuteilen steht an.
Was sich übertragen lässt
Nicht jedes Team braucht Übergänge mit WebGL oder einen Cache-Webhook. Übertragbar ist der Ablauf: eine Codebasis in Git, Aufgaben mit prüfbarem Ziel, Tests, eine Vorschau je Änderung, eine gepflegte Regeldatei und eine Freigabe durch Menschen. Was davon in eurem Team schon da ist, lässt sich mit der Checkliste für KI-Agenten in der Entwicklung klären.
Wie wir diesen Ablauf für andere Teams einrichten, steht auf der Seite zu KI-gestützter Softwareentwicklung.
Häufige Fragen zum Fallbericht kopfwelt.com
Schreibt die KI den Code von kopfwelt.com allein?
Schreibt die KI den Code von kopfwelt.com allein?
Nein. Der Agent schreibt den größten Teil der Zeilen, aber jede Aufgabe beginnt mit einer Beschreibung durch einen Menschen, und jeder Pull Request wird von einem Menschen geprüft und zusammengeführt. Inhalte in Storyblok legt der Agent höchstens als Entwurf an. Veröffentlicht wird von Hand.
Ist der Code von kopfwelt.com öffentlich?
Ist der Code von kopfwelt.com öffentlich?
Nein, das Repository ist privat. Öffentlich ist das Ergebnis: die Website, ihre Markdown-Fassungen, Sitemap, llms.txt und die Ladezeiten, die jeder selbst messen kann. Die Zahlen in diesem Artikel stammen aus dem Repository und sind mit Befehl und Stichtag angegeben.
Was bedeutet die Durchlaufzeit von neun Minuten?
Was bedeutet die Durchlaufzeit von neun Minuten?
Sie misst die Zeit vom Öffnen eines Pull Requests bis zum Zusammenführen, als Median über 187 Pull Requests. Der Agent öffnet den Pull Request erst, wenn die Arbeit aus seiner Sicht fertig ist. Die Zahl sagt also, wie schnell geprüft und freigegeben wird, nicht, wie lange die Umsetzung gedauert hat.
Welche Werkzeuge braucht man für so einen Ablauf?
Welche Werkzeuge braucht man für so einen Ablauf?
Auf kopfwelt.com sind es GitHub für Code und Pull Requests, Claude Code als Agent, Vitest und Playwright für Tests und Vercel für Vorschau und Hosting. Die Werkzeuge lassen sich austauschen. Entscheidend sind Git, Tests, eine Vorschau je Änderung, eine Regeldatei und die Freigabe durch Menschen.
Lässt sich das auf ein Team mit mehreren Entwicklerinnen und Entwicklern übertragen?
Lässt sich das auf ein Team mit mehreren Entwicklerinnen und Entwicklern übertragen?
Der Ablauf schon, die Zahlen nicht. Auf kopfwelt.com prüft und gibt eine Person frei. In einem Team kommen Zuständigkeiten für Reviews, Schutzregeln für Branches und abgestimmte Regeldateien dazu. Die Checkliste in dieser Serie fragt genau das ab.
Quellen
Repository von kopfwelt.com (privat), ausgewertet am 22.11.2026 mit
git log,git rev-list --countundgh pr list --state merged --limit 1000 --json number,createdAt,mergedAt,title.Pull Requests #326, #330 und #331 im selben Repository, 16. und 17. November 2026.
Anthropic: How Claude remembers your project, Dokumentation zu CLAUDE.md, Abruf 22.11.2026.
Vercel: Preview Deployments, Abruf 22.11.2026.
Google: PageSpeed Insights, Messwerkzeug für Ladezeiten.