Le bistouri et la tronçonneuseThe scalpel and the chainsaw

« Sois paresseux » est une tronçonneuse. Elle coupe la plomberie — et l'organe avec.'Be lazy' is a chainsaw. It cuts the plumbing — and the organ with it.

Ton agent sur-construit : tu demandes un sélecteur de date, il installe une librairie, écrit un wrapper et ouvre un débat sur les fuseaux horaires. Le remède à la mode est une règle « sois paresseux / YAGNI » qui supprime tout ce qu'elle peut. Elle marche sur la plomberie — et mutile le domaine, parce qu'elle ne sait pas distinguer un objet-valeur Money d'une classe EmailValidator de 27 lignes : elle compte les lignes, alors elle coupe les deux. Il manque une chose à la règle paresseuse : le discernement. Classe le code avant de le couper.Your agent over-builds: ask for a date picker and it installs a library, writes a wrapper, and opens a debate about timezones. The fashionable cure is a 'be lazy / YAGNI' rule that deletes whatever it can. It works on plumbing — and maims the domain, because it can't tell a Money value object from a 27-line EmailValidator class: it counts lines, so it cuts both. The lazy rule is missing one thing: discernment. Classify the code before you cut it.

Deux erreurs symétriques : gonfler la plomberie, éventrer le domaine.Two symmetric errors: bloating the plumbing, gutting the domain.

L'outil unique se trompe dans les deux sens. La tronçonneuse à laquelle on a dit « construis » gonfle l'accessoire : une factory, une interface et un fichier de config pour cinq lignes de comportement. La même tronçonneuse à laquelle on a dit « sois paresseux » éventre l'essentiel : elle supprime l'objet-valeur Money parce qu'il n'a « qu'une seule devise aujourd'hui » — et le calcul de devises se disperse partout. Une seule lame ne peut pas faire les deux gestes. Il en faut deux.The single tool errs both ways. The chainsaw told to 'build' bloats the incidental: a factory, an interface, and a config file for five lines of behaviour. The same chainsaw told to 'be lazy' guts the essential: it deletes the Money value object because it has 'only one currency today' — and currency math scatters everywhere. One blade can't make both cuts. You need two.

Supprimer une abstraction essentielle ne retire pas la complexité — elle la déplace.Deleting an essential abstraction doesn't remove complexity — it moves it.

Voilà le piège qui rend l'éventration si tentante : à l'instant de la coupe, le diff rétrécit. On a « simplifié ». Mais un objet-valeur ne portait pas de la complexité décorative : il appliquait un invariant à un seul endroit. L'inliner ne supprime pas l'invariant — il l'éparpille sur tous les sites d'appel, où plus rien ne le fait respecter. L'animation fait avancer le temps après la coupe.Here's the trap that makes gutting so tempting: at the moment of the cut, the diff shrinks. You 'simplified'. But a value object wasn't carrying decorative complexity: it enforced an invariant in a single place. Inlining it doesn't delete the invariant — it scatters it across every call site, where nothing enforces it anymore. The animation advances time after the cut.

« Une seule implémentation » n'est pas le test. Ce que ça protège l'est.'One implementation' isn't the test. What it protects is.

Les deux extraits regardent exactement les mêmes deux abstractions : un port PaymentGateway et un UserService.get_user, chacune avec une seule implémentation. La tronçonneuse applique la même règle aux deux — « une impl → delete » — et tue le port en même temps que le passe-plat. Le bistouri pose une autre question, abstraction par abstraction : qu'est-ce que je perds si je supprime ça ? Bascule le toggle.Both snippets look at the exact same two abstractions: a PaymentGateway port and a UserService.get_user, each with a single implementation. The chainsaw applies one rule to both — 'one impl → delete' — and kills the port along with the pass-through. The scalpel asks a different question, abstraction by abstraction: what do I lose if I delete this? Flip the toggle.

# deux abstractions, UNE seule implémentation chacune.
# le bistouri ne compte pas les lignes : il demande ce que ça protège.

# PORT PaymentGateway → GARDÉ
#   protège une frontière (le domaine ignore Stripe)
#   et une couture de test (on teste sans réseau)
class PaymentGateway(Protocol):
    def charge(self, money: Money) -> Receipt: ...

class StripeGateway:                  # la seule implémentation, aujourd'hui
    def charge(self, money): ...      # un jour : Adyen, un fake en test

# PASSE-PLAT UserService.get_user → COUPÉ
#   ne protège rien : il relaie, point.
user = user_repo.find_by_id(id)       # on appelle le repo directement