Un DESIGN.md se trouve à côté du code et décrit le design souhaité en termes exploitables par un agent. Les agents de codage implémentent bien les interfaces, mais sans direction artistique, ils ont tendance à revenir à un style neutre par défaut. Google Labs publie désormais une spécification et un validateur DESIGN.md en version alpha. Le format est actif et utile, bien que la spécification avertisse encore qu'il peut changer.

Un DESIGN.md nécessite plus qu'une simple liste de couleurs. Les agents ont également besoin de directives sur la mise en page, l'espacement, le traitement des composants et les détails qui distinguent un design d'un autre. Un brief utile consacre la majeure partie de son contenu à ces décisions.

Un brief complet couvre l'ensemble du système, pas seulement les tokens. Le DESIGN.md généré par Identity Forge est organisé selon ces sections :

• Overview : ce qu'est le design, à qui il s'adresse et l'intention ressentie en une phrase ou deux.
• Colors : les tokens sémantiques sous forme de variables CSS prêtes à être collées dans globals.css, en mode clair et sombre. Explication des tokens de couleur sémantiques.
• Typography : l'association de polices, l'échelle, le lettrage et les graisses, ainsi qu'une configuration de police Next.js prête à l'emploi.
• Layout : la base d'espacement, la largeur du conteneur et les règles de composition.
• Elevation & Depth : le système d'ombres (ou son absence délibérée).
• Shapes : les rayons de bordure par élément (boutons, cartes, champs de saisie, badges) et le traitement des bordures.
• Components : comment les composants de base doivent être traités, avec un exemple.
• Page Structure & Layout : comment composer des pages entières ; c'est ici que l'on empêche la production d'un contenu IA générique.
• Personality & References : la voix et les références derrière le design.
• Distinctive Motifs : les éléments signatures à reproduire ; "ils définissent le design autant que les tokens."
• Do's & Don'ts : les règles qui maintiennent l'interface générée dans l'univers du design.
• Agent Rules : des instructions explicites pour l'agent de codage lui-même.

Un DESIGN.md n'est aussi bon que le système qui le soutient. Voici le kit gratuit ambient-sage : les tokens, polices et traitements décrits par son DESIGN.md, rendus en direct :

1. 1

   CLI : écrivez DESIGN.md + tokens dans votre dépôt

   La voie la plus rapide. Choisissez le slug d'un kit dans la galerie et appliquez-le ; vous obtenez un fichier DESIGN.md validé ainsi qu'un fichier de tokens correspondant.

   Copy

   identityforge apply ambient-sage

2. 2

   MCP : laissez l'agent le récupérer

   Avec le serveur MCP installé, l'agent appelle get_design_md(slug) pour lire le brief complet et apply_theme pour l'écrire. Installez-le pour votre outil :

   Copy

   npx --yes identityforge@latest install --client claude-code

3. 3

   shadcn : installez les tokens référencés par le DESIGN.md

   Si vous ne voulez que les valeurs, l'élément du registre installe directement les variables CSS du kit.

   Copy

   npx shadcn add https://identityforge.io/r/ambient-sage.json

Identity Forge génère le DESIGN.md et les tokens à partir du même kit, de sorte que le texte décrit les valeurs présentes dans la feuille de style. Pour comprendre en quoi cela diffère de l'adaptation manuelle d'une entrée de catalogue DESIGN.md, consultez Identity Forge vs getdesign.md.