Cómo escribir un brag document
Qué es
Un brag document es un único documento donde anotas tu trabajo a medida que sucede: lo que entregaste, a quién desbloqueaste, qué decisiones impulsaste, qué aprendiste. Julia Evans popularizó la idea en su artículo sobre brag documents, y se volvió un consejo estándar para ingenieros de todos los niveles.
Por qué deberías tener uno
Seis meses de trabajo no caben en tu memoria. Cuando llega la evaluación de desempeño o el paquete de promoción, recuerdas las últimas semanas y el gran lanzamiento, y el resto se perdió.
Tu manager ve todavía menos. Gran parte del trabajo senior y staff nunca aparece en un tablero de sprint: la revisión que desbloqueó a otro equipo, el incidente que cerraste de noche, el documento de diseño que evitó una reescritura. Si no lo anotas, nadie lo hará.
También te ayuda a ti. Leer un mes de entradas muestra a dónde se fue realmente tu tiempo, y si se fue a donde querías.
Cómo escribir el tuyo
- Un documento, lo más reciente primero. Una página en tu app de notas basta. Agrupa las entradas por mes o por trimestre.
- Empieza con tus objetivos. Dos o tres líneas arriba con lo que persigues en este ciclo, para leer cada entrada frente a ellas.
- Una línea por entrada. La fecha, lo que hiciste y el impacto. "Entregué la migración de facturación, que desbloqueó el lanzamiento de marzo" es mejor que "trabajé en facturación".
- Agrega la evidencia. Un enlace al pull request, al documento, al hilo o al dashboard. Seis meses después, el enlace es lo que hace creíble la línea.
- Anota el trabajo invisible. Revisiones que desbloquearon a alguien, mentoría, incidentes, entrevistas, decisiones que ayudaste a cerrar.
- Actualízalo cada semana. Quince minutos el viernes por la tarde, mientras la semana sigue fresca.
- Compártelo antes de las evaluaciones. Envíaselo a tu manager unas semanas antes del cierre del ciclo, para que pueda usar tus palabras.
Una plantilla
## Objetivos de este semestre - Entregar la migración de facturación - Hacer las guardias más tranquilas para el equipo de plataforma ## Octubre de 2026 - 2026-10-17: Entregué la migración de facturación. Desbloqueó el lanzamiento de marzo. (enlace) - 2026-10-15: Revisé el cambio de reintentos de Ana. Su equipo pudo desplegar antes del congelamiento. (enlace) - 2026-10-14: Envié a Leo el resumen del incidente que le prometí. El postmortem se cerró esa misma semana. (enlace)
Cómo Zebra lo completa por ti
Lo difícil de un brag document son los quince minutos semanales. Zebra ya tiene el material, porque tu día se arma con él.
Cada mañana, cuando Zebra prepara tu día, la tarea principal se elige con un motivo de una línea: qué desbloquea o qué plazo cumple. Zebra guarda esa línea. Cada tarde, guarda las promesas que hiciste en reuniones y chats, con las palabras que dijiste.
El viernes, el resumen semanal revisa en tu gestor de tareas cuáles de esas tareas principales completaste y qué promesas cumpliste, y tu Claude agrega una línea por cada una a tu brag document, en Notion, Google Drive o donde vivan tus notas. Nada sin terminar entra, y puedes editar cada línea.
Conecta Zebra a Claude y tu brag document empieza a llenarse este viernes.