Pourquoi chaque affirmation de ce site a un reçu
Un portfolio est une liste d’affirmations que personne ne peut vérifier, alors le lecteur les décote toutes. Ici, chaque chiffre ouvre sa source, sa méthode et la solidité de sa preuve. Y compris les plus faibles.
Je passe mes journées avec des agents de code, et la première règle que j’ai apprise, c’est qu’un agent juge mal son propre travail : son résumé est une preuve faible. J’ai donc arrêté d’accepter des résumés et commencé à exiger des preuves. Il serait curieux de vous demander ensuite de me croire sur parole pour tout ce qui est écrit ici.
Le problème des portfolios
Un portfolio, un CV, une étude de cas : ce sont toujours des listes d’affirmations. « A mené une transformation. » « A réduit la latence de 90 %. » « Livré en six semaines. » Le lecteur n’a aucun moyen de vérifier, alors un lecteur attentif fait la seule chose raisonnable : il décote tout un peu. Les affirmations honnêtes paient pour les gonflées.
L’IA aggrave les choses au lieu de les arranger. N’importe qui peut maintenant produire une étude de cas léchée en dix minutes. Le soin ne signale plus l’effort, et des chiffres assurés ne signalent plus une mesure.
Ce qui porte encore de l’information, c’est la trace derrière une affirmation : d’où vient le chiffre, comment il a été obtenu, quand il a été vérifié, et si vous pourriez le vérifier vous-même.
Ce qu’est un reçu
Chaque affirmation de ce site qui pourrait être fausse porte une petite étiquette. Ouvrez-la, et vous trouvez à chaque fois les six mêmes choses :
- L’affirmation, en une ou deux phrases, avec son chiffre.
- La source : un historique git, une suite de tests, un journal d’exécution, un document, un article public.
- La méthode, quand elle compte : la commande, le filtre, ce qui a été compté et ce qui ne l’a pas été.
- Une référence : des commits ou des fichiers, pour mémoire.
- La date de vérification. Les chiffres vieillissent. Un comptage du mois dernier est signalé comme tel.
- Qui peut voir la preuve. Tout le monde, ou sur demande.
Et un champ de plus, celui auquel je tiens le plus : la solidité.
Trois niveaux de solidité, affichés honnêtement
Toutes les preuves ne se valent pas, et faire comme si était justement le problème que j’essaie d’éviter. Chaque reçu dit donc de quel type il est.
| Solidité | Ce que ça veut dire | Exemple |
|---|---|---|
| Mesuré | Un chiffre que vous pouvez recompter ou rejouer avec la méthode indiquée | un nombre de commits, un résultat de tests, un journal de coûts |
| Artefact | Un fichier, un commit ou une capture que vous pouvez ouvrir | un document de conception, une pull request, une capture d’écran |
| Déclaré | Ma parole, tirée de mon CV | vingt ans de postes , la transformation du système d’information d’une aciérie |
Les reçus déclarés restent sur le site. Ma carrière d’avant 2023 n’a laissé aucun historique git que je puisse montrer, et inventer une preuve d’apparence plus solide irait contre le principe même. Ils sont marqués pour ce qu’ils sont, et des références sont disponibles sur demande.
La plupart des preuves sont privées, et ce n’est pas grave
Une grande partie du travail derrière ce site vit dans des dépôts privés : des outils que j’ai construits pour moi, des produits construits pour de vraies personnes qui n’ont pas demandé à figurer sur un site web. Un reçu ne prétend pas le contraire. Il dit « dépôt privé, visite sur demande ».
Ça vaut quand même quelque chose. Une affirmation avec une source nommée, une méthode et une date, c’est une affirmation dont on peut me demander des comptes en entretien. Vous pouvez me demander d’ouvrir le dépôt et de lancer la commande. Si je ne peux pas, vous avez appris quelque chose d’important sur moi.
Le site se vérifie lui-même
Les reçus ne sont pas une décoration tapée à la main à côté du texte. Ils vivent à part, dans des fichiers de données, chacun avec son identifiant, et les pages les citent par cet identifiant. Un identifiant inconnu fait échouer le build . Une affirmation ne peut pas perdre sa source sans bruit au détour d’une modification : le site ne se déploierait pas.
La règle pour en ajouter un est celle que je donne aux agents : rien n’entre sans une source que j’ai lue. Un fait sans source est coupé, aussi bien qu’il sonne.
L’appliquer à votre propre travail
Pas besoin d’un site web pour ça. La même discipline marche pour un CV, un dossier de promotion ou une revue de projet.
- Écrivez chaque affirmation en une phrase, avec un chiffre. « Amélioration des performances » n’est pas une affirmation. « Temps de réponse p90 ramené de 900 à 300 ms » en est une.
- Mettez la source et la méthode juste à côté. La requête, le tableau de bord, la plage de commits. Si vous ne pouvez en nommer aucune, vous vous souvenez, vous ne mesurez pas.
- Notez-la honnêtement. Mesuré, artefact ou déclaré. Le lecteur fait davantage confiance à un document dont une partie est visiblement plus faible.
- Datez-la. Puis revérifiez les chiffres que vous réutilisez.
- Coupez ce que vous ne pouvez pas sourcer. Ça fait mal, et tout ce qui reste en sort plus solide.
- Rendez la vérification mécanique. Un script, une étape de build, un relecteur qui demande « d’où ça vient ? » pour chaque chiffre. Tout ce qui ne compte pas sur votre mémoire pour rester prudent.
Le but n’est pas d’avoir l’air rigoureux. C’est que chaque phrase en soit une que je défends volontiers, preuves sur la table.