Design-Einrichtung
Übersicht
Bevor der erste Bildschirm entsteht, klären, was das Produkt ist, für wen es gedacht ist, wie es sich anfühlen soll und wie es niemals aussehen darf. Das wird in DESIGN.md festgehalten, dem Briefing, das jede spätere Designentscheidung zuerst liest. Fragen, nicht erfinden: Eine vom Agenten erfundene Marke ist eine Vermutung, die die Person rückgängig machen muss. Lies, was vorhanden ist, interviewe die Person Schritt für Schritt mit einer Frage pro Nachricht, schreibe das Briefing, halte für die Genehmigung an, und baue dann die Grundlagen auf.
Wann verwenden
- Eine Designaufgabe und keine
DESIGN.mdim Projektstammverzeichnis. - „Richte das Design ein“, „Definiere unseren Stil / unsere Marke / unsere Richtlinien“,
/craft-setup(/craft:craft-setupim Claude Code Plugin).
Wann NICHT verwenden
DESIGN.mdexistiert und die Aufgabe ist ein Design:craftverwenden.- Ein Token oder eine Richtlinie ändern:
craft-systemverwenden.
Schritte
- Zuerst lesen. README, Dokumentation, vorhandenes CSS oder Tokens, die Design-Datei, Brand-Ordner, jeden alten
DESIGN.md-Entwurf. Notiere, was sie bereits beantworten. Wenn der Code bereits ein Designsystem enthält (ein UI-Paket, Token-Dateien, eine Komponentenbibliothek), nenne dies mit einer Angabe der Anzahl und schreibe „Designsystem-Quelle:<Pfad>“ in den Markenabschnitt des Briefings. Biete in Schritt 6 an, es in das Designtool zu importieren, anstatt die Grundlagen zu erstellen; die dadurch beantworteten Markenfragen werden übersprungen. Zwei UI-Pakete → frage, welches die Quelle ist, bevor du eine Markenfrage überspringst. Stelle niemals eine Frage, die diese Dateien bereits beantworten. Bestätige es in einem Satz („Dein README sagt nur pt-BR und Mitglieder über 60, also entwerfe ich für 18px Text und 48px Tippbereiche“). - Befragung, eine Frage pro Nachricht. Folge der Befragung in ihrer Reihenfolge: Produkt, Zielgruppe und Stimme, Stimmung, Marke, Referenzen, Einschränkungen.
- Biete nach Möglichkeit 3–5 Optionen plus „etwas anderes“ an.
- Überspringe jede bereits beantwortete Frage.
- Höre auf, wenn die Antworten ausreichen, um den ersten Bildschirm zu entwerfen. Sechs gute Antworten sind besser als fünfzehn.
- Referenzen sind erforderlich. Frage nach 2–5 Produkten, Websites oder Bildern, die ihnen gefallen. Frage bei jeder Referenz, was übernommen und was vermieden werden soll. Wenn es sich um einen Link oder ein Bild handelt, das du öffnen kannst, sieh es dir an und sage, was du siehst, bevor du fragst.
- Schreibe
DESIGN.mdin das Projektstammverzeichnis, basierend auf der Vorlage, mit allen acht Abschnitten: Produkt, Zielgruppe und Stimme, Stimmung, Marke, Referenzen, Einschränkungen, Entscheidungsprotokoll und Offene Fragen.- Verwende nach Möglichkeit ihre Worte.
- Alles, was du abgeleitet hast und sie nicht bestätigt haben, kommt unter „Offene Fragen“, nicht als Tatsache in das Briefing.
- Halte an und zeige der Person
DESIGN.md. Ändere es, bis sie es genehmigen. - Grundlagen.
- Designsystem bereits im Code: Biete den Import an. Bei Zustimmung: ERFORDERLICHER UNTERBEFEHL:
craft-sync(Import). Es zeigt einen Bestand an und fragt, welche Komponenten gezeichnet werden sollen. Bei Ablehnung: „ – Import in abgelehnt“ im Entscheidungsprotokoll notieren. Biete es auch nach einem „Überspringen“ an: Es geht um das Designtool, nicht um das Briefing. - Kein System im Code: ERFORDERLICHER UNTERBEFEHL:
craft-systemim Erstellungsmodus für die Grundlagen (Tokens, Typografie, Abstände, Interaktionsregeln). Es hat seinen eigenen Genehmigungsstop. - Vorhandene Tokens und Stile sind der Ausgangspunkt: Erweitere sie, benenne sie nicht um und verschiebe sie nicht ohne Nachfrage.
- Designsystem bereits im Code: Biete den Import an. Bei Zustimmung: ERFORDERLICHER UNTERBEFEHL:
Wenn die Person „Überspringen“ oder „Entwirf es einfach“ sagt
Frage nicht weiter. Schreibe ein minimales DESIGN.md basierend auf dem, was du gelesen und was sie gesagt haben:
- Jede Lücke wird zu einer offenen Frage;
- Jede Annahme wird als „(angenommen)“ markiert.
Sage in einem Satz, welche Annahmen am wichtigsten sind. „Überspringen“ hebt das Interview und den Genehmigungsstop des Briefings auf, niemals Schritt 6:
- Designsystem im Code → stelle immer noch die eine Import-Frage („Jetzt in importieren? Ich zeige, was vorhanden ist, und du wählst die Komponenten aus“), dann fahre fort;
- Noch keine Tokens → der Grundlagen-Schritt und sein Stop werden trotzdem ausgeführt, weil
craftnur mit Systemteilen zeichnen kann.
Setze dann mit der von ihnen angefragten Aufgabe fort.
Bevor du beginnst
- Wenn kein Adapter in
references/adapters/zu deinem Werkzeug passt, führe die gleichen Verben in deinem Werkzeug aus und sage, welche du manuell zugeordnet hast. Wenn überhaupt kein Designtool vorhanden ist, erstelle in HTML (html.md). Wenn nur ein Bild vorhanden ist, sage, dass daraus gelesene Werte Schätzungen sind. DESIGN.mdist eine einfache Markdown-Datei im Repository für jedes Werkzeug. Nur die optionale Referenztafel lebt im Designtool.
Regeln
| Regel | Grund |
|---|---|
| Eine Frage pro Nachricht, mit Optionen | Eine Wand voller Fragen wird überflogen und nur halb beantwortet |
| Lesen, bevor du fragst; frage niemals, was die Dateien sagen | Wenn du fragst, was im README steht, zeigst du, dass du nicht hingesehen hast |
| Keine erfundene Marke: Farben, Schriftarten und Stimmung kommen von ihnen oder werden als „(angenommen)“ markiert | Eine erfundene Marke ist eine Vermutung, die sie Bildschirm für Bildschirm rückgängig machen müssen |
| Referenzen enthalten immer „übernehmen/vermeiden“ | „Ich mag Stripe“ ist nutzlos; „die ruhigen Abstände übernehmen, die Farbverläufe vermeiden“ ist eine Regel |
| „Gefällt mir gar nicht“ wird explizit gefragt | Was vermieden werden soll, grenzt das Design schneller ein als das Ziel |
| Vorhandene Dateien während der Einrichtung nicht neu gestalten | Die Einrichtung dokumentiert Entscheide; ihr CSS zu ändern, ist eine Designaufgabe, um die sie noch nicht gebeten haben |
| Keine Bildschirme während der Einrichtung | Bildschirme kommen von craft, nachdem das Briefing und die Grundlagen genehmigt sind |
Erledigt, wenn
DESIGN.md mit seinen acht Abschnitten genehmigt ist und die Grundlagen festgelegt sind: erstellt und genehmigt über craft-system, oder (mit einem System im Code) importiert über craft-sync oder der Import abgelehnt und protokolliert. Nach einem „Überspringen“: DESIGN.md ist mit markierten Annahmen geschrieben, die Grundlagen existieren (genehmigt oder bereits im Projekt), und die ursprüngliche Aufgabe wurde fortgesetzt.
Häufige Fehler
| Gedanke | Realität |
|---|---|
| „Ich wähle eine schöne Palette und Schriftarten, sie können es ändern“ | Sie können nicht ändern, was ihnen nicht bekannt war, dass es entschieden wurde. Frage, oder markiere es als „(angenommen)“. |
| „Solange ich hier bin, entwerfe ich die Hauptbildschirme“ | Das ist craft’s Aufgabe, nach der Genehmigung. Die Einrichtung endet mit dem Briefing und den Grundlagen. |
| „Lass mich alle sechs Fragen auf einmal stellen, um Zeit zu sparen“ | Eine pro Nachricht, mit Optionen. Das ist schneller für sie zu beantworten. |
| „Ihre Tokens sind unordentlich, ich werde sie umstrukturieren“ | Erweitere sie. Eine Umstrukturierung ist eine separate, genehmigte Änderung. |
| „Keine Referenzen gegeben, ich überspringe diesen Abschnitt“ | Frage nach ihnen. Wenn sie keine haben, biete drei an, die zur Stimmung passen, und frage, was von jeder übernommen und vermieden werden soll. |