Un brag document es una lista continua de lo que has hecho en el trabajo, llevada por ti, con tus palabras, actualizada mientras los detalles siguen frescos. No es un currículum ni un informe de estado: un currículum se escribe para desconocidos y lo comprime todo, y un informe de estado va sobre esta semana. El brag document existe para que, cuando alguien pregunte qué lograste en los últimos seis o doce meses, la respuesta se recupere en vez de reconstruirse.
De dónde viene el término
La expresión la popularizó la programadora Julia Evans en una entrada de 2019, «Get your work recognized: write a brag document», con un argumento sencillo: tu responsable no puede recordar tu trabajo con el detalle con que lo recuerdas tú, y esperar eso no es razonable. El documento cierra esa distancia sin depender de la memoria ajena.
La práctica es más antigua que el nombre —las evaluaciones siempre han premiado a quien guardaba pruebas—, pero nombrarla importó, porque la convirtió en algo que puedes recomendarle a un compañero sin que suene a autobombo.
Qué se incluye
Casi todo el mundo enumera solo funcionalidades entregadas y luego se pregunta por qué el documento parece flojo. Las categorías de abajo son las que se caen sistemáticamente y suelen ser el material más fuerte en una conversación de evaluación.
- Trabajo entregado, con fechas y un resultado medible para cada uno.
- Trabajo que no era un entregable: revisiones de código, gestión de incidencias, semanas de guardia, entrevistas que condujiste, documentación que nadie encargó.
- Mentoría y desbloqueos: a quién ayudaste, en qué y qué cambió para esa persona después.
- Decisiones en las que influiste, incluidas aquellas en las que tu aportación fue el argumento y el artefacto era de otra persona.
- Cosas que salieron mal, qué cambiaste a raíz de ello y qué harías distinto. Esta sección es la que impide que el documento se lea como publicidad.
- Capacidades y contexto que adquiriste: un sistema del que ahora te ocupas, un ámbito por el que ahora se puede preguntar a ti.
Un ejemplo resuelto
La diferencia entre una entrada útil y una inútil está por completo en la concreción. Dos versiones del mismo semestre:
- Flojo: «Mejoré la canalización de importación. Ayudé a incorporar a gente nueva. Contribuí a la hoja de ruta.»
- Fuerte: «Reescribí el manejo de reintentos en la importación (ene-feb). Los fallos silenciosos pasaron de aproximadamente uno por semana a cero en los dos meses siguientes; ahora aparecen en el panel de la cola, así que ops ya no se entera por avisos de clientes. PR 2214.»
- Fuerte: «Incorporé a dos ingenieros en marzo y abril: escribí la guía de configuración del entorno que usaron ambos, con lo que el tiempo hasta el primer commit bajó de una semana a dos días.»
- Fuerte: «Argumenté en contra del despliegue multirregión en la revisión de diseño de febrero; lo aplazamos y entregamos en su lugar el arreglo de la cola. En junio el despliegue se recortó por los mismos motivos.»
Por qué los plazos de las evaluaciones juegan en tu contra
Una evaluación cubre seis o doce meses. La imagen más nítida que tiene quien evalúa cubre las últimas semanas, porque así funciona la atención en todo el mundo, también en los buenos responsables. El trabajo del segundo mes llega ya descolorido a la conversación, y el trabajo hecho por alguien que se fue, en un proyecto que se canceló, puede no llegar en absoluto.
Hay un segundo problema, más mecánico: quien evalúa cambia. Un responsable que llegó en abril no puede juzgar enero de memoria, solo por los rastros, y los rastros que existen son tickets y entradas de calendario, que sobrerrepresentan las reuniones y el trabajo terminado y subrepresentan todo lo difícil.
Esto es una observación sobre cómo funcionan las evaluaciones, no un hallazgo de investigación, y conviene tratarlo así. Pero es fácil de comprobar con tu propia última evaluación, que es la única comprobación que importa aquí.
Cómo llenarlo sin otro ritual semanal
Nadie sostiene un segundo documento. La versión realista es no escribir nada adicional y montar el brag document con material que ya produces: entradas fechadas sobre qué cambió ese día, mensajes en los que explicaste una decisión y las notas que tomaste tras una incidencia.
Eso funciona si la materia prima se recupera por descripción en lugar de por ubicación: preguntar «qué hice en la canalización de importación» y obtener las seis entradas que la mencionan, sin haber sabido en enero que importarían en diciembre. Montar medio año así es trabajo de veinte minutos. Reconstruirlo desde el calendario es una tarde, y sale mal.
Lo que un brag document no hará
No sustituye que el trabajo se vea mientras ocurre. Un documento presentado en la evaluación para explicar seis meses de aportación invisible es una posición más débil que haberlo dicho en marzo, y ningún nivel de detalle la rescata.
También depende de la cultura. En algunas organizaciones llegar con un registro escrito se lee como preparación; en otras, como presión. La versión que funciona en todas partes son pruebas en lugar de adjetivos: números, fechas y nombres, dejando el juicio a quien lee. Y los números sin una base son ruido: «reduje los errores un 60 %» no significa nada sin el punto de partida, el periodo y el método de medida. Por último, nada de esto mueve una banda salarial ni un congelamiento de contrataciones. Un brag document gana las discusiones que de verdad van sobre pruebas, que son menos de las que parece, pero no ninguna.
Llévalo de forma continua en vez de escribirlo el día de la evaluación, y haz cada entrada lo bastante concreta como para comprobarse: qué cambió, cuándo, para quién y cuánto respecto a qué base. Incluye las categorías poco vistosas —revisiones, guardias, mentoría, el argumento ganado en una revisión de diseño—: nadie más las está anotando.