Pour les agents IAFor AI agents

Ce système de design est conçu pour être compris et utilisé par des agents IA. Les agents observent, analysent, proposent. Les humains approuvent, décident, déploient. This design system is built to be understood and used by AI agents. Agents observe, analyze, propose. Humans approve, decide, deploy.

Le dernier mot est toujours humain. The final decision is always human.

Types d'agentsAgent types

Quatre rôles dans l'ordre du pipeline de production — de la conception au déploiement. Four roles in production pipeline order — from design to deployment.

Agent Figma

Designer Agent

Détecte les dérives dans Figma : instances détachées, descriptions manquantes, espacements et tokens incohérents.Detects drift in Figma: detached instances, missing descriptions, inconsistent spacing and tokens.

Agent Code

Developer Agent

Détecte les mauvais usages de tokens dans le code, génère les Web Components, ouvre des PRs de correction.Detects bad token usage in code, generates Web Components, opens fix PRs.

Agent Tests

QA Agent

Exécute les tests d'accessibilité, de régression visuelle, de conformité des tokens avant tout merge.Runs accessibility, visual regression, and token compliance tests before every merge.

Agent Docs

Documentation Agent

Génère des changelogs, guides de migration, notes d'accessibilité, mises à jour des guidelines.Generates changelogs, migration guides, accessibility notes, and guideline updates.

Ce que les agents peuvent faireWhat agents can do

AutoriséAllowed

Lire tous les fichiers du dépôtRead all files in the repository
Générer du code respectant les contratsGenerate code following the contracts
Détecter les dérives de tokensDetect token drift
Proposer des correctionsPropose fixes
Créer une branche fix/ ou docs/Create a fix/ or docs/ branch
Faire des commits sur une branche featureCommit on a feature branch
Ouvrir une PR avec description complèteOpen a PR with full description

InterditForbidden

Merger une PR sans approbation humaineMerge a PR without human approval
Pusher directement sur main ou developPush directly to main or develop
Modifier tokens/component.json sans approbation expliciteModify tokens/component.json without explicit approval
Inventer des variantes ou tokens non définisInvent undefined variants or tokens
Utiliser des valeurs en dur (hex, px, etc.)Use hardcoded values (hex, px, etc.)
Ignorer les règles d'accessibilitéIgnore accessibility rules

Ordre de lecture obligatoireMandatory reading order

Avant toute action dans ce dépôt, un agent doit lire dans cet ordre : Before any action in this repository, an agent must read in this order:

FichierFile	RôleRole
`AGENTS.md`	Routeur d'agents — première lecture obligatoireAgent router — mandatory first read
`DESIGN.md`	Contrat de marque portablePortable brand contract
`.claude/rules/project-overview.md`	Contexte généralGeneral context
`.claude/rules/tokens-system.md`	Règles des tokensToken rules
`.claude/rules/development.md`	Règles de développementDevelopment rules
`guidelines/components/button.md`	Contrat du composant concernéContract for the relevant component
`.claude/instructions/session-spec.md`	Quick reference pour la sessionSession quick reference

Règle d'escaladeEscalation rule

Toute modification touchant les tokens sémantiques ou de composant déclenche une escalade automatique vers un humain. Les agents ne peuvent pas approuver leurs propres modifications sur ces tokens. Any change to semantic or component tokens triggers automatic escalation to a human. Agents cannot approve their own modifications to these tokens.

Règle de nommage — rappelNaming rule — reminder

/* ✅ Correct — intention lisible par un agent / intent readable by an agent */
color: var(--sda-component-button-primary-background);

/* ❌ Interdit — valeur brute, aucune intention / raw value, no intent */
color: #0d74ce;

/* ❌ Interdit — token primitif utilisé directement / primitive token used directly */
color: var(--sda-primitive-color-blue-11);

Compétences (Skills)Skills

Skill	RôleRole
`.claude/skills/ai-ds-composer.md`	Compose des interfaces depuis du langage naturel en respectant les contratsComposes interfaces from natural language following the contracts
`.claude/skills/ai-component-metadata.md`	Génère les métadonnées de composantGenerates component metadata
`.claude/skills/codebase-index.md`	Index du dépôt pour navigation rapideRepository index for fast navigation