Was macht Craft?
Überblick
Die erste Tür für alles Visuelle. Aus „Gestalte die Preisseite“ wird ein fertiges, überprüftes Design. Sie arbeitet nach dem Projekt-Brief, deckt jeden Zustand ab, bietet Optionen nur bei offener Ausrichtung, verwendet nur Bausteine des Designsystems und prüft ihre Arbeit vor der Präsentation. Sie ruft die anderen Designfähigkeiten an festgelegten Punkten auf; sie ersetzt sie nicht.
Wann verwenden
- „Entwerfen / Erstellen / Mockup / Neugestalten der <Seite, des Bildschirms, des Flows, des Elements>“,
/craft(/craft:craftim Claude Code Plugin). - Mehrere Seiten auf einmal („Gestalte das Onboarding: Begrüßung, Registrierung, Verifizierung“).
Wann NICHT verwenden
- Eine kleine Änderung, die genau beschrieben wurde (ein Wert, ein Label, eine Größe): gleich ausführen.
- Nur eine Überprüfung („Was stimmt hier nicht?“):
craft-critique. Nur Optionen:craft-explore.
Vorbereitung
- Wenn kein Adapter in
references/adapters/zu deinem Werkzeug passt, führe die gleichen Aktionen in deinem Werkzeug aus und gib an, welche du manuell zugeordnet hast. Gibt es überhaupt kein Designtool, erstelle in HTML (html.md). Hast du nur ein Bild, weise darauf hin, dass daraus abgelesene Werte Schätzungen sind.
Stopps sind real
Ein Stopp bedeutet: Beende deinen Zug mit der Frage und warte. Das kannst du immer tun, auch in einer Einzelsitzung oder ohne Bildschirm, wo deine letzte Nachricht die Frage ist. Entscheide niemals einen Stopp für die Person, weil die Sitzung „nicht warten kann“ oder „um einen Hin-und-her zu sparen“. Wenn du selbst entscheidest, wird aus einer Fünf-Sekunden-Antwort stundenlange Nacharbeit.
Schritte
- Kontext.
- Lies
DESIGN.mdim Projektstammverzeichnis. Fehlt sie oder hat sie keinen Produktabschnitt (eine reine Sync-Aufzeichnung) → ERFORDERLICHE SUB-FÄHIGKEIT:craft-setup, dann hierher zurückkehren. - Lies das Designsystem (Tokens, Komponenten, Leitfaden) und die mit dieser Seite verwandten Bildschirme.
- Wenn der Brief und der Code widersprüchlich sind (der Brief sagt Türkis, die Tokens sagen Blau): Folge dem Code, nenne es in einem Satz, füge den Konflikt zu
DESIGN.md› Offene Fragen hinzu und biete an, das Falsche zu aktualisieren. Überschreibe niemals Tokens innerhalb des CSS einer Seite. - Wenn der Leitfaden des Designtools und der Code unterschiedlich sind und eine
design-sync.jsonexistiert, erkläre den Leitfaden nicht für veraltet. Ordne ihn zu: Code geändert → biete an, den Leitfaden vor dem Zeichnen zu aktualisieren; Leitfaden geändert → es ist die Änderung der Person, die auf einen Export wartet, also zeichne damit und erwähne den ausstehenden Export.
- Lies
- Umfang in Worten. Liste jede zu erstellende Seite oder jedes Element auf, jeweils mit seiner Aufgabe und seinem nächsten Schritt.
- Mehrdeutige Begriffe erhalten eine klare Interpretation („Preisseite = die Preisliste der Bäckerei, nicht die Abonnementpläne“).
- Stopp und bestätige die Liste, wenn es mehr als ein Element gibt oder die Anfrage vage ist. Bei einem klaren Element: weitermachen.
- Für jedes Element, der Reihe nach:
- ERFORDERLICHE SUB-FÄHIGKEIT:
craft-states. Ihre geschriebene Zustandsliste und ihr Stopp kommen zuerst. - Offene Ausrichtung? Nur wenn die Person nach Ideen gefragt hat oder wenn zwei strukturell unterschiedliche Layouts plausibel sind und weder der Brief noch das System zwischen ihnen wählt → ERFORDERLICHE SUB-FÄHIGKEIT:
craft-explorevor dem Zeichnen der Zustände. Frage bei mehreren Seiten beim Umfangsstopp, welche Seite (falls überhaupt) Optionen erhält; führe niemals standardmäßig eine Optionsrunde pro Seite durch. Die Zustände werden dann in der gewählten Richtung gezeichnet. Ein Bildschirm, der einem bestehenden Muster folgt, geht direkt zum Zeichnen. - Zeichne den Hauptzustand, dann die anderen Zustände, nur mit den Bausteinen und Tokens des Systems. Etwas Neues (eine Komponente, eine Farbe, eine Größe, die die Skala nicht hat) → ERFORDERLICHE SUB-FÄHIGKEIT:
craft-system(Hinzufügen-Modus) vor der Verwendung. Eine Komponente, die im Code existiert, aber im Tool nicht gezeichnet ist („nur im Code“ im Index) → ERFORDERLICHE SUB-FÄHIGKEIT:craft-sync(Import einer Komponente), zuerst nur diese Komponente zeichnen. Wenn die Person den Import abgelehnt hat (sieheDESIGN.md), frage einmal vor dem Import; wenn sie immer noch nein sagt, baue aus den Werten des Codes direkt auf der Tafel und notiere es. Zeichne niemals ein Nachahmungsstück und codiere niemals einen neuen Wert in einer Seite fest. - ERFORDERLICHE SUB-FÄHIGKEIT:
craft-critiqueim Selbstprüfmodus für jede Tafel: rendere sie, behebe, was innerhalb des Aufgabenumfangs gefunden wird, und rendere erneut.
- ERFORDERLICHE SUB-FÄHIGKEIT:
- Abschluss.
- Zeige das Ergebnis mit der Zusammenfassung unten.
- Füge die Entscheidungen zu
DESIGN.md› Entscheidungsprotokoll hinzu (Datum, Entscheidung, Grund). - Verschiebe jede beantwortete Frage aus den Offenen Fragen.
Abschlusszusammenfassung (Form deiner letzten Nachricht)
Erstellt: <Seiten/Elemente> — <wo: Dateien oder Tafeln>
Entscheidungen: <jede, eine Zeile mit Grund> (auch in DESIGN.md › Entscheidungsprotokoll)
Systemänderungen: <hinzugefügte/geänderte Bausteine oder Tokens> — betrifft: <Bildschirme>
Selbstprüfung behoben: <was craft-critique geändert hat, bevor du es gesehen hast>
Offene Fragen: <was die Person noch entscheiden muss>
Regeln
| Regel | Grund |
|---|---|
DESIGN.md zuerst, jedes Mal | Ohne Brief erfindet jeder Bildschirm seinen eigenen Stil |
| Umfang vor der Arbeit bestätigt, wenn mehr als ein Element | Drei Seiten, die auf einem falschen Verständnis aufbauen, sind drei verschwendete Seiten |
Zustandsliste vor dem Zeichnen (via craft-states) | Der Happy Path ist nur einer von vielen Zuständen |
| Optionen nur, wenn die Ausrichtung offen ist | Optionen bei einem gelösten Muster verschwenden die Aufmerksamkeit der Person |
Nur Systembausteine und -tokens; neue gehen über craft-system | Hartcodierte Werte in Seiten sind der Anfang von Drift |
| Code schlägt einen veralteten Brief; notieren, nicht überschreiben | Die Tokens sind das, was ausgeliefert wird; der Brief wird durch Entscheidungen aktualisiert, nicht stillschweigend |
| Selbstprüfung vor dem Zeigen | Die Person sollte das Design überprüfen, nicht Fehler fangen |
Entscheidungen gehen in DESIGN.md | Das nächste Session-Design beginnt damit, nicht aus dem Gedächtnis |
Erledigt, wenn
Jedes Element im bestätigten Umfang seine gezeichneten und selbstgeprüften Zustände hat, jede Systemänderung über craft-system gelaufen ist, die Abschlusszusammenfassung gegeben wurde und das Entscheidungsprotokoll in DESIGN.md aktualisiert wurde.
Häufige Fehler
| Gedanke | Realität |
|---|---|
| „Drei Seiten sind klar genug, ich baue sie einfach“ | Bestätige zuerst die Liste. Es kostet eine Nachricht. |
| „Ich mache Buttons hier 52px; der Token sagt 44, aber dieses Publikum braucht größere“ | Das ist eine Systementscheidung. Schlage sie über craft-system vor, dann verwende sie überall. |
| „Der Brief sagt Türkis, also überschreibe ich das Blau im CSS dieser Seite“ | Code gewinnt. Markiere den Konflikt und frage nach; patche Tokens niemals lokal. |
| „Ich zeige es, sie sagen mir dann, was falsch ist“ | Führe zuerst craft-critique im Selbstprüfmodus aus und sage, was es behoben hat. |
| „Die Entscheidungen stehen in meiner Nachricht, das reicht“ | Nachrichten scrollen weg. Füge sie zu DESIGN.md hinzu. |
| „Diese Sitzung kann nicht auf Antworten warten, also treffe ich die Entscheidungen selbst und liste sie auf“ | Deinen Zug mit der Frage zu beenden ist warten. Tu das; baue nichts über den ersten offenen Stopp hinaus. |
| „Um einen Hin-und-her zu sparen, gebe ich beide Stopps in eine Nachricht“ | In Ordnung, wenn du dann stoppst. Frage beides, baue nichts, warte. |