How to keep a brag document
And how to actually stick with it — a practical guide
Here's the uncomfortable truth about performance reviews: the person who gets promoted isn't always the one who did the best work. It's the one who can show it. When review season arrives, your manager is running on memory — and memory is heavily weighted toward the last few weeks. Nine months of good work quietly evaporates.
A brag document is the fix. It's an ongoing record of what you did, why it mattered, and what came of it — kept while it's fresh, so you're never reconstructing a year from calendars and old messages the night before your self-review.
What goes in it
One formula works for every role: what you did → why it mattered → the result.
- Projects you shipped and the outcome (numbers if you have them)
- Times you unblocked or helped someone else
- Decisions you drove and their impact
- Skills you picked up and where you applied them
- The unglamorous work that kept things running
A template you can copy
Group by quarter, then by theme:
- Delivery — what you shipped, with impact.
- Collaboration — who you helped, cross-team work, mentoring.
- Growth — what you learned or leveled up.
Copy this into any doc and start filling it in today:
Two or three sentences per entry is plenty. Detail is what makes an entry compelling six months later — "improved the API" is forgettable; "cut p99 latency and cleared the auth backlog so the mobile team could ship on time" is a promotion bullet. When it's time to write the review itself, start from these self-review examples; for interviews, frame the big wins as STAR stories.
The move most people miss: share it
A brag document you keep secret only helps your memory. The real power move is sending it to your manager a week before they write about you — most managers write reviews from whatever they can recall, and they'd much rather work from your record than their memory. You're not bragging; you're doing their prep for them. The same doc hands your manager evidence when they defend your rating in calibration, and it turns 1:1s from status updates into career conversations — skim it together once a month and the promotion topic raises itself.
The hard part isn't writing it. It's keeping it.
Every brag-doc guide tells you to update it every Friday. Almost no one does. The doc goes stale by week two, and you're back to reconstructing your year from memory. The advice is right; the discipline is the problem.
Make it automatic
Nisshi is a work journal built around this exact problem. You jot a few lines about your day — or let completed tasks and meetings fill it in — and Nisshi does the rest: it turns your entries into weekly and sprint summaries on its own, shapes them into impact stories, and drafts a full self-review for any date range when you need it. You keep the habit small; the brag document builds itself.
And because your work record is nobody's business but yours, it all stays on your Mac — on-device, no accounts, no cloud.