How to Keep a Brag Document That Actually Gets You Promoted

Every engineer has been there. Performance review comes around. Your manager asks what you've accomplished in the past six months. And your mind goes blank.

You know you did important work. You shipped features, fixed bugs, helped teammates. But the specifics? Gone. Lost in the blur of daily standups and Jira tickets.

This is why you need a brag document.

What Is a Brag Document?

A brag document is a running record of your accomplishments, wins, and career growth. It's not for showing off—it's for showing up prepared when it matters most.

Unlike your manager's notes (if they even keep them), your brag document:

• Captures details while they're fresh
• Includes context only you know
• Follows you across teams and companies
• Gives you confidence in promotion conversations

The Problem with "I'll Remember"

You won't.

That critical bug you fixed in March? By October, you've forgotten the impact. The cross-team project you led? The details fade. The time you mentored a struggling teammate to success? You might not even think to mention it.

Our brains are terrible at retaining accomplishments. We remember stress and challenges. We forget routine wins.

This creates a bias toward recency. In performance reviews, the last month weighs more than the previous five—not because it was more important, but because it's what you remember.

What to Include in Your Brag Document

Impact and Outcomes

For each significant piece of work, capture:

• What was the problem or opportunity? Why did this work matter?
• What did you do specifically? Your contribution, not the team's.
• What was the measurable outcome? Revenue, users, time saved, bugs prevented.
• What skills did you demonstrate? Technical, leadership, communication.

Example: "Led migration from monolith to microservices for the payments team. Reduced deploy time from 45 minutes to 8 minutes. Coordinated with 3 teams over 4 months. Demonstrated system design and cross-team leadership."

Behaviors and Growth

Promotions aren't just about output—they're about how you work.

Document examples of:

• Mentoring or helping teammates
• Cross-team collaboration
• Taking initiative beyond your role
• Handling ambiguity or difficult situations
• Receiving and acting on feedback

Feedback and Recognition

Save the evidence:

• Positive Slack messages from teammates
• Recognition in team meetings
• Positive peer review comments
• Any written praise from stakeholders

This external validation strengthens your case far more than self-assessment alone.

How Often to Update

The right frequency is: before you forget.

For most engineers, this means weekly or bi-weekly. A quick 5-10 minute session to capture what you accomplished.

Don't overthink it. A rough note now is better than a polished summary you never write.

Set a recurring calendar reminder. Make it a habit, not a heroic effort.

A Simple Template

Here's a format that works:

## Week of [Date]

### Wins
- [What you accomplished and why it mattered]

### Impact
- [Metrics, outcomes, or tangible results]

### Behaviors
- [How you worked: collaboration, leadership, initiative]

### Feedback
- [Any recognition or positive comments received]

### Learning
- [Skills developed, lessons learned]

Adapt this to what makes sense for you. The best format is one you'll actually use.

Turning Your Brag Document Into Promotions

A brag document is raw material. Here's how to use it:

Before 1:1s with Your Manager

Review recent entries. Come with specific examples to discuss. Ask for feedback on the work you're highlighting.

During Performance Reviews

Your brag document becomes your self-review outline. You're not scrambling to remember—you're selecting from a curated list.

In Promotion Conversations

You can speak with specificity: "In the past year, I led three cross-team projects, mentored two junior engineers to independence, and reduced our deploy time by 80%."

This confidence changes how people perceive you.

The Compound Effect

The real power of a brag document emerges over time. After a year, you have a detailed record of growth. After two years, you can trace your trajectory from where you started to where you are now.

This longitudinal view is invaluable when:

• Negotiating compensation
• Interviewing for new roles
• Reflecting on your career direction
• Building confidence after setbacks

Make It Effortless

The biggest threat to your brag document is friction. Make updating it as easy as possible.

Some options:

• A simple text file you keep open
• A dedicated Notion page
• A recurring Slack reminder to yourself
• A weekly reflection ritual

Or let Seekersy handle it for you. Our weekly check-ins automatically capture your accomplishments, behaviors, and growth—building your career evidence without the manual work.

Automate Your Brag Document

Seekersy turns your weekly reflections into a comprehensive career record. Track your growth, document your wins, and build evidence that travels with you.

Start Tracking Your Wins