Warum du dich für den Kontext des Designs interessieren solltest


Da Entwickler*innen zunehmend agentische Codierungstools verwenden, sind die Struktur und Klarheit von Design-Dateien wichtiger denn je. Durch eine umsichtige Organisation deiner Arbeit kannst du dazu beitragen, dass deine Entwicklerkolleg*innen effizienter und genauer arbeiten.
Warum du dich für den Kontext des Designs interessieren solltest teilen
Hero-Illustration von Cynthia Alfonso
Eine klare Designrichtung zu finden, erfordert Zeit und Liebe zum Detail, aber es ist nur ein Teil des großen Ganzen. Dasselbe Maß an Sorgfalt sollte auch auf den Übergabeprozess angewendet werden. Jetzt, da mehr Entwickler*innen den Figma Dev Mode MCP-Server nutzen, um Design-Kontext in agentische Codierungswerkzeuge einzubringen, spielen Designer*innen eine größere Rolle dabei, diesen Prozess reibungsloser zu gestalten. Je klarer Ihre Dateien sind, desto besser können diese Tools Ihre Arbeit in präzisen Code interpretieren und übersetzen. Hier teilen wir drei Best Practices, um Entwickler*innen – und den von ihnen verwendeten KI-Agenten – den Kontext zu geben, den sie benötigen, um vom Design zur Produktion zu gelangen.
1. In Grundlagen investieren
Wir haben schon lange über die Bedeutung des Aufbaus eines Designsystems gesprochen. Komponenten und Variablen für Farbe, Größenanpassung, Abstand und Typografie schaffen wiederholbare Muster, die Zeit sparen und Konsistenz im großen Maßstab gewährleisten. Um jedoch noch mehr Effizienzen freizuschalten, musst du diese Grundlagen direkt mit dem Code verknüpfen. Die Dokumentationsfunktionen von Figma wie Code Connect und Codesyntax helfen, diesen Codebasis-Kontext in Figma zu integrieren. Code Connect verbindet Komponenten mit ihren codierten Gegenstücken und zeigt im Dev Mode genaue Codeausschnitte an, während die Code-Syntax definiert, wie Variablen in Web- und nativen Codebasen geschrieben werden sollten.

Erfahre mehr über den Aufbau, die Skalierung und die Pflege eines erfolgreichen Designsystems.
Für einen tieferen Einblick in die Code-Syntax, sieh dir das Video von Entwickler-Advocate Jake Albaugh über die Automatisierung dieses Prozesses über die Browser-Konsole an.
Mit dem MCP-Server von Figma Dev Mode können KI-Agenten auf diesen zusätzlichen Kontext in Figma zugreifen, um genaueren Code zu generieren. Wenn beispielsweise eine Kartenkomponente im Designsystem mit Code verbunden ist und gemeinsame Variablen für Abstand, Farbe und Typografie verwendet, kann der MCP-Server einem KI-Agenten den genauen Kontext geben, den er benötigt, um diese Karte in produktionsreifem Code zu generieren. Anstatt die gesamte Codebase zu durchsuchen, um die richtigen Teile zu finden, können KI-Agenten diese direkt abrufen und den Code schneller generieren, wodurch Entwickler*innen Zeit gespart und die Genauigkeit verbessert wird. Und da der Kontext in deine Figma-Bibliotheken eingebaut ist, erstrecken sich die Vorteile über die gesamte Organisation, sodass alle, die neue Benutzeroberflächen erstellen, automatisch den richtigen Codekontext erhalten.


2. Die Dateien für die Nutzung durch Entwickler*innen strukturieren
Sich die Zeit zu nehmen, Seitenhierarchien einzurichten und jeden Frame und jede Ebene zu benennen, kann mühsam erscheinen, aber am Ende die richtige Dateistruktur zu haben, ist die Mühe wert. Wenn man bei Layouts, Benennung und Hierarchie bewusst Entscheidungen trifft, hilft das nicht nur beim Design, sondern bietet auch nützlichen Kontext für MCP und Entwickler*innen.
Hier sind einige wichtige Tipps, die du beim Strukturieren der Dateien beachten solltest:
- Framesfür verschiedene Breakpunkte erstellen. Erstelle Frames für verschiedene Breakpoints. Das Hinzufügen von Frames für wesentliche visuelle Unterschiede – zum Beispiel, wenn du eine Navigationsleiste in ein Menü-Icon umwandelst – hilft dabei, das responsive Verhalten explizit zu gestalten.
- Das Auto-Layout nutzen. Mit dem Auto-Layout wird definiert, wie Designs auf unterschiedliche Ansichtsbreiten, Breakpunkte und zusätzliche Texte reagieren. Wann immer möglich, wende das Auto-Layout auf vertikale Listen, horizontale Reihen und Rasterlayouts an. Für Elemente, die den Fluss unterbrechen müssen, kannst du Ebenen so einstellen, dass sie das Auto-Layout ignorieren und Größenänderungsbeschränkungen anwenden.
- Die Ebenenstrukturen sauber halten. Ebenenhygiene hilft, eine klare Hierarchie aufrechtzuerhalten, und das Vermeiden unnötiger Gruppen oder Frames erleichtert die Navigation in den Dateien.
- Die Ebenen benennen. Ebenen helfen KI und Entwickler*innen zu verstehen, was jedes Element darstellt. Wenn Ebenennamen unklar sind, ist es wahrscheinlicher, dass KI das Design falsch interpretiert, was nachgelagerte Probleme für die Entwickler*innen verursacht. Eine klare Benennung ermöglicht es KI-Agenten, Code mit höherer Genauigkeit zu generieren – zum Beispiel ist es nützlicher, etwas als „Karte“, „Reihe“ oder „Avatar“ zu bezeichnen, als „Frame 1337“. Wenn du wenig Zeit hast, kann dir die KI von Figma zur Ebenenumbenennung in Sekundenschnelle dabei helfen, Ebenen umzubenennen.

Auf dem obigen Bild ist die Datei, die als „schlecht“ gekennzeichnet ist, höchstwahrscheinlich dazu geeignet, KI-Agenten zu verwirren, wenn sie Code generieren, da sie keine aussagekräftigen Namen und eine klare Hierarchie der Elemente aufweist. Das mittlere Bild ist eine Verbesserung, mit hilfreichen Ebenennamen und der Verwendung von Auto-Layout zur Definition räumlicher Beziehungen, was es KI-Agenten erleichtert, qualitativ hochwertigen Code zu generieren. Trotzdem erzeugt die Struktur Variabilität im Output. Das „beste“ Beispiel zeigt eine gut organisierte Datei mit klarer Benennung, logischer Struktur und wiederverwendbaren Mustern. Mit diesem Setup generieren KI-Agenten qualitativ hochwertigen Code, der direkt von den Komponenten und Variablen Ihrer Codebasis abzapft, was zu präziseren Ergebnissen führt.
3. Interaktionsabsichten teilen
Die Kommunikation interaktiver Elemente des Designs ist ebenso wichtig wie die Kommunikation statischer Elemente. Das Hinzufügen von Annotationen, um die gewünschte Funktionalität zu erfassen, gibt KI-Agenten den Kontext, um nicht nur zu verstehen, wie etwas aussehen sollte, sondern auch, wie es sich verhalten sollte. Klare Notizen zu Zuständen, Übergängen und dynamischem Inhalt verringern das Rätselraten und bringen das Ergebnis näher an deine Absicht beim ersten Durchgang heran.

Erwäge, Annotationen zu schreiben, wenn Ihr Design Folgendes nutzt:
- Interaktive Elemente: Beschreibe Momente der Interaktivität beim Klicken oder Überfahren mit der Maus oder wenn ein bestimmter Cursor verwendet werden soll.
- Bedingte Zustände: Benenne Szenarien, bei denen eine Zustandsänderung durch eine Aktion der Benutzer*innen oder eine bestimmte Bedingung verursacht wird. Zum Beispiel ist eine Schaltfläche mit der Beschriftung „Abschicken“ deaktiviert, bis die erforderlichen Felder validiert wurden.
- Dynamischer Inhalt: Wenn dein Design statischen Platzhalterinhalt enthält, der dynamisch sein soll, stelle Anweisungen bereit, um Daten aus einer Datenquelle abzurufen.
Wenn die Funktionalität ebenso klar dokumentiert ist wie die visuellen Elemente, bereite MCP darauf vor, Code zu erzeugen, der die vollständige Entwurfsabsicht darstellt.
Letztendlich ist es sehr wichtig, Schritte zu unternehmen, um dem Designsystem Kontext, Struktur, Benennung und klar geschriebene Annotationen hinzuzufügen – nicht nur, um das Verständnis der Entwickler*innen zu verbessern, sondern auch, um den richtigen Kontext für agentische Codierungstools bereitzustellen. Selbst beim Arbeiten mit diesen agentischen Codierungstools ist eine klare Kommunikation zwischen Designer*innen und Entwickler*innen entscheidend für Ausrichtung und Klarheit.


