Un brag document è un elenco continuo di ciò che hai fatto al lavoro, tenuto da te, con parole tue, aggiornato mentre i dettagli sono freschi. Non è un curriculum e non è un aggiornamento di stato: un curriculum si scrive per estranei e comprime tutto, un aggiornamento riguarda questa settimana. Il brag document esiste perché, quando qualcuno chiede che cosa hai realizzato negli ultimi sei o dodici mesi, la risposta venga recuperata e non ricostruita.
Da dove viene il termine
L’espressione è stata resa popolare dalla programmatrice Julia Evans in un post del 2019, «Get your work recognized: write a brag document», con un argomento semplice: chi ti valuta non può ricordare il tuo lavoro nel dettaglio in cui lo ricordi tu, e pretenderlo non è ragionevole. Il documento colma quel divario senza dipendere dalla memoria altrui.
La pratica è più vecchia del nome — le valutazioni hanno sempre premiato chi conservava le prove — ma il nome ha contato, perché ha reso la pratica qualcosa che puoi consigliare a un collega senza che suoni come autopromozione.
Che cosa ci va dentro
Quasi tutti elencano solo le funzionalità rilasciate e poi si chiedono perché il documento sembri esile. Le categorie qui sotto sono quelle che saltano sistematicamente e sono di solito il materiale più forte in una conversazione di valutazione.
- Lavoro rilasciato, con date e un risultato misurabile per ciascuno.
- Lavoro che non era una consegna: revisioni di codice, gestione di incidenti, settimane di reperibilità, colloqui condotti, documentazione che nessuno aveva assegnato.
- Mentoring e sblocchi — chi hai aiutato, su che cosa, e che cosa è cambiato per quella persona dopo.
- Decisioni che hai influenzato, comprese quelle in cui il contributo era l’argomentazione e l’artefatto era di qualcun altro.
- Cose fallite, che cosa hai cambiato di conseguenza e che cosa faresti diversamente. È questa sezione a impedire che il documento si legga come pubblicità.
- Competenze e contesto acquisiti: un sistema di cui ora sei responsabile, un ambito su cui ora si può interpellare te.
Un esempio svolto
La differenza tra una voce utile e una inutile sta interamente nella specificità. Due versioni dello stesso semestre:
- Debole: «Migliorato la pipeline di import. Aiutato nell’inserimento dei nuovi. Contribuito alla roadmap.»
- Forte: «Riscritta la gestione dei tentativi in import (gen–feb). I fallimenti silenziosi sono passati da circa uno a settimana a zero nei due mesi successivi; ora compaiono nella dashboard della coda, quindi ops non li scopre più dalle segnalazioni dei clienti. PR 2214.»
- Forte: «Inseriti due ingegneri a marzo e aprile — scritta la guida di configurazione dell’ambiente che hanno usato entrambi; il tempo fino al primo commit è sceso da circa una settimana a due giorni.»
- Forte: «Argomentato contro il rilascio multiregione nella revisione di design di febbraio; l’abbiamo rimandato e rilasciato invece la correzione della coda. A giugno il rilascio è stato ridotto per gli stessi motivi.»
Perché i tempi delle valutazioni giocano contro di te
Una valutazione copre sei o dodici mesi. L’immagine più nitida di chi valuta copre le ultime settimane, perché l’attenzione funziona così per tutti, anche per i bravi responsabili. Il lavoro del secondo mese arriva alla conversazione già sbiadito, e il lavoro fatto da qualcuno che se n’è andato, su un progetto cancellato, potrebbe non arrivare affatto.
C’è un secondo problema, più meccanico: chi valuta cambia. Un responsabile arrivato ad aprile non può giudicare gennaio a memoria, solo dalle tracce — e le tracce esistenti sono ticket e voci di calendario, che sovrarappresentano le riunioni e il lavoro finito e sottorappresentano tutto ciò che era difficile.
Questa è un’osservazione su come funzionano le valutazioni, non un risultato di ricerca, e va trattata come tale. È però facile verificarla sulla tua ultima valutazione, che è l’unica verifica che qui conta.
Come riempirlo senza un altro rituale settimanale
Nessuno regge un secondo documento. La versione realistica è non scrivere nulla in più e comporre il brag document dal materiale che già produci: voci datate su che cosa è cambiato quel giorno, messaggi in cui hai spiegato una decisione e appunti presi dopo un incidente.
Funziona se la materia prima si recupera per descrizione invece che per posizione: chiedere «che cosa ho fatto sulla pipeline di import» e ottenere le sei voci che la menzionano, senza aver saputo a gennaio che sarebbero servite a dicembre. Comporre così un semestre è lavoro da venti minuti. Ricostruirlo dal calendario è un pomeriggio, ed è sbagliato.
Che cosa un brag document non farà
Non sostituisce il fatto che il lavoro sia visibile mentre accade. Un documento prodotto alla valutazione per spiegare sei mesi di contributo invisibile è una posizione più debole dell’averlo detto a marzo, e nessuna quantità di dettagli la salva.
Dipende anche dalla cultura. In alcune organizzazioni arrivare con un elenco scritto si legge come preparazione, in altre come lobbying. La versione che viaggia bene ovunque sono prove e non aggettivi: numeri, date e nomi, lasciando il giudizio a chi legge. E i numeri senza una base di partenza sono rumore: «ridotti gli errori del 60%» non significa nulla senza il valore iniziale, il periodo e il metodo di misura. Infine, niente di tutto questo sposta una fascia retributiva o un blocco delle assunzioni. Un brag document vince le discussioni che riguardano davvero le prove: sono meno di quanto sembri, ma non sono zero.
Tienilo in corso invece di scriverlo al momento della valutazione, e rendi ogni voce abbastanza specifica da poter essere verificata: che cosa è cambiato, quando, per chi e di quanto rispetto a quale base. Includi le categorie poco appariscenti — revisioni, reperibilità, mentoring, l’argomento vinto in una revisione di design: nessun altro le sta annotando.