Como escrever um brag document
O que é
Um brag document é um documento único onde você anota seu trabalho conforme ele acontece: o que entregou, quem destravou, quais decisões conduziu, o que aprendeu. A Julia Evans popularizou a ideia no post dela sobre brag documents, e virou conselho padrão para engenheiros de todos os níveis.
Por que você deveria ter um
Seis meses de trabalho não cabem na sua memória. Quando chega a avaliação de desempenho ou o pacote de promoção, você lembra das últimas semanas e do grande lançamento, e o resto sumiu.
Seu gestor vê menos ainda. Grande parte do trabalho sênior e staff nunca aparece num quadro de sprint: o review que destravou outro time, o incidente que você fechou de madrugada, o design doc que evitou uma reescrita. Se você não anotar, ninguém vai anotar.
Ele também ajuda você. Ler um mês de entradas mostra para onde seu tempo realmente foi, e se foi para onde você queria.
Como escrever o seu
- Um documento, o mais recente primeiro. Uma página no seu app de notas basta. Agrupe as entradas por mês ou por trimestre.
- Comece pelas suas metas. Duas ou três linhas no topo com o que você busca neste ciclo, para ler cada entrada à luz delas.
- Uma linha por entrada. A data, o que você fez e o impacto. "Entreguei a migração de billing, que destravou o lançamento de março" é melhor que "trabalhei em billing".
- Coloque a evidência. Um link para o pull request, o doc, a thread ou o dashboard. Seis meses depois, é o link que dá credibilidade à linha.
- Anote o trabalho invisível. Reviews que destravaram alguém, mentoria, incidentes, entrevistas, decisões que você ajudou a fechar.
- Atualize toda semana. Quinze minutos na sexta à tarde, enquanto a semana ainda está fresca.
- Compartilhe antes das avaliações. Mande para seu gestor algumas semanas antes do fechamento do ciclo, para que ele possa usar suas palavras.
Um modelo
## Metas deste semestre - Entregar a migração de billing - Deixar o plantão mais tranquilo para o time de plataforma ## Outubro de 2026 - 2026-10-17: Entreguei a migração de billing. Destravou o lançamento de março. (link) - 2026-10-15: Revisei a mudança de retry da Ana. O time dela conseguiu fazer deploy antes do congelamento. (link) - 2026-10-14: Mandei para o Leo o resumo do incidente que eu tinha prometido. O postmortem fechou na mesma semana. (link)
Como o Zebra preenche para você
A parte difícil de um brag document são os quinze minutos semanais. O Zebra já tem o material, porque seu dia é montado com ele.
Toda manhã, quando o Zebra prepara seu dia, a tarefa principal é escolhida com um motivo de uma linha: o que ela destrava ou qual prazo cumpre. O Zebra guarda essa linha. Toda noite, guarda as promessas que você fez em reuniões e chats, com as palavras que disse.
Na sexta, o resumo semanal confere no seu gerenciador de tarefas quais dessas tarefas principais você concluiu e quais promessas cumpriu, e seu Claude adiciona uma linha para cada uma no seu brag document, no Notion, no Google Drive ou onde suas notas ficam. Nada que não terminou entra, e você pode editar cada linha.
Conecte o Zebra ao Claude e seu brag document começa a ser preenchido nesta sexta.