Que fait app-design-studio ?
Objectif : à partir d'un nom d'application, produire un dépôt de conception qui est à la fois beau et utilisable, cohérent sur tous les écrans, et prêt à être confié à un designer, à un agent qui construit en Compose/Flutter/React Native, ou au pont Compose-to-Figma.
Pourquoi ce skill existe : les modèles d'image dessinent des écrans attrayants individuellement mais dérivent entre les écrans, oublient les états et brisent discrètement l'utilisabilité (texte minuscule, faible contraste, petites cibles tactiles). Solution : verrouiller d'abord un système de design, générer à partir de celui-ci, puis vérifier ce qui peut être mesuré avec des scripts et ce qui ne peut pas l'être (le goût) avec une rubrique plus un choix humain.
Cible = profil (décider en PREMIER, à S0 ; ne jamais choisir silencieusement par défaut quand l'utilisateur a dit site web/portail/tableau de bord)
| Cible | Orientation / tailles | Lire ceux-ci (et UNIQUEMENT ceux-ci pour le vocabulaire de la cible) |
|---|---|---|
mobile (app) | portrait 9:19.5 écrans, une taille | screen-taxonomy.md, blocs mobile de design-bible-template.md et prompt-templates/README.md, seuils en dp/sp |
web type site (site web, page d'atterrissage, boutique, blog) | paysage desktop 16:10 (1440x900) pages, plus une mise en page responsive étroite de 390px de la même page | web-design.md, prompt-templates/web.md, bloc web de design-bible-template.md, seuils en px |
web type app (portail, tableau de bord, admin, SaaS) | paysage desktop d'abord ; mise en page étroite ensuite. Uniquement si l'utilisateur dit que les téléphones sont le périphérique principal, définir "mobile_first": true et rendre la mise en page étroite principale | identique à site |
both | une bible et des tokens partagés, deux profils | les deux ensembles, jamais mélangés dans un seul prompt |
| Définissez `"platform": "mobile" | "web"dansinventory.json`. Un prompt est écrit exactement avec le vocabulaire d'un seul profil. |
Hygiène des mots-clés (la raison d'être de cette section) : les modèles d'image obéissent aux mots qu'on leur donne. Un prompt de site web qui dit « portrait », « téléphone », « barre d'état », « 9:19.5 », « navigation en bas », « zone de pouce », « Android/iOS » ou « écran d'application » revient comme un écran de téléphone. Les prompts web disent « page de site web », « paysage desktop 16:10, 1440 de large », « en-tête avec liens », « barre latérale », « sans navigateur ». La mise en page étroite est appelée « mise en page responsive étroite, 390px de large », jamais « écran de téléphone ». python scripts/prompt_lint.py <design-dir> échoue tout prompt dans prompts/ qui utilise les mots d'un autre profil ; exécutez-le avant d'envoyer un lot.
Règles de sortie (toujours)
- L'image est l'interface utilisateur elle-même, bord à bord : pas de cadre d'appareil, pas de maquette de téléphone/ordinateur portable, pas de chrome de navigateur, pas d'arrière-plan supplémentaire, pas de toile autour. (Cadres de présentation uniquement si l'utilisateur demande des planches.) Mobile : écrans portrait. Web : pages desktop paysage et, le cas échéant, la mise en page étroite ; pages longues en une seule image haute ou 2-3 images de section de la même largeur.
- Les exemples dans ce skill sont des illustrations d'un modèle, jamais du contenu : ne copiez pas leurs noms, copies, palettes, polices ou mises en page dans un prompt (garde de biais dans
references/design-craft.md). - Haute fidélité : vrai texte, vraies icônes, vraies images. Pas de lorem ipsum, pas de noms de marque fictifs.
- Un seul système de design sur l'ensemble. Ne jamais inventer un nouveau style par écran.
- Deux modes de prompt (
references/design-craft.md) : brief (intention courte + les quelques faits qui comptent + l'ambiance ; par défaut pour les premiers rendus et les directions S2, donne le résultat le plus distinctif) et verrouillé (chaînes exactes, décomptes, bloc de bible ; pour les frères après le choix et pour les corrections). Faire un rendu brief d'abord, regarder, puis verrouiller ce qui doit correspondre. Les modèles échouent bien plus sur la cohérence que sur la beauté, mais trop contraindre le premier rendu le rend mécanique. - Éditer, ne pas refaire : corriger une chaîne erronée avec un passage d'édition ne nommant que ce changement ; un refaire complet jette tout ce qui a déjà été approuvé.
- Pas de vraies marques, logos ou visages de vraies personnes ; uniquement des noms fictifs et des marques génériques. Ne jamais écrire de clés API dans le dépôt.
- Répondre à l'utilisateur dans la langue dans laquelle il écrit (souvent Roman Urdu/Hinglish) ; les fichiers et les prompts restent en anglais.
Workflow (S0-S9)
Travailler dans le dossier projet de l'utilisateur sous design/<app-slug>/ (disposition : references/repo-layout.md). Suivre l'état de la phase dans design/<app-slug>/STATUS.md. Ne demander à l'utilisateur que lorsque la réponse change le résultat (max 3 questions à S0) ; sinon, choisir une valeur par défaut raisonnable et le dire.
S0 Accueil. Nom de l'application/site, objectif en une ligne, public, cible + type (tableau ci-dessus ; demander si les mots « site web », « portail », « tableau de bord » ou « page d'atterrissage » apparaissent et que la cible n'est pas claire), ressenti de la plateforme (mobile par défaut : Android + iOS neutre, Material 3 penchant ; web : neutre), mots d'ambiance, clair/sombre (par défaut : tokens clair + sombre, écrans en clair). Écrire BRIEF.md (problème, public, périmètre, non-objectifs) ; si l'utilisateur n'est pas disponible, indiquer la lecture que vous avez faite en haut au lieu d'attendre. Lire references/aesthetic-vs-usability.md une fois.
S1 Inventaire d'écrans. Construire inventory.json à partir de references/screen-taxonomy.md (web : references/web-design.md section 4) : cœur fixe (splash, langue, onboarding, autorisations, authentification, accueil, paramètres) + écrans de fonctionnalités spécifiques à cette application + détails + états + dialogues + feuilles + composants. Chaque élément a un id, groupe, objectif, états, priorité. Montrer une liste compacte à l'utilisateur ; confirmer avant d'utiliser des crédits d'image.
S2 Plan de conception + bible + 3 directions (porte humaine). D'abord écrire un plan de conception de 10 lignes par direction (references/design-craft.md section 2) et l'auto-revoir par rapport aux valeurs par défaut génériques. Ensuite écrire la bible (references/design-bible-template.md) en trois brèves alternatives (ambiance différente, logique de palette, police, langage des formes). Chaque bible nomme la couleur du texte sur chaque couleur remplie (sur-primaire, sur-accent, texte de badge) et la barre d'état de la plateforme (Android : heure à gauche, icônes à droite ; iOS : style 9:41). Avant de faire un rendu, mettre la palette de chaque direction dans un petit fichier de tokens et exécuter scripts/contrast_check.py dessus : une direction qui n'a l'air bien qu'avec un contraste insuffisant ne doit pas atteindre le choix humain. Écrire chaque prompt dans prompts/<id>.<direction>.md d'abord et envoyer exactement le texte de ce fichier (le prompt sauvegardé est celui reproductible). Faire le rendu d'un écran héros par direction (web : la même page, desktop et mobile). Grouper les trois en un même appel Codex. S'arrêter et laisser l'utilisateur choisir – le goût est la seule chose que les scripts ne peuvent pas juger, c'est donc là que l'humain décide. Enregistrer le choix dans DESIGN.md.
S3 Tokens. À partir de la direction choisie, écrire tokens.json (couleurs clair/sombre, échelle de police, grille d'espacement 4/8, rayon, élévation, taille d'icône, cible tactile). Exécuter scripts/contrast_check.py tokens.json et corriger les paires défaillantes maintenant – moins coûteux que de corriger 40 écrans plus tard.
S4 Planche de composants. Générer la fiche des composants (boutons, champs de saisie, chips, cartes, lignes de liste, navigation, barre supérieure, toasts, dialogues, feuilles) à partir des tokens. Cette image est la référence visuelle passée à chaque génération ultérieure, ce qui maintient la cohérence des écrans.
S5 Écrans. Générer les écrans dans l'ordre de l'inventaire en utilisant references/prompt-templates/. Chaque prompt commence par le bloc verrouillé de la bible, puis les chaînes et décomptes exacts, puis une liste explicite « ne pas ajouter ». Choisir le moteur selon le travail : un modèle capable de texte (gpt-image/Codex, Nano Banana, Stitch) pour les écrans entiers, ou la route de rendu HTML (texte et décomptes exacts, puis capture d'écran ; testé de bout en bout sur un ensemble de 21 écrans de lecteur PDF : écrire html/<group>/<id>.html à partir des variables CSS de tokens.json et des icônes Iconify, puis node scripts/render_screens.mjs <design-dir> écrit le PNG plus un <id>.spec.json mesuré à partir du DOM réel, et run_gates.py l'audite ; nécessite Node + playwright, env PLAYWRIGHT_MODULE/CHROME_PATH si non installé localement) – FLUX/Runware déforme le texte et les décomptes de l'interface utilisateur, donc l'utiliser uniquement pour l'art qui se trouve à l'intérieur d'un écran. Utiliser Iconify MCP pour les icônes afin que le style d'icône reste d'une seule famille. Passer la planche de composants comme référence de style lorsque l'outil le permet. Enregistrer sous screens/<group>/<id>.png plus <id>.spec.json (éléments avec taille, taille de police, couleurs, indicateur interactif – schéma dans references/repo-layout.md).
S6 États, dialogues, feuilles. Mêmes prompts, même bible. Les états vides guident l'action suivante ; l'erreur est visuellement différente du vide ; le chargement utilise des squelettes qui correspondent à la mise en page réelle.
S7 Auto-critique, verdicts et journal des prompts. Critiquer chaque rendu vous-même avant de le montrer (references/critique-template.md : utilisabilité réussi/échoué avec preuves + rubrique esthétique, écrit dans reports/critique/<id>.md) ; en dessous de 4.0 ou tout ÉCHEC d'utilisabilité signifie corriger par un passage d'édition ou rejeter et régénérer, sans attendre l'utilisateur. Après avoir regardé CHAQUE image générée, écrire un verdict (accepter / corriger / rejeter) et le journaliser : python scripts/prompt_log.py add <design-dir> --id ... --image ... --prompt ... --mode brief|locked|edit --verdict ... --tags ... --reason ... ; les images rejetées sont déplacées vers rejected/. prompt_log.py summary montre le taux d'acceptation par mode de prompt et les tags de défaillance récurrents ; tout tag rejeté deux fois devient une ligne dans references/design-craft.md « Leçons apprises » (c'est ainsi que le skill s'améliore). Ensuite exécuter python scripts/run_gates.py design/<app-slug>. Il exécute le contraste, la vérification des tokens, l'audit des éléments (cibles tactiles, taille de texte minimale) et la couverture des états, et écrit reports/gates.md. Ensuite noter chaque écran avec la rubrique dans references/aesthetic-vs-usability.md (ouvrir le PNG et regarder – ne pas noter de mémoire). Régénérer les écrans défaillants, max 2 tentatives chacun ; si toujours en échec, le signaler à l'utilisateur plutôt que de boucler.
S8 Export. Assembler le dépôt (references/repo-layout.md) : PNG, spécifications, tokens, DESIGN.md, inventaire, plan de flux, copy/strings.json, rapports. Extras optionnels, uniquement quand l'utilisateur les veut : (a) couche de vérité HTML pour les valeurs CSS exactes (references/image-qa-loop.md), (b) stocker les actifs – icône, graphique de fonctionnalité, captures d'écran de boutique avec titres rendus en HTML, validés par scripts/validate_assets.py contre references/store-asset-specs.md. Pour les captures d'écran de boutique marketing (ensembles dirigés par titres comme les applications les mieux classées), utiliser le skill store-screenshots avec ces écrans en entrée. Remise facultative : les tokens/spécifications alimentent le code Compose + le pont Figma ; le dire dans HANDOFF.md.
S9 Revue humaine. Présenter la planche contact et le rapport de portes. Tout ce qui est généré avant que la véritable application n'existe est étiqueté concept (ne jamais présenter des graphiques conceptuels de boutique comme de véritables captures).
Guide de jugement (esthétique vs utilisabilité)
Les seuils dépendent de la cible : mobile = nombres dp/sp ci-dessous ; web = seuils px dans references/web-design.md section 3 (zone de frappe 44px, corps >= 16px, lignes 65ch, pas de défilement horizontal à 390). Traiter l'utilisabilité comme un plancher et l'esthétique comme un plafond. Les nombres de plancher sont non négociables car mesurables : cibles tactiles >= 48dp (44pt iOS), texte du corps >= 16sp et rien en dessous de 12sp, contraste 4.5:1 (3:1 pour les grands textes et icônes), une action principale par écran, actions clés dans la zone inférieure du pouce, grille d'espacement 4/8. Au-dessus du plancher, dépenser de la personnalité : un appariement de polices distinctif, un accent contrôlé, un moment d'illustration ou d'image mémorable par flux, un espacement généreux. Quand ils entrent en conflit (ex. une étiquette élégante gris pâle), l'utilisabilité gagne et vous récupérez l'élégance ailleurs (poids, espacement, contraste de taille), pas en abaissant le plancher.
À éviter (« signes distinctifs de l'IA »)
Lire references/design-craft.md, references/interaction-and-density.md et references/ai-tells-avoid.md avant d'écrire le premier prompt (les briefs indiquent la cible de densité : peu de mots, espace généreux, une action primaire). La version courte : dégradés violet-bleu, cartes en verre sans raison, imbrication boîte-dans-boîte, spam de faux graphiques, écrans d'accueil à douze widgets, mélanges d'icônes génériques, minuscules étiquettes décoratives, lorem ipsum, écrans clonés avec de petites modifications.
Carte de référence
references/screen-taxonomy.md– quels écrans/états/dialogues/feuilles existent et quand (cible MOBILE uniquement).references/web-design.md– cible site web / application web : fenêtres d'affichage, seuils px, taxonomie des pages, mise en page, signes distinctifs de l'IA web.references/prompt-templates/web.md– blocs FORMAT/CONTENU web et prompts par type de page.references/aesthetic-vs-usability.md– curseurs, planchers, rubrique, règles de régénération.references/design-bible-template.md– le bloc répété dans chaque prompt.references/prompt-templates/– prompts par type d'écran.references/design-craft.md– prompts brefs vs verrouillés, plan de conception, valeurs par défaut génériques, audace en un seul endroit, règles de copie, boucle de critique.references/ai-tells-avoid.md– anti-modèles.references/repo-layout.md– disposition des dossiers et schémas JSON.references/image-qa-loop.md– la boucle de vérification/édition par image, couche de vérité HTML optionnelle, strings.json.references/store-asset-specs.md– tailles et règles du Play/App Store (revérifier les pages officielles avant de soumettre).references/interaction-and-density.md– budget de mots/densité, divulgation progressive, état d'interaction visible, questions de révision (utiliser dans chaque brief et critique).references/critique-template.md– la boucle d'auto-critique et de correction par image.scripts/prompt_log.py– journal des verdicts + résumé des apprentissages (voir S7).assets/– exemple detokens.json,inventory.json,spec.json, squeletteDESIGN.md.scripts/– portes déterministes (Python)