Communitygithub.com

craft-setup

Nutze dies, wenn eine Anfrage zum Entwerfen oder Erstellen einer Seite, eines Bildschirms oder eines Elements in einem Projekt ohne DESIGN.md im Stammverzeichnis beginnt, wenn jemand bittet, das Design, den Stil, die Marke oder die Richtlinien eines Produkts einzurichten, zu definieren oder zu starten, oder wenn /craft-setup (/craft:craft-setup im Claude Code Plugin) verwendet wird.

Was ist craft-setup?

Die **craft-setup**-Fähigkeit führt den gesamten Design-Einrichtungsprozess aus, bevor die erste Benutzeroberfläche erstellt wird. Sie stellt sicher, dass ein klares Briefing (`DESIGN.md`) existiert, das Produkt, Zielgruppe, Stimmung, Marke, Referenzen und Einschränkungen dokumentiert – alles basierend auf Benutzerinterviews und vorhandenen Projektdaten, nicht auf Erfindungen des Assistenten. Die Fähigkeit umfasst das Lesen vorhandener Dokumentation und Design-Systeme, das schrittweise Befragen (eine Frage pro Nachricht) mit Optionen, das Schreiben der `DESIGN.md` anhand einer Vorlage, eine Genehmigungsschleife und dann den Aufbau der Grundlagen (Design-Tokens, Typografie, Abstände) entweder durch den Unterbefehl `craft-system` (falls kein System im Code vorhanden ist) oder durch `craft-sync` (Import eines bestehenden Systems in das Designtool). Falls der Benutzer „überspringen“ sagt, wird trotzdem eine minimale `DESIGN.md` mit markierten Annahmen erstellt, und die Grundlagen werden nicht übersprungen. Die Fähigkeit ist plattformunabhängig (funktioniert in Claude Code, Cursor, Codex usw. über Adapter-Skripte) und legt Wert auf Benutzerentscheidungen, klare Annahmen und die Vermeidung von erfundenen Marken oder nicht genehmigten Umgestaltungen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diego3g/craft/tree/HEAD/skills/craft-setup

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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.md im Projektstammverzeichnis.
  • „Richte das Design ein“, „Definiere unseren Stil / unsere Marke / unsere Richtlinien“, /craft-setup (/craft:craft-setup im Claude Code Plugin).

Wann NICHT verwenden

  • DESIGN.md existiert und die Aufgabe ist ein Design: craft verwenden.
  • Ein Token oder eine Richtlinie ändern: craft-system verwenden.

Schritte

  1. 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“).
  2. 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.
  3. 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.
  4. Schreibe DESIGN.md in 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.
  5. Halte an und zeige der Person DESIGN.md. Ändere es, bis sie es genehmigen.
  6. 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-system im 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.

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 craft nur 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.md ist eine einfache Markdown-Datei im Repository für jedes Werkzeug. Nur die optionale Referenztafel lebt im Designtool.

Regeln

RegelGrund
Eine Frage pro Nachricht, mit OptionenEine Wand voller Fragen wird überflogen und nur halb beantwortet
Lesen, bevor du fragst; frage niemals, was die Dateien sagenWenn 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)“ markiertEine 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 gefragtWas vermieden werden soll, grenzt das Design schneller ein als das Ziel
Vorhandene Dateien während der Einrichtung nicht neu gestaltenDie Einrichtung dokumentiert Entscheide; ihr CSS zu ändern, ist eine Designaufgabe, um die sie noch nicht gebeten haben
Keine Bildschirme während der EinrichtungBildschirme 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

GedankeRealitä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.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills