DESIGN.md
DESIGN.md ist eine Markdown-Datei im Projektordner, die KI-Agenten dein Design System in Klartext erklärt – mit Tokens, Stilrichtlinien und Regeln, was erlaubt ist und was nicht.
Was ist DESIGN.md – und woher kommt das Format?
DESIGN.md ist eine einfache Textdatei im Markdown-Format, die im Hauptordner eines Projekts liegt. Sie beschreibt, wie dein Interface aussehen soll, und zwar so, dass Menschen und KI-Agenten sie gleichermaßen verstehen. Bekannt wurde das Format durch Google Stitch und wird inzwischen auch mit Coding-Tools wie Claude Code genutzt.
Dahinter steckt eine simple Beobachtung: Ohne klare Vorgaben greifen KI-Tools auf das zurück, was in ihren Trainingsdaten am häufigsten vorkommt. Das Ergebnis sieht dann aus wie alles andere. Eine DESIGN.md gibt dem Agenten stattdessen deine Marke als Leitplanke.
Was steht in einer DESIGN.md?
- Design Tokens: Farben mit Einsatzzweck, Schriften, Größen, Abstände und Komponentenstile. Mehr dazu bei den Design Tokens.
- Design-Philosophie: Wie soll sich dein Interface anfühlen – ruhig, mutig, verspielt?
- Richtlinien: Kontraste, Barrierefreiheit sowie Dos and Don'ts.
Der Vorteil von Markdown: Es liest sich für Menschen angenehm, wird von Sprachmodellen gut verstanden und lässt sich wie Code versionieren. Die DESIGN.md ist damit die lesbare Kurzfassung deines Design Systems.
Was sind häufige Fragen rund um DESIGN.md?
- Was ist eine DESIGN.md und wofür brauche ich sie?
- Wo lege ich die DESIGN.md ab?
- Was ist der Unterschied zwischen DESIGN.md, CLAUDE.md und SKILL.md?
- Kann ich eine DESIGN.md aus Figma oder meiner Website erzeugen?
- Wie halte ich eine DESIGN.md aktuell?
- Brauche ich eine DESIGN.md, wenn ich Webflow nutze?
5 Tipps für eine DESIGN.md, mit der KI wirklich nach deiner Marke gestaltet
- Konkrete Werte statt Adjektive: „#0F172A“ ist hilfreicher als „ein dunkles Blau“.
- Den Zweck dazuschreiben: Nicht nur welche Farbe, sondern wofür sie gedacht ist.
- Verbote nennen: „Keine Verläufe, keine Schlagschatten“ hilft oft mehr als eine lange Wunschliste.
- Kompakt bleiben: Was kurz und klar ist, wird auch klar umgesetzt.
- Aktuell halten: Neue Komponente, neue Farbe? Datei anpassen. Eine veraltete DESIGN.md ist schlimmer als keine.
Ich übersetze Marken in genau solche Regeln – von den Brand Guidelines bis zur lesbaren Datei für KI-Tools. Wie das bei dir aussehen kann, besprechen wir gern: komm einfach auf mich zu.
Deine Marke, in einer Sprache, die KI versteht
Du willst, dass KI-Tools nach deiner Marke gestalten statt nach Zufall? Genau so etwas ermögliche ich für meine Kund:innen: Brand Guidelines, Tokens und eine saubere DESIGN.md aus einer Hand. Erzähl mir von deinem Projekt!
Diese Leistungen passen zuDESIGN.md
Über den Autor
Als erfahrener Brand Designer, Webdesigner und zertifizierter Webflow Expert betreue ich schon seit vielen Jahren Kund:innen aus verschiedensten Branchen und verhelfe ihnen durch herausragendes Design zu mehr Marktanteilen.
