Design-Lab-Skill
Dieser Skill implementiert einen vollständigen Design-Explorations-Workflow: Interview, Varianten generieren, Feedback sammeln, verfeinern, Vorschau und finalisieren.
KRITISCH: Aufräumverhalten
Alle temporären Dateien MÜSSEN gelöscht werden, wenn der Prozess endet, sei es durch:
- Benutzer bestätigt finales Design → aufräumen, dann Plan erstellen
- Benutzer bricht ab/storniert → sofort aufräumen, kein Plan erstellt
Hinterlassen Sie niemals .claude-design/ oder __design_lab-Routen. Wenn der Benutzer "abbrechen", "stornieren", "stoppen" oder "doch nicht" sagt, bestätigen und dann alle temporären Artefakte löschen.
Phase 0: Vorab-Erkennung
Vor Beginn des Interviews automatisch erkennen:
Paketmanager
Sperrdateien im Projektstammverzeichnis prüfen:
pnpm-lock.yaml→pnpmverwendenyarn.lock→yarnverwendenpackage-lock.json→npmverwendenbun.lockb→bunverwenden
Framework-Erkennung
Konfigurationsdateien prüfen:
next.config.jsodernext.config.mjsodernext.config.ts→ Next.js- Prüfen auf
app/-Verzeichnis → App Router - Prüfen auf
pages/-Verzeichnis → Pages Router
- Prüfen auf
vite.config.jsodervite.config.ts→ Viteremix.config.js→ Remixnuxt.config.jsodernuxt.config.ts→ Nuxtastro.config.mjs→ Astro
Styling-System-Erkennung
package.json-Abhängigkeiten und Konfigurationsdateien prüfen:
tailwind.config.jsodertailwind.config.ts→ Tailwind CSS@mui/materialin Abhängigkeiten → Material UI@chakra-ui/reactin Abhängigkeiten → Chakra UIantdin Abhängigkeiten → Ant Designstyled-componentsin Abhängigkeiten → styled-components@emotion/reactin Abhängigkeiten → Emotion.css- oder.module.css-Dateien → CSS Modules
Design-Gedächtnis-Prüfung
Nach vorhandener Design-Gedächtnis-Datei suchen:
docs/design-memory.mdDESIGN_MEMORY.md.claude-design/design-memory.md
Wenn gefunden, lesen und zum Vorbefüllen von Standardwerten und Überspringen redundanter Fragen verwenden.
Visuelle Stil-Inferenz (KRITISCH)
VERWENDEN Sie KEINE generischen/vordefinierten Stile. Extrahieren Sie die visuelle Sprache aus dem Projekt:
Wenn Tailwind erkannt wurde, tailwind.config.js oder tailwind.config.ts lesen:
// Extrahieren und verwenden:
theme.colors // Farbpalette
theme.spacing // Abstandsskala
theme.borderRadius // Radiuswerte
theme.fontFamily // Typografie
theme.boxShadow // Elevationssystem
Wenn CSS-Variablen vorhanden sind, globals.css, variables.css oder :root-Definitionen lesen:
:root {
--color-* /* Farb-Tokens */
--spacing-* /* Abstands-Tokens */
--font-* /* Typografie-Tokens */
--radius-* /* Border-Radius-Tokens */
}
Wenn UI-Bibliothek erkannt wurde (MUI, Chakra, Ant), die Theme-Konfiguration lesen:
- MUI:
theme.tsodercreateTheme()-Aufruf - Chakra:
theme/index.tsoderextendTheme()-Aufruf - Ant:
ConfigProvider-Theme-Prop
Immer vorhandene Komponenten scannen, um Muster zu verstehen:
- 2-3 vorhandene Buttons finden → deren Styling-Muster beachten
- 2-3 vorhandene Karten finden → Abstände, Rahmen, Schatten beachten
- Vorhandene Formulare finden → Eingabestile, Label-Positionierung beachten
- Vorhandene Typografie finden → Überschriftengrößen, Fließtext beachten
Abgeleitete Stile im Design Brief speichern zur konsistenten Verwendung in allen Varianten.
Phase 1: Interview
Verwenden Sie das AskUserQuestion-Tool für alle Interviewschritte. Fragen basierend auf dem Design-Gedächtnis anpassen, falls vorhanden.
Schritt 1.1: Umfang & Ziel
Diese Fragen stellen (können in einer einzigen AskUserQuestion mit mehreren Fragen kombiniert werden):
Frage 1: Umfang
- Kopfzeile: "Umfang"
- Frage: "Entwerfen wir eine einzelne Komponente oder eine vollständige Seite?"
- Optionen:
- "Komponente" - Ein wiederverwendbares UI-Element (Button, Karte, Formular, Modal, usw.)
- "Seite" - Ein vollständiges Seiten- oder Bildschirmlayout
Frage 2: Neu oder Redesign
- Kopfzeile: "Typ"
- Frage: "Ist dies ein neues Design oder ein Redesign von etwas Bestehendem?"
- Optionen:
- "Neu" - Etwas von Grund auf neu erstellen
- "Redesign" - Eine vorhandene Komponente/Seite verbessern
Wenn "Redesign" ausgewählt wurde, fragen: Frage 3: Vorhandener Pfad
- Kopfzeile: "Speicherort"
- Frage: "Was ist der Dateipfad oder die Route der vorhandenen UI?"
- Optionen: (Benutzer kann über "Andere" antworten)
Wenn das Ziel unklar ist, einen Namen basierend auf den Repo-Mustern vorschlagen und bestätigen.
Schritt 1.2: Schmerzpunkte & Inspiration
Frage 1: Schmerzpunkte
- Kopfzeile: "Probleme"
- Frage: "Was sind die größten Schmerzpunkte beim aktuellen Design (oder was sollte dieses neue Design vermeiden)?"
- Optionen:
- "Zu überladen/dicht" - Informationsüberflutung, schwer zu scannen
- "Unklare Hierarchie" - Primäre Aktionen sind nicht offensichtlich
- "Schlechte mobile Erfahrung" - Funktioniert nicht gut auf kleinen Bildschirmen
- "Veraltetes Aussehen" - Fühlt sich alt oder inkonsistent mit der Marke an
- multiSelect: true
Frage 2: Visuelle Inspiration
- Kopfzeile: "Visueller Stil"
- Frage: "Auf welche Produkte oder Marken soll ich mich für visuelle Inspiration beziehen?"
- Optionen:
- "Stripe" - Sauber, minimalistisch, vertrauenswürdig
- "Linear" - Dicht, tastatur-zentriert, entwicklerfokussiert
- "Notion" - Flexibel, inhaltsfokussiert, verspielt
- "Apple" - Premium, geräumig, raffiniert
- multiSelect: true
Frage 3: Funktionale Inspiration
- Kopfzeile: "Interaktionen"
- Frage: "Welche Interaktionsmuster soll ich nachahmen?"
- Optionen:
- "Inline-Bearbeitung" - Direkt an Ort und Stelle bearbeiten, ohne Modals
- "Progressive Offenlegung" - Zeige mehr nach Bedarf
- "Optimistische Aktualisierungen" - Sofortiges Feedback, Synchronisierung im Hintergrund
- "Tastaturkürzel" - Effizienz für Power-User
Schritt 1.3: Marken- & Stilrichtung
Frage 1: Marken-Adjektive
- Kopfzeile: "Markenton"
- Frage: "Welche 3-5 Adjektive beschreiben das gewünschte Markengefühl?"
- Optionen:
- "Minimalistisch" - Sauber, einfach, aufgeräumt
- "Premium" - Hochwertig, poliert, raffiniert
- "Verspielt" - Lustig, freundlich, zugänglich
- "Nützlich" - Funktional, effizient, sachlich
- multiSelect: true
Frage 2: Dichte
- Kopfzeile: "Dichte"
- Frage: "Welche Informationsdichte bevorzugen Sie?"
- Optionen:
- "Kompakt" - Mehr Informationen sichtbar, engere Abstände
- "Komfortabel" - Ausgewogene Abstände, einfaches Scannen
- "Großzügig" - Viel Weißraum, fokussierte Aufmerksamkeit
Frage 3: Dunkler Modus
- Kopfzeile: "Dunkler Modus"
- Frage: "Ist der dunkle Modus erforderlich?"
- Optionen:
- "Ja" - Muss den dunklen Modus unterstützen
- "Nein" - Nur heller Modus
- "Nice to have" - Unterstützen, falls einfach, nicht erforderlich
Schritt 1.4: Persona & Jobs-to-be-Done
Frage 1: Primärer Benutzer
- Kopfzeile: "Benutzer"
- Frage: "Wer ist der primäre Endbenutzer?"
- Optionen:
- "Entwickler" - Technisch, tastaturorientiert
- "Designer" - Visuell, detailorientiert
- "Geschäftsbenutzer" - Effizienzorientiert, weniger technisch
- "Endverbraucher" - Allgemeine Öffentlichkeit, unterschiedliche technische Fähigkeiten
Frage 2: Kontext
- Kopfzeile: "Kontext"
- Frage: "Was ist der primäre Nutzungskontext?"
- Optionen:
- "Desktop-first" - Hauptsächlich auf größeren Bildschirmen verwendet
- "Mobile-first" - Hauptsächlich auf Telefonen verwendet
- "Beide gleichermaßen" - Muss auf allen Geräten gut funktionieren
Frage 3: Schlüsselaufgaben
- Kopfzeile: "Schlüsselaufgaben"
- Frage: "Was sind die 3 wichtigsten Aufgaben, die Benutzer erledigen müssen?"
- (Benutzer kann über "Andere" antworten - dies ist offen)
Schritt 1.5: Einschränkungen
Frage 1: Erforderliche Elemente
- Kopfzeile: "Behalten"
- Frage: "Gibt es Elemente, die erhalten bleiben müssen?"
- Optionen:
- "Vorhandene Texte/Labels" - Aktuellen Text beibehalten
- "Aktuelle Felder/Eingaben" - Formularstruktur beibehalten
- "Navigationsstruktur" - Aktuelle Navigation beibehalten
- "Keine" - Alles frei ändern
Frage 2: Technische Einschränkungen
- Kopfzeile: "Einschränkungen"
- Frage: "Gibt es technische Einschränkungen?"
- Optionen:
- "Keine neuen Abhängigkeiten" - Nur vorhandene Bibliotheken verwenden
- "Vorhandene Komponenten verwenden" - Auf aktuellem Designsystem aufbauen
- "Muss barrierefrei sein (WCAG)" - Strenge Zugänglichkeitsanforderungen
- "Keine" - Keine besonderen Einschränkungen
- multiSelect: true
Phase 2: Design Brief erstellen
Nach dem Interview einen strukturierten Design Brief als JSON erstellen und unter .claude-design/design-brief.json speichern:
{
"scope": "component|page",
"isRedesign": true|false,
"targetPath": "src/components/Example.tsx",
"targetName": "Example",
"painPoints": ["Zu dicht", "Primäre Aktion unklar"],
"inspiration": {
"visual": ["Stripe", "Linear"],
"functional": ["Inline-Validierung"]
},
"brand": {
"adjectives": ["minimalistisch", "vertrauenswürdig"],
"density": "comfortable",
"darkMode": true
},
"persona": {
"primary": "Entwickler",
"context": "desktop-first",
"keyTasks": ["Checkout abschließen", "Bestellung überprüfen", "Rabatt anwenden"]
},
"constraints": {
"mustKeep": ["vorhandene Felder"],
"technical": ["keine neuen Abhängigkeiten", "WCAG barrierefrei"]
},
"framework": "nextjs-app",
"packageManager": "pnpm",
"stylingSystem": "tailwind"
}
Vor dem Fortfahren eine Zusammenfassung für den Benutzer anzeigen.
Phase 3: Design Lab erstellen
Verzeichnisstruktur
Alle Dateien unter .claude-design/ erstellen:
.claude-design/
├── lab/
│ ├── page.tsx # Haupt-Lab-Seite (framework-spezifisch)
│ ├── variants/
│ │ ├── VariantA.tsx
│ │ ├── VariantB.tsx
│ │ ├── VariantC.tsx
│ │ ├── VariantD.tsx
│ │ └── VariantE.tsx
│ ├── components/
│ │ └── LabShell.tsx # Lab-Layout-Wrapper
│ ├── feedback/ # Interaktives Feedbacksystem
│ │ ├── types.ts # TypeScript-Schnittstellen
│ │ ├── selector-utils.ts # Elementidentifikation
│ │ ├── format-utils.ts # Feedback-Formatierung
│ │ ├── FeedbackOverlay.tsx # Haupt-Overlay-Komponente
│ │ └── index.ts # Modul-Exporte
│ └── data/
│ └── fixtures.ts # Gemeinsame Mock-Daten
├── design-brief.json
└── run-log.md
Feedbacksystem-Einrichtung (KRITISCH - NIEMALS ÜBERSPRINGEN)
Das FeedbackOverlay ist die PRIMÄRE Funktion des Design Labs. Ohne es können Benutzer kein interaktives Feedback geben. NIEMALS ein Design Lab ohne das FeedbackOverlay generieren.
Zuverlässigkeitsstrategie: Um Importpfadprobleme über verschiedene Projektkonfigurationen hinweg zu vermeiden, erstellen Sie das FeedbackOverlay direkt im Routenverzeichnis (z.B. app/design-lab/FeedbackOverlay.tsx), NICHT in .claude-design/. Dies gewährleistet, dass ein einfacher relativer Import (./FeedbackOverlay) immer funktioniert.
Erforderliche Dateien im Routenverzeichnis:
app/design-lab/ # oder app/__design_lab/ wenn Unterstriche funktionieren
├── page.tsx # Haupt-Lab-Seite mit Varianten
└── FeedbackOverlay.tsx # Eigenständige Overlay-Komponente (aus Vorlagen kopieren)
Vorlagenquelle: design-and-refine/templates/feedback/FeedbackOverlay.tsx
Warum dieser Ansatz:
.claude-design/-Pfade können aufgrund von Bundler-Konfigurationen fehlschlagen- Relative Importe aus demselben Verzeichnis funktionieren immer
- Das Routenverzeichnis wird während der Bereinigung trotzdem gelöscht
Routenintegration
Next.js App Router:
app/__design_lab/page.tsx erstellen, die aus .claude-design/lab/ importiert
Next.js Pages Router:
pages/__design_lab.tsx erstellen, die aus .claude-design/lab/ importiert
Vite React:
- Wenn React Router vorhanden ist: Route zu
/__design_labhinzufügen - Wenn kein Router vorhanden ist: Bedingte Darstellung in
App.tsxbasierend auf dem Abfrageparameter?design_lab=trueerstellen
Andere Frameworks: Die am besten geeignete temporäre Route für das erkannte Framework erstellen.
Richtlinien zur Variantenerstellung
WICHTIG: Lesen Sie DESIGN_PRINCIPLES.md für UX-, Interaktions- und Bewegungsbest Practices. Aber verwenden Sie KEINE vordefinierten visuellen Stile — leiten Sie sie aus dem Projekt ab.
Universelle Prinzipien anwenden (aus DESIGN_PRINCIPLES.md):
- UX: Nielsens Heuristiken, Reduzierung der kognitiven Last, progressive Offenlegung
- Komponentenverhalten: Button-Zustände, Formular-Anatomie, Kartenstruktur
- Interaktion: Feedback-Muster, Zustandsbehandlung, optimistische Aktualisierungen
- Bewegung: Timing (150-300ms), Beschleunigung (ease-out für Eintritte, ease-in für Austritte)
- Barrierefreiheit: Fokus-Zustände, ARIA-Muster, Touch-Ziele (mindestens 44px)
Visuelle Stile aus dem Projekt ableiten:
- Farben → aus Tailwind-Konfiguration, CSS-Variablen oder vorhandenen Komponenten
- Typografie → aus vorhandenen Überschriften, Fließtext in der Codebasis
- Abstände → aus der Abstandsskala des Projekts oder vorhandenen Mustern
- Border-Radius → aus vorhandenen Karten, Buttons, Eingaben
- Schatten → aus vorhandenen erhöhten Komponenten
Jede Variante MUSS eine andere Designachse erkunden. Erstellen Sie keine geringfügigen Abweichungen — machen Sie sie bedeutungsvoll unterschiedlich. Verwenden Sie die vorhandene visuelle Sprache des Projekts für alle Varianten.
Variante A: Informationshierarchie-Fokus
- Inhaltshierarchie umstrukturieren (was ist am wichtigsten?)
- Gestalt-Gesetz der Nähe anwenden — verwandte Elemente näher zusammen gruppieren
- Eine primäre Aktion pro Ansicht
- Vorhandene Typografie-Skala verwenden, um klare Ebenen zu schaffen
Variante B: Layout-Modell-Erkundung
- Einen anderen Layout-Ansatz ausprobieren (Karte vs. Liste vs. Tabelle vs. geteilter Bereich)
- Kartenanatomie oder Tabellenverhaltensmuster aus DESIGN_PRINCIPLES anwenden
- Responsives Verhalten an jedem Breakpoint berücksichtigen
- Vorhandenes Raster-/Layoutsystem des Projekts verwenden
Variante C: Dichtevariation
- Wenn der Brief "komfortabel" sagt, eine kompaktere Version ausprobieren
- Wenn der Brief "kompakt" sagt, eine großzügigere Version ausprobieren
- Vorhandene Abstands-Tokens des Projekts verwenden — sie nur anders anwenden
- Die Kompromisse zeigen: mehr sichtbare Daten vs. einfacheres Scannen
Variante D: Interaktionsmodell
- Unterschiedliches Interaktionsmuster (Modal vs. Inline vs. Panel vs. Drawer)
- Feedback-Muster anwenden: sofortig → Fortschritt → Abschluss
- Alle erforderlichen Zustände implementieren (Laden, Fehler, Leer, Deaktiviert)
- Optimistische Aktualisierungen für nicht-destruktive Aktionen in Betracht ziehen
Variante E: Ausdrucksrichtung
- Die Markenrichtung vorantreiben, die der Benutzer im Interview beschrieben hat
- Unterschiedliche Verwendungen der vorhandenen Design-Tokens des Projekts erkunden
- Mehr oder weniger Schatten, Rahmen, Hintergrundfarben
- Bewegung anwenden, wo sie Bedeutung verleiht (Hover, Fokus, Übergänge)
Lab-Seiten-Anforderungen
Die Design-Lab-Seite muss Folgendes enthalten:
-
Kopfzeile mit:
- Zusammenfassung des Design Briefs (Ziel, Umfang, Hauptanforderungen)
- Anweisungen zur Überprüfung
-
Variantenraster mit:
- Klaren Bezeichnungen (A, B, C, D, E)
- Kurzer Begründung für jede Variante ("Warum dies existiert")
- Der tatsächlich gerenderten Variante