Communitygithub.com

Prototyp zuerst

Designoptionen als Prototypen zeigen und vor dem Bauen eine Auswahl treffen lassen. Nutzbar für neue Screens, neue Abläufe, ein Redesign, eine Website oder Landingpage, jede „Zeig mir Optionen“- oder „Kannst du das prototypen?“-Anfrage und jede UX-Frage mit mehr als einer sinnvollen Antwort. Umfasst auch das Bauen auf Basis des ausgewählten Prototyps.

Was ist Prototyp zuerst?

Dieser Skill ist für Agenten konzipiert, die auf Wunsch des Nutzers interaktive Designarbeiten durchführen. Er optimiert den Design-Feedback-Zyklus, indem er den Agenten dazu zwingt, mehrere Designvarianten als klickbare Prototypen darzustellen, bevor irgendein Code in die Codebasis gelangt. Der Skill verhindert die Verschwendung von Entwicklungszeit, indem sichergestellt wird, dass der Nutzer vor der Implementierung eine fundierte Designentscheidung trifft. Er umfasst fünf klar definierte Phasen: Recherche und Fragen, Erstellen von 2–4 Varianten, Präsentation der Runde, Auswahlentscheidung des Nutzers und schließlich die Implementierung nur der ausgewählten Variante. Der Skill schützt vor häufigen Fallstricken wie der Erstellung von PRs für Prototypen oder der stillschweigenden Änderung eines Prototyps während der Bauphase. Er unterstützt plattformübergreifend jeden Agenten, der Code oder HTML generieren kann, und seine Ausgabe ist ein einfaches Format, das die getesteten Ideen und ihre Kompromisse klar kommuniziert. Die Hauptvorteile sind kürzere Review-Zyklen, weniger Verschwendung im Design-Sprint und Code, der zu einer visuell genehmigten Referenz zurückverfolgt werden kann.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/0xa3k5/skills/tree/main/skills/prototype-first

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Prototyp zuerst?

Ich bin Designer. Ich beurteile Arbeit, indem ich sie ansehe und durchklicke, nicht indem ich einen Plan lese. Ein Prototyp kostet Minuten. Das Falsche zu bauen kostet einen Stapel PRs und einen Tag Review.

Dieser Skill macht eines: Er holt vor dem Schreiben von Code eine Designentscheidung von mir ein. Er erstellt niemals einen PR für einen Prototyp, liefert nie einen Prototyp als Produkt aus und baut nie eine Richtung, die ich nicht ausgewählt habe.

Harte Regeln

  1. Erstelle niemals einen PR für einen Prototyp, nicht einmal einen Entwurf. PRs sind für Code, der auf main landen soll. Ein Prototyp-PR fügt Review- und CI-Rauschen für etwas hinzu, das weggeworfen wird.
  2. Halte nach jeder Runde an. Sende die Varianten im untenstehenden Format und warte dann auf meine Antwort. Beginne nicht mit dem Bauen der „wahrscheinlichsten Wahl“, während ich schaue. Wenn ich etwas anderes wähle, ist diese Arbeit Verschwendung und ich muss sie trotzdem reviewen.
  3. Der ausgewählte Prototyp ist die Spezifikation. Der Bau muss so aussehen wie er. Späteres Feedback ändert nur, was ich benannt habe. Ich vergleiche den Bau mit dem Bild, das ich ausgewählt habe, sodass jede Abweichung als Fehler und nicht als Verbesserung gelesen wird.
  4. Prototyp-Labels bleiben in Prototyp-Dateien. „B2“, „Richtung A“ und Varianten-Spitznamen erscheinen niemals in Code, Tokens, Commits, PRs oder Issues. Sie bedeuteten nur während der Auswahl etwas. Im Code-Repositorium sind sie Rauschen, das später jemand entschlüsseln muss.
  5. Betrachte Referenzen als Bilder. Wenn ich Referenzseiten oder -Apps nenne, betrachte Screenshots davon. Ein reiner Textabruf verliert jede visuelle Qualität, die die Referenz gut gemacht hat, und das Ergebnis wirkt generisch.

Sollte dies ein Prototyp sein?

Hat die Änderung eine offensichtliche Antwort (ein Abstandswert, ein Label, ein Farbtoken)?
├── Ja → Baue es und sag, was sich geändert hat. Das Überspringen des Prototyps ist ein gutes Ergebnis.
└── Nein
    ├── Neuer Screen, neuer Ablauf, Redesign oder 2+ sinnvolle Antworten?
    │   └── Ja → Prototyp.
    │       ├── Braucht echte Daten, echte Navigation oder natives Verhalten?
    │       │   └── Ja → Wegwerf-Branch `proto/<thema>` von main abgezweigt
    │       └── Nein → Eigenständige HTML-Datei, geteilt im Chat oder Issue-Thread
    └── Unsicher → Frage in einer Zeile: „Prototyp dafür oder gleich bauen?"

Verstecke niemals einen Prototyp innerhalb des Produkts hinter einer /lab-Route oder einem Dev-Flag.

Arbeitsablauf

Phase 1: Referenzen und Fragen

  1. Sammle Screenshots von jeder Referenz, die ich genannt habe. Schneide lange Seiten in Abschnitte.
  2. Schreibe konkrete Beobachtungen für jede auf: den Typ, die Überschriftenbehandlung, wie das Produkt gezeigt wird, wie das Layout strukturiert ist und der eine Moment, der heraussticht. Sag, warum jede funktioniert.
  3. Hinterfrage die Anfrage. Wenn das, worum ich gebeten habe, schwache UX ist, sag es und sag warum. Denke von der Seite des Endbenutzers, nicht von der wörtlichen Reparatur, die ich beschrieben habe.
  4. Stelle mir ein paar kurze, nummerierte Fragen zu dem, was du nicht ableiten kannst, z. B. Typ, Dichte, Ton und was von der aktuellen Version behalten werden soll.

Erledigt, wenn: jede Referenz schriftliche Beobachtungen hat und ich deine Fragen beantwortet habe oder du keine hattest.

Phase 2: Erstelle die Varianten

  • Zeige 2 bis 4 Varianten, benannt mit A, B, C und D. Eine Variante lehrt mich nichts über meinen Geschmack. Mehr als vier ist Rauschen.
  • Mindestens eine Variante ist deine eigene bessere Idee, wenn du in Phase 1 widersprochen hast. Setze sie neben die, um die ich gebeten habe.
  • Mache Mockups im Kontext. Zeige das ganze Fenster oder den ganzen Abschnitt, nicht eine Komponente, die auf einer leeren Seite schwebt.
  • Verwende das echte Design. Verwende die aktuellen Tokens, Typografie und Komponenten der App. Zeige Hell und Dunkel, wenn die App beides hat.
  • Verwende realistische Daten. Real aussehende Namen, Zahlen und Textlängen. Niemals Lorem Ipsum und niemals Daten von echten Menschen oder Orten.
  • Mache Abläufe klickbar. Baue für alles mit Schritten oder Zuständen eine HTML-Datei mit einem Szenario-Umschalter, einem Hell/Dunkel-Umschalter, funktionierenden Interaktionen und einer Klartext-Notiz darüber, was jeder Zustand bedeutet.
  • Passe den Detailgrad der Frage an. Für eine visuelle Richtung sieht es wie das fertige Produkt aus, weil das Aussehen das ist, was ich beurteile. Für einen Ablauf sieht es aus wie die App und funktioniert, und der Feinschliff kann warten, weil ich beurteile, ob ich mich verliere.

Erledigt, wenn: jede Variante im Kontext mit echten Tokens und realistischen Daten gemockt ist und jeder Ablauf klickbar ist.

Phase 3: Sende die Runde und halte an

Sende die Runde im Format unter „Erforderliches Ausgabeformat“. Halte dann an.

Erledigt, wenn: die Runde gesendet ist. Es passiert nichts weiter, bis ich antworte.

Phase 4: Lies meine Auswahl

Ich sageEs bedeutetDu tust
„C“Baue C wie gezeigtGehe zu Phase 5
„D, aber 1,5px nicht 3px“D mit genau dieser ÄnderungÄndere nur das, dann Phase 5
„A's Buttons, C's Suchleiste“Eine MischungNimm jedes benannte Teil von der Variante, von der ich es genannt habe. Das Teil, das mir am besten gefällt, dominiert. Treibe nicht in Richtung der Variante, die einfacher zu bauen war.
„Mir gefällt B, aber ich möchte es testen“Eine vorläufige WahlBaue B und behalte den Zweitplatzierten, bis ich B in der echten App oder auf dem Gerät ausprobiert habe
Feedback zu einer VarianteIteriereZeige die nächste Runde nur dieser Variante, zurück zu Phase 3
„Ich verstehe diesen Prototyp nicht“Hör auf zu prototypenBaue das Echte in einem PR
„Keine davon“Du hast meine Absicht verfehltGehe zurück zu den Referenzen und meinen Worten. Mache keine vierte Version derselben Idee.

Frage nach dem Warum, wenn ich es nicht sage. Wenn ich wähle, ohne einen Grund zu nennen, frage eine kurze Frage: „Was hat B gewinnen lassen?" Notiere meine Antwort zusammen mit der Entscheidung. Eine Wahl ohne ihren Grund lehrt den nächsten Agenten nichts über meinen Geschmack.

Erledigt, wenn: du weißt, welche Variante oder welche Mischung von Teilen zu bauen ist und warum.

Phase 5: Baue auf Basis der Auswahl

  • Weise denjenigen, der baut, kurz mit dem Prototyp-Link und den genauen Werten ein: Farben, Größen, Abstände und Typografie. Niemand baut aus dem Gedächtnis nach.
  • Beschreibe das Design durch das, was es ist („dichte Tabelle, Status-Pills, linke Leiste“), niemals durch sein Label.
  • Wende späteres allgemeines Feedback („zu voll“, „keine Hierarchie“) nur dort an, wo ich darauf hingewiesen habe. Es ist keine Erlaubnis, Dinge zu entfernen, die mir im Prototyp gefallen haben. Bevor du ein Prototyp-Element entfernst oder änderst, benenne es und frage.

Erledigt, wenn: der Bau der Auswahl entspricht und kein Prototyp-Label im Code, in Commits, PRs oder Issues erscheint.

Erforderliches Ausgabeformat

Jede Runde sieht so aus:

**Wo zu sehen:** <Link oder Anhang> oder `git checkout proto/<thema> && <Ausführungsbefehl>`

| Variante | Wetten auf | Kompromiss |
| --- | --- | --- |
| A | <eine Zeile: die Idee, die diese Variante testet> | <was sie aufgibt> |
| B | ... | ... |

**Wogegen ich Einspruch erhoben habe:** <ein oder zwei Zeilen oder „nichts“>

Antworte mit einem Buchstaben, einer Mischung (`A's x, C's y`) oder `keine`.

Halte dich daran. Der Prototyp erklärt.

Aufrufvarianten

AufrufVerhalten
/prototype-firstVollständiger Arbeitsablauf ab Phase 1, stoppt nach Phase 3
/prototype-first <variante>Iteriere mit einer Variante aus der letzten Runde, zurück zu Phase 3
/prototype-first compareEin Prototyp mit einem AKTUELL / VORGESCHLAGEN-Umschalter gegen die aktuelle UI

Verwandte Skills