Un brag document est une liste continue de ce que vous avez fait au travail, tenue par vous, dans vos mots, mise à jour pendant que les détails sont frais. Ce n’est ni un CV ni un point d’avancement : un CV s’écrit pour des inconnus et comprime tout, un point d’avancement porte sur cette semaine. Le brag document existe pour que la réponse à « qu’avez-vous accompli ces six ou douze derniers mois » soit retrouvée et non reconstruite.
D’où vient le terme
L’expression a été popularisée par la programmeuse Julia Evans dans un billet de 2019, « Get your work recognized: write a brag document », avec un argument simple : votre responsable ne peut pas se souvenir de votre travail dans le détail où vous vous en souvenez, et l’exiger n’est pas raisonnable. Le document comble cet écart sans dépendre de la mémoire d’autrui.
La pratique précède le nom — les entretiens ont toujours récompensé ceux qui gardaient des traces —, mais la nomination a compté : elle en a fait quelque chose qu’on peut conseiller à un collègue sans que cela sonne comme de l’autopromotion.
Ce qu’on y met
La plupart ne listent que les fonctionnalités livrées, puis s’étonnent que le document paraisse maigre. Les catégories ci-dessous sont celles qui sautent systématiquement et constituent d’ordinaire le matériau le plus fort dans un entretien.
- Le travail livré, avec des dates et un résultat mesurable pour chacun.
- Le travail qui n’était pas un livrable : revues de code, gestion d’incidents, semaines d’astreinte, entretiens menés, documentation que personne n’avait demandée.
- Le mentorat et le déblocage — qui vous avez aidé, sur quoi, et ce qui a changé pour cette personne ensuite.
- Les décisions que vous avez influencées, y compris celles où l’argument était votre contribution et l’artefact celui d’un autre.
- Ce qui a échoué, ce que vous avez changé en conséquence et ce que vous feriez autrement. C’est cette section qui empêche le document de se lire comme une publicité.
- Les compétences et le contexte acquis : un système dont vous êtes désormais responsable, un domaine sur lequel on peut désormais vous interroger.
Un exemple travaillé
La différence entre une entrée utile et une entrée inutile tient entièrement à la précision. Deux versions du même semestre :
- Faible : « Amélioré le pipeline d’import. Aidé à intégrer de nouveaux arrivants. Contribué à la feuille de route. »
- Fort : « Réécrit la gestion des réessais à l’import (janv.–févr.). Les échecs silencieux sont passés d’environ un par semaine à zéro sur les deux mois suivants ; ils remontent maintenant dans le tableau de bord de la file, donc les ops ne les découvrent plus via les clients. PR 2214. »
- Fort : « Intégré deux ingénieurs en mars et avril — écrit le guide de configuration de l’environnement qu’ils ont tous deux utilisé, ce qui a ramené le délai jusqu’au premier commit d’environ une semaine à deux jours. »
- Fort : « Argumenté contre le déploiement multirégion en revue de conception en février ; nous l’avons repoussé et livré le correctif de la file à la place. Le déploiement a été réduit en juin pour les mêmes raisons. »
Pourquoi le calendrier des entretiens joue contre vous
Un entretien couvre six ou douze mois. L’image la plus nette qu’en a l’évaluateur couvre les dernières semaines, parce que l’attention fonctionne ainsi chez tout le monde, y compris chez les bons managers. Le travail du deuxième mois arrive déjà délavé, et le travail réalisé par quelqu’un qui est parti, sur un projet annulé, peut ne pas arriver du tout.
Il y a un second problème, plus mécanique : les évaluateurs changent. Un responsable arrivé en avril ne peut pas juger janvier de mémoire, seulement d’après les traces — et les traces existantes sont des tickets et des entrées d’agenda, qui surreprésentent les réunions et le travail fini et sous-représentent tout ce qui était difficile.
C’est une observation sur le fonctionnement des entretiens, pas un résultat de recherche, et il faut la traiter comme telle. Mais elle se vérifie facilement sur votre propre dernier entretien, et c’est la seule vérification qui compte ici.
Comment le remplir sans un rituel hebdomadaire de plus
Personne ne tient un second document. La version réaliste consiste à ne rien écrire de plus et à assembler le brag document à partir de matériaux que vous produisez déjà : des entrées datées sur ce qui a changé ce jour-là, des messages où vous expliquiez une décision, et les notes prises après un incident.
Cela fonctionne si la matière brute se récupère par description plutôt que par emplacement — demander « qu’ai-je fait sur le pipeline d’import » et obtenir les six entrées qui le mentionnent, sans avoir su en janvier qu’elles compteraient en décembre. Assembler un semestre ainsi prend vingt minutes. Le reconstruire depuis l’agenda prend un après-midi, et il est faux.
Ce qu’un brag document ne fera pas
Il ne remplace pas la visibilité du travail pendant qu’il se fait. Un document produit au moment de l’entretien pour expliquer six mois de contribution invisible est une position plus faible que de l’avoir dit en mars, et aucun luxe de détail ne la sauve.
Il dépend aussi de la culture. Dans certaines organisations, arriver avec un relevé écrit se lit comme de la préparation ; dans d’autres, comme du lobbying. La version qui passe partout, ce sont des preuves plutôt que des adjectifs — chiffres, dates et noms, en laissant le jugement au lecteur. Et des chiffres sans base de comparaison sont du bruit : « réduit les erreurs de 60 % » ne veut rien dire sans le niveau de départ, la période et la méthode de mesure. Enfin, rien de tout cela ne déplace une grille salariale ni un gel des embauches. Un brag document gagne les débats qui portent vraiment sur des preuves — moins nombreux qu’on ne le croit, mais pas inexistants.
Tenez-le en continu plutôt que de l’écrire au moment de l’entretien, et rendez chaque entrée assez précise pour être vérifiée : ce qui a changé, quand, pour qui, et de combien par rapport à quelle base. Incluez les catégories ingrates — revues, astreintes, mentorat, l’argument gagné en revue de conception : personne d’autre ne les note.