Moteur de 268 contrôles pour le dépôt
Conçu le moteur de garde‑fous du dépôt — 268 contrôles de commit
enregistrés, 277 règles de linting et 15 règles ESLint
personnalisées — ainsi que 146 tests de ces garde‑fous, pour que les
exigences soient appliquées par la compilation et non par la seule
revue.
2025

Situation. Les normes inscrites dans un guide de contribution
restent des recommandations. Tout le monde les approuve, puis vient
un vendredi, une petite modification, et le guide cède. Le zéro
avertissement ne pouvait tenir sans autre chose que la bonne
volonté. Les linters propres aux langages restent en outre bien en
deçà des règles spécifiques au projet, celles qui définissent
précisément le fonctionnement attendu de ce code.

Tâche. Les règles importantes devaient devenir exécutables : en
enfreindre une devait faire échouer un commit plutôt que dépendre
d'une personne disposant du temps et de la mémoire nécessaires pour
le repérer en revue.

Action. Un moteur de garde‑fous a été construit. Il comprend 274
scripts de contrôle, dont 268 enregistrés dans les hooks de commit,
ainsi que 277 linters JavaScript, 96 validateurs shell et 17
validateurs Python. Ils couvrent ce dont les outils standard ne se
soucient pas : possibilité d'annuler une migration, présence d'une
clé de traduction dans les deux langues, concordance d'une route
enregistrée avec OpenAPI ou ajout discret d'une suppression locale.
Quinze règles ESLint personnalisées imposent les conventions
TypeScript. Une règle mérite d'être citée : tout commit préfixé fix:
doit comporter un test qui échoue sans la correction, ce qui fournit
un contrôle exécutable de cette régression. Et comme un garde‑fou
défaillant est pire que son absence — il laisse tout passer sans que
personne ne le sache — ces contrôles possèdent eux‑mêmes 146 tests.

Résultat. Les personnes chargées de la revue pouvaient consacrer
davantage de temps à la conception, car les contrôles automatiques
traitaient les règles mécaniques qu’ils encodaient avant le push
d’une branche. Le compromis est réel : les commits sont lents et un
contrôle mal écrit est profondément agaçant à contourner. Ces 146
tests existent parce que cette situation s'est produite.

Catégories:
1DevOps	/fr/categories/devops/	advisory.engineer.company	70
1Automatisation et CI/CD	/fr/categories/automation/	advisory.engineer.company	70
1Tests et assurance qualité	/fr/categories/testing/	advisory.engineer.company	70
1Direction technique	/fr/categories/technical-leadership/	advisory.engineer.company	70
1Documentation	/fr/categories/documentation/	advisory.engineer.company	70

Prestations:
1DevOps et automatisation CI/CD	/fr/services/devops-cicd/	advisory.engineer.company	70
1Développement d'agents d'IA sur mesure	/fr/services/ai-agents/	advisory.engineer.company	70
1Direction technique et conseil	/fr/services/technical-leadership/	advisory.engineer.company	70
1Documentation technique	/fr/services/technical-documentation/	advisory.engineer.company	70

hCette page sur le Web	URL:https://advisory.engineer.company/fr/portfolio/built-a-268-check-guard-engine-for-the-repo/	advisory.engineer.company	70
