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
`governance/rules/project-overview.md`	Contexte généralGeneral context
`governance/rules/tokens-system.md`	Règles des tokensToken rules
`governance/rules/development.md`	Règles de développementDevelopment rules
`guidelines/components/button.md`	Contrat du composant concernéContract for the relevant component
`governance/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(--agtc-component-button-primary-background);

/* ❌ Interdit — valeur brute, aucune intention / raw value, no intent */
color: #0d74ce; /* audit-ignore: anti-pattern example, shown on purpose */

/* ❌ Interdit — token primitif utilisé directement / primitive token used directly */
color: var(--agtc-primitive-color-blue-11); /* audit-ignore: anti-pattern example, shown on purpose */

Compétences (Skills)Skills

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

Utiliser Agentica avec un autre outil IAUsing Agentica with another AI tool BêtaBeta

Ce système de design n'est pas construit uniquement pour Claude Code. AGENTS.md, à la racine du dépôt, est le point d'entrée unique de gouvernance — lu nativement par la plupart des outils IA de développement. Chaque outil a ensuite son propre mécanisme pour les compétences (Skills) et les automatismes ; voici ce qui existe aujourd'hui pour Codex, GitHub Copilot et Gemini CLI. This design system isn't built for Claude Code alone. AGENTS.md, at the repo root, is the single governance entry point — read natively by most AI coding tools. Each tool then has its own mechanism for skills and automation; here's what exists today for Codex, GitHub Copilot, and Gemini CLI.

Pourquoi bêta : les portages Codex et Copilot (.agents/skills/) n'ont pas encore été essayés dans une vraie session de ces outils — construits contre leurs docs officielles, pas testés en conditions réelles. Les hooks Gemini (.gemini/hooks/*.js) sont testés uniquement en local contre des payloads simulés : le nom exact des champs qu'ils lisent est la meilleure estimation possible à partir de la documentation de Gemini CLI, pas une certitude confirmée en session réelle. Si un de ces mécanismes ne se déclenche pas comme attendu chez toi, ouvre une issue. Why beta: the Codex and Copilot ports (.agents/skills/) haven't yet been tried in a real session of either tool — built against their official docs, not tested in real conditions. The Gemini hooks (.gemini/hooks/*.js) are tested only locally against simulated payloads: the exact field names they read are the best available estimate from Gemini CLI's docs, not something confirmed in a real session. If one of these doesn't fire as expected for you, please open an issue.

OutilTool	Lit `AGENTS.md` ?Reads `AGENTS.md`?	Compétences (Skills)Skills	Rappels automatiquesAutomatic reminders
Codex CLI	Nativement, à la racine et imbriquéNatively, root and nested	`.agents/skills/` — chargées automatiquement, aucune installation— auto-loaded, no install step	Aucun — Codex n'a pas de système de hooksNone — Codex has no hooks system
GitHub Copilot (CLI et agent de codage)(CLI and coding agent)	Nativement, plus `.github/copilot-instructions.md`Natively, plus `.github/copilot-instructions.md`	`.agents/skills/` — même format que Codex, chargé automatiquement— same format as Codex, auto-loaded	Aucun — pas de système de hooks non plusNone — no hooks system either
Gemini CLI	Pas nativement — via l'import `@AGENTS.md` dans `GEMINI.md`Not natively — via the `@AGENTS.md` import in `GEMINI.md`	Non empaqueté — le format d'extension de Gemini exige une installation explicite, donc ne suit pas le dépôt automatiquementNot packaged — Gemini's extension format requires an explicit install step, so it doesn't travel with the repo automatically	`.gemini/settings.json` — rappel ADR et rappel revue de patterns UX, natifs— ADR and UX-pattern-review reminders, native

Cette parité n'est ni automatique ni garantie — governance/ai-skills-reference.md documente ce que chaque compétence Claude Code automatise et comment le reproduire ; governance/tool-parity/ garde, pour chaque outil déjà intégré, une attestation signée par un humain listant explicitement ce qui est remplacé et ce qui est une absence acceptée. Un check CI (tool-parity) bloque toute config d'outil IA sans cette attestation. This parity is neither automatic nor guaranteed — governance/ai-skills-reference.md documents what each Claude Code skill automates and how to reproduce it; governance/tool-parity/ keeps, for every tool already integrated, a human-signed attestation explicitly listing what's replaced and what's an accepted absence. A CI check (tool-parity) blocks any AI-tool config that lacks that attestation.