Méthode · repris de LinkedIn

Les deux documents que personne n'écrit

Connecter un design system à une IA ne suffit pas : il reste deux documents que l'IA ne peut pas écrire à ta place, et ce sont des aveux.

Article · le fil se lit aussi sur LinkedIn

UI Collective vient de sortir une vidéo sur les design systems face à l'IA, et elle explique bien un problème que je rencontre souvent en mission : tu connectes ton design system à une IA, elle voit tes composants et tes variables, mais elle ne sait pas lequel utiliser dans quel cas. Alors elle devine.

Une liste sans mode d'emploi

Ce que ça donne, tout le monde l'a vu : elle prend trois variables sur trente, elle écrase la couleur d'un bouton avec un dégradé sorti de nulle part, elle ignore la moitié de tes styles de texte. On se dit que l'IA n'est pas prête. En réalité, elle a reçu une liste sans mode d'emploi.

La méthode proposée dans la vidéo est simple : tu découpes ton design system en groupes (les composants de formulaire, la navigation, l'affichage de données) et tu écris une fiche par groupe qui explique quoi utiliser quand.

Les deux documents que l'IA ne peut pas écrire à ta place

Là où la vidéo devient vraiment intéressante, c'est qu'il reste deux documents qu'aucune IA ne peut produire, parce que leur matière n'existe nulle part ailleurs que dans la tête de l'équipe.

Le premier liste les défauts que l'équipe connaît et ne corrigera pas, ceux dont la réparation ne se trouve pas dans le design system. Ta couleur de marque ne passe pas le contraste en texte sur fond blanc. Ce n'est pas un token à changer, c'est plusieurs fichiers à mettre à jour. Tant que cet arbitrage n'est écrit nulle part, chaque audit lancé avec une IA le remonte, et l'équipe repasse du temps à réexpliquer une décision déjà rendue.

Le second liste ce que personne n'écrit parce que tout le monde le sait. Trois composants de carte qui se ressemblent, un seul est autorisé sur le dashboard. Un tableau qui bascule en liste sous une certaine largeur, sauf sur une page précise. L'IA prend le composant dont le nom lui parle. Un designer qui arrive fait exactement pareil, sauf qu'on finit par le lui dire en revue.

Des aveux, et les deux premières pages qui manquent

Ces deux documents sont des aveux, et c'est précisément pour ça qu'ils ne sont jamais écrits : personne n'aime documenter ses compromis. Ils devraient pourtant être les deux premières pages de votre documentation, parce que ce sont les deux seules que ni une IA ni un nouveau designer ne peuvent deviner.

La discussion continue sur LinkedIn