Der Bauplan

Was du hier siehst

Wie wir eine KI gebaut haben, die unser Unternehmen kennt ist einer der längsten Guides auf dieser Website: wie wir der KI bei Carewell ein gemeinsames, dauerhaftes Gedächtnis über das Unternehmen gegeben haben, und wie du dasselbe aufbaust. Hier ist er als Word-Dokument mit 26 Seiten, auf Englisch. Der Text ist der des Guides, unverändert. Alles darum herum ist neu: ein Titelblatt, ein Inhaltsverzeichnis, eine Zusammenfassung auf einer Seite, ein Kapitel pro Abschnitt mit seinem Namen oben auf jeder Seite, acht Abbildungen, hervorgehobene Kästen, eine Seite im Querformat mit dem ganzen Bauplan und eine Rückseite mit einem QR-Code, der den Guide online öffnet.

Ich vermute, dass viele Leute gar nicht wissen, was ein Word-Dokument sein kann. Word hat echte Formatvorlagen, Abbildungen mit nummerierten Beschriftungen, Fussnoten, Abschnitte, die eine einzelne Seite ins Querformat drehen, Kontrollkästchen und eingebettete Schriften. Ich wollte sehen, was eine KI daraus macht, wenn du etwas Grossartiges verlangst.

Warum dieser Guide

Ich habe Claude Code gebeten, einen passenden Guide auszuwählen, der nicht zu kurz ist. Er hat diesen gewählt und zwei Gründe genannt. Der Guide ist ein Bauplan: Er beschreibt einen Kreislauf, vier Phasen und sieben Schritte, und zeichnet nichts davon. Und es ist die Art Text, die Leute an ihre Geschäftsleitung weitergeben, wo eine Word-Datei immer noch gelesen, ausgedruckt und beschrieben wird.

Bilder, wo sie zählen

Der Guide online hat ein einziges Bild, die Illustration oben. Mein Prompt verlangte Visualisierungen dort, wo sie am meisten bringen. Also ist Claude Code den Text durchgegangen und hat nach Dingen gesucht, die er in Worten beschreibt und die als Bild leichter zu verstehen sind. Er hat acht Abbildungen gezeichnet:

• Das Problem: dieselben vier Leute, jede und jeder fängt im eigenen Chat bei null an, neben einem gemeinsamen Gedächtnis.
• Die drei Zutaten und wie sie sich gegenseitig speisen.
• Warum es sich verstärkt: ein leerer Chat, der nach jedem Gespräch wieder bei null steht, neben einem System, das behält, was es lernt. Die Abbildung ist als Skizze beschriftet, weil keine Messungen dahinterstehen.
• Das Flywheel, mit den vier Arten, wie sich das System selbst korrigiert.
• Wohin der Aufwand geht: etwa 20 Prozent Struktur, 80 Prozent Wissen, und die vier Phasen, die das System gefüllt haben.
• Die sieben Schritte auf einer Linie.
• Wie Wissen hineinkommt, und was die KI lesen darf.
• Der ganze Bauplan auf einer Seite im Querformat, zum Ausdrucken und Aufhängen.

Andere Teile wurden zu Elementen von Word statt zu Bildern, damit sie bearbeitbar bleiben: die vier Szenarien aus dem Alltag und die fünf Fehler als Karten, die Ordnerstruktur als Codeblock zum Kopieren, der Check in Kapitel 9 als Kontrollkästchen zum Anklicken, und die Meinungsverschiedenheit zwischen unserem CEO und mir als Eintrag mit beiden Sichtweisen nebeneinander, so wie der Guide vorschlägt, sie festzuhalten.

Eine richtige Word-Datei

• Echte Überschriften. Der Navigationsbereich von Word zeigt jedes Kapitel, das Inhaltsverzeichnis verlinkt auf jedes, und seine Seitenzahlen sind Felder, die Word aktualisieren kann.
• Formatvorlagen statt loser Formatierung. Einleitungsabsatz, Zitat, Karte, Beschriftung: Jedes Element ist eine benannte Formatvorlage. Änderst du die Vorlage, zieht das ganze Dokument mit.
• Fussnoten für Papier. Die Links bleiben anklickbar, und der erste Link auf jeden Guide und jeden Tool-Test bekommt eine Fussnote mit der Adresse. So sagt dir auch ein ausgedrucktes Exemplar, wo du nachschauen kannst.
• Die Schriften stecken in der Datei. Die Schriften dieser Website sind eingebettet. Auf einem Computer ohne sie hat LibreOffice trotzdem die aus der Datei verwendet; Word sollte das auch tun.
• Beschreibungen für Screenreader. Jede Abbildung hat eine, und das PDF hat Tags für Screenreader und ein Lesezeichen für jedes Kapitel.
• Der QR-Code funktioniert. Ein Decoder hat ihn gelesen, bevor er auf die Rückseite kam.

Wie es entstanden ist

Mein ganzer Prompt steht unten auf dieser Seite. Claude Code arbeitet direkt im Projekt dieser Website. Den Guide, meine Schreibregeln und das Design der Website hatte er also von Anfang an zur Hand.

Er hat das Dokument als Code geschrieben: Ein Skript liest den Guide und baut daraus die Word-Datei. Der Text existiert nur einmal, im Guide, und wenn ich den Guide ändere, lässt sich das Dokument mit dem neuen Text neu bauen. Jede Abbildung in den Kapiteln hängt an einem Satz im Guide. Schreibe ich diesen Satz um, bricht der Build ab und sagt, welche Abbildung ihren Platz verloren hat.

Dann hat er jede Seite in ein Bild umgewandelt und sich angesehen, über viele Runden. Der erste Durchgang hatte Probleme, die du nur beim Hinschauen siehst. Jede Abbildung war auf die Höhe einer Textzeile abgeschnitten, wegen einer Einstellung für den Zeilenabstand, die LibreOffice, das die Seiten in Bilder umwandelt, als feste Höhe gelesen hat. Die Kontrollkästchen erschienen angekreuzt, obwohl keines angekreuzt war. In den Abbildungen ragten Beschriftungen aus ihren Kästen, und mehrere Kapitel endeten mit einer einzigen Zeile auf einer eigenen Seite. Er hat jedes Problem behoben und wieder hingeschaut.

Zum Schluss hat er die Datei gegen die Spezifikation des Word-Formats geprüft. Das fand etwas, das kein Bild zeigt: Jede Textmarke hatte dieselbe Nummer, was das Format nicht erlaubt.

Was nicht perfekt ist

• Niemand hat es bisher in Word geöffnet. Word läuft dort nicht, wo Claude Code arbeitet, deshalb liefen alle Prüfungen und die Vorschauen hier in LibreOffice, einem kostenlosen Office-Paket. Word bricht vielleicht eine Zeile oder eine Seite an einer anderen Stelle um. Stimmt eine Seitenzahl im Inhaltsverzeichnis nicht, klick sie mit der rechten Maustaste an und wähle «Feld aktualisieren».
• Jedes Kapitel beginnt auf einer neuen Seite, deshalb enden manche auf einer fast leeren Seite. In einem gedruckten Bericht ist das normal, auf dem Bildschirm ist es viel Weiss.
• Die Abbildungen sind Bilder. Ihre Beschriftungen kannst du in Word ändern, aber für eine Beschriftung in einer Abbildung änderst du den Code, der sie zeichnet.
• Es gibt das Dokument nur auf Englisch. Den Guide gibt es auch auf Deutsch und Französisch, das Dokument nicht.
• Die Zusammenfassung und die Beschriftungen der Abbildungen sind separat geschrieben. Sie geben den Guide in weniger Worten wieder. Ändere ich eine Tatsache im Guide, muss ich sie von Hand nachprüfen. Der Build prüft nur die Sätze, an denen die Abbildungen hängen.
• Niemand hat es in Google Docs oder Apple Pages geprüft. Beide verwenden ihre eigenen Schriften statt der eingebetteten. Das PDF sieht überall gleich aus.

Was du daraus lernen kannst

• Verlang das Format, das du brauchst, und sag, wer es liest. Ein Dokument für eine Geschäftsleitung, die Dinge ausdruckt, braucht andere Entscheidungen als eine Seite, durch die Leute scrollen.
• Verlang Bilder dort, wo der Text eine Struktur beschreibt: einen Kreislauf, Schritte, ein Vorher und Nachher, einen Vergleich. Lass die KI die Stellen auswählen und begründen. Das ist ein guter Test, ob sie den Text verstanden hat.
• Halte den Text an einem Ort. Dieses Dokument wird aus dem Guide gebaut. Der lange Text existiert also nur einmal, und nur die kurzen Zusammenfassungen brauchen einen zweiten Blick.
• Lass sie ihre eigene Arbeit ansehen, und prüf dann, was Hinschauen nicht findet. Die Bilder der Seiten zeigten die abgeschnittenen Abbildungen. Erst die Prüfung gegen die Spezifikation des Formats fand die doppelten Textmarken.