Que fait Conception Penpot ?
Penpot MCP uniquement — pas de HTML/CSS parallèle sauf si demandé. Lire high_level_overview une fois ; inspecter la page ciblée (shapeStructure, composants/tokens) avant toute écriture.
Demander d’abord
- Mode :
mockupoudesign? - Instructions : quoi construire/modifier. Alternatives multi-variantes uniquement si demandé.
- Plateforme : utiliser les règles du projet si définies ; sinon demander. Ne jamais supposer iOS/Android/web.
S’arrêter si l’un manque.
Modes
Mockup — validation basse-fidélité : structure, hiérarchie, flux ; remplissages simples, espacements réels ; pas de finition sauf si demandé.
Design — fidélité plus élevée : tokens, typographie, états, chrome. Mêmes règles de composants/flex. Préférer grouper → componentiser → affiner plutôt que reconstruire.
Règles
Composants : apparaît deux fois → composant/instance. Même fondation, état différent → variantes (Actif, État, Taille, …). Structure sur les masters ; surcharges sur les copies ; detach() pour dupliquer seulement. Noms : Toolbar/Button ; calques : fond, icône, libellé (stables entre variantes). Profondeur ≤ 4 ; pas de master dans un master.
Layout : flex/grille ; penpotUtils.addFlexLayout si des enfants existent. Espacement : échelle 8dp (4 demi-pas). Contrôles : material-alignment.md. Actif = variante/style, pas de décalage de layout. Ordre Z : fond → contenu → superpositions.
Arbre de construction : de l’extérieur vers l’intérieur uniquement — conteneur (vide + flex) → ses coquilles enfants directes (ordre Z) → récursion dans chaque élément enfant. Ne jamais envelopper des feuilles existantes. Détail : build-order.md.
Processus : bibliothèque : tokens → atomes → variantes. Puis assembler les écrans avec l’arbre de construction. Travail existant : grouper → createComponent → remplacer les doublons par des instances. Vérifier avec export_shape. Planifier avant les grandes réécritures.
API : penpot-api.md. Plongée en profondeur : dépôt research/penpot-design-practices.md.
Extensibilité
Si un retour pourrait devenir une règle générique pour Penpot (pas spécifique au projet), demander : « Ajouter ceci à penpot-design après avoir terminé ? »
- Oui : noter le libellé pendant la tâche ; une fois la tâche terminée, modifier
personal-skills/skills/penpot-design/; réinstaller :
puis confirmer ce qui a changé.npx skills add cucoreanu/personal-skills --skill penpot-design - Non : session uniquement. Ne jamais modifier la compétence en milieu de tâche sauf si l’utilisateur le demande maintenant.
Terminé
- Mode, instructions, plateforme (si nécessaire) confirmés
- Les doublons sont des composants ; les états sont des variantes
- Flex/grille + alignement des contrôles inspiré de Material
- Toile construite de l’extérieur vers l’intérieur (conteneur → coquilles enfants → éléments imbriqués)
- Mockup basse-fidélité / design haute-fidélité selon le mode ; export vérifié