Documentation complèteComplete documentation
S'assurer que chaque modification du système est accompagnée de sa documentation correspondante, sans dette documentaire silencieuse.Ensure every system modification is accompanied by its corresponding documentation, with no silent documentation debt.
Flux du pipelinePipeline flow
01 · Matrice01 · Matrix
Fichier modifié → documentation requiseModified file → required documentation
Chaque type de changement a ses surfaces de documentation obligatoires (matrice guideline/ADR/log).Each type of change has its mandatory documentation surfaces (guideline/ADR/log matrix).
02 · Vérification02 · Verification
Toutes les surfaces documentéesAll surfaces documented
guidelines/ · decisions/ · GitHub Projects · DESIGN.md · AGENTS.md · .claude/rules/ · Site rebuildguidelines/ · decisions/ · GitHub Projects · DESIGN.md · AGENTS.md · .claude/rules/ · Site rebuild
03 · Parité03 · Parity
FR/EN — aucune langue absenteFR/EN — no language missing
Tout contenu ajouté en français → version anglaise requise (et vice versa). Aucune langue absente sur le site.Any content added in French → English version required (and vice versa). No language missing on the site.
Valeur métierBusiness value
Un système de design sans documentation est un système de design mort. Ce gate garantit que chaque changement laisse une trace lisible — par les humains comme par les agents IA.A design system without documentation is a dead design system. This gate ensures every change leaves a readable trace — for humans and AI agents alike.
Matrice de déclenchementTrigger matrix
| Fichier modifiéChanged file | ActionAction |
|---|---|
tokens/ (couleurs) | guidelines/foundations/color.mdguidelines/foundations/color.md |
tokens/ (typo) | guidelines/foundations/typography.mdguidelines/foundations/typography.md |
components/agtc-*.js | guidelines/components/[composant].mdguidelines/components/[component].md |
Tout changement significatif | GitHub Projects — item mis à jour (ADR-069)GitHub Projects — item updated (ADR-069) |
Décision architecturale | decisions/ADR-0XX.md + decisions/README.mddecisions/ADR-0XX.md + decisions/README.md |
Tout changement visible | Site rebuild : node site/build.jsSite rebuild: node site/build.js |
ContrôlesChecks
- guidelines/foundations/*.md mis à jour si fondation modifiée (couleur, typo, espacement)guidelines/foundations/*.md updated if foundation changed (color, type, spacing)
- guidelines/components/[composant].md mis à jour si composant modifiéguidelines/components/[component].md updated if component changed
- decisions/ADR-0XX.md créé pour toute décision architecturale nouvelledecisions/ADR-0XX.md created for any new architectural decision
- decisions/README.md mis à jour pour chaque nouvel ADRdecisions/README.md updated for each new ADR
- GitHub Projects — item créé/mis à jour pour tout chantier significatif (ADR-069)GitHub Projects — item created/updated for any significant undertaking (ADR-069)
- DESIGN.md mis à jour si identité, gouvernance ou principes changentDESIGN.md updated if identity, governance or principles change
- AGENTS.md mis à jour si nouvelle règle pour les agentsAGENTS.md updated if new rule for agents
- Parité bilingue FR/EN vérifiée sur toutes les pages modifiéesFR/EN bilingual parity verified on all modified pages