Design Craft
Eine Arbeitsmethode für Frontend-Design und -Build. Die SKILL.md enthält alles, was jede Aufgabe benötigt; die
references/ Dateien bieten Tiefe, Zahlen und Code. Lese eine davon, wenn ihr Auslöser in der Tabelle am Ende zutrifft.
Umfang: Eine neue Seite, ein neuer Flow oder eine neue Komponente durchläuft die Schritte 1-8. Eine kleine Änderung (ein Zustand, eine Animation, ein String) durchläuft nur die davon betroffenen Schritte, dann Schritt 8 für das, was sich geändert hat.
Ordnung der Bedürfnisse
Funktional → zuverlässig → benutzbar → genussvoll. Füge niemals Freude zu etwas hinzu, das kaputt, langsam oder verwirrend ist, und liefere niemals ohne die oberste Schicht aus: Persönlichkeit, die auf "später" verschoben wird, wird selten ausgeliefert.
1. Rahmen (vor jeglichem Code)
- Job-Story: Wenn [Situation], möchte ich [Motivation], damit ich [Ergebnis]. Unbekannte Situation oder Ergebnis → frage nach, oder formuliere die Annahme als Hypothese in deiner Zusammenfassung.
- Wähle den Ehrgeiz, den das Briefing verlangt, und investiere Mühe dort:
| Brief | Investieren in | Erster Proof |
|---|---|---|
| Markenauftritt, "Premium", "Award-Niveau", "voller Animationen" | Eine signifikante Interaktion, die im Thema verankert ist (Schritt 2) | Die Interaktion funktioniert mit echten Inhalten: Anfang, Mitte, Unterbrechung, Loslassen |
| Launch, Editorial, Marketing-Seite | Das Angebot ist klar und seine besten Belege sind erkundbar | Erster Bildschirm auf einem Telefon lesbar; Hauptaktion ohne Wartezeit erreichbar |
| App, Tool, Dashboard | Die schwierigste Entscheidung, Kosten eines Fehlers, Geschwindigkeit der wiederholten Nutzung | Eine realistische Aufgabe mit sich ändernden Daten, plus Erholung von einem Fehler |
| Komponente oder Design-System | Ein Verhaltensvertrag, der zwei verschiedene Konsumenten überlebt | Dieselbe Komponente in zwei Kontexten mit langen Inhalten |
- Trenne Fakten von Annahmen. Nenne den emotionalen Zustand des Besuchers bei der Ankunft; er bestimmt den Ton.
- Prüfe, was existiert: Tokens, Komponenten, Patterns, Konventionen. Wiederverwenden vor Erfinden.
2. Finde die Signatur im Thema
Für ausdrucksstarke Arbeit suche nach einer Eigenschaft des Themas, die der Besucher erkennen würde, wenn das Logo abgedeckt ist, und einem Verb, das es ihnen erlaubt, es zu steuern. Ein Bier gießt sich ein, schäumt und zeigt seine Farbe; ein Stoff fällt; eine Schriftart hat Achsen; eine Uhr hat ein Uhrwerk. Gestalte die Interaktion um diese Eigenschaft herum.
- Substitutionstest: Tausche eine nicht verwandte Marke ein. Wenn der Effekt immer noch unverändert funktioniert, handelt es sich nicht um das Thema. Kehre zum Thema zurück, bevor du Feinschliff hinzufügst.
- Vier Beats: Was lädt zur Eingabe ein → was reagiert bei Kontakt → was wird bei anhaltender Eingabe enthüllt → was bleibt beim Loslassen erhalten. Ein durchgängiges Objekt sollte alle vier tragen.
- Mehr Effekte beheben nie "es fühlt sich einfach an". Ändere stattdessen die zentrale Idee oder Mechanik.
- Jede Geste erhält ein einfaches Äquivalent (einen Schieberegler, einen Button, eine Radiogruppe), das dieselben Informationen erreicht.
3. Günstig erkunden, den schwierigsten Teil zuerst beweisen
- Beschreibe mindestens drei strukturell unterschiedliche Ansätze in jeweils wenigen Zeilen. Wähle einen aus, begründe warum.
- Gestalte einen Standbild mit echten Inhalten vor der Bewegung: Lesereihenfolge, Typografie, Bildmaterial, primäre Aktion. Ein Standbild aus der Mitte einer Animation sollte ebenfalls absichtlich aussehen.
- Baue die riskanteste Behauptung zuerst (die Geste, die Scroll-Szene, den schwierigen Workflow) und überprüfe sie in einem echten Browser, bevor du den Rest der Seite darum herum baust.
4. System zuerst
- Tokens vor Komponenten. Komponenten verbrauchen semantische Tokens (
--color-action), die auf Primitive aliassen (--amber-400). Kein Hex, px oder magische Zahlen innerhalb von Komponenten-Styles. - Abstände auf einer 4er-Skala (4, 8, 12, 16, 24, 32, 48, 64). Body 16px/1rem bei 1.5 Zeilenhöhe; Überschriften 1.1-1.25. Ein modulares Schriftverhältnis. Maximal zwei Schriftarten (+ Mono). Tabellenziffern für sich ändernde Zahlen.
- 1-3 Markenfarben, Neutralfarben, Statusfarben. Jedes Textpaar erfüllt WCAG AA (4.5:1 Fließtext, 3:1 groß/UI). Farbe ist niemals das einzige Signal.
- Bewegungs-Tokens (Dauern, Easing) leben neben Farbe und Abstand.
- Props benennen die Bedeutung (
variant="destructive"), nicht das Aussehen. Wiederholte Überschreibungen bedeuten eine fehlende Variante.
5. Jeder Zustand, nicht nur der Glückspfad
Interaktive Komponenten: Standard, Hover, focus-visible, aktiv, deaktiviert, laden, Fehler, ausgewählt. Bildschirme: leer, laden, teilweise, Fehler, Erfolg, offline. Asynchrone Arbeit:
- Letzte Anfrage gewinnt; eine langsame ältere Antwort darf eine neuere nicht überschreiben.
- Behalte die Eingabe des Benutzers nach jedem Fehler bei und behalte vorherige Ergebnisse sichtbar (abgedimmt) während des Ladens.
- Leeres Konto, keine Ergebnisse und fehlgeschlagener Fetch sind unterschiedliche Zustände mit unterschiedlichen nächsten Aktionen.
Tastatur-bedienbar, semantisches HTML zuerst, ARIA nur, wo HTML es nicht ausdrücken kann, ein Label auf jedem Feld, einen sichtbaren Ausweg aus jedem Modal, und Fokus wird beim Schließen auf etwas Sinnvolles zurückgesetzt.
6. Emotion, Text und Ehrlichkeit
- Klarheit schlägt Klugheit. Wenn ein Witz einen zusätzlichen Satz braucht, streiche ihn. Kontraktionen, einfache Worte.
- Stimme ist konstant, Ton wechselt: warm bei Erfolg, sachlich und ruhig bei Fehlern, sanft bei sensiblen Eingaben.
- Fehler: Was passiert ist, warum, was als nächstes zu tun ist und was behalten wurde. Gib niemals dem Benutzer die Schuld. Kein Humor hier.
- Leere Zustände laden ein: Was wird hier erscheinen plus eine klare erste Aktion.
- Peak-End: Platziere die eine große Freude am Ende einer echten Errungenschaft, niemals in einem Frustrationstal.
- Auf Seiten mit hohem Einsatz, nenne die Ängste des Besuchers beim Namen und beantworte jede vor dem Call-to-Action.
- Bildmaterial: standardmäßig ein diverses Ensemble; frage "wen schließen wir aus?"
- Ehrlichkeit: Kennzeichne KI-generierte Bilder und Demodaten, wo Menschen sie für echt halten könnten. Der Text muss mit dem übereinstimmen, was die Bilder zeigen (eine Dose, die 5,0 % druckt, bedeutet, die Seite sagt 5,0 %).
- Regulierte Kategorien (Alkohol, Finanzen, Gesundheit, Kinder): Füge die erforderliche Zugangssperre oder den Hinweis hinzu und überprüfe die Bilder anhand der Werbenormen der Kategorie, z.B. keine sexualisierten Bilder für Alkohol.
7. Bewegung
Jede Animation hat eine Aufgabe: Kontext, Aufmerksamkeit, Feedback oder Persönlichkeit. Keine Aufgabe, keine Animation.
| Token | Wert | Nutzung |
|---|---|---|
--dur-1 | 100ms | Drücken, Fokus, Umschalten (≈ die Wahrnehmungsschwelle) |
--dur-2 | 200ms | Die meisten UI-Übergänge, Hover, kleiner Eintritt |
--dur-3 | 300ms | Panels, Drawer, Modals |
--dur-4 | 400-500ms | Nur für Vollbild- oder Hero-Choreografie |
--ease-out | cubic-bezier(0,0,.2,1) | Eintreten / Aufmerksamkeit erregen |
--ease-in | cubic-bezier(.4,0,1,1) | Verlassen / Aufmerksamkeit verlieren (Ausgänge ~20-30% kürzer) |
--ease-in-out | cubic-bezier(.4,0,.2,1) | Bewegen zwischen Positionen auf dem Bildschirm |
| spring | kritisch gedämpft, neu ausrichtbar | Gesten; Geschwindigkeit beibehalten, wenn sich das Ziel ändert |
- Blockiere niemals die Hauptaktion mit Choreografie. Ein Preloader oder Intro darf die primäre Aktion nicht länger als etwa eine Sekunde aufhalten, und wiederkehrende Besucher überspringen es.
- Räumliche Konsistenz: Dinge verlassen den Bereich, wie sie gekommen sind; gemeinsame Elemente verwandeln sich an Ort und Stelle.
- Stagger 30-60ms mit einer abklingenden Verzögerung (
base*√i); halte die gesamte Sequenz unter ~300ms. - Scroll-Szenen: Der Fortschritt wird vom gemessenen Weg des Abschnitts abgeleitet, sodass dieselbe Scroll-Position immer denselben Frame liefert, Scrollen nach oben sauber umkehrt und direkte Links in die Mitte funktionieren.
- Gesten: Ein Besitzer des Fortschritts; der Griff bleibt am Zeiger befestigt; Loslassen übergibt die Geschwindigkeit an eine Feder; Unterbrechung während der Bewegung hinterlässt die UI bedienbar.
- Animiere nur
transformundopacity. Unterprefers-reduced-motionentferne Bewegung, Parallaxe, Zoom und Autoplay, behalte kurze Überblendungen und lass benutzergesteuerte Gesten weiterhin funktionieren. - Technische Fallstricke, die echte Builds zerbrachen (eine Eigenschaft, ein Besitzer; pausierte Scroll-Timelines; Snap-
Labels innerhalb der Timeline; nicht-negative Frame-Zeit; Vorladen von austauschbaren Assets):
references/motion-engineering.md.
8. In einem echten Browser verifizieren, dann übergeben
Führe scripts/walk.py aus (Playwright + lokaler Chrome) bei Desktop, Telefon und reduzierter Bewegung: echter Mauszeiger-Zug,
durch jeden Abschnitt scrollen, Konsolenfehler, seitlicher Überlauf. Ein versteckter oder minimierter Vorschaubereich
drosselt Animations-Frames, also beurteile Bewegung nicht danach. Details: references/verification.md.
Bewerte dann anhand der Job-Story, nicht nach Geschmack:
- Erfüllt es die Job-Story? Ist die primäre Aktion das Prominenteste und überall erreichbar?
- Alle Zustände vorhanden (Schritt 5)? Tastatur, Screenreader-Labels, Kontrast?
- Nur Tokens? Vorhandene Komponenten wiederverwendet?
- Text folgt Schritt 6, einschließlich Ehrlichkeits-Kennzeichnungen?
- Hat jede Animation eine Aufgabe, die richtige Easing-Richtung, einen Unterbrechungspfad und einen Reduced-Motion-Pfad?
- Besteht die Signatur den Substitutionstest? Gibt es einen Peak, platziert an einem Ende?
- Was würde ich schneiden? Entferne ein Element oder einen Effekt und sieh, ob es besser wird.
Übergebe mit der Begründung: das Problem, der Ansatz, abgelehnte Alternativen und warum, was getestet wurde und wie
(Emulation vs. echtes Gerät) und bekannte Grenzen. Vorlage:
references/process-and-teams.md Anhang B.
Referenzen
| Lesen | Wann |
|---|---|
references/motion-engineering.md | beim Bauen von GSAP/ScrollTrigger/Lenis, Canvas, Geste oder Scroll-Szene-Arbeit |
references/verification.md | bevor visuelle oder interaktive Arbeit als erledigt erklärt wird |
references/imagery.md | beim Generieren oder Vorbereiten von Bildern, Produkt-Ausschnitten, Art Direction |
references/animation.md | Choreografie, die 7 Bewegungsprinzipien, Stagger-Mathematik, Bewegungs-Tokens |
references/emotion.md | Design-Persona, Onboarding, Freude, Vertrauen und Angst, Ausfall-Text |
references/design-systems.md | Tokens, Komponenten-APIs, Governance, Versionierung, Docs |
references/product-design.md | Recherche, Story-first, Skizzieren, Feedback, Prototyping, Testen |
references/design-thinking.md | ein mehrdeutiges Problem, das Empathie/Definieren/Ideieren/Prototypen/Testen erfordert |
references/design-engineering.md | Auswahl der Prototyp-Treue, Design↔Code-Handshake |
references/process-and-teams.md | Kritik-Sessions, Begründungs- und Übergabe-Vorlagen, DesignOps |