Was macht app-design-studio?
Ziel: Aus einem einzigen App-Namen ein Design-Repository erstellen, das gleichzeitig schön und benutzbar ist, über alle Bildschirme hinweg konsistent und bereit, es einem Designer, einem Agenten für Compose/Flutter/React Native oder der Compose-to-Figma-Bridge zu übergeben.
Warum diese Skill existiert: Bildmodelle zeichnen attraktive Einzelbildschirme, aber sie driften zwischen Bildschirmen, vergessen Zustände und brechen leise die Benutzbarkeit (winziger Text, geringer Kontrast, kleine Antippziele). Lösung: Zuerst ein Designsystem festlegen, daraus generieren und dann mit Skripten prüfen, was messbar ist, und mit einer Bewertungsmatrix plus menschlicher Auswahl, was nicht (Geschmack).
Ziel = Profil (zuerst in S0 entscheiden; niemals stillschweigend standardmäßig, wenn der Benutzer Website/Portal/Dashboard sagt)
| Ziel | Ausrichtung / Größen | Diese (und NUR diese) Profil-Wörter lesen |
|---|---|---|
mobile (App) | Hochformat 9:19,5 Bildschirme, eine Größe | screen-taxonomy.md, mobile Blöcke von design-bible-template.md und prompt-templates/README.md, Untergrenzen in dp/sp |
web Art site (Website, Landing, Store, Blog) | Querformat Desktop 16:10 (1440x900) Seiten, plus ein schmales 390px Responsive-Layout derselben Seite | web-design.md, prompt-templates/web.md, Web-Block von design-bible-template.md, Untergrenzen in px |
web Art app (Portal, Dashboard, Admin, SaaS) | Querformat Desktop zuerst; schmales Layout als zweites. Nur wenn der Benutzer sagt, dass Telefone das Hauptgerät sind, setze "mobile_first": true und mache das schmale Layout primär | wie site |
both | gemeinsame Bibel und Tokens, zwei Profile | beide Sets, niemals innerhalb eines Prompts gemischt |
| Setze `"platform": "mobile" | "web"ininventory.json`. Ein Prompt wird mit genau dem Wortschatz eines Profils geschrieben. |
Schlüsselwort-Hygiene (der Grund, warum dieser Abschnitt existiert): Bildmodelle gehorchen den Wörtern, die sie bekommen. Ein Website-Prompt mit „Hochformat”, „Telefon”, „Statusleiste”, „9:19,5”, „Bottom Navigation”, „Daumenzone”, „Android/iOS” oder „App-Bildschirm” liefert einen Telefonbildschirm. Web-Prompts sagen „Website-Seite”, „Querformat Desktop 16:10, 1440 breit”, „Kopfzeile mit Links”, „Seitenleiste”, „browserlos”. Das schmale Layout heißt „schmales Responsive-Layout, 390px breit”, niemals „Telefonbildschirm”. python scripts/prompt_lint.py <design-verz> schlägt fehl bei jedem Prompt in prompts/, der Wörter eines anderen Profils verwendet; führe es aus, bevor du einen Batch sendest.
Ausgaberegeln (immer)
- Das Bild ist die Benutzeroberfläche selbst, randlos: kein Geräterahmen, kein Telefon/Laptop-Mockup, kein Browser-Chrome, kein zusätzlicher Hintergrund, keine Leinwand darum. (Präsentationsrahmen nur, wenn der Benutzer Boards möchte.) Mobil: Hochformatbildschirme. Web: Querformat Desktop-Seiten und, wo aufgeführt, das schmale Layout; lange Seiten als ein hohes Einzelbild oder 2-3 Abschnittsbilder mit derselben Breite.
- Beispiele in dieser Skill sind Illustrationen eines Musters, niemals Inhalt: Kopiere nicht ihre Namen, Kopie, Paletten, Schriftarten oder Layouts in einen Prompt (Voreingenommenheitsschutz in
references/design-craft.md). - Hohe Wiedergabetreue: echte Kopie, echte Symbole, echte Bilder. Kein Lorem Ipsum, keine Platzhalter-Markennamen.
- Ein Designsystem für das gesamte Set. Erfinde niemals einen neuen Stil pro Bildschirm.
- Zwei Prompt-Modi (
references/design-craft.md): kurz (kurze Absicht + die wenigen Fakten, die zählen + das Gefühl; Standard für erste Render und S2-Richtungen, ergibt das unverwechselbarste Ergebnis) und fest (exakte Zeichenfolgen, Anzahlen, Bibelblock; für Geschwister nach der Auswahl und für Korrekturen). Rendere zuerst kurz, schau hin, lege dann fest, was übereinstimmen muss. Modelle scheitern weitaus häufiger an Konsistenz als an Schönheit, aber eine Überlastung des ersten Renders macht es mechanisch. - Bearbeiten, nicht neu würfeln: Korrigiere eine falsche Zeichenfolge mit einem Bearbeitungsdurchgang, der nur diese Änderung nennt; ein vollständiges Neu-Rendern verwirft alles bereits Genehmigte.
- Keine echten Marken, Logos oder Gesichter realer Personen; nur fiktive Namen und generische Zeichen. Schreibe niemals API-Schlüssel in das Repository.
- Antworte dem Benutzer in der Sprache, in der er schreibt (oft Roman Urdu/Hinglish); Dateien und Prompts bleiben auf Englisch.
Workflow (S0-S9)
Arbeite im Projektordner des Benutzers unter design/<app-slug>/ (Layout: references/repo-layout.md). Verfolge den Phasenstatus in design/<app-slug>/STATUS.md. Frage den Benutzer nur, wenn die Antwort das Ergebnis ändert (maximal 3 Fragen in S0); wähle ansonsten eine sinnvolle Standardeinstellung und teile dies mit.
S0 Aufnahme. App-/Seitenname, einzeiliger Zweck, Zielgruppe, Ziel + Art (Tabelle oben; frage nach, wenn die Wörter „Website”, „Portal”, „Dashboard” oder „Landing” erscheinen und das Ziel unklar ist), Plattform-Gefühl (Mobilstandard: Android + iOS neutral, Material 3 tendenziell; Web: neutral), Tonwörter, hell/dunkel (Standard: helle + dunkle Tokens, Bildschirme in hell). Schreibe BRIEF.md (Problem, Zielgruppe, Umfang, Nicht-Ziele); wenn der Benutzer nicht verfügbar ist, gib stattdessen die von dir getroffene Interpretation oben an, anstatt zu warten. Lese references/aesthetic-vs-usability.md einmal.
S1 Bildschirm-Inventar. Erstelle inventory.json aus references/screen-taxonomy.md (Web: references/web-design.md Abschnitt 4): fester Kern (Splash, Sprache, Onboarding, Berechtigungen, Authentifizierung, Startseite, Einstellungen) + für diese App spezifische Funktionsbildschirme + Details + Zustände + Dialoge + Sheets + Komponenten. Jeder Eintrag hat ID, Gruppe, Zweck, Zustände, Priorität. Zeige dem Benutzer eine kompakte Liste; bestätige vor dem Ausgeben von Bildcredits.
S2 Designplan + Bibel + 3 Richtungen (menschliches Tor). Schreibe zuerst einen 10-zeiligen Designplan pro Richtung (references/design-craft.md Abschnitt 2) und überprüfe ihn selbst gegen die generischen Standardeinstellungen. Schreibe dann die Bibel (references/design-bible-template.md) als drei kurze Alternativen (unterschiedliche Stimmung, Palettenlogik, Schriftart, Formsprache). Jede Bibel nennt die Textfarbe auf jeder gefüllten Farbe (on-primary, on-accent, Badge-Text) und die Statusleiste der Plattform (Android: Zeit links, Symbole rechts; iOS: 9:41-Stil). Bevor du renderst, lege die Palette jeder Richtung in eine kleine Token-Datei und führe scripts/contrast_check.py darauf aus: Eine Richtung, die nur mit nicht bestandenem Kontrast gut aussieht, darf nicht zur menschlichen Auswahl gelangen. Schreibe jeden Prompt in prompts/<id>.<richtung>.md und sende genau den Text dieser Datei (der gespeicherte Prompt ist der reproduzierbare). Rendere einen Heldenbildschirm pro Richtung (Web: dieselbe Seite, Desktop und Mobil). Verarbeite alle drei in einem Codex-Aufruf. Stoppe und lasse den Benutzer wählen – Geschmack ist die eine Sache, die Skripte nicht beurteilen können, also hier entscheidet der Mensch. Zeichne die Wahl in DESIGN.md auf.
S3 Tokens. Schreibe aus der gewählten Richtung tokens.json (Farben hell/dunkel, Schriftgrößenskala, Abstand 4/8-Raster, Radius, Elevation, Symbolgröße, Touch-Ziel). Führe scripts/contrast_check.py tokens.json aus und korrigiere fehlschlagende Paare jetzt – billiger als 40 Bildschirme später zu korrigieren.
S4 Komponenten-Board. Generiere das Komponentenblatt (Schaltflächen, Eingabefelder, Chips, Karten, Listenzeilen, Navigation, obere Leiste, Toasts, Dialoge, Sheets) aus den Tokens. Dieses Bild ist die visuelle Referenz, die an jede spätere Generierung weitergegeben wird, was Bildschirme konsistent hält.
S5 Bildschirme. Generiere Bildschirme in der Inventarreihenfolge mit den references/prompt-templates/. Jeder Prompt beginnt mit dem gesperrten Bibelblock, dann exakte Zeichenfolgen und Anzahlen, dann eine explizite „nicht hinzufügen”-Liste. Wähle die Engine nach Aufgabe: Ein textfähiges Modell (gpt-image/Codex, Nano Banana, Stitch) für ganze Bildschirme, oder die HTML-Render-Route (exakter Text und Anzahlen, dann Screenshot; getestet Ende-zu-Ende an einem 21-Bildschirm-PDF-Reader-Set: schreibe html/<gruppe>/<id>.html aus tokens.json CSS-Variablen und Iconify-Symbolen, dann node scripts/render_screens.mjs <design-verz> schreibt das PNG plus eine gemessene <id>.spec.json aus dem echten DOM, und run_gates.py prüft es; benötigt Node + Playwright, env PLAYWRIGHT_MODULE/CHROME_PATH, wenn nicht lokal installiert) – FLUX/Runware verstümmelt UI-Text und Anzahlen, verwende es daher nur für Kunst, die innerhalb eines Bildschirms sitzt. Verwende Iconify MCP für Symbole, damit der Symbolstil eine Familie bleibt. Übergib das Komponentenboard als Stilreferenz, wenn das Werkzeug dies unterstützt. Speichere als screens/<gruppe>/<id>.png plus <id>.spec.json (Elemente mit Größe, Schriftgröße, Farben, interaktivem Flag – Schema in references/repo-layout.md).
S6 Zustände, Dialoge, Sheets. Gleiche Prompts, gleiche Bibel. Leere Zustände leiten die nächste Aktion; Fehler ist visuell anders als leer; Laden verwendet Skelette, die dem echten Layout entsprechen.
S7 Selbstkritik, Urteile und das Prompt-Protokoll. Kritisiere jedes Rendern selbst, bevor du es zeigst (references/critique-template.md: Usability bestanden/nicht bestanden mit Belegen + Ästhetik-Bewertungsmatrix, geschrieben in reports/critique/<id>.md); unter 4.0 oder jedes Usability-FEHL bedeutet Korrektur durch Bearbeitungsdurchgang oder Ablehnen und Neugenerieren, ohne auf den Benutzer zu warten. Nachdem du JEDES generierte Bild angesehen hast, schreibe ein Urteil (akzeptieren / korrigieren / ablehnen) und protokolliere es: python scripts/prompt_log.py add <design-verz> --id ... --image ... --prompt ... --mode brief|locked|edit --verdict ... --tags ... --reason ...; abgelehnte Bilder verschieben sich nach rejected/. prompt_log.py summary zeigt die Akzeptanzrate pro Prompt-Modus und wiederkehrende Fehler-Tags; jedes Tag, das zweimal abgelehnt wurde, wird zu einer Zeile in references/design-craft.md „Gelernte Lektionen” (so verbessert sich die Skill). Führe dann python scripts/run_gates.py design/<app-slug> aus. Es prüft Kontrast, Token-Lint, Element-Audit (Touch-Ziele, minimale Textgröße) und Zustandsabdeckung und schreibt reports/gates.md. Bewerte dann jeden Bildschirm mit der Bewertungsmatrix in references/aesthetic-vs-usability.md (öffne das PNG und schau hin – bewerte nicht aus dem Gedächtnis). Generiere fehlschlagende Bildschirme neu, maximal 2 Versuche pro Bildschirm; wenn immer noch fehlschlagend, markiere es für den Benutzer, anstatt in einer Schleife zu verharren.
S8 Export. Stelle das Repository zusammen (references/repo-layout.md): PNGs, Spezifikationen, Tokens, DESIGN.md, Inventar, Ablaufplan, copy/strings.json, Berichte. Optionale Extras, nur wenn der Benutzer sie wünscht: (a) HTML-Wahrheitsschicht für exakte CSS-Werte (references/image-qa-loop.md), (b) Store-Assets – Symbol, Feature-Grafik, Store-Screenshots mit Überschriften, die als HTML-Text gerendert werden, validiert durch scripts/validate_assets.py gegen references/store-asset-specs.md. Für Marketing-Store-Screenshots (überschriftengeführte Sets wie Top-Chart-Apps) verwende die store-screenshots-Skill mit diesen Screens als Eingabe. Optionale Übergabe: Tokens/Spezifikationen speisen den Compose-Code + Figma-Bridge; sage dies in HANDOFF.md.
S9 Menschliche Überprüfung. Präsentiere das Kontaktblatt und den Gate-Bericht. Alles, was vor der Existenz der echten App generiert wurde, wird als concept gekennzeichnet (präsentiere niemals Konzept-Store-Grafiken als echte Aufnahmen).
Urteilsleitfaden (Ästhetik vs. Benutzbarkeit)
Untergrenzen hängen vom Ziel ab: Mobil = dp/sp-Zahlen unten; Web = px-Untergrenzen in references/web-design.md Abschnitt 3 (44px Trefferbereich, Körpertext >= 16px, 65ch-Zeilen, kein horizontaler Scroll bei 390). Behandle Benutzbarkeit als Boden und Ästhetik als Decke. Bodenzahlen sind nicht verhandelbar, weil sie messbar sind: Touch-Ziele >= 48dp (44pt iOS), Körpertext >= 16sp und nichts unter 12sp, Kontrast 4,5:1 (3:1 für großen Text und Symbole), eine primäre Aktion pro Bildschirm, Schlüsselaktionen in der unteren Daumenzone, 4/8-Abstandsraster. Oberhalb des Bodens gib Persönlichkeit aus: eine unverwechselbare Schriftartenkombination, ein kontrollierter Akzent, ein einprägsamer Illustrations- oder Bildmoment pro Ablauf, großzügiger Abstand. Wenn sie in Konflikt geraten (z. B. ein blassgraues elegantes Etikett), gewinnt die Benutzbarkeit und du holst die Eleganz woandershin zurück (Gewicht, Abstand, Größenkontrast), nicht indem du den Boden senkst.
Vermeiden („KI-Verlegenheiten”)
Lese references/design-craft.md, references/interaction-and-density.md und references/ai-tells-avoid.md, bevor du den ersten Prompt schreibst (Kurzbeschreibungen geben das Dichteziel an: wenige Wörter, großzügiger Raum, eine primäre Aktion). Die Kurzversion: Lila-Blau-Verläufe, Glaskarten ohne Grund, Kasten-in-Kasten-Verschachtelung, gefälschter Diagramm-Spam, Zwölf-Widget-Startseiten, gemischte generische Symbolpakete, winzige dekorative Etiketten, Lorem Ipsum, geklonte Bildschirme mit kleinen Bearbeitungen.
Referenzkarte
references/screen-taxonomy.md– welche Bildschirme/Zustände/Dialoge/Sheets es gibt und wann (nur MOBIL-Ziel).references/web-design.md– Website/Web-App-Ziel: Viewports, px-Untergrenzen, Seiten-Taxonomie, Layout, Web-KI-Verlegenheiten.references/prompt-templates/web.md– Web-FORMAT/INHALT-Blöcke und pro-Seitentyp-Prompts.references/aesthetic-vs-usability.md– Regler, Böden, Bewertungsmatrix, Regenerierungsregeln.references/design-bible-template.md– der Block, der in jedem Prompt wiederholt wird.references/prompt-templates/– pro Bildschirmtyp-Prompts.references/design-craft.md– Kurz- vs. Fest-Prompts, Designplan, generische Standardeinstellungen, Kühnheit an einer Stelle, Kopierregeln, Kritikschleife.references/ai-tells-avoid.md– Anti-Muster.references/repo-layout.md– Ordnerstruktur und JSON-Schemas.references/image-qa-loop.md– der pro-Bild-Verifizierungs-/Bearbeitungszyklus, optionale HTML-Wahrheitsschicht, strings.json.references/store-asset-specs.md– Play/App Store-Größen und -Regeln (überprüfe vor dem Einreichen die offiziellen Seiten erneut).references/interaction-and-density.md– Wort-/Dichtebudget, progressive Offenlegung, sichtbarer Interaktionszustand, Überprüfungsfragen (in jeder Kurzbeschreibung und Kritik verwenden).references/critique-template.md– die pro-Bild-Selbstkritik- und Korrekturschleife.scripts/prompt_log.py– Urteilsprotokoll + Erkenntniszusammenfassung (siehe S7).assets/– Beispiele fürtokens.json,inventory.json,spec.json,DESIGN.md-Grundgerüst.scripts/– deterministische Gates (Pyth…
[abgeschnitten für Übersetzung]