---
title: "max.system, max.zeichen und max.lab — Maximilian Dahl"
description: "Product Design Case Study von Maximilian Dahl: ein eigenes Design System mit vier Token-Schichten, 131 eigenen Zeichen, Komponentenverträgen, Guards und einer Dokumentationsplattform, gebaut mit Claude Code, Codex und Orca nach denselben Regeln."
url: https://max.does.systems/work/max-system/
lang: de
---

Product Design Case Study · Design Systems · Eigenes System · Eigenes System · max.systems · Oktober 2026

# Ein Design System, das man nicht umgehen kann

Für mein Portfolio habe ich kein Template genommen, sondern ein System gebaut: vier Token-Schichten, 131 eigene Zeichen, Verträge für jede Komponente und Guards, die jede feste Farbe ablehnen. Menschen und KI-Agenten arbeiten nach denselben Regeln, und max.lab macht meine früheren Systeme live begehbar.

Case lesen · RZu den Ergebnissen

Rolle im Projekt · Alles in einer Hand · Gestaltung, Architektur, Code und Dokumentation

Werkzeuge · Astro, React, Tailwind 4 · Radix Colors und shadcn; gebaut mit Claude Code, Codex und Orca

Umfang · Drei Teile · max.system, max.zeichen und max.lab

Status · Live · +2 · Stand September 2026 · Live · Trägt diese Website seit Oktober 2026 · Geprüft · Guards und rund 300 Tests bei jedem Build · Offen · Wirkung nicht gemessen · und 2 weitere Zustände

Stand September 2026

**Live · +2**

Stand September 2026

- Live
   Trägt diese Website seit Oktober 2026

- Geprüft
   Guards und rund 300 Tests bei jedem Build

- Offen
   Wirkung nicht gemessen

Ich habe keine Regeln für mein Portfolio aufgeschrieben. Ich habe ein System gebaut, an dem keine Änderung vorbeikommt, egal ob sie von mir oder von einem Agenten stammt.

max.system, max.zeichen und max.lab

## Kurzfassung

- 88 Rollen
   in vier Token-Schichten; feste Werte lassen den Build scheitern

- 131
   Zeichen aus einer Quelle, fremde Icon-Imports gesperrt

- 300+
   Komponentendateien mit Vertrag
   **300+**Komponentendateien mit Vertrag · Manifest mit Quellhashes

1. Problem
   Ein Weg pro Wert
   Vier Token-Schichten. Keine Farbe und kein Abstand liegt außerhalb.

2. Eingriff
   Das System sagt Nein
   Guards lassen den Build scheitern, wenn etwas am System vorbeigeht.

3. Ergebnis
   Für Mensch und Agent
   Dieselben Dateien und Tests gelten für mich und jedes KI-Werkzeug. max.lab macht frühere Systeme begehbar.

Rolle im Projekt**Alles in einer Hand**Gestaltung, Architektur, Code und Dokumentation

Werkzeuge**Astro, React, Tailwind 4**Radix Colors und shadcn; gebaut mit Claude Code, Codex und Orca

Umfang**Drei Teile**max.system, max.zeichen und max.lab

02 · Warum ein eigenes System

## Ein Portfolio für Design Systems muss selbst eins sein

Ich baue mein Portfolio mit KI-Agenten. Die sind schnell, aber sie erfinden gern: einen Hexwert hier, ein fremdes Icon da, einen Abstand, den es nirgends sonst gibt. Nach ein paar Wochen hätte die Seite ausgesehen wie die Codebasen, die ich in jedem meiner Jobs aufgeräumt habe.

Das System muss vier Jobs erledigen, je nachdem, wer gerade baut, ändert oder prüft:

- **Ich, beim Bauen**Job Story
   Wenn · ich eine neue Seite oder einen Case baue,
   will ich · nur aus Tokens, Zeichen und Komponenten des Systems schöpfen,
   damit · die Seite auch nach Hunderten Änderungen aus einem Guss bleibt.

- **Ich, beim Ändern**Job Story
   Wenn · ich eine Komponente ändere,
   will ich · vorher sehen, welche Seiten und Bausteine sie nutzen,
   damit · nichts unbemerkt an anderer Stelle bricht.

- **Ein KI-Agent**Job Story
   Wenn · ich eine Aufgabe im Repository bekomme,
   will ich · Regeln, Komponenten und Grenzen aus Dateien lesen, statt zu raten,
   damit · meine Änderung die Guards besteht.

- **Wer meine Arbeit prüft**Job Story
   Wenn · ich ein Design System beurteile, das nicht veröffentlicht werden darf,
   will ich · es live anfassen und bis zum Token zurückverfolgen,
   damit · ich mehr sehe als einen Screenshot.

Formuliert aus den Anforderungen, die ich an das System gestellt habe.

Einordnung

Die Entscheidung

Statt Regeln zu dokumentieren und auf Disziplin zu hoffen, habe ich das System so gebaut, dass es keinen anderen Weg gibt. Was nicht aus den Tokens kommt, besteht keinen Test. Der Preis: Jede neue Idee braucht zuerst einen Namen und eine Rolle. Dafür bleibt die Seite auch nach Hunderten Änderungen aus einem Guss.

03 · Vier Token-Schichten

## Jede Farbe hat genau einen Weg

Die Werte kommen aus fünf Radix-Skalen, hell und dunkel. Darüber liegen 88 Bedeutungsrollen wie Fläche, Text, Linie, Marke, Erfolg und Warnung. Eine schmale Brücke übersetzt sie für shadcn, und erst die oberste Schicht macht sie in Tailwind nutzbar. Die Standardpaletten von Tailwind habe ich entfernt: Was nicht im System steht, existiert nicht.

Vier Schichten

1. Primitives
   Radix-Skalen, Abstände, Radien, Typo, Bewegung. Nur Token-Dateien dürfen sie anfassen.

2. Bedeutung
   88 Rollen; der Dark Mode tauscht nur die Skalen.

3. shadcn-Brücke
   18 Namen, die nur auf Bedeutungen zeigen.

4. Tailwind
   Eigene Farben, Radien, Schatten und Schriften, sonst nichts.

Vom Utility bis zum Farbwert · Live auf dieser Seite

max.does.systems · max.system · Live · Original · Original · Läuft mit dem echten System dieser Seite: dieselben Tokens, Komponenten und Regeln.[Dokumentation](https://max.does.systems/design-system/foundations/)

Rolle wählen und die Kette verfolgen, in Hell und Dunkel nebeneinander.

Einordnung

Die Entscheidung

Radien und Schatten heißen nach ihrer Rolle, nicht nach Zahlen: tag, control, card, sheet; lift, object, island. Der Preis: Wer neu dazukommt, lernt zuerst die Namen. Dafür war es eine einzige Änderung, als alle Radien eine Stufe runder werden sollten.

04 · max.zeichen

## Eigene Zeichen statt einer Icon-Bibliothek

Fremde Icon-Sets bringen ihre eigene Strichstärke und Haltung mit. Ich habe deshalb max.zeichen gezeichnet: 64 UI-Zeichen in Outline und Filled, jeweils in sechs echten Größen auf einem 32er-Raster, dazu Illustrationen, Hero-Motive und 48 Flow-Motive in sieben Paletten. Die Geometrie liegt als Quelle in Code; ein Build erzeugt daraus SVGs, Sprites, React-Komponenten und Custom Elements.

131 Zeichen, durchsuchbar · Live auf dieser Seite

max.does.systems · max.system · Live · Original · Original · Läuft mit dem echten System dieser Seite: dieselben Tokens, Komponenten und Regeln.[Dokumentation](https://max.does.systems/design-system/zeichen/)

Suchen, filtern, Größe wechseln: Jede Größe ist gezeichnet, nicht skaliert.

Die Website bekommt nur freigegebene Dateien, mit Prüfsumme und gesperrter Version. Bearbeitet wird ausschließlich in der Quelle. Ein Import aus lucide-react lässt den Build scheitern.

Einordnung

Die Entscheidung

Ich habe keine Bibliothek angepasst, sondern eine eigene gezeichnet. Der Preis: Jedes neue UI-Zeichen entsteht von Hand, in allen sechs Größen. Dafür hat die Seite eine Handschrift, vom kleinsten Icon bis zum Hero-Motiv.

05 · Verträge und Workbench

## Wissen gehört in Verträge, nicht in Köpfe

Jede Komponente hat einen Vertrag: Aufgabe, Einstiegspunkt, Grenzen und wie sie wiederverwendet wird, direkt, über eine Elternkomponente oder nur als Referenz. Ein generiertes Manifest hält Quellhashes, ein Nutzungsscan zeigt, wo eine Komponente wirklich gebraucht wird. Eine Kommandozeile beantwortet dieselben Fragen für Menschen und Agenten.

Ein Vertrag, live · Live auf dieser Seite

max.does.systems · max.system · Live · Original · Original · Läuft mit dem echten System dieser Seite: dieselben Tokens, Komponenten und Regeln.[Dokumentation](https://max.does.systems/design-system/library/)

Komponente wählen: Aufgabe, Wiederverwendung, Grenzen, echte Verwendungen und die Komponente selbst.

Was das System weiß, steht im Manifest: über hundert kuratierte Verträge, über 300 Komponentendateien, mehr als 500 gescannte Quelldateien. Dort steht auch, was es nicht weiß: Ein Import beweist nicht, dass etwas wirklich gerendert wird.

06 · Guards

## Das System sagt Nein

Bei jedem Build laufen deshalb Guards, die harte Fehler auslösen.

Was abgelehnt wird

1. Feste Werte
   Hex, rgb, oklch, px- und rem-Literale außerhalb der Token-Dateien.

2. Fremde Paletten
   Tailwind-Farben, Werte außerhalb der Skala, Primitives in Komponenten.

3. Fremde Zeichen
   Icon-Imports, die nicht aus max.zeichen kommen.

4. Drift
   Veraltetes Manifest, Demos ohne Komponente, Dateien ohne Vertrag.

Rund 300 Tests und eine Browser-Matrix über Deutsch und Englisch, drei Breiten und beide Themes halten das zusammen. Im Lab verhindert ein eigener Guard, dass Originalcode früherer Arbeitgeber je veröffentlicht wird.

### Barrierefreiheit

Für jede Änderung gilt: Tastatur, sichtbarer Fokus, Kontrast, reduzierte Bewegung und kein horizontales Scrollen bei 320 Pixeln. Geprüft wird in beiden Themes bei 1440, 390 und 320 Pixeln, und Farbe ist nie die einzige Information. Kontraste nach WCAG, mindestens 4,5:1 für Text und 3:1 für Icons, messen Browser-Skripte auf ausgewählten Seiten. Automatisch in jedem Build läuft das noch nicht; ein Prüfwerkzeug wie axe fehlt bislang.

Learning

Regeln, die niemand prüft, sind Vorschläge. Ein System hält erst, wenn der Build Nein sagen kann.

07 · Mensch und Agent

## Dieselben Regeln für Mensch und Agent

Ob Claude, Codex oder ChatGPT: Alle lesen dieselben Dateien. Ein Agentenvertrag beschreibt Tokens, Komponenten und Grenzen, eigene Skills führen durch Case-Texte, Storys und Variantenlabore. Es braucht keinen Server und keinen Schlüssel, nur das Repository.

Auch diese Seite hat Patterns, und das wichtigste ist die Entscheidung: Jedes Kapitel nennt eine, mit ihrem Preis. Ihre Regeln stehen im Case-Playbook des Repositorys, dasselbe, das auch die Agenten lesen. Hier das Pattern an der Entscheidung dieses Kapitels.

Pattern: Entscheidung im Kapitel · aus diesem Case

Beispiel

Einordnung

Die Entscheidung

Regeln stehen als Dateien im Repository, nicht im Prompt. Prompts verschwinden mit der Session. Dateien bleiben, lassen sich prüfen und gelten für jedes Werkzeug. Deshalb steht jede Regel, die ein Agent kennen muss, im Repository, und jede wichtige Regel hat zusätzlich einen Test. Der Preis: Eine Regel muss so genau formuliert sein, dass ein Test sie prüfen kann.

1. Markierung · Glyphe und Art der Notiz, damit die Entscheidung aus dem Fließtext heraussticht

2. Titel · Nennt die Entscheidung als Aussage

3. Begründung und Preis · Warum so entschieden, und was es gekostet hat

Regeln

- Richtig:Je Kapitel eine Entscheidung, mit ihrem Preis.

- Richtig:Überschriften als Aussagen.

- Richtig:Nur, was in portfolio.os belegt ist.

- Falsch:Wirkung behaupten, die nicht gemessen ist.

**So liest es ein Agent`patterns/entscheidung.md`**

`--- pattern: entscheidung quelle: docs/case-playbook.md --- ## Anatomie 1. Markierung [mark] — Glyphe und Art der Notiz, damit die Entscheidung aus dem Fließtext heraussticht 2. Titel [title] — Nennt die Entscheidung als Aussage 3. Begründung und Preis [body] — Warum so entschieden, und was es gekostet hat ## Regeln - DO: Je Kapitel eine Entscheidung, mit ihrem Preis. - DO: Überschriften als Aussagen. - DO: Nur, was in portfolio.os belegt ist. - DON’T: Wirkung behaupten, die nicht gemessen ist.`

Die Regeln sind gekürzt aus dem Case-Playbook übernommen.

Ein Weg für Mensch und Agent

1. Eigener Branch
   Jede Änderung entsteht abseits der Live-Seite

2. Vertrag
   Neue Komponenten brauchen einen Eintrag in der Registry, sonst scheitert der Check

3. Guards und Tests
   Laufen bei jedem Build und lösen harte Fehler aus

4. Vorschau
   Jeder Stand ist als Vorschau prüfbar, bevor er live geht

5. Release
   Nur ich gebe frei, als ein Merge

Auch das Aufräumen hat einen Weg. Ein Nutzungsbericht liest den Quellcode und ordnet jede Komponente ein: Anfang November 2026 waren 202 von 321 von einer öffentlichen Seite aus erreichbar, 107 nur aus Doku oder Vorschau. Gelöscht wird nichts automatisch, jeder Kandidat wird einzeln geprüft.

Mein Anteil

Gestaltung, Architektur, Code und Dokumentation liegen bei mir. Gebaut habe ich mit Claude Code, Codex und Orca; die Entscheidungen und die Abnahme treffe ich, und ein anderes Modell hat die Workbench unabhängig geprüft.

08 · max.lab

## Systeme, die man anfassen kann

Meine früheren Systeme gehören meinen früheren Arbeitgebern. Um sie trotzdem zeigen zu können, habe ich max.lab gebaut: eine Dokumentationsplattform, in der Compass und Camelot als Nachbau laufen, gemessen am gerenderten Original und neu geschrieben. Ein Inspektor führt jeden Abstand und jede Farbe auf das Token zurück, das sie erzeugt.

Compass-Button mit Inspektor · Live im Lab

max.lab · Compass · Live · Nachbau · Nachbau · Für diese Seite neu geschrieben, nicht der Originalcode. Wo ein Detail angenähert ist, steht es in der Dokumentation.[Dokumentation](https://max.does.systems/lab/#/compass/komponenten/button?lang=de)

Mit „Maße“ zeigt der Inspektor jeden Wert samt Token.

Das Lab ist selbst ein System: ein gemeinsamer Vertrag für Komponenten beider Systeme, ein Einbettungsprotokoll für Höhe und Theme und ein öffentlicher Build, der nur Nachbauten enthält.

Siehe auch:[Camelot Design System](https://max.does.systems/work/camelot/)

09 · Ergebnis

## Was daraus geworden ist

1. Ein Weg pro Wert
   Vier Schichten, 88 Rollen; feste Werte lassen den Build scheitern
   Keine Farbe und kein Abstand außerhalb der Tokens

2. Eine Handschrift
   131 Zeichen aus einer Quelle, fremde Icon-Imports gesperrt
   Eigene Zeichen statt fremder Icon-Sets

3. Wissen im System
   Über 300 Komponentendateien mit Vertrag, Manifest mit Quellhashes
   Jede Komponente erklärt sich selbst

4. Mensch und Agent
   Agentenvertrag und Skills im Repository, ohne Server oder Schlüssel
   Dieselben Regeln in jedem Werkzeug

5. Frühere Systeme zeigen
   max.lab mit Inspektor, eingebettet in die Cases
   Compass und Camelot live statt als Screenshot

6. Was noch offen ist · offen
   nicht gemessen
   Tempo und Qualität messen

10 · Rückblick

## Was ich gelernt habe und heute anders machen würde

### Einordnung

max.system trägt eine Website, gebaut von einer Person mit Agenten; wie es mit mehreren Teams skaliert, ist nicht erprobt. Belegt sind Umfang, Verträge und Prüfungen, nicht wie viel schneller ich damit baue; Compass und Camelot zeigt das Lab als Nachbau. Stand 1. November 2026.

### Learnings

1. Abdeckung ist kein Ziel
   Ich lösche keine Variantenstudie, nur damit eine Kennzahl besser aussieht. Eine offene Liste ist eine Arbeitsliste, keine Fehlerliste.

2. Gleiche Werte, verschiedene Rollen
   Zwei Tokens mit demselben Wert lege ich nicht zusammen, wenn sie verschiedene Aufgaben haben. Sonst bricht die erste Änderung beide.

3. Schulden benennen
   Ein Schrift-Token heißt noch wie die Schrift von früher, zeigt aber längst auf eine andere. Das steht offen im Code, bis es sauber umbenannt ist.

### Was ich heute anders machen würde

1. Die Guards zuerst
   Ich würde die Prüfungen vor den ersten Komponenten schreiben. Jede Regel, die erst später kam, brachte Aufräumarbeit mit sich.

2. Namen nach Aufgabe, von Anfang an
   Ein Schrift-Token trägt noch den Namen einer früheren Schrift. Hätte ich jede Rolle von Anfang an nach ihrer Aufgabe benannt, gäbe es diese Schuld nicht.

3. Eine Ausgangsbasis festhalten
   Ich hätte notieren sollen, wie lange eine neue Seite vor dem System gedauert hat. So bleibt der Gewinn an Tempo eine Einschätzung.

> Ein Design System beweist sich nicht in seiner Dokumentation, sondern in dem, was es ablehnt.
> 
> Maximilian Dahl

fin (for now)

**Fallnotizen · Wie dieser Case zu lesen ist.**

Belege · Die Repositories von max.systems, max.zeichen und max.lab, ihre Commits, Verträge und Tests. Zahlen aus dem Manifest vom 1. November 2026.

KI · Gebaut mit Claude Code, Codex und Orca. Entscheidungen, Gestaltung und Abnahme liegen bei mir; ein anderes Modell hat die Workbench unabhängig geprüft.

Stand · Stand 1. November 2026
