Product Design Case Study · Design Systems · Eigenes SystemEigenes 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.
- Rolle im Projekt
- Alles in einer HandGestaltung, Architektur, Code und Dokumentation
- Werkzeuge
- Astro, React, Tailwind 4Radix Colors und shadcn; gebaut mit Claude Code, Codex und Orca
- Umfang
- Drei Teilemax.system, max.zeichen und max.lab
- Status
- und 2 weitere Zustände
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
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 VertragManifest mit Quellhashes
Problem
Ein Weg pro Wert
Vier Token-Schichten. Keine Farbe und kein Abstand liegt außerhalb.
Eingriff
Das System sagt Nein
Guards lassen den Build scheitern, wenn etwas am System vorbeigeht.
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 HandGestaltung, Architektur, Code und Dokumentation
- Werkzeuge
- Astro, React, Tailwind 4Radix Colors und shadcn; gebaut mit Claude Code, Codex und Orca
- Umfang
- Drei Teilemax.system, max.zeichen und max.lab
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 BauenJob 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 ÄndernJob 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-AgentJob 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üftJob 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.
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.
Primitives
Radix-Skalen, Abstände, Radien, Typo, Bewegung. Nur Token-Dateien dürfen sie anfassen.
Bedeutung
88 Rollen; der Dark Mode tauscht nur die Skalen.
shadcn-Brücke
18 Namen, die nur auf Bedeutungen zeigen.
Tailwind
Eigene Farben, Radien, Schatten und Schriften, sonst nichts.
Vom Utility bis zum Farbwert
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
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.
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
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.
Das System sagt Nein
Bei jedem Build laufen deshalb Guards, die harte Fehler auslösen.
Feste Werte
Hex, rgb, oklch, px- und rem-Literale außerhalb der Token-Dateien.
Fremde Paletten
Tailwind-Farben, Werte außerhalb der Skala, Primitives in Komponenten.
Fremde Zeichen
Icon-Imports, die nicht aus max.zeichen kommen.
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.
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.
Beispiel
- MarkierungGlyphe und Art der Notiz, damit die Entscheidung aus dem Fließtext heraussticht
- TitelNennt die Entscheidung als Aussage
- Begründung und PreisWarum 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 Agentpatterns/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.
Eigener Branch
Jede Änderung entsteht abseits der Live-Seite
Vertrag
Neue Komponenten brauchen einen Eintrag in der Registry, sonst scheitert der Check
Guards und Tests
Laufen bei jedem Build und lösen harte Fehler aus
Vorschau
Jeder Stand ist als Vorschau prüfbar, bevor er live geht
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.
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
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
Was daraus geworden ist
Ein Weg pro Wert
Vier Schichten, 88 Rollen; feste Werte lassen den Build scheitern
Keine Farbe und kein Abstand außerhalb der Tokens
Eine Handschrift
131 Zeichen aus einer Quelle, fremde Icon-Imports gesperrt
Eigene Zeichen statt fremder Icon-Sets
Wissen im System
Über 300 Komponentendateien mit Vertrag, Manifest mit Quellhashes
Jede Komponente erklärt sich selbst
Mensch und Agent
Agentenvertrag und Skills im Repository, ohne Server oder Schlüssel
Dieselben Regeln in jedem Werkzeug
Frühere Systeme zeigen
max.lab mit Inspektor, eingebettet in die Cases
Compass und Camelot live statt als Screenshot
Was noch offen istoffen
nicht gemessen
Tempo und Qualität messen
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
Abdeckung ist kein Ziel
Ich lösche keine Variantenstudie, nur damit eine Kennzahl besser aussieht. Eine offene Liste ist eine Arbeitsliste, keine Fehlerliste.
Gleiche Werte, verschiedene Rollen
Zwei Tokens mit demselben Wert lege ich nicht zusammen, wenn sie verschiedene Aufgaben haben. Sonst bricht die erste Änderung beide.
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
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.
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.
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.
fin (for now)