How to Keep a Brag Document Before Review Season Arrives

Review season has a predictable failure mode. You sit down to write your self review, try to remember what you did since January, and come up with the last six weeks plus one big project from the spring. Everything in between, the bug you quietly fixed, the onboarding doc you wrote, the client you saved, is gone.

A brag document fixes that. The term was popularized by Julia Evans in her post Get your work recognized: write a brag document, and the idea is simple: keep a running record of your work and why it mattered, so that when you need it, the evidence is already written.

Start It Today, Even Late In The Year

If it is October and you have nothing, spend thirty minutes reconstructing the year from sources you already have:

• Your calendar, month by month.
• Sent email and chat messages, searched for “shipped”, “launched”, “fixed”, “thanks”.
• Closed tickets or merged changes.
• Documents you created or heavily edited.

You will not recover everything. You will recover far more than memory alone, and from now on you can add as you go.

Record The Impact, Not Just The Task

A list of tasks reads like a job description. What makes a brag document useful is the “so what”.

Before:

Rewrote the onboarding guide.

After:

Rewrote the customer onboarding guide in March. New-customer support tickets in their first month dropped from about 40 to about 15 over the next quarter, and the sales team now sends it with every contract.

If you do not know the impact yet, write the task and a note to check later. Many results only become visible months after the work.

Include The Invisible Work

The work most likely to be forgotten, by you and by your manager, is the work that prevented problems: mentoring a new hire, reviewing other people’s work, writing the runbook nobody asked for, calming a difficult client. Write it down with the same care. It often counts for more in promotion discussions than another shipped feature, because it shows you operating at the next level.

Keep It Easy To Update

The format matters less than the habit. A single document with a heading per month works. So does a running note with dated entries. Pick something you can add to in under two minutes, and put a recurring reminder in your calendar, for example Friday afternoon.

A useful entry has four parts:

1. What you did.
2. When.
3. What changed because of it, with numbers if you have them.
4. Who noticed, such as a thank you message you can link.

Turn It Into Your Review

When the review form arrives, your brag document becomes the raw material. Group entries by the categories your review uses (impact, collaboration, growth), pick the strongest three or four in each, and write them up. How to write a performance self review covers that step in detail.

It also helps with other conversations: a written request for a promotion, a raise discussion, or simply a one to one where your manager asks what you have been working on. Sharing a short version with your manager every quarter is one of the easiest ways to make sure your work is visible before decisions are made.

A Context For Turning Notes Into Evidence

A Wrivio Context for brag document entries could say:

Rewrite these work notes as brag document entries. Each entry: what I did, when, and the result, in two sentences at most. Use plain, factual language without superlatives. Keep every number, date, project name, and person’s name exactly as written. Where no result is given, add “(impact: to check)” rather than inventing one.

Press Ctrl+Shift+Space, paste a week of rough notes, and review the diff. The “to check” markers are the useful part: they are the follow-ups that turn a task list into evidence.

Common Questions

What is a brag document?

A brag document is a running record of your work and its impact, kept so you can write reviews, promotion cases, and updates from evidence rather than memory. It is usually private, though many people share a version with their manager.

How often should I update a brag document?

Weekly is ideal, and it takes a few minutes. A recurring calendar reminder on Friday afternoons is the easiest way to keep the habit.

Is it arrogant to keep a brag document?

No. It is a factual record of what you did and why it mattered. Managers often lack visibility into their team’s work, and a clear record helps them advocate for you.

What if I cannot measure the impact of my work?

Describe the effect in concrete terms instead, such as who used it, what it replaced, or what problem stopped happening. A specific qualitative result is still much better than a task description.

Download Wrivio for Windows to turn a week of scrappy work notes into clear brag document entries.