What is a brag document?
A private, running record of your accomplishments and their impact — kept so you can advocate for yourself at reviews and promotions.
A brag document is a private, running record of your accomplishments and the impact they had, kept so you can advocate for yourself at reviews and promotions. It works because memory fails and managers forget — and it fails when keeping it up becomes a chore.
Where it came from
The engineer Julia Evans popularized the term, describing the review-season blank page and the simple antidote: write things down as you go instead of reconstructing a year from your brain. Some call it a "hype doc" or a "work log"; the idea is identical.
Why it works
A brag document quietly solves three problems at once:
- Your manager can't advocate for what they can't remember — and "their work is great" doesn't pass a committee
- It survives manager changes: a new manager months before your review can read your year and understand it
- It fights imposter syndrome with evidence — proof you did add value, in your own words
- The myth that good work speaks for itself — it doesn't travel without you
- The once-a-year scramble through old emails and tickets
- Relying on memory, which recency bias quietly rewrites in your manager's favor, not yours
Why it fails
The number-one reason brag docs die is upkeep. A manual document competes with your real work and loses; within a quarter it's stale, and you're back to reconstructing. The fix isn't more discipline — it's removing the friction so capture costs seconds, not a weekly ritual.
How to prioritize what to record
- Impact over activity — what changed, not what you did.
- Scope you stretched into — work bigger than your level usually does.
- Glue work — quietly essential, almost never logged elsewhere.
- Recognition and growth — praise received, skills gained.
How Workfied helps here
Workfied is the brag document that maintains itself, from a ten-second note — so "what is a brag document" stops being a question you answer the hard way every December. Built for you, never your company. Encrypted in transit and at rest.
Evidence
Where it came from
The brag-doc practice was named to help people get under-credited work recognized at review time.
Source: Julia Evans, jvns.ca
Why it works
Your manager can't advocate for what they can't remember — and they have to convince other people too.
Workfied house view
Include vs cut
It's yours. Record freely; share only what you choose. The value is in the keeping, not the showing.
Workfied house view