Como escrever um brag document
O que é
Um brag document é um documento único onde registas o teu trabalho à medida que acontece: o que entregaste, quem desbloqueaste, que decisões conduziste, o que aprendeste. A Julia Evans popularizou a ideia no artigo dela sobre brag documents, e tornou-se um conselho comum para engenheiros de todos os níveis.
Porque deves ter um
Seis meses de trabalho não cabem na tua memória. Quando chega a avaliação de desempenho ou o processo de promoção, lembras-te das últimas semanas e do grande lançamento, e o resto perdeu-se.
O teu manager vê ainda menos. Grande parte do trabalho sénior e staff nunca aparece num quadro de sprint: a revisão que desbloqueou outra equipa, o incidente que fechaste à noite, o documento de design que evitou uma reescrita. Se não o escreveres, ninguém o fará.
Também te ajuda a ti. Ler um mês de entradas mostra para onde foi realmente o teu tempo, e se foi para onde querias.
Como escrever o teu
- Um documento, o mais recente primeiro. Uma página na tua app de notas chega. Agrupa as entradas por mês ou por trimestre.
- Começa pelos teus objetivos. Duas ou três linhas no topo com o que procuras alcançar neste ciclo, para que cada entrada possa ser lida à luz delas.
- Uma linha por entrada. A data, o que fizeste e o impacto. "Entreguei a migração da faturação, que desbloqueou o lançamento de março" é melhor do que "trabalhei na faturação".
- Junta a prova. Um link para o pull request, o documento, a conversa ou o dashboard. Seis meses depois, é o link que torna a linha credível.
- Regista o trabalho invisível. Revisões que desbloquearam alguém, mentoria, incidentes, entrevistas, decisões que ajudaste a fechar.
- Atualiza-o todas as semanas. Quinze minutos na sexta à tarde, enquanto a semana ainda está fresca.
- Partilha-o antes das avaliações. Envia-o ao teu manager umas semanas antes do fecho do ciclo, para que possa usar as tuas palavras.
Um modelo
## Objetivos deste semestre - Entregar a migração da faturação - Tornar os turnos de prevenção mais calmos para a equipa de plataforma ## Outubro de 2026 - 2026-10-17: Entreguei a migração da faturação. Desbloqueou o lançamento de março. (link) - 2026-10-15: Revi a alteração de tentativas da Ana. A equipa dela conseguiu fazer deploy antes do congelamento. (link) - 2026-10-14: Enviei ao Leo o resumo do incidente que lhe prometi. O postmortem fechou na mesma semana. (link)
Como o Zebra o preenche por ti
O difícil num brag document são os quinze minutos semanais. O Zebra já tem o material, porque o teu dia é construído com ele.
Todas as manhãs, quando o Zebra prepara o teu dia, a tarefa principal é escolhida com um motivo de uma linha: o que desbloqueia ou que prazo cumpre. O Zebra guarda essa linha. Todas as noites, guarda as promessas que fizeste em reuniões e chats, com as palavras que disseste.
À sexta-feira, o resumo semanal verifica no teu gestor de tarefas quais dessas tarefas principais concluíste e que promessas cumpriste, e o teu Claude acrescenta uma linha por cada uma ao teu brag document, no Notion, no Google Drive ou onde estiverem as tuas notas. Nada por terminar entra, e podes editar cada linha.
Liga o Zebra ao Claude e o teu brag document começa a ser preenchido já esta sexta.