Forme DS

Avec l’IA

Agents de code

Un agent qui écrit du code d'interface Forme® doit connaître un petit noyau de faits : quel paquet, quels imports, quel registre, quelles règles. Ces faits vivent dans un fichier llms.txt — la source de vérité DS pour agents. Cette page explique à quoi il sert et montre un extrait à jour pour le DS 2.0.

Le fichier llms.txt

llms.txt est un résumé condensé, lisible par un modèle, de tout ce qu'il faut savoir pour rester dans la ligne : installation, règle d'or, inventaire des composants avec leur intention, tokens, doctrine, et les pièges à éviter. Un agent le charge avant de générer du code d'UI ; il y trouve la bonne primitive pour une intention donnée plutôt que de réinventer un composant.

Attention à l'ancienne version. Le llms.txt legacy décrit @forme/ui v1 (React-Aria, registry.forme.ch). Ce socle est périmé. N'utilise que les faits DS 2.0 ci-dessous.

Les faits DS 2.0 qu'un agent doit connaître

  • Paquet composants : @forme-ch/ui (couche Forme sur Astryx).
  • Socle : @astryxdesign/core ; tokens & polices : @forme-ch/design-system.
  • Registre : GitHub Packages (npm.pkg.github.com), scope @forme-ch, token PAT read:packages.
  • Imports : contrôles depuis @forme-ch/ui/controls, icônes depuis @forme-ch/ui/icons, shell depuis @forme-ch/ui/shell.
  • CSS (ordre) : reset Astryx → astryx → design-system ; puis data-astryx-theme="forme".
  • Doctrine : source unique, API label, tokens obligatoires, jamais de CSS de composant dans une app.

Où le trouver

Le fichier à jour est publié à la racine du site : design.forme.ch/llms.txt. Il couvre aussi la marque (couleurs, palette Forme, rédaction) pour les agents qui produisent des documents. Un agent le charge en entier ; on ne recopie pas d’extrait ailleurs, pour qu’il n’existe qu’une version.

Un agent conforme est un agent qui consomme. Il importe depuis @forme-ch/ui, référence des tokens, passe un label, et n'écrit jamais de CSS de composant. Les mêmes règles que pour un humain — voir Conformité.