Agentica, le système de décision pour les humains et les agents IA
Un design system personnel construit pour prouver une thèse : les décisions de design devraient survivre aux outils, aux frameworks et aux personnes qui les ont construites. Zéro dépendance à un fournisseur.
Contexte / problème
La plupart des design systems documentent ce qui a été construit. Peu préservent le pourquoi. Les équipes perdent leurs décisions dans des commentaires Figma, des fils Slack et le savoir tacite, alors les mêmes débats se répètent, la documentation devient obsolète, et le système devient dépendant de la seule personne qui se souvient du raisonnement. J'ai construit Agentica pour tester si ce problème est solvable, pas pour un client, mais comme preuve d'un modèle de gouvernance qui manque, selon moi, à la plupart des design systems d'entreprise.
Décisions et gouvernance
Chaque choix significatif dans Agentica est consigné comme un Architecture Decision Record versionné, contexte, alternatives considérées, compromis, et le raisonnement derrière la décision finale. Ce n'est pas de la documentation après coup ; c'est le mécanisme qui permet au système d'évoluer sans effacer sa propre histoire.
Agentica est aussi construit avec les agents IA comme acteur défini du système, avec une limite explicite. Les agents peuvent détecter des incohérences, proposer des composants et rédiger de la documentation. Ils ne peuvent pas approuver, déployer, ou contourner la gouvernance. L'humain garde le dernier mot, par design, pas par convention.
- Décider
- Gouverner
- Systématiser
- Exécuter
Architecture
Une seule source de vérité alimente quatre niveaux : fondations (tokens), contrats sémantiques, composants et applications. Les composants sont construits en Web Components natifs, indépendants du framework, compilés vers CSS, JS, Tailwind, Angular, iOS et Android. Si l'outillage IA autour disparaissait demain, le système continuerait de fonctionner : documenté, scripté et testé pour le prouver.
Résultat / preuve
- 850+ tokens de design en mode clair et sombre
- 17 composants livrés, d'autres en développement actif
- 70+ ADR capturant le raisonnement derrière chaque décision majeure
- Portes de qualité automatisées pour l'accessibilité (WCAG 2.1), la régression visuelle, la documentation et la cohérence des tokens