Changelog

Historique des versions d'Agentica — chaque entrée décrit les changements, décisions et améliorations apportées au système. Agentica version history — each entry describes the changes, decisions, and improvements made to the system.

2026-06-29
v0.2.0 Non lancéeUnreleased

Tokens — Dark mode dual-modeTokens — Dark mode dual-mode

  • tokens/semantic.dark.json — 38 tokens delta (valeurs qui changent entre light et dark), DTCG-conforme, pattern "deux fichiers, un seul build CSS" (ADR-065)tokens/semantic.dark.json — 38 delta tokens (values that change between light and dark), DTCG-compliant, "two files, one CSS build" pattern (ADR-065)
  • Style Dictionary : second run → dist/tokens/css/dark.css sous sélecteur [data-theme="dark"] { … color-scheme: dark; }Style Dictionary: second run → dist/tokens/css/dark.css under [data-theme="dark"] { … color-scheme: dark; } selector
  • Convention text.on-dark — renommage de on-inverse → on-dark sur tous les tokens (plus explicite pour les équipes produit)text.on-dark convention — renamed on-inverse → on-dark across all tokens (clearer for product teams)

ComposantsComponents

  • agtc-feature-card — nouveau Web Component (glassmorphism, variantes default/marketing, niveaux de titre 1–6, revue UX P1–P8 approuvée, ADR-063)agtc-feature-card — new Web Component (glassmorphism, default/marketing variants, heading levels 1–6, UX review P1–P8 approved, ADR-063)
  • Correction contraste agtc-feature-card : 10 violations Chromatic (ratio 1.12) → 0. Cause : text.primary sur fond glassmorphism toujours sombre → remplacé par text.on-darkagtc-feature-card contrast fix: 10 Chromatic violations (ratio 1.12) → 0. Root cause: text.primary on always-dark glassmorphism background → replaced with text.on-dark

Storybook & ChromaticStorybook & Chromatic

  • @storybook/addon-themes — toggle dark/light dans la toolbar Storybook (withThemeByDataAttribute, data-theme sur <html>)@storybook/addon-themes — dark/light toggle in Storybook toolbar (withThemeByDataAttribute, data-theme on <html>)
  • Chromatic Story Modes — 2 snapshots par story (light #fcfcfc / dark #0a0c11), baselines séparées. Résout les régressions visuelles dark/light non détectéesChromatic Story Modes — 2 snapshots per story (light #fcfcfc / dark #0a0c11), separate baselines. Resolves undetected dark/light visual regressions

PerformancePerformance

  • Home page 1 453 KB → 65 KB (−95 %) : illustrations SVG chargées en lazy-load via IntersectionObserver, jamais inlinées dans le HTMLHome page 1,453 KB → 65 KB (−95%): SVG illustrations lazy-loaded via IntersectionObserver, never inlined in HTML
  • Google Fonts non-bloquant : @import supprimé de site.css → <link> dans <head> avec preconnect — élimine 2 allers-retours réseauNon-blocking Google Fonts: @import removed from site.css → <link> in <head> with preconnect — eliminates 2 network round trips

Site & Redesign V2Site & Redesign V2

  • Redesign site V2 complet : mode sombre par défaut (data-theme="dark"), glassmorphism, aurora hero, footer 4 colonnes, sidebar gauche pages agents, logo 3 couleursFull site V2 redesign: dark mode by default (data-theme="dark"), glassmorphism, aurora hero, 4-column footer, left sidebar for agent pages, 3-colour logo
  • Mode clair V2 fonctionnel : token adaptatifs background-page, bloc [data-theme="light"], 4 combinaisons dark/light × marketing/produit (ADR-064)Working V2 light mode: adaptive background-page tokens, [data-theme="light"] block, 4 dark/light × marketing/product combinations (ADR-064)
  • Documentation dark mode sur la page Démarrer : snippets HTML/JS/CSS, règle text.on-dark documentéeDark mode documentation on Get started page: HTML/JS/CSS snippets, text.on-dark rule documented

GouvernanceGovernance

  • ADR-063 (agtc-feature-card), ADR-064 (mode clair V2), ADR-065 (dark mode dual-mode) — 65 ADRs au totalADR-063 (agtc-feature-card), ADR-064 (V2 light mode), ADR-065 (dark mode dual-mode) — 65 ADRs total

Gouvernance & synchronisation FigmaGovernance & Figma sync

  • Audit complet Figma ↔ code via MCP Figma : 1 470+ variables vérifiées (tokens non-couleur + 654 tokens couleur, Text Styles, Effect Styles) contre tokens/*.jsonFull Figma ↔ code audit via Figma MCP: 1,470+ variables verified (non-color tokens + 654 color tokens, Text Styles, Effect Styles) against tokens/*.json
  • 2 dérives de valeur corrigées côté Figma : échelle fontSize primitive (rem×4 au lieu de px), espacement densité compact/comfortable (valait 0 au lieu des formules floor/ceil ADR-025)2 value drifts fixed on the Figma side: primitive fontSize scale (rem×4 instead of px), compact/comfortable density spacing (was 0 instead of the ADR-025 floor/ceil formulas)
  • 822 variables Figma reclassées de ALL_SCOPES vers des scopes explicites (GAP, CORNER_RADIUS, FONT_SIZE, TEXT_FILL, FRAME_FILL/SHAPE_FILL, STROKE_COLOR, EFFECT_COLOR) — conforme aux bonnes pratiques du design system builder Figma822 Figma variables reclassified from ALL_SCOPES to explicit scopes (GAP, CORNER_RADIUS, FONT_SIZE, TEXT_FILL, FRAME_FILL/SHAPE_FILL, STROKE_COLOR, EFFECT_COLOR) — aligned with Figma design-system-builder best practices

Tests — Stratégie PlaywrightTesting — Playwright strategy

  • ADR-066 : Playwright remplace Chromatic pour les pages du site (limite mensuelle de snapshots gratuits atteinte le 2026-07-01) — deux périmètres distincts, Chromatic conservé pour les stories composantsADR-066: Playwright replaces Chromatic for site pages (free monthly snapshot quota reached 2026-07-01) — two distinct scopes, Chromatic kept for component stories
  • Infrastructure complète : projets chromium/firefox/webkit, snapshots de référence committées dans tests/visual/snapshots/, exécution dans l'image Docker officielle Playwright pour éliminer les faux positifs de rendu entre OSFull infrastructure: chromium/firefox/webkit projects, reference snapshots committed under tests/visual/snapshots/, run inside the official Playwright Docker image to eliminate cross-OS rendering false positives
  • Rafraîchissement des snapshots de référence exclusivement via workflow_dispatch avec approbation humaine explicite — jamais automatisé (ADR-066, ADR-004)Reference snapshots refreshed exclusively via workflow_dispatch with explicit human approval — never automated (ADR-066, ADR-004)
  • Items optionnels : audit accessibilité axe-core, ouverture automatique d'une issue GitHub sur régression visuelle détectée, rapport HTML publié sur GitHub PagesOptional add-ons: axe-core accessibility audit, automatic GitHub issue on detected visual regression, HTML report published to GitHub Pages

Dette de tokens résorbéeToken debt resolved

  • agtc-feature-card : 3 défauts corrigés — fond/bordure d'overlay codés en dur → nouveaux tokens semantic.color.background.overlay-dark / semantic.color.border.overlay-dark, référence vers un token de couleur d'accent inexistant corrigéeagtc-feature-card: 3 defects fixed — hardcoded overlay background/border → new semantic.color.background.overlay-dark / semantic.color.border.overlay-dark tokens, reference to a non-existent accent color token fixed
  • agtc-button : nouveaux tokens de typographie label-bold/detail-bold, composant aligné dessus (audit Figma)agtc-button: new label-bold/detail-bold typography tokens, component aligned to them (Figma audit)
  • agtc-code-block : 3 valeurs de typographie codées en dur corrigées (line-height, font-weight, letter-spacing) — seul consommateur du token semantic.typography.mono.family du dépôtagtc-code-block: 3 hardcoded typography values fixed (line-height, font-weight, letter-spacing) — the repo's only consumer of the semantic.typography.mono.family token
  • Nouvelle catégorie de token letterSpacing (ADR-067), puis étendue à une échelle complète de 11 valeurs — résorbe la dette des 9 variables --agtc-tracking-* du site, ~50 sites d'appel repointés vers les tokens (ADR-068)New letterSpacing token category (ADR-067), later extended to a full 11-value scale — resolves the debt on the site's 9 --agtc-tracking-* variables, ~50 call sites repointed to tokens (ADR-068)

Gouvernance FigmaFigma governance

  • Charte de gouvernance de la librairie Figma : le code fait foi, jamais l'inverse ; cycle de vie d'une modification — page de staging, règle no-delete (jamais .remove(), déplacer vers une frame _corbeille), rapport 10 points avant toute revue humaineFigma library governance charter: code is the source of truth, never the reverse; change lifecycle — staging page, no-delete rule (never .remove(), move to a _corbeille frame instead), 10-point report before any human review
  • Audit étendu : vérification de la parité code↔Figma après toute instruction visuelle humaine directe, méthode de test de combinaisons variantes × états × contenu (technique EightShapes)Extended audit: code↔Figma parity check after any direct human visual instruction, variant × state × content combination test method (EightShapes technique)
  • Les 15 Text Styles de la librairie (typographie standard + nouvelle typographie mono de documentation) sont désormais intégralement bindés à des Variables Figma — plus aucune valeur de typographie codée en durAll 15 library Text Styles (standard typography + new documentation mono typography) are now fully bound to Figma Variables — no more hardcoded typography values

Plan de continuité sans agents IAContinuity plan without AI agents

  • Guide How-to-sans-agents.md et 8 scripts scripts/continuity/ : marche à suivre humaine si l'accès aux agents IA devient indisponible, pour l'équipe système de design et les équipes produits consommatricesHow-to-sans-agents.md guide and 8 scripts/continuity/ scripts: human fallback procedure if AI agent access becomes unavailable, for both the design system team and consuming product teams
  • Nouvelle page continuite.html publiée sur le site (Mode Produit), synthétisant le plan par équipeNew continuite.html page published on the site (Product Mode), summarizing the plan by team

SiteSite

  • Refactor du pattern de layout : un seul conteneur unifie les deux patterns de mise en page avec sidebarLayout pattern refactor: a single container now unifies both sidebar layout patterns
  • Section Durabilité de la page d'accueil reformulée (accroche marketing sur l'absence de dépendance/verrouillage aux agents IA)Home page Durability section reworded (marketing framing around freedom from AI agent lock-in/dependency)
  • Lien vers la page Continuité ajouté au footer (partagé par toutes les pages) et à la page DocumentationLink to the Continuity page added to the footer (shared across all pages) and to the Documentation page

Gestion de projetProject management

  • Migration du suivi de projet vers GitHub Projects (ADR-069, remplace ADR-016) : 100 items migrés (91 chantiers historiques + 1 en attente + 8 tickets de backlog), champs Status/Domaine/Dépendance/ADR/Date, vues Board/Par domaine/HistoriqueProject tracking migrated to GitHub Projects (ADR-069, replaces ADR-016): 100 items migrated (91 historical items + 1 pending + 8 backlog tickets), Status/Domaine/Dépendance/ADR/Date fields, Board/By domain/History views
  • log/kit-construction.md et son hook PostToolUse de journalisation automatique retirés du dépôt — le suivi de tâches ne vit plus dans un fichier versionnélog/kit-construction.md and its automatic PostToolUse logging hook removed from the repo — task tracking no longer lives in a versioned file
  • Champ Priorité (P0 à P3) ajouté au projet ; backlog découpé en 4 chantiers (traduction anglaise, nettoyage du dépôt, gouvernance Figma, Community File Figma) totalisant 23 sous-tickets priorisés, chacun rattaché à son parent via le champ DépendancePriority field (P0 to P3) added to the project; backlog split into 4 initiatives (English translation, repository cleanup, Figma governance, Figma Community File) totalling 23 prioritized sub-tickets, each linked to its parent via the Dependency field

Nettoyage du dépôtRepository cleanup

  • AGENTS.md corrigé : la section citait encore GitHub Issues, CONTEXT.md et docs/adr/ (boilerplate d'un template jamais adapté), en contradiction avec project-overview.md (GitHub Projects exclusif, ADR-069) — 3 fichiers docs/agents/*.md obsolètes supprimésAGENTS.md fixed: the section still referenced GitHub Issues, CONTEXT.md and docs/adr/ (boilerplate from a template never adapted to this repo), contradicting project-overview.md (GitHub Projects exclusive, ADR-069) — 3 obsolete docs/agents/*.md files removed
  • Références mortes vers Redesign/AI anti-patters.md et deux-contextes.md (supprimés le 2026-06-20) corrigées dans contexts-utilisation.md et guidelines/foundations/contextes.mdDead references to Redesign/AI anti-patters.md and deux-contextes.md (deleted 2026-06-20) fixed in contexts-utilisation.md and guidelines/foundations/contextes.md
  • Workflow CI mort deploy-redesign.yml retiré (remplacé depuis longtemps par deploy-site.yml) ; branche feature/redesign supprimée (vérifiée fusionnée)Dead deploy-redesign.yml CI workflow removed (long superseded by deploy-site.yml); feature/redesign branch deleted (verified merged)
  • Artefacts orphelins racine retirés : script de capture d'écran ad hoc, note de handoff obsolète, rapport de test encore suivi malgré .gitignoreOrphaned root artifacts removed: ad hoc screenshot script, stale handoff note, test report still tracked despite .gitignore
  • Dossier Redesign/ (25 Mo, prototype d'exploration déjà clos) archivé hors dépôt (intégrité vérifiée par checksums) puis suppriméRedesign/ folder (25 MB, already-closed exploration prototype) archived outside the repo (integrity verified via checksums), then removed
  • Dossier illustrations/ (3 diagrammes SVG v1 approuvés mais jamais intégrés au site, ADR-051) retiré — remplacé par le système d'illustrations PNG Brand/illustrations/illustrations/ folder (3 approved v1 SVG diagrams, never integrated into the site, ADR-051) removed — replaced by the Brand/illustrations/ PNG illustration system

InternationalisationInternationalization

  • ADR-070 : l'anglais devient la langue par défaut du dépôt, en 6 chantiers priorisés, pour le partage avec la communauté internationaleADR-070: English becomes the repository's default language, split into 6 prioritized initiatives, to support sharing with the international community
  • Documentation racine (README, AGENTS.md, DESIGN.md, les 3 guides How-to-*.md) entièrement traduite — l'anglais remplace le français, aucune version FR conservée dans ces fichiersRoot documentation (README, AGENTS.md, DESIGN.md, all 3 How-to-*.md guides) fully translated — English replaces French, no FR version kept in these files
  • Langue par défaut du site basculée de fr à en (<html lang>, data-lang, replis JS, sélecteur FR/EN) — le français reste pleinement disponible via le sélecteur, parité lang-fr/lang-en vérifiée sur les 104 pagesSite default language switched from fr to en (<html lang>, data-lang, JS fallbacks, FR/EN switcher) — French remains fully available via the switcher, lang-fr/lang-en parity verified across all 104 pages
2026-06-19
v0.1.0

FondationsFoundations

  • Architecture de tokens 3 niveaux : primitifs → sémantiques → composant (DTCG-conforme)3-layer token architecture: primitives → semantic → component (DTCG-compliant)
  • Palette de couleurs Radix UI (échelles 12 niveaux), espacement grille 4px, typographie Atkinson HyperlegibleRadix UI color palette (12-step scales), 4px spacing grid, Atkinson Hyperlegible typography
  • Bibliothèque d'icônes Lucide — 1 500+ icônes, 3 tailles, contrats d'accessibilité WCAG 1.1.1Lucide icon library — 1,500+ icons, 3 sizes, WCAG 1.1.1 accessibility contracts

ComposantsComponents

  • 14 Web Components (Lit) : Button, Input, Badge, Card, Checkbox, Radio, Toggle, Table, Code Block, Banner, Link, Icon, Segmented, Top Nav14 Web Components (Lit): Button, Input, Badge, Card, Checkbox, Radio, Toggle, Table, Code Block, Banner, Link, Icon, Segmented, Top Nav
  • Variantes Button : primary, secondary, ghost, critical — confirmation obligatoire pour les actions irréversiblesButton variants: primary, secondary, ghost, critical — required confirmation for irreversible actions
  • Tokens de composant institutionnels dans tokens/component.jsonInstitutional component tokens in tokens/component.json

Gouvernance & AgentsGovernance & Agents

  • 62 ADRs (Architecture Decision Records) — toutes les décisions tracées et justifiées62 ADRs (Architecture Decision Records) — all decisions traced and justified
  • 4 types d'agents IA : Designer, Developer, QA, Documentation4 AI agent types: Designer, Developer, QA, Documentation
  • Conformité WCAG 2.1 AA — audit intégré, 0 violation critiqueWCAG 2.1 AA compliance — built-in audit, 0 critical violations
  • Pipeline qualité complet : tokens-audit, WCAG, UX patterns, ADR, docs, site rebuildFull quality pipeline: tokens-audit, WCAG, UX patterns, ADR, docs, site rebuild

Site & DocumentationSite & Documentation

  • Générateur de site statique sur-mesure (Node.js), bilingue FR/ENCustom static site generator (Node.js), bilingual FR/EN
  • Storybook publié sur Chromatic — canvas interactif, previews, specsStorybook published on Chromatic — interactive canvas, previews, specs
  • Sync Figma ↔ JSON via Tokens StudioFigma ↔ JSON sync via Tokens Studio
Contribuer à ce projet Contribute to this project

Ce système est ouvert aux contributions — tokens, composants, décisions architecturales, corrections d'accessibilité ou documentation. Toute amélioration est bienvenue. This system welcomes contributions — tokens, components, architectural decisions, accessibility fixes, or documentation. Every improvement counts.

Voir sur GitHub View on GitHub