the world of dizzi

Die Methode

Wie ein Mensch zehn Anwendungen baut

Nicht durch schnelleres Tippen. Sondern dadurch, dass die Regeln zuerst aufgeschrieben werden – und dass sie auch dann nicht gebrochen werden, wenn es bequem wäre.

Kurz gesagt
Die Regeln stehen vor dem Code fest und gelten auch dann, wenn ein Bruch schneller wäre.
Ein Mensch führt; Bau-Chats der KI erledigen die Arbeit und geben sie schriftlich weiter, nicht im Gespräch.
Geld, Veröffentlichen und Löschen geschehen nie ohne einen Menschen.

Alles auf dieser Seite beruht auf einer Datei im öffentlichen Repository oder sagt, wohin diese Datei gegangen ist. Die Dokumente sind deutsch – geschrieben, um benutzt zu werden, nicht um vorgezeigt zu werden –, und die Zitate unten stehen in ihrem Wortlaut, mit der Quelle jedes Mal genannt.

Kapitel eins

Geschriebenes Gesetz vor dem Code

Bevor es eine Architektur gab, gab es eine Datei mit verbindlichen Arbeitsregeln, und jede Sitzung seither musste sie achten, ohne daran erinnert zu werden. Es ist ein kurzes Dokument. Es ist auch der Grund, warum das System nicht auseinanderlief, während ein einzelner Mensch zehn Anwendungen gebaut hat.

Die nützlichste dieser Regeln ist die über Ehrlichkeit, weil sie die Software bindet und nicht nur den Autor. Ein Wert, der nie gemessen wurde, wird als nicht gemessen gemeldet. Er wird nie zur Null, und eine Null wird nie zur Behauptung.

Gesetz 2 · Ehrlichkeit

„Ehrliche Bewertungen. Motto: ‚Wir finden gemeinsam den besten Weg.‘ Bei eigenen Zweifeln: offen sagen, nicht schönreden.“

Gesetz 4 · Qualität

„Code-Qualität = oberstes Gesetz. Strukturell, professionell, funktionell, effizient, absolut sauber und nachvollziehbar.“

Der englische Satz, mit dem das README des Repositorys dieselbe Regel sagt: “If a value was never measured, the system says so instead of showing a zero.” Diese Regel gilt auch für diese Website – deshalb gibt es eine Seite, die sagt, wie die Zahlen vorn auf dieser Website gezählt wurden →

Kapitel zwei

Verträge vor Funktionen

Eine Funktion baut man einmal. Ein Vertrag baut die nächsten neun.

Der App-Vertrag legt fest, was jede Anwendung beantworten muss: Gesundheit, Manifest, Zusammenfassung, Einstellungen, Konto, Tresor, Prüfprotokoll, Aktionen und einen MCP-Werkzeugserver. Wer ihn erfüllt, dessen Anwendung nimmt das Dashboard von selbst auf; der Assistent erreicht sie ohne neue Anbindung.

Zum Vertrag statt zum Wunsch wird er dadurch, dass eine Maschine ihn prüft. Ein Konformitäts-Modul läuft in der Testsammlung von sieben der zehn, sodass eine Anwendung, die abweicht, an ihrem eigenen Bau scheitert. Die Spezifikation ist über die Rangfolge unmissverständlich: Wo Text und Code einander widersprechen, gilt der Code.

# the scaling mechanic, in one line
write the contract
  → the app appears in the dashboard
  → the assistant can reach it
  → its tests enforce the contract
  → appkit upgrades reach it for free
Festgelegt in docs/16, durchgesetzt von appkit/conformance.py.Quelle: docs/16_APP_VERTRAG_SPEC.md

Kapitel drei

Recherche vor Entscheidungen

Unabhängige Recherche ist hier keine Verzierung nach Belieben; sie ist Gesetz 3 – gezielt an kritischen Stellen und regelmäßig dazwischen. Die Protokolle werden aufgeschrieben und aufbewahrt: Recherche-Wellen für das Netz, Grundlagenrecherche und Studien zu Kennzahlen für die Trading-Seite, ein Katalog der Strategien, der festhält, was verworfen wurde, und ebenso, was übernommen wurde.

Die verworfenen Möglichkeiten aufzubewahren ist der Teil, der sich später auszahlt. Sechs Monate danach lautet die Frage nie „was habe ich gewählt?“ – sondern „habe ich mir das schon angesehen, und warum habe ich Nein gesagt?“

docs/recherche – die Recherche-Protokolle ↗

Gesetz 3 · Recherche

„Regelmäßige selbstständige Recherche. An kritischen Stellen gezielt, und generell regelmäßig eingestreut, damit ein maximal optimiertes Produkt entsteht.“

Gesetz 9 · kein Auseinanderlaufen

„Es darf NIE ein Zustand entstehen, in dem Code/Plan und Doku auseinanderlaufen; veraltete Referenzen werden beim Update aktiv entfernt.“

Kapitel vier

Ein Orchester aus Bau-Chats der KI

Das ist der Teil, der von außen schwer zu sehen ist, deshalb hier ganz schlicht. Ein Mensch führt. Ein verwaltender Chat hält den Gesamtstand und entscheidet, was als Nächstes geschieht; getrennte Bau-Chats erledigen die eigentliche Arbeit, ein Arbeitspaket nach dem anderen. Sie sprechen nicht miteinander. Sie sprechen über geschriebene Übergabe-Dokumente – dieselbe Art von Schriftstück wie die Verträge und die Gesetze.

Dieses Übergabe-Dokument ist die eigentliche Erfindung. Es trägt den Auftrag, die Grenzen, die verbotenen Schritte und die Abnahme-Prüfung, sodass ein frischer Chat ohne Erinnerung an gestern ein Paket aufnehmen und im selben Maß fertigstellen kann. Voneinander unabhängige Arbeitspakete laufen gleichzeitig, jedes in seinem eigenen Arbeitsbaum, sodass zwei Bauten nie um denselben Stand kämpfen.

Gesetz 10 · drei Stufen

„Modell-Wachsamkeit – DREI Stufen: Assistenz-KI / Bau-KI / Architektur-KI. Arbeitspakete werden dreistufig markiert. Ehrlich bleiben: kein unnötiges Hochstufen – aber auch kein riskantes Runterstufen; im Zweifel eine Stufe höher.“

  • Assistenz-Stufe – nur für Pakete, für die es schon ein sauberes Referenz-Muster gibt, grüne Tests es absichern, keine Entscheidung über die Architektur nötig ist und nichts angefasst wird, was für Sicherheit oder Geld kritisch ist.
  • Bau-Stufe – der Standard für gewöhnliche Bau-Arbeit.
  • Architektur-Stufe – feine Logik von Architektur und Schema, der Kern der KI, große selbstständige Läufe über Nacht, tiefe Prüfungen der Sicherheit, schwierige Fehler.

Die erste Ausführung eines neuen Musters bekommt nie die Assistenz-Stufe. Diese Regel ist aufgeschrieben, nicht aus dem Stegreif.

Kapitel fünf

Der Weg, den ein Arbeitspaket nimmt

Das Kapitel oben nennt die Beteiligten. Hier ist der Weg, auf dem sie laufen: was mit einem einzelnen Arbeitspaket zwischen der ersten geschriebenen Zeile und dem Zusammenführen geschieht. Jeder Halt ist eine Regel mit einem Dokument dahinter.

  1. Der Auftrag steht vor der Arbeit

    Ein Paket beginnt als Datei: das Ziel, der Commit, von dem es ausgeht, die Schritte, die verboten sind, und die Prüfung, die es bestehen muss, bevor es sich fertig nennen darf. Es ist für jemanden ohne Erinnerung an gestern geschrieben, denn genau der nimmt es auf.

  2. Die Spur gehört zur Akte

    Unabhängige Pakete laufen gleichzeitig, jedes in seinem eigenen Arbeitsbaum auf seinem eigenen Zweig, sodass zwei Bauten nie denselben Stand bearbeiten. Dieser Teil ist nachprüfbar statt behauptet: Die Verträge im Repository nennen Baum, Zweig und Stufe in ihrem Statuskopf, sodass sich ein Dokument bis zu der Spur zurückverfolgen lässt, die es hervorgebracht hat.

    Ein Vertrag, der seine Spur im Kopf trägt ↗

  3. Die Erlaubnis kommt vor der Nacht, nicht während ihrer

    Ein Lauf ohne Aufsicht trägt seine Erlaubnisse schriftlich: was neu gestartet werden darf, was grün bleiben muss, was er nicht anfassen darf und was am Morgen auf dem Tisch liegen muss. Die Arbeitsregeln legen die Reihenfolge fest – der Plan wird einmal zurückgelesen, ein Mensch bestätigt, und erst dann arbeitet die Maschine allein durch.

    Gesetz 7, die Nachtschicht ↗

  4. Zweimal hintereinander sauber, sonst ist es nicht fertig

    Der Abschluss eines Pakets ist eine Schleife, kein Häkchen: die Prüfungen laufen lassen, durchsehen, was sie berührt haben, reparieren, was sie gefunden haben, und dann alles noch einmal laufen lassen – das Paket gilt erst nach zwei sauberen Durchgängen hintereinander als fertig. Ein einzelner sauberer Durchgang sieht nämlich auch so aus, wenn eine Prüfung das, was sie lesen sollte, nie erreicht hat.

  5. Es endet in einem Dokument, nicht in einem Gespräch

    Das Letzte, was ein Paket hervorbringt, ist ein Übergabe-Blatt: was gebaut wurde, was gemessen wurde, was offen blieb. Der nächste Chat beginnt mit dem Blatt. Eine Übergabe, die nur in einem Gespräch lebt, ist weg, wenn das Gespräch weg ist.

  6. Der Überblick bleibt bei dem Menschen, der führt

    Nach einem großen Paket verlangen die Regeln eine große Kontrollrunde über alles, und vor dieser Runde eine systematische Ausgabe dessen, was die Systeme jetzt tun – sodass der Überblick an den Teilen abgelesen wird statt aus einer Zusammenfassung über sie.

    Gesetz 1, die Kontrollrunden ↗

Drei Halte auf diesem Weg verlinkten früher ein ausgearbeitetes Beispiel – ein Arbeitspaket, seinen Abschluss, ein Übergabe-Blatt. Diese Dateien lagen bis zum 6. August 2026 im öffentlichen Auszug, dann wurde er auf einen kuratierten Satz von Dokumenten zurückgeschnitten. Die Beispiele gehören nicht zu diesem Satz, deshalb sind die Links weg, statt ins Leere zu zeigen: was jetzt veröffentlicht ist und was es war →

Diese Website ist auf dieselbe Weise gebaut. Sie ist ein Arbeitspaket wie jedes andere: zuerst aufgeschrieben, in einem eigenen Arbeitsbaum gebaut, an einer Prüfung aus benannten Skripten gemessen – und erst dann fertig genannt, als diese Prüfung zweimal hintereinander sauber durchlief.

Kapitel sechs

Ein Mensch vor allem, was sich nicht umkehren lässt

Die Assistenten des Netzes beobachten und schlagen vor. Wirkung verlangt einen Menschen, auf der Sicherheitsstufe, die zur Handlung passt. Geld, Veröffentlichen und Löschen sind die drei Stellen, an denen diese Regel nicht verhandelbar ist – und es sind genau die drei Stellen, an denen ein selbstständiges System am verlockendsten und am gefährlichsten ist.

Durchgesetzt wird das durch den Aufbau statt durch Disziplin: Der Endpunkt für den Vorschlag und der Endpunkt für die Freigabe sind verschiedene Endpunkte, die Freigabe verlangt eine frische Anmeldung, und beide Seiten landen in einem Prüfprotokoll, das die vorschlagende Seite nicht ändern kann.

Gesetz · ein Mensch vor dem Unumkehrbaren

„Nichts Unumkehrbares ohne einen Menschen. Geld, Veröffentlichen und Löschen stehen hinter ausdrücklichen Toren. Die Trading-Flotte schlägt vor; ein Mensch entscheidet.“

Gesetz 11 · Ruhe vor Hast

„Im Zweifelsfall lieber eine Sekunde länger prüfen oder noch einmal überdenken, bevor gehandelt wird. ‚Schnell bitte‘ setzt Sorgfalt nie außer Kraft. Die Struktur trägt – nicht die Eile.“

Kapitel sieben

Warum es schnell geht

Das Tempo ist nicht der Punkt, aber es ist die Frage, die alle stellen, also hier die ehrliche Antwort – sechs Teile, keiner davon Zauberei.

Verträge machen Anwendungen zusammensetzbar

Die zehnte Anwendung sollte weniger kosten als die zweite, weil die Schnittstelle einmal entschieden wurde und durch Tests durchgesetzt wird. Das ist das Argument für die Architektur, keine Messung – ich habe es nie gestoppt.

appkit verhindert das Auseinanderlaufen

Eine gemeinsame Bibliothek statt zehn auseinanderlaufender Kopien. Eine Verbesserung der Sicherheit kommt in jeder Anwendung an, welche die Bibliothek einbindet, mit einem Commit.

Gesetze verhindern Nacharbeit

Die meiste verlorene Zeit in einem Projekt geht dafür drauf, etwas rückgängig zu machen, das nie hätte begonnen werden sollen. Geschriebene Regeln sind billiger als Umkehr.

Die KI liefert Menge

Bau-Chats erzeugen Code und Dokumentation in einem Tempo, das ein einzelner Mensch nicht schafft. Das ist der Teil, den alle schon kennen.

Der Mensch liefert das Urteil

Was gebaut wird, was abgelehnt wird, wann etwas gut genug ist und wann Schluss ist. Diese Entscheidung hat hier kein Modell bekommen.

Und es ist nachprüfbar

Das Tempo ist keine Behauptung auf einer Website. Es sind datierte Dokumente in einem Repository – der App-Vertrag vom 12. Juni 2026, sieben Verträge vom 3. und 4. Juli, der Chronik-Vertrag vom 11. Juli.