Notre approche / Norme d'ingénierie

285 règles.
168 refusent le commit.

La plupart des « standards d'ingénierie » sont un document que personne ne relit. Le nôtre est exécutable : à chaque commit, une passe mécanique évalue le code contre un registre de règles et refuse ce qui ne passe pas. Pas un rappel. Un refus.

285

règles au registre

registry.json

168

bloquantes — elles refusent, elles n'avertissent pas

blocking = true

132

adossées à un script exécutable

dont 96 bloquantes

148

évaluées avant même que le commit existe

trigger = pre-commit

01 · Le défaut que ça corrige

Une norme qu'on peut ignorer n'est pas une norme.

Trois choses cassent un standard écrit. On les a rencontrées toutes les trois, alors on a arrêté de l'écrire et on a commencé à l'exécuter.

Le document que personne ne rouvre

Un standard en PDF vieillit le jour où il est signé. Un registre, lui, tourne : une règle qui ne correspond plus au code échoue, et se fait corriger ou retirer.

La revue qui dépend de qui relit

Deux relecteurs, deux verdicts. Une règle mécanique rend le même verdict à 3 h du matin qu'en réunion — c'est la seule façon qu'un standard survive à la fatigue.

L'exception « juste cette fois »

Elle devient la règle en trois semaines. Ici l'exception existe, mais elle est nommée, écrite dans le fichier, et visible en revue — pas murmurée.

02 · Quand ça mord

Cinq moments, du plus tôt au plus tard.

Plus une règle mord tôt, moins elle coûte. La moitié du registre s'exécute avant que le commit existe ; ce qui demande le dépôt entier attend la nuit.

pre-commitAvant que le commit existe — la faute n'entre jamais dans l'historique148
nightlyCe qui demande le dépôt entier — dérive, couverture, dette46
pr-gateÀ la revue — ce qui ne se juge que sur une tranche complète38
pre-pushAvant que ça quitte la machine — types, build, cohérence24
release-tagAu moment de livrer — provenance, signature, inventaire12
03 · Le dernier verdict, tel quel

Un standard qui dit toujours oui ne prouve rien.

Voici la sortie réelle de la dernière passe sur ce site même. On la publie entière, y compris la colonne qui dit qu'un tiers des règles ne s'appliquaient pas.

Évaluées

147

Les règles dont le déclencheur correspondait à ce qui était mis en jeu.

Passées

106

72 %. Le reste a été corrigé avant que le commit existe — c'est le but.

Sans objet

41

Elles ne mordaient pas sur cette tranche. Compter un « sans objet » comme une réussite serait du théâtre.

Ce que ce chiffre veut dire, et ce qu'il ne veut pas dire.

106 sur 147 n'est pas une note de qualité : c'est un compte de règles applicables satisfaites au moment du commit. Une règle qui ne s'applique pas ne dit rien de bon ni de mauvais. Et une passe qui ne refuse jamais rien est le signal qu'il faut aller lire le registre, pas se féliciter.

04 · La boucle

Une règle nouvelle avertit avant de refuser.

Poser une règle bloquante du jour au lendemain casse une équipe et se fait contourner. Chaque règle traverse la même boucle — c'est ce qui la rend tenable.

Un défaut se répète

Le même incident revient deux fois. On écrit la règle qui l'aurait attrapé, en mode avertissement, branchée sur le bon déclencheur.

Elle avertit, on compte

Fenêtre de calibration : la règle tourne sans bloquer et on mesure ses faux positifs. Une règle qui crie au loup se corrige ou se retire — elle ne passe pas bloquante.

Elle refuse, et on le prouve

Passée bloquante, elle est mutation-testée : on réintroduit exprès le défaut et on exige qu'elle échoue. Une garde qui n'échoue jamais ne prouve rien.

05 · Ce que ça change pour vous

Vous n'achetez pas notre discipline. Vous achetez sa trace.

Le livrable porte sa preuve

Chaque livraison arrive avec le verdict de la passe qui l'a laissée sortir — évaluées, passées, sans objet. Pas une affirmation de qualité : un relevé.

La qualité ne dépend pas de qui était là

La même règle s'applique au premier jour d'un nouveau et au dixième commit d'un senior. C'est ce qui permet à une équipe de changer sans que la barre bouge.

Ce qu'on n'a pas vérifié est écrit

Les trous de couverture sont déclarés, pas tus. Un rapport qui ne liste aucune limite est un rapport à relire.

Demandez le verdict avant de signer.

On vous montre la passe sur un vrai dépôt — règles évaluées, refusées, corrigées. Pas une démo : une sortie.

D'où vient chaque chiffre de cette page

285 / 168 / 101 / 132 / 96 et la répartition par déclencheur sont comptés dans le registre d'ingénierie. Le verdict 147 / 106 / 41 est la sortie de la passe pre-commit exécutée sur ce dépôt le 2026-07-28. Aucun chiffre n'est arrondi ni arrangé.

Ce que cette page ne revendique pas : aucune certification, aucun audit tiers, aucune norme externe. C'est un standard interne, mécaniquement appliqué. C'est toute la revendication.