Comment rédiger un brag document
Ce que c’est
Un brag document est un document unique où vous notez votre travail au fil de l’eau : ce que vous avez livré, qui vous avez débloqué, quelles décisions vous avez portées, ce que vous avez appris. Julia Evans a popularisé l’idée dans son article sur les brag documents, et c’est devenu un conseil classique pour les ingénieurs de tous niveaux.
Pourquoi en tenir un
Six mois de travail ne tiennent pas dans votre mémoire. Quand arrive l’entretien annuel ou le dossier de promotion, vous vous souvenez des dernières semaines et du grand lancement, et le reste a disparu.
Votre manager en voit encore moins. Une grande partie du travail senior et staff n’apparaît jamais dans un tableau de sprint : la revue qui a débloqué une autre équipe, l’incident clos en pleine nuit, le document de conception qui a évité une réécriture. Si vous ne l’écrivez pas, personne ne le fera.
Il vous aide aussi. Relire un mois d’entrées montre où votre temps est vraiment passé, et s’il est passé là où vous le vouliez.
Comment rédiger le vôtre
- Un seul document, le plus récent en haut. Une page dans votre application de notes suffit. Regroupez les entrées par mois ou par trimestre.
- Commencez par vos objectifs. Deux ou trois lignes en haut sur ce que vous visez ce cycle-ci, pour lire chaque entrée à leur lumière.
- Une ligne par entrée. La date, ce que vous avez fait et l’impact. "Livré la migration de la facturation, qui a débloqué la sortie de mars" vaut mieux que "travaillé sur la facturation".
- Ajoutez la preuve. Un lien vers la pull request, le document, le fil ou le tableau de bord. Six mois plus tard, c’est le lien qui rend la ligne crédible.
- Notez le travail invisible. Les revues qui ont débloqué quelqu’un, le mentorat, les incidents, les entretiens, les décisions que vous avez aidé à trancher.
- Mettez-le à jour chaque semaine. Quinze minutes le vendredi après-midi, tant que la semaine est encore fraîche.
- Partagez-le avant les entretiens. Envoyez-le à votre manager quelques semaines avant la fin du cycle, pour qu’il ou elle puisse reprendre vos mots.
Un modèle
## Objectifs de ce semestre - Livrer la migration de la facturation - Rendre les astreintes plus calmes pour l’équipe plateforme ## Octobre 2026 - 2026-10-17 : Livré la migration de la facturation. A débloqué la sortie de mars. (lien) - 2026-10-15 : Relu le changement de relances d’Ana. Son équipe a pu déployer avant le gel. (lien) - 2026-10-14 : Envoyé à Leo le résumé d’incident promis. Le postmortem a été clos la même semaine. (lien)
Comment Zebra le remplit pour vous
Le plus dur dans un brag document, ce sont les quinze minutes hebdomadaires. Zebra a déjà la matière, puisque votre journée est construite avec.
Chaque matin, quand Zebra prépare votre journée, la tâche principale est choisie avec une raison d’une ligne : ce qu’elle débloque ou quelle échéance elle respecte. Zebra garde cette ligne. Chaque soir, il garde les promesses faites en réunion et par message, avec les mots que vous avez dits.
Le vendredi, le résumé hebdomadaire vérifie dans votre gestionnaire de tâches lesquelles de ces tâches principales vous avez terminées et quelles promesses vous avez tenues, et votre Claude ajoute une ligne pour chacune à votre brag document, dans Notion, Google Drive ou là où vivent vos notes. Rien d’inachevé n’y entre, et vous pouvez modifier chaque ligne.
Connectez Zebra à Claude et votre brag document commence à se remplir dès ce vendredi.