Tech / KI

KI-assistierte Webentwicklung: wie diese Website entsteht

Zwei Sprachen, hell und dunkel, vom Handy bis zum großen Monitor: Diese Website baue ich mit Claude Code und einem Team aus KI-Agenten. So ist es aufgebaut, und hier liegt die Grenze.

14.11.2026
Inhalt · 5 Abschnitte

Früher war bei meinen eigenen Websites bei 80 Prozent Schluss. Ein WordPress-Template sah ganz nett aus, aber sobald ich etwas anders haben wollte, ging es nicht.

Diese Website hat zwei Sprachen, einen hellen und einen dunklen Modus und passt sich vom Handy bis zum großen Monitor an. Gebaut habe ich sie seit März mit KI, erst mit OpenAI Codex, seit Mai mit Claude Code. Inzwischen arbeitet daran ein kleines Team aus KI-Agenten mit festen Rollen: einer plant mit mir, andere recherchieren, setzen um, prüfen Texte und testen jede Änderung, bevor sie live geht.

Die 80-Prozent-Grenze ist dabei nicht verschwunden. Sie ist gewandert, zu mir. Was auf der Seite stehen soll, muss ich liefern, und was daraus geworden ist, muss ich gegenprüfen. Hier steht, wie das Team aufgebaut ist und wo die Grenze heute genau verläuft.

120+ Seiten in zwei Sprachen
8.700 Bildvarianten, vom Handy bis zum großen Monitor
6 Prüfer für jeden Artikel
5 automatische Prüfungen vor jedem Livegang

Neue Begriffe erklären die Klappboxen Einfach erklärt, Tiefer abtauchen ist für alle, die es genau wissen wollen. Wer nur wissen will, wie die Arbeit zwischen mir und der KI aufgeteilt ist, liest bis Unter der Haube.

Erst Inhalt, dann Code

Angefangen hat diese Website am 20. März. Am Tag danach entstanden sechs Planungsdokumente, bevor es überhaupt ein Website-Gerüst gab: wer hier was finden soll, wie Fotografie und Technik nebeneinander stehen, welche Seiten es braucht, wie das Design aussehen könnte und mit welchem Tech-Stack ich baue. Erst dann kam die erste Zeile Code.

Wer früher Websites für andere gebaut hat, kennt das: Kunden wollen eine Website, wissen aber nicht, was darauf soll. An dem Punkt war ich auch. Eine KI schreibt Code in Minuten, aber sie kann mir nicht sagen, was ich zeigen will. Bilder raussuchen, Erfahrungen aufschreiben, entscheiden, wofür die Seite steht, das bleibt meine Arbeit. Lässt man das weg, entsteht AI Slop: Text, der nur aufwärmt, was ohnehin schon im Netz steht.

Die Storyline kommt von mir, das Ausformulieren nicht mehr

Ich bin kein Rechtschreib-Profi und kein Genie im Formulieren. Mein Vater ist Deutschlehrer und hat früher alles Korrektur gelesen, was ich geschrieben habe. Wissen in eine gute Storyline zu packen, liebe ich. Das Ausformulieren habe ich gehasst, und deshalb habe ich mein Wissen lange weniger gern geteilt: Es aufzubereiten war jedes Mal extra Aufwand. Eine deutsche und eine englische Fassung parallel zu pflegen, hätte ich allein nie durchgehalten.

Heute liefere ich den Rohstoff: welche Geschichte ein Text erzählen soll, was der Leser danach wissen soll, welche Fakten und Erfahrungen ich beitragen kann. Oft diktiere ich das einfach. Claude macht daraus zuerst einen Bauplan, fragt nach, wo etwas fehlt, und schreibt erst, wenn ich den Plan freigegeben habe. Die englische Fassung entsteht danach aus demselben Kern neu, nicht Satz für Satz übersetzt.

Beim Gegenlesen ist die Aufteilung ungleich: Jeden Text lese ich, Code nur in Stichproben. Das unterscheidet das hier von dem, was man Vibecoding nennt, also Code anzunehmen, ohne ihn anzusehen. Den Code prüfen bei mir Agenten und automatische Tests, und was die nicht kennen, sehe ich auf der Seite oder gar nicht.

Ab hier geht es darum, wie das Team dahinter aufgebaut ist.


Unter der Haube

Angefangen habe ich mit OpenAI Codex und wenig Setup drumherum, also im Grunde mit einem Chatfenster. Codex war stark bei Texten und schwächer beim Code. Weil meine anderen Projekte eher codelastig sind, bin ich im Mai zu Claude Code gewechselt. Im August kamen Schreib-Skill, Prüfgremium und Prüf-Agenten dazu, im November die automatische Pipeline und eine feste Arbeitsteilung. Heute sieht das so aus:

Ich entscheide, der Orchestrator plant, Worker liefern, die Prüfung läuft von selbst.
Wer was macht Von oben nach unten: Ich gebe Inhalt, Urteil und Freigabe. Zwischen mir und dem Orchestrator (Opus) läuft die Planung in beide Richtungen. Der Orchestrator schreibt Aufträge an drei Worker (alle Sonnet): Rechercheur für Fakten mit Quelle, Umsetzer für Code nach Auftrag, Prüf-Agent für fünf Prüfungen. Höchstens drei laufen gleichzeitig. Darunter ein zweiter Strang für Texte: Schreib-Skill, Prüfgremium mit sechs Sitzen, Humanizer, dann lese ich selbst. Ich Inhalt, Urteil, Freigabe Orchestrator Opus plant mit mir, schreibt Aufträge Rechercheur Fakten mit Quelle Sonnet Umsetzer Code nach Auftrag Sonnet Prüf-Agent 5 Prüfungen Sonnet höchstens 3 gleichzeitig Der Strang für Texte Schreib-Skill Prüfgremium · 6 Sitze Humanizer ich lese
Einfach erklärt

Ein KI-Agent bekommt eine Aufgabe und arbeitet sie selbst ab: Er liest Dateien, schreibt Code, startet Programme und macht weiter, bis die Aufgabe erledigt ist. Ein Skill ist bei Claude Code ein gespeicherter Ablauf in einer Textdatei. Statt jedes Mal zu erklären, wie ich Texte haben will, steht es einmal dort, und Claude hält sich daran.

Opus plant mit mir, Sonnet arbeitet ab

Anthropic bietet seine Modelle in mehreren Größen an. Opus ist das stärkste und teuerste, Sonnet der schnellere Allrounder. Bei mir spricht nur Opus mit mir. Es versteht, was ich will, trifft die Entscheidungen mit mir und schreibt Aufträge. Alles, was viel Lesen oder Tippen nach klarer Vorgabe bedeutet, geht an Worker auf Sonnet, höchstens drei gleichzeitig: ein Rechercheur, der Fakten sammelt, ein Umsetzer, der Code nach Auftrag ändert, und ein Prüf-Agent, der Tests fährt.

Ein Beispiel aus diesem Artikel: Wie die Bilder ausgeliefert werden, wie der Farbmodus umschaltet und was jede Prüfung fängt, hat ein Rechercheur zusammengetragen, zu jeder Aussage mit dem Pfad der Datei, aus der sie stammt. Opus hat daraus geschrieben und die wichtigsten Zahlen noch einmal selbst nachgesehen.

Damit nicht jeder Agent alles auf einmal liest, gibt es Regeln, die nur laden, wenn sie gebraucht werden. Die Projektdatei CLAUDE.md liest Claude bei jedem Start: wie die Seite gebaut ist, welche Befehle es gibt, was nie passieren darf, etwa ohne mein Go etwas live zu stellen. Die Stilregeln für Texte laden dagegen erst, wenn Claude einen Text anfasst, die Regeln für Preise erst bei der Preis-Engine. Warum das wichtig ist, habe ich im Reiseartikel mit dem Bild vom Schreibtisch erklärt.

Sechs Prüfer für jeden Text

Jeder Artikel läuft durch dieselbe Kette. Ein Schreib-Skill führt mich durch Bauplan und Entwurf. Danach liest ein Prüfgremium den Text, sechs Agenten mit je einer Rubrik: Lesbarkeit, was sich kürzen lässt, Positionierung, fachliche Glaubwürdigkeit, Suchintention und Dramaturgie, also ob der Aufbau trägt. Jeder Sitz sieht nur seine Rubrik und den Text, nicht die Urteile der anderen. Das Gremium ändert nie selbst etwas. Es berichtet, und ich entscheide pro Befund.

Zum ersten Entwurf dieses Artikels hatte es einiges zu sagen. Fünf von sechs Sitzen fanden einen Satz im Abschnitt zum Livegang überflüssig, er ist raus. Die Dramaturgie fand den technischen Teil zu sehr wie eine Inventarliste, deshalb ist er jetzt um das Team herum gebaut. Der Kürzen-Sitz wollte die Abschnitte zu Bildern und Grafiken ganz streichen. Ich habe sie gekürzt und behalten, weil sie zeigen, was ohne KI nicht entstanden wäre. Und dem Sitz für Positionierung war mein Satz über Rechtschreibung zu bescheiden. Der bleibt.

Ganz am Ende geht jeder Text durch den Humanizer, einen frei verfügbaren Skill, der typische KI-Muster findet: aufgeblasene Formulierungen, Dreierlisten aus Prinzip, Sätze, die nur gut klingen. Damit er meine Stimme trifft, bekommt er ein paar Absätze von mir als Vorlage. Danach lese ich.

Tiefer abtauchen

Jeder Sitz ist derselbe Agent mit nur einem Werkzeug, dem Lesen von Dateien. Was er prüft, steht in einer Rubrik-Datei, die ihm der Auftrag mitgibt. Der Dramaturgie-Sitz fragt zum Beispiel: Steht in den ersten Sätzen ein konkretes Ergebnis, eine Zahl oder Szene statt einer Definition? Hat ein Leser, der nach dem ersten Drittel aufhört, die Kernaussage? Ergeben die Überschriften allein schon das Argument? Kommt das Fazit vor dem FAQ? Auf Wunsch kommt ein siebter Sitz dazu, der den Text wie ein Fremder liest, einmal als Laie und einmal als Praktiker. Bereits veröffentlichte Artikel bekommt das Gremium mit einem Urteil zurück: behalten, nacharbeiten, stark kürzen oder neu aufsetzen.

Nichts Bekanntes rutscht durch

Gefährlich sind bei einer Website, an der eine KI mitbaut, vor allem Änderungen, die an einer Stelle stimmen und an einer anderen etwas kaputt machen. Oder die auf der deutschen Seite landen und auf der englischen nicht. Deshalb muss jede Änderung durch fünf Prüfungen:

Nichts geht live, bevor alle fünf grün sind. Lokal und bei GitHub, jedes Mal.
Fünf Prüfungen Eine Änderung durchläuft fünf Prüfungen nacheinander: Typprüfung (passt der Code zusammen), Sprachparität (DE und EN vollständig), Preis-Regression (Preise unverändert), Build (bauen alle Seiten), Linkprüfung (kein Link ins Leere). Sind alle grün, folgt meine Freigabe, dann geht die Seite live. Dieselben fünf Prüfungen laufen zweimal: lokal im Prüf-Agenten und bei GitHub in der CI. Änderung 1 Typprüfung passt der Code zusammen? 2 Sprachparität DE und EN vollständig? 3 Preis-Regression Preise unverändert? 4 Build bauen alle Seiten? 5 Linkprüfung kein Link ins Leere? alles grün meine Freigabe live läuft zweimal lokal: Prüf-Agent GitHub: CI
  1. Typprüfung: findet Code, der nicht zusammenpasst, etwa eine Komponente, die mit falschen Angaben aufgerufen wird.
  2. Sprachparität: Jede deutsche Seite braucht ihr englisches Gegenstück, jeder Artikel seinen Zwilling und jede Seite einen Eintrag im Seitenverzeichnis. Ausnahmen stehen auf einer kurzen, ausdrücklichen Liste.
  3. Preis-Regression: Die Preisrechner werden Feld für Feld gegen eine unabhängige Referenzrechnung geprüft.
  4. Build: Alle Seiten werden gebaut. Dabei fallen fehlerhafte Artikelangaben und kaputte Importe auf.
  5. Linkprüfung: Jeder interne Link, jeder Sprachumschalter und jede Angabe für Suchmaschinen muss auf eine Seite zeigen, die es wirklich gibt.

Diese fünf Schritte laufen zweimal. Zuerst lokal: Bevor Claude etwas als fertig meldet, fährt der Prüf-Agent alle fünf, und er prüft nur, repariert nie. Dann noch einmal auf GitHub, sobald eine Änderung zur Übernahme ansteht. Dass die zweite Runde etwas findet, ist selten geworden. Im Juni war sie noch rot: Die Typprüfung hatte 13 Fehler gefunden, alle rund um die Art, wie Bilder im Code beschrieben werden. Damals gab es den lokalen Prüf-Agenten noch nicht.

Live geht nur, was ich freigegeben habe. Danach läuft alles automatisch: Prüfungen, Build, und erst wenn alles grün ist, lädt ein eigener Schritt die fertigen Dateien auf den Server. Dieser Schritt passt auf sich selbst auf:

  • Er meldet sich mit einem Schlüssel an, ein Passwort liegt nirgends.
  • Er prüft, ob am Ziel wirklich diese Website liegt und ob der Build vollständig ist.
  • Er löscht nie mehr als eine festgelegte Zahl von Dateien auf einmal und lässt Dateien, die nur auf dem Server leben, in Ruhe.
  • Von Hand gestartet, macht er erst nur einen Probelauf und zeigt, was er hochladen und löschen würde.

Damit kann nichts durchrutschen, was eine der Prüfungen kennt. Was keine kennt, steht weiter unten.

Einfach erklärt

Ein Branch ist eine Arbeitskopie neben der Hauptversion. Dort wird gebaut und geprüft, ohne dass die echte Seite etwas davon merkt. Ein Pull Request ist der Antrag, diese Arbeitskopie in die Hauptversion zu übernehmen, das Übernehmen selbst heißt Merge. Bei jedem solchen Antrag startet GitHub automatisch die Prüfungen. Das nennt man Continuous Integration, kurz CI.

Tiefer abtauchen

Die Preis-Regression ist ein sogenannter Golden-Master-Test. Im Prüfskript steckt die alte Preisformel als eigene, unabhängige Rechnung. Für eine feste Reihe von Hochzeits- und Porträt-Fällen in allen Preismodi rechnen Skript und Website-Engine parallel, und jedes Feld muss übereinstimmen. So kann Claude die Engine umbauen, ohne dass sich still ein Preis verschiebt.

Die Linkprüfung läuft mit dem Werkzeug lychee über die fertig gebauten Seiten, ganz ohne Internet. Auch Adressen, die auf die eigene Domain zeigen, etwa die Sprachverweise für Suchmaschinen, werden auf die gebauten Dateien umgebogen und mitgeprüft.

Was das Team gebaut hat, das ich allein nicht gebaut hätte

Gebaut ist die Seite mit Astro. Astro erzeugt alle Seiten vorab als fertige HTML-Dateien. Beim Aufruf rechnet kein Server, und an eigenem JavaScript läuft im Browser nur ein kleines Skript für Farbmodus, Menü und Inhaltsverzeichnis. Die Preisrechner sind die einzigen interaktiven Teile.

Bilder in passender Größe. Jedes Foto geht durch eine Bildkomponente. Sie erzeugt es in mehreren Breiten als AVIF und WebP und lädt es erst, wenn es ins Bild scrollt. Das Handy bekommt die kleine Fassung, der große Monitor die große. Über die ganze Seite sind das rund 8.700 Bildvarianten und etwa 1,5 Gigabyte. Ohne Zwischenspeicher hat ein Build in der Pipeline schon anderthalb Stunden gedauert, mit Cache werden nur neue Bilder umgerechnet.

Eine Grafik, vier Fassungen. Jede Grafik in meinen Artikeln gibt es auf Deutsch und Englisch, hell und dunkel. Das klingt nach vier Dateien pro Grafik. Es ist eine: eine kleine Komponente mit einer Zeichnung als Code, einem SVG, und den Beschriftungen in beiden Sprachen. Farben stehen nicht in der Zeichnung, sie kommen aus denselben Farbvariablen wie der Rest der Seite. Wechselt der Modus, färbt sich die Grafik mit um. Eine geänderte Beschriftung ist damit eine Zeile Text, nicht vier neue Bilder.

Dieselbe Grafik in zwei Sprachen und zwei Farbschemata. Bauen muss ich sie nur einmal.
Eine Grafik, vier Fassungen Vier gleiche kleine Diagramme in einem Raster aus zwei mal zwei Feldern: Text, Prüfung, live. Oben links deutsch im hellen Schema, oben rechts englisch hell, unten links deutsch im dunklen Schema, unten rechts englisch dunkel. Deutsch · hell Text Prüfung live Englisch · hell Text Check live Deutsch · dunkel Text Prüfung live Englisch · dunkel Text Check live

Zwei Sprachen, die zusammenpassen. Der Sprachumschalter führt zur übersetzten Seite. Gibt es noch keine, landet man auf der Übersicht der anderen Sprache statt auf einer Fehlerseite.

Tiefer abtauchen

Bis 1920 Pixel Breite bleibt die Grundschrift bei 16 Pixeln, darüber wächst die ganze Seite mit, statt als schmaler Streifen in der Mitte zu stehen. Das ist eine einzige Regel. Fast alle Maße sind in rem angegeben, also relativ zur Grundschrift, und die wächst mit der Fensterbreite:

html {
  font-size: clamp(100%, calc(0.263vw + 10.95px), 131.25%);
}

Bei 3440 Pixeln ergibt das 20 Pixel, gedeckelt ist bei 21. Schrift, Abstände und die maximale Seitenbreite wachsen damit gemeinsam.

Wo die KI danebenlag

Drei Fehler aus den letzten Monaten, und alle drei sahen auf den ersten Blick richtig aus.

Umlaute. In den Texten der Porträt-Preisrechner stand „fuer“, „groesser“ und „Verfuegbarkeit“. Die KI hatte deutschen Text mit ae, oe und ue geschrieben. Aufgeräumt wurde das im Juni, in zwei Durchgängen über knapp 90 Zeilen. Seitdem steht in den Regeln: sichtbarer Text immer mit echten Umlauten.

Eine Regel, die nicht griff. Diese Woche sollte eine Regel die Grafiken auf eine mittlere Breite begrenzen. Sie stand im Stylesheet, gegriffen hat sie nicht. Erst ein zweiter Anlauf hat sie wirksam gemacht. Keine der fünf Prüfungen merkt so etwas. Das sieht man nur auf der Seite.

Eine Absicherung, die nur gut aussah. Die erste Absicherung des Livegangs sah im Code überzeugend aus und hätte beim Hoster nichts bewirkt. Sie wurde am selben Tag durch die Schutzmechanismen ersetzt, die oben stehen.

Die Grenze liegt jetzt bei mir

Früher war die 80-Prozent-Grenze technisch: Das Template konnte nicht mehr. Heute liegt sie bei mir, an drei Stellen. Den Inhalt muss ich liefern, kein Agent weiß, was ich zeigen will. Gestaltung bleibt eine Lücke, denn weder Claude noch ich sind Designer. Und Konsistenz: eine Änderung, die nicht über alle Seiten nachgezogen wird, oder eine mit Nebenwirkungen an anderer Stelle. Gegen einen Teil davon helfen die Prüfungen, gegen den Rest nur, die Seite anzusehen, auf dem Handy und am Monitor, hell und dunkel.

Der größere Gewinn ist für mich aber gar nicht die Technik. Das Ausformulieren war lange der Grund, warum ich mein Wissen weniger gern geteilt habe. Heute ist es nicht mehr der Engpass, und diese Seite ist das Ergebnis.

FAQ

Muss ich programmieren können?

Für eine einfache Seite nicht. Für ein Setup wie dieses hilft es: Git, eine Kommandozeile und genug Verständnis, um eine Stichprobe Code beurteilen zu können. Die meiste Arbeit steckt trotzdem im Inhalt.

Ist dieser Text von einer KI geschrieben?

Mitgeschrieben. Storyline, Fakten und Erfahrungen kommen von mir, formuliert hat Claude, geprüft haben sechs Agenten und ich. Jeder Satz, der hier steht, ist durch meine Hände gegangen.

Kann ich das Setup nachbauen?

Die Bausteine sind frei verfügbar: Claude Code, Astro und der Humanizer-Skill. Meine Regeln und Rubriken sind auf diese Seite zugeschnitten. Ein sinnvoller Anfang ist eine kurze CLAUDE.md, eine automatische Prüfung für den Fehler, der am meisten nervt, und ein Skill für das, was man der KI am häufigsten erklärt.

Mehr zum Thema: wie ich mit KI-Agenten meine Reisen plane, steht im Artikel KI-Agenten statt Reisebüro. Weitere Projekte rund um KI stehen im KI-Bereich.

Arbeitsstand