Promotion Preparation

This skill provides frameworks for building compelling promotion cases, maintaining brag documents, tracking accomplishments, and effectively advocating for your career advancement.

Keywords

promotion, brag document, promotion case, self-advocacy, wins, accomplishments, impact, career advancement, tracking wins, promotion document, manager alignment, performance review, evidence-based promotion

When to Use This Skill

• Building a promotion case document

• Starting or maintaining a brag document

• Tracking and categorizing accomplishments

• Preparing for performance reviews

• Understanding what managers look for

• Learning to advocate for yourself

• Documenting impact and contributions

Core Principle: You Own Your Promotion

Critical insight: Promotions are not handed out - they are earned and advocated for.

Your manager:

• Cannot remember all your accomplishments

• Has limited time to build your case

• Needs your help to advocate for you

• Wants you to succeed but needs evidence

Your responsibility:

• Track your own wins consistently

• Build your promotion case proactively

• Communicate impact clearly

• Align with manager on expectations

• Make it easy for your manager to promote you

The Promotion Case Document

A promotion case document is your comprehensive argument for advancement. It serves multiple purposes:

• Provides evidence for promotion discussions

• Helps your manager advocate for you

• Forces you to articulate your impact

• Identifies gaps you can address

Three-Section Structure

1. Accomplishments & Impact (What You've Done)

Document specific achievements with measurable outcomes:

• Projects delivered and their business impact

• Problems solved and value created

• Technical contributions and innovations

• Process improvements and efficiency gains

2. Growth & Learning (How You've Developed)

Show trajectory and development:

• Skills acquired or deepened

• Challenges overcome

• Feedback incorporated

• Areas of improvement demonstrated

3. Future Focus (What You'll Do Next)

Demonstrate readiness for next level:

• Goals aligned to next-level expectations

• Larger scope you're ready to take on

• Development areas you're addressing

• Vision for your expanded role

Brag Document Fundamentals

A brag document (also called "work log" or "wins journal") is your ongoing record of accomplishments.

Why Keep a Brag Document?

• Memory is unreliable: You forget 80% of what you did by review time

• Recency bias: Recent work overshadows earlier achievements

• Cumulative impact: Small wins add up to significant patterns

• Confidence building: Reviewing wins combats imposter syndrome

• Interview prep: Ready-made STAR stories for future opportunities

Cadence

Frequency Activity

Weekly Quick bullet points of wins (5-10 min)

Monthly Review and expand bullets, add context

Quarterly Synthesize themes, identify patterns

Annually Build promotion case from accumulated evidence

What to Capture

For each win, capture:

• What: The specific accomplishment

• How: Your approach and actions

• Impact: Measurable outcomes (quantify when possible)

• Skills: What this demonstrates

• Category: Type of contribution (see Win Categorization)

Win Categorization

Not all wins are created equal. Categorize to show breadth:

Impact Types

Type Description Example

Delivery Shipped features, projects, products "Launched payment v2, processing $2M/day"

Quality Improved reliability, reduced bugs "Reduced error rate from 2% to 0.1%"

Efficiency Faster, cheaper, better processes "Cut deploy time from 2 hours to 15 min"

Innovation New approaches, creative solutions "Introduced caching strategy saving $50K/year"

Leadership Mentoring, leading, enabling others "Mentored 2 engineers to senior level"

Collaboration Cross-team work, partnerships "Led joint initiative with 3 teams"

Scope Levels

Scope Description Next Level Signal

Individual Your personal contribution Expected at current level

Team Improved your team's outcomes Mid → Senior

Multi-team Impact across multiple teams Senior → Staff

Org-wide Shaped organizational outcomes Staff → Principal

Self-Advocacy Skills

Making Your Work Visible

Visibility is not self-promotion - it's professional communication:

• Status updates: Regular, concise updates on progress

• Demo your work: Present at team meetings, tech talks

• Document decisions: Write design docs, ADRs, post-mortems

• Share learnings: Blog posts, knowledge sharing sessions

• Volunteer for visibility: All-hands demos, cross-team presentations

Articulating Impact

Weak: "I worked on the new API"

Strong: "I designed and implemented the new payments API, which reduced integration time from 2 weeks to 2 days and enabled 3 new partner integrations in Q3"

Formula: Action + Specifics + Measurable Outcome

Working with Your Manager

• Align on expectations: What does next level look like specifically?

• Share your goals: Make your promotion aspirations known

• Regular check-ins: Use 1:1s to discuss progress

• Ask for feedback: What gaps exist? What would make the case stronger?

• Request opportunities: Ask for stretch assignments aligned to next level

Common Mistakes

In Tracking Wins

• Waiting too long: Weekly tracking beats quarterly scrambles

• Being too modest: Document everything, filter later

• Only big wins: Small wins show consistency

• Skipping context: Future-you won't remember details

• No quantification: Numbers make impact concrete

In Building the Case

• Too generic: "I'm a good team player" vs specific examples

• Missing business impact: Technical achievements without business context

• No growth narrative: List of tasks vs story of development

• Ignoring gaps: Pretending weaknesses don't exist vs addressing them

• Going alone: Not aligning with manager throughout

In Self-Advocacy

• Assuming merit is enough: Great work must be visible

• Waiting to be noticed: Proactive communication is expected

• Over-advocating: Balance confidence with humility

• Wrong audience: Tailor message to stakeholders

• Timing: Don't wait until review time to start

Manager's Perspective

Understanding how managers view promotions helps you prepare effectively:

What managers need:

• Clear evidence to present to their managers

• Confidence that you'll succeed at next level

• Reduced risk of "promoting too early"

• Peer-level support for the promotion

What makes promotion easy:

• Well-documented accomplishments with impact

• Already operating at next level

• No significant concerns or gaps

• Clear narrative they can tell

What makes promotion hard:

• Vague contributions hard to articulate

• Gaps in critical competencies

• Inconsistent performance

• Lack of peer support or visibility

Building Your Promotion Timeline

6 Months Before Review

• Start or refresh brag document

• Align with manager on promotion goals

• Identify gaps and create development plan

• Seek stretch assignments

3 Months Before Review

• Begin drafting promotion case

• Review against next-level expectations

• Gather supporting evidence (docs, metrics)

• Get feedback on draft from manager

1 Month Before Review

• Finalize promotion document

• Ensure manager has everything needed

• Prepare talking points

• Document recent wins

At Review Time

• Be prepared to discuss your case

• Listen to feedback openly

• If not promoted, understand gaps and plan

• Continue tracking for next cycle

References

For detailed guidance, see:

• references/promotion-case-structure.md

• Complete promotion document template with examples

• references/brag-document-guide.md

• Weekly/monthly tracking templates and tips

• references/win-categorization.md

• Multi-dimensional win classification framework

• references/manager-perspective.md

• What managers look for, how to align

Related Skills

• career-strategy

• Level expectations, progression paths, and career planning

• career-strategy

• Internal vs external growth decisions

• interview-skills

• Using accomplishments in interviews

Related Commands

• /soft-skills:promotion-preparation

• Generate a structured promotion case document

• /soft-skills:track-win

• Document an accomplishment in brag document format

User-Facing Interface

When invoked directly by the user, this skill supports two workflows: building a promotion case and assessing career readiness.

Build Promotion Case Workflow

When invoked with role arguments (e.g., <current-role> <target-role> [achievements...] ):

• Parse Arguments - Extract current role, target role, and any key achievements listed.

• Gather Context - If achievements are sparse, ask probing questions about projects delivered, business impact, leadership activities, and growth trajectory.

• Load Level Expectations - Reference career-strategy skill for target level competency expectations.

• Structure Promotion Case - Generate a three-section promotion document:

• Accomplishments & Impact - Specific achievements with quantified outcomes

• Growth & Learning - Skills developed, challenges overcome, feedback incorporated

• Future Focus - Goals aligned to next-level expectations, expanded scope readiness

• Identify Gaps - Highlight areas where the case could be strengthened with more evidence or development.

• Save Results - Offer to save the promotion case document.

Assess Readiness Workflow

When invoked with assessment intent (e.g., promotion , job-change , level <target> ):

• Parse Arguments - Determine assessment type (promotion readiness, job change readiness, or level assessment).

• Gather Self-Assessment Data - Ask structured questions about current contributions, scope of impact, competency demonstration, and visibility.

• Evaluate Against Framework - Score readiness across competency categories (Technical, Design, Operations, Product, Leadership, Communication).

• Generate Readiness Report - Produce assessment with:

• Overall readiness score and recommendation

• Strength areas with evidence

• Gap areas with specific development actions

• Suggested timeline and next steps

• Recommend Actions - Prioritized list of actions to close gaps before pursuing advancement.

Version History

• v1.0.0 (2025-12-26): Initial release

Last Updated

Date: 2025-12-26 Model: claude-opus-4-5-20251101