Skip to content

VisiTrans Design System für Claude: Anforderungen, Quellen, Extraktionsplan

Stand: 2026-11-04 · Zweck: Vorlage, um das VisiTrans Design System als Design-System-Artifact in Claude (Desktop / Claude Code / claude.ai) anzulegen, damit Slides, Designs und Seiten es automatisch nutzen.


1. Ergebnis in Kürze

  • Claude legt ein Design System als Artifact vom Typ „Design System“ an (https://claude.ai/artifact/5M7UeXXcx16TP3vzVFNDzd). Es ist eine Sammlung von Dateien unter project/: README (Markenhandbuch), tokens.json, Schriftdateien, Logo-Uploads, Komponenten-Previews und ein Index.
  • Für diesen Account existiert noch kein Design System (Abfrage vom 2026-11-04).
  • Fast alles, was gebraucht wird, liegt schon im Toolkit: der Skill vt-b-visitrans-design-system ist strukturell bereits ein Export eines Claude-Design-Systems (README, colors_and_type.css, preview/-Karten, ui_kits/). Die verbindlichen Werte stehen in configs/visitrans-cd-tokens.yaml.
  • Open Brain ist als Wertequelle unbrauchbar: die meisten Einträge tragen Werte vor dem CD-Manual vom 08.10.2026 (Orange #FC9E00, Anthrazit #101216, Magenta #FF00FF/#9C27B0, Frutiger, „Light-Brand VisiFair“). Open Brain liefert nur Entscheidungs-Historie und Begründungen.
  • Vor dem Befüllen müssen sechs Widersprüche entschieden werden (Abschnitt 4).

2. Was Claude für ein Design System braucht

Quelle: die Typ-Anleitung SKILL.md des Artifact-Typs „Design System“ (Release 1793745383-1961).

2.1 Dateien unter project/

Pfad Inhalt Pflicht Hinweise
design-system.json Index: v:3, layout:"files", createdOnFiles, title, namespace, libraries, groups, assetGroups, lastChange ja wird als letzte Datei geschrieben; title ist der Name des Systems
README.md Markenhandbuch: Content-Grundlagen, visuelle Grundlagen, Ikonografie, Nutzungsregeln mit Token-Namen ja jeder Leser (Agent) startet hier
tokens.json Farben je Theme, Typografie, Spacing, Radius, optional Shadow dringend empfohlen Listenformat, kein DTCG/W3C-Map-Format (siehe 2.2)
*.md (weitere) zusätzliche Kapitel des Handbuchs optional max. 24 Abschnitte
fonts/<datei> echte Schriftdateien wenn eigene Schrift in tokens.json → type.fonts[].file referenziert
assets/<Gruppe>/<datei> Logos, Bilder (PNG/SVG/PDF …) als Asset-Upload empfohlen erster Ordner = Gruppe; jede Gruppe braucht einen Eintrag in assetGroups und eine README.md
components/<Comp>/README.md Richtlinie einer Komponente, erster Satz = Zusammenfassung optional
components/<Comp>/preview.html Live-Preview, Zeile 1 <!-- @dsCard group="…" height=… --> optional läuft mit tokens.css, Fonts, bundle.css vorgeladen
components/Cover/preview.html Titelkarte über dem Handbuch ja wird zuletzt geschrieben
components/bundle.js, bundle.css, index.d.ts, lib/*.js echte Komponentenbibliothek optional ein klassisches Script, das window.<namespace> setzt
tokens.css, manifest.json, api/… von der Seite generiert nie schreiben

Grenzen: 1.008 Dateien, 256 MiB je System, 15 MiB je Datei, SVG ≤ 2 MB, Upload ≤ 20 MB.

2.2 Format von tokens.json

  • Jede Familie außer type ist {"tokens":[{"name","value","usage"}, …]} – eine Liste.
  • color hat zusätzlich themes; ein Token-Wert ist {"<theme-id>": "#hex", …}. Das erste Theme ist das primäre – fehlende Werte erben von ihm. Für VisiTrans also dark zuerst.
  • Namen: [A-Za-z0-9][A-Za-z0-9_.-]{0,63}, keine Leerzeichen, kein /, jeder Name nur einmal.
  • Erlaubte Farbwerte: Hex, rgb()/rgba()/hsl()/oklch(), Alias "{anderer-token}". Verboten (Token fällt weg): var(), color-mix(), benannte Farben, transparent.
  • type: fonts (Datei + Gewicht), families, groups mit styles (fontSize, lineHeight, fontWeight).
  • Jeder Token bekommt eine usage-Notiz.

2.3 Qualitäts-Checkliste des Typs

  • Werte exakt aus der Quelle, nie erfunden; Logos kopiert, nie nachgebaut.
  • Text ≥ 4,5:1 auf seinem Grund in jedem Theme, 3:1 ab 24 px, für Kontrollränder, Fokusringe, Icons. Ein Paar, das die Quelle verletzt, bleibt drin, aber die usage-Notiz markiert es.
  • Keine KI-Klischees (Blau-Lila-Verläufe, Emoji-Karten, Karten mit farbigem Linksrand).
  • CDN-Skripte mit exakter Version, nie @latest.

2.4 Wie es angelegt wird

  1. Ein Artifact aus dem Typ erzeugen (Publish mit type_url, title = „VisiTrans“, keine Dateien).
  2. Alle Dateien lokal unter <ordner>/project/… bauen; Logos als Assets hochladen.
  3. Ein Publish mit allen Dateien, der Index zuletzt.
  4. Danach steht das System in der Liste der Design Systems und kann für Slides und Designs als Standard gewählt werden (wo genau der Standard gesetzt wird, ist in der Oberfläche zu prüfen).

Nicht gebraucht: das DesignSync-Werkzeug und /design-sync. Sie synchronisieren eine Komponentenbibliothek mit einem claude.ai/design-Projekt; das eigenständige Claude Design schließt am 14.12.2026.


3. Quellen und Zuordnung

3.1 Rangfolge der Quellen

Rang Quelle Rolle
1 VisiTrans_CD_08.10.2026_EW08.pdf (ONEDRIVE_ROOT/03-Corporate Design/03-cd-manual/) kanonisch
2 configs/visitrans-cd-tokens.yaml Single Source of Truth aller Token-Werte im Toolkit
3 docs/decisions/2026-10-29-cd-manual-one-value-per-colour.md Entscheidungen E1–E6 (Rollen der Farben)
4 plugins/vt-brand/skills/visitrans-design-system/ (README, SKILL, CSS, Previews, Fonts, Logos) Handbuchtext, semantische Tokens, Previews
5 plugins/vt-brand/skills/visitrans_cd/SKILL.md + assets/logos/ Logo-Regeln, VisiArea-Logos, Dokument-Kontext
6 Visitrans/V024-Websites-dev (02-assets/design/design-tokens.json, packages/01-ui/) echte Komponenten (Phase 2)
7 Open Brain nur Begründungen und Historie, keine Werte

3.2 Zuordnung Quelle → Zielpfad

Ziel im Design System Quelle Umformung
project/README.md Design-System-README.md (Content Fundamentals, Visual Foundations, Iconography) + SKILL.md Non-negotiables 1–10 + Oberflächen-Tabelle (Theme je Surface) + Regel E5 (Links auf Dunkel) Ordnerindex und Dateiverweise auf Skill-Pfade entfernen; Logo-Anzahl korrigieren; Lucide mit fester Version statt @latest
project/tokens.json → color YAML colors.primary, action, surface, functional, Ramps, secondary_gray + semantische Tokens aus colors_and_type.css (--bg, --fg, --cta, --cta-hover …, dunkel und hell) Themes dark (zuerst) und light; jede Farbe mit usage; approval: pending-designer als Hinweis in usage
project/tokens.json → type YAML typography.web + Typ-Abschnitt der CSS (Display 800, -0.025em, Eyebrow 600 / 0.18em) fonts → fonts/Inter-Variable.woff2, fonts/Inter-Italic-Variable.woff2
project/tokens.json → spacing, radius YAML spacing, radii Liste mit usage
project/tokens.json → shadow CSS Glow (glow-sm…xl) und helle Schatten
project/fonts/* visitrans-design-system/assets/fonts/*.woff2 Lizenz (SIL OFL) im README nennen
project/assets/Logos VisiTrans/… usw. 35 PNG-Lockups aus visitrans-design-system/assets/logos/ eine Gruppe je Marke, README.md je Gruppe mit Hintergrundregel (bl-or auf hell, wh-or auf dunkel) und Schutzraum
project/assets/Logos VisiArea/… visitrans_cd/assets/logos/VisiArea.jpg, VisiArea_Defense.jpg das Design-System-Skill hat keine VisiArea-PNGs
components/Button, Input, Card, Badge preview/components-*.html auf das Preview-Format umstellen (Zeile-1-Marker, Tokens statt eingebettetem CSS)
components/Logo, Clearspace preview/brand-logos.html, brand-clearspace.html, brand-sublockups.html, brand-dark-bg.html
components/ThemeSwitcher SKILL.md § Light↔dark switcher + preview/product-ui-light.html Code bleibt nur im Toolkit-Skill, die Komponente verweist darauf
components/Cover neu nach cover.md des Typs
Farb-, Typo-, Spacing-Karten preview/colors-*, type-*, spacing-* entfallen voraussichtlich, weil die Seite sie aus tokens.json erzeugt; beim Bauen prüfen
UI-Kits ui_kits/visitrans|visimatch|visifair/index.html Phase 2: als Komponenten „Seitenvorlage“ oder weglassen

4. Widersprüche, die vor dem Befüllen entschieden werden müssen

# Widerspruch Fundstellen Empfehlung
W1 Hintergrund der Websites: Toolkit sagt „Schwarz #2B2B2A nie als Fläche, dunkle Flächen sind Anthrazit #444343“; V024-SPEC-039 setzt surface.background = #2B2B2A configs/visitrans-cd-tokens.yaml (Kommentar zu black), Entscheidung E2 vs. V024 specs/39-cd-farbwerte/spec.md FR-1 Toolkit-Regel übernehmen (jüngere, repo-weite Entscheidung mit CD-Begründung), V024 angleichen – Owner-Entscheidung nötig
W2 Größter Radius: YAML hat xl: 16px, README sagt „nie größer als 12 px“ YAML radii.xl, README § Borders 16 px streichen oder Regel lockern
W3 Gewicht der Display-Headlines: YAML h1 700, README/SKILL 800 YAML typography.web.scale.h1, SKILL Non-negotiable 2 800 für Display, 700 für H1–H2 als zwei getrennte Stile führen
W4 Erweiterte Farben und Produkt-Themes (Dunkelblau, Petrol, Lila, Hellgrün) sind „nicht Teil des CD“, aber in product_themes als Sekundärfarben gesetzt; auf #444343 alle unter 3:1 YAML extended, product_themes nicht ins Design System aufnehmen, nur im Toolkit für Diagramme belassen
W5 Freigabe ausstehend: Tiefenstufen, Funktionsfarben (Gelb/Grün/Cyan/Rot) sind approval: pending-designer YAML-Kommentare aufnehmen, in usage als „Freigabe Designer offen“ markieren
W6 Logo-Bestand: README nennt 32 bzw. 60 PNGs, tatsächlich 35; VisiArea fehlt als PNG README Z. 39 und 52, assets/logos/ mit den tatsächlichen Dateien arbeiten; VisiArea-PNG aus OneDrive 05-VisiArea/01-Web-logos/ nachziehen

4.1 Entscheidungen vom 2026-11-04 (Rolf)

# Entscheidung Folge
W1 Anthrazit #444343 ist der dunkle Hintergrund auf allen Oberflächen; Schwarz #2B2B2A nur Logo, Text, Linien V024 SPEC-039 FR-1/FR-2 an E2 angleichen (Folgeaufgabe im Website-Repo)
W2 Größter Radius 12 px; radii.xl (16 px) wird gestrichen vor dem Streichen prüfen, welcher Generator xl liest
W3 Display 800 (-0.025em), H1/H2 700 – zwei getrennte Stile tokens.json führt display und h1/h2 getrennt
W4 Erweiterte Farben nur, wenn sie im CD-Manual stehen → sie stehen nicht drin (siehe 4.2) nicht ins Design System; Verbleib im Toolkit klärt der Designer
W5 Zuerst prüfen, ob das Manual Ersatzwerte liefert; sonst an den Designer → liefert es nicht (siehe 4.2) Designer-Anfrage (4.3)
W6 35 PNGs + VisiArea-PNGs aus OneDrive 10 Dateien aus 01-Logos/05-VisiArea/VisiAREA Logos · PNG für WEB/ (je 5 Farbvarianten für VisiArea und VisiArea DEFENSE); README-Zählung korrigieren

4.2 Prüfung gegen das CD-Manual vom 08.10.2026

Das Manual (16 Seiten, Text ausgelesen am 2026-11-04) definiert genau fünf Farben: Schwarz #2B2B2A (K100), Anthrazit #444343 (K90), Orange #F9AB07, Weiß #FFFFFF (S. 10) und Magenta #E24892 (S. 11).

  • Erweiterte Farben (Dunkelblau #3F51B5, Gelb #FFEB3B, Lila #9C27B0, Hellgrün #B2FF59, Petrol #00697C, Rot #D32F2F): kommen im aktuellen Manual nicht vor. Das alte Manual EW01 vom 04.08.2025 hatte Seiten „Sekundärfarben“, „Erweiterte Farben“, „Monochrome Farben“ ohne Werte im Text. Die Werte selbst sind Material-Design-Standardfarben – vermutlich nie vom Designer festgelegt.
  • Tiefenstufen (#373737, #4C4C4C, #565656, Grauskala): kein Wert im Manual. Einziger Anker außer K100/K90: S. 12 nennt für das monochrome Logo „40 % Schwarz“ – das Manual kennt also Schwarz-Abstufungen, gibt aber keinen RGB/HEX-Wert dafür an.
  • Statusfarben Gelb #FFFF00, Grün #73FF59, Cyan #00FFFF, Rot: kein Ersatz im Manual möglich.
  • Neu entdeckt: S. 15 definiert Produkt-Icons (Bildmarken VT, VM, VF, VA) als freigegebene Originaldateien. Sie fehlen bisher im Toolkit; in OneDrive liegen nur Favicons für VisiMatch und VisiFair.

4.3 Anfrage an den Designer

  1. HEX/RGB-Werte für Schwarz-Abstufungen (mindestens 40 %, die das Manual selbst nutzt; dazu die Stufen für Flächen und Ränder auf Anthrazit: K95, K85, K80, K70, K55 und die hellen Stufen K10–K5).
  2. Statusfarben für Produkt-UI (Erfolg, Info, Warnung, Fehler) – je ein Wert für helle und Anthrazit-Flächen, Kontrast ≥ 4,5:1 für Text.
  3. Diagramm-/Infografik-Farben: braucht das CD eine eigene Palette, oder reichen Orange, Anthrazit und Graustufen?
  4. Originaldateien der Produkt-Icons VT, VM, VF, VA (S. 15), möglichst als SVG und PNG.

Bis zur Antwort kommen nur die fünf CD-Farben ohne Vorbehalt ins Design System. Die abgeleiteten Werte bleiben mit der Notiz „Freigabe Designer offen“ (Vorschlag aus W5, solange keine Antwort vorliegt).

Stand 2026-11-04: Anfrage per Mail an Udo Scharello versendet, Antwort offen.

4.4 Farben im Social-Media-Tool (F055-VisiFair Social Media)

Rolf: Das Tool nutzt Farben, die nicht im CD-Manual stehen; sie sollen durch die tatsächlich genutzten CD-Farben ersetzt werden.

Fundstellen (gelesen am 2026-11-04, main @ 0537ac30):

  • App: Visitrans/F055-app-code (Angular 21 SPA + Cloudflare Worker). Farbquelle ist apps/web/src/styles/vt-variables.css, eine Kopie des Toolkit-Stylesheets aus der Zeit vor dem CD-Manual vom 08.10.2026 – sie beruft sich auf „VisiTrans_CD_17.02.2026“. Dazu Literale in apps/web/src/styles.css und 15 Feature-Stylesheets (features/post, kalender, freigabe, uebersicht, platzhalter). Die Prüfskripte apps/web/scripts/pruefe-cd.sh und pruefe-kontrast.mjs (mit Fixtures) prüfen gegen die alten Werte.
  • Konzept: OneDrive 3-VisiFair/02-Projekte/F055-VisiFair Social Media/02-Themen/strategie/20260730-visifair-social-media-analyse.md Z. 70 (#FF9E00, #FF00FF) und Z. 509 („VisiFair = Light-Theme“) – beides überholt.

Abweichungen und Ersatz (Ersatz = CD-Wert oder Toolkit-YAML):

Rolle im Tool Wert im Tool Ersatz Status des Ersatzes
Orange #FF9E00 #F9AB07 CD
Orange Hover / Pressed #E68E00 / #CC7E00 #E19A05 / #C88905 abgeleitet aus CD-Orange
Orange als Text auf Hell #8A5400 #966704 abgeleitet
Orange-Tönungen #FFC266, #FFEACC, #FFF6E6, #FFF8ED Orange-Ramp 300/100/50 aus der YAML abgeleitet
Schwarz (Text, Logo) #000000 #2B2B2A CD
Dunkle Fläche #101216, #0B0D11, #1A1C20, #202226 #444343 + Tiefenstufen #373737, #4C4C4C, #565656 CD + Freigabe offen
Schwarz-Abstufungen #1A1A1A, #333333, #666666, #999999, #CCCCCC, #E6E6E6, #F2F2F2 K-Stufen der YAML (gray-*) Freigabe offen (4.3 Punkt 1)
Magenta #FF00FF (+ #CC00CC, #990099, #FF66FF, #FFE6FF) #E24892 (+ Ramp 600/700/300/50) CD
Text auf Magenta-Button Schwarz Weiß, fett ≥ 18,7 px (Regel E5) CD-Folge
Danger Magenta #D32F2F hell / #EA9B9B Text dunkel Freigabe offen
Status Gelb/Grün/Cyan #FFFF00, #73FF59, #00FFFF, dazu #FFEA00, #FFFF99, #B6FFA8, #A8FFFF bleiben vorerst nicht CD, Freigabe offen (4.3 Punkt 2)
Erfolg-Grün (zweites) #3BB273 entfällt, --vt-success nutzen nicht CD
Graue Neutraltöne #808080, #898989, #E0E0E0, #F8F8F8, rgba(128,128,128,…) K-Stufen der YAML Freigabe offen
Orange-Glow rgba(255,158,0,…) rgba(249,171,7,…) CD
KPI-Kacheln linear-gradient Orange/Gelb/Grün/Cyan/Grau Flächen ohne Verlauf README: „keine Gradients“

Nebenbefund: Die App setzt nur das helle Theme. Nach der Oberflächenregel (eingeloggte Produkt-UI) müsste sie zwischen Hell und Dunkel umschaltbar sein.

Umsetzung: eigene Aufgabe im Repo F055-app-code – vt-variables.css durch die aktuelle Toolkit-Fassung von colors_and_type.css ersetzen, Literale in styles.css und den Feature-Stylesheets auf Tokens umstellen, pruefe-cd.sh und pruefe-kontrast.mjs samt Fixtures nachziehen. Die Feature-Stylesheets außer post* und konflikt-hinweis sind noch nicht einzeln gelesen.

Stand 2026-11-04: umgesetzt und gemergt mit Visitrans/F055-app-code#239 (Branch fix/cd-manual-farben-2026-10-08). Der Nebenbefund zum Theme-Umschalter ist darin nicht enthalten.

Zusätzlich: Open Brain enthält mehrere veraltete Kopien von docs/guides/design-system.md (Captures vom 30.03. und 23.09.2026) und einen F010-Eintrag mit „VisiFair = Light“. Sie widersprechen dem aktuellen Stand und sollten aktualisiert oder entfernt werden, damit spätere Sessions sie nicht als Fakt lesen.


5. Extraktionsplan

Schritt Was Ergebnis Wer
1 W1–W6 entscheiden Entscheidungen hier eintragen Rolf
2 Konverter YAML + CSS → tokens.json schreiben, neben scripts/design_system/generate_css_variables.py, mit Test tokens.json wird aus der SSOT erzeugt und lässt sich bei CD-Änderungen neu erzeugen Claude
3 README.md des Systems aus README + SKILL zusammenstellen, Abschnitte 3.2 Zeile 1 Markenhandbuch Claude, Review Rolf
4 Fonts und Logos in einen Arbeitsordner kopieren, Asset-Gruppen-READMEs schreiben project/fonts/, project/assets/ Claude
5 Komponenten-Previews (Button, Input, Card, Badge, Logo, ThemeSwitcher) und Cover ins Preview-Format bringen project/components/ Claude
6 Kontraste aller Text/Grund-Paare in beiden Themes nachrechnen Liste der markierten Paare Claude
7 Design-System-Artifact „VisiTrans“ anlegen, Assets hochladen, alle Dateien in einem Publish, Index zuletzt Link zum System Claude, nach Freigabe
8 System als Standard für Slides/Designs setzen, mit einem Test-Deck prüfen Standard aktiv Rolf
9 Phase 2: Komponenten aus V024-Websites-dev/packages/01-ui als bundle.js übernehmen echte Komponenten später
10 Veraltete Open-Brain-Einträge aktualisieren sauberes Gedächtnis Rolf / Claude mit Freigabe

Stand 2026-11-04, Schritte 2–6 gebaut (lokal, nicht veröffentlicht):

  • Generator scripts/design_system/generate_claude_tokens_json.py, Build scripts/design_system/build_claude_design_system.py (--output <ordner> erzeugt <ordner>/project/), Tests in tests/spec-228/test_claude_tokens_json.py und test_build_claude_design_system.py.
  • Quellen des Systems (README, Komponenten Button, Input, Card, Badge, Logo, ThemeSwitcher, Cover, Gruppen-READMEs) unter plugins/vt-brand/skills/visitrans-design-system/claude-design-system/; die 10 VisiArea-PNGs liegen jetzt in assets/logos/ (45 insgesamt).
  • Farben: die fünf CD-Farben plus nur die abgeleiteten Stufen, die die beiden Themes brauchen (als „designer approval pending“ markiert). Status-, Fehler- und Diagrammfarben sind nicht enthalten, bis der Designer antwortet.
  • Kontrastprüfung (Schritt 6, --contrast-report): 36 Paare. Unter Ziel und markiert: Orange-Text auf bg-soft im dunklen Theme (4,44:1); Weiß auf Magenta (3,77:1, nur fette Schrift ab 18,7 px) für accent in beiden Themes und cta im hellen Theme.
  • design-system.json wird erst in Schritt 7 geschrieben, weil es die Blob-IDs der hochgeladenen Logos braucht; die Logo-Preview verweist bis dahin auf die Asset-Pfade.

Hinweis zu Schritt 2: Wird tokens.json von Hand geschrieben statt generiert, driftet es beim nächsten CD-Update von der YAML ab – genau das Muster, das 2026 schon zweimal passiert ist (Schwarz/Anthrazit, Magenta als Danger-Farbe).

Next steps

Erledigt am 2026-11-04: Designer-Anfrage (4.3) versendet, F055-Farbumstellung (4.4) gemergt, Handbuch-Session zu Richtlinie und Arbeitsanweisungen im Repo V004-VisiTrans Handbuch -dev gestartet.

Erledigt am 2026-11-04, abends: Schritt 7 (Design-System-Artifact „VisiTrans“ mit 45 Logos veröffentlicht), Schritt 8 (als Standard gesetzt, Test-Deck mit fünf Folien geprüft), radii.xl aus der YAML gestrichen (W2). Das Test-Deck zeigte: Die Spotlight-Schreibweise aus dem Web rendert in Folien fast schwarz; das README nennt jetzt eine Folien-Schreibweise.

  1. Nach Antwort des Designers: freigegebene Werte in configs/visitrans-cd-tokens.yaml übernehmen, dann tokens.json neu erzeugen.