So schreiben Sie DESIGN.md, das KI-Agenten zuverlässig verstehen

KI-Agenten folgen DESIGN.md-Prosa nur, wenn sie nicht nur Werte, sondern konkrete Regeln und Absichten beschreibt. Ein einfaches Farbtoken wie #1A1C1E sagt einem Agenten noch nichts über den Kontext – erst die Beschreibung der Rolle macht daraus eine handlungsleitende Anweisung.

Warum schwache Prosa Agenten im Stich lässt

Viele DESIGN.md-Dateien beschränken sich auf technische Tokens: Primärfarbe ist #1A1C1E, Sekundärfarbe #6C7278. Doch was bedeutet das für die Benutzerführung? Ohne Kontext kann ein Agent keine Entscheidungen treffen, die über die wörtliche Nennung hinausgehen. Eine starke Prosa hingegen definiert nicht nur Farben, sondern deren Zweck – etwa: „Nutze die Akzentfarbe ausschließlich für die primäre Interaktion, um den Fokus des Nutzers zu lenken.“

Wie Agenten Markdown interpretieren

KI-Modelle wurden mit strukturierten Daten trainiert, darunter umfangreiche Markdown-Dokumentation. Deshalb eignet sich diese Formatierung ideal, um Design-Intentionen zu vermitteln. Tokens definieren Werte, Prosa legt die Regeln fest, nach denen diese Werte eingesetzt werden. Ohne diese Regeln bleibt dem Agenten nur das Raten – und das führt zu inkonsistenten oder sogar unbrauchbaren Ergebnissen.

Die essenziellen Abschnitte für KI-verträgliche Systeme

Ein gut strukturiertes DESIGN.md beantwortet typische Fragen, die ein Agent sonst aus dem Kontext erraten müsste:

• Übersicht: Beschreibt die Persönlichkeit und das Ziel des Designsystems.
• Farben: Erklärt die Rollen der Farbtöne und die Regeln für ihren Einsatz.
• Typografie: Legt fest, welche Schriftstile für welche Inhalte verwendet werden.
• Layout: Definiert Raster, Abstände und visuelle Hierarchien.
• Do’s und Don’ts: Enthält harte Grenzen, die typische Fehler direkt ausschließen.

Warum Do’s und Don’ts der entscheidende Teil sind

Diese Sektion ist der einzige Ort, an dem Sie konkrete Verbote formulieren können – und genau das macht sie so wertvoll. Beispiele:

• „Nutze den Akzentton ausschließlich für eine primäre Aktion pro Bildschirm.“
• „Vermeide das Mischen von abgerundeten und eckigen Ecken innerhalb derselben Ansicht.“
• „Halte einen Kontrast von mindestens 4,5:1 (WCAG AA) für normalen Text ein.“
• „Verwende pro Bildschirm nicht mehr als zwei Schriftgewichte.“

Jede dieser Zeilen eliminiert eine ganze Kategorie möglicher Fehlentscheidungen. Ohne sie könnte ein Agent etwa mehrere Akzentfarben auf einer Seite einsetzen – oder Schriftstile willkürlich kombinieren.

Wann ist genug genug?

Ein guter Test: Könnte ein Designer, der Ihr Produkt noch nie gesehen hat, Ihr System allein anhand Ihrer DESIGN.md korrekt anwenden? Wenn ja, haben Sie die richtige Balance gefunden. Konzentrieren Sie sich darauf, typische Fehlerquellen explizit auszuschließen – und hören Sie auf, wenn keine weiteren Unklarheiten übrig sind.

Häufige Fragen – und klare Antworten

• Sollte ich deskriptive Farbnamen verwenden?

Ja, aber immer in Verbindung mit dem Token-Namen. So kann der Agent die Begründung mit dem konkreten Wert verknüpfen.

• Welcher Abschnitt ist am wichtigsten?

Die Do’s und Don’ts. Sie verhindern direkt Fehler, die sonst durch unklare Absichten entstehen würden.

Fazit: Tokens sind nur der Anfang

Designsysteme leben von ihrer Prosa. Tokens mögen einfach zu definieren sein – doch erst die Regeln machen daraus ein System, das Agenten verstehen und zuverlässig umsetzen können. Investieren Sie Ihre Zeit in klare, handlungsleitende Beschreibungen. Denn am Ende zählt nicht, was Sie sagen, sondern wie Sie es sagen.

In Zukunft werden KI-Agenten eine immer größere Rolle in der Design-Entscheidungsfindung spielen. Wer heute schon DESIGN.md mit klaren Regeln schreibt, ist morgen einen Schritt voraus.