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 examplesreferences/brag-document-guide.md- Weekly/monthly tracking templates and tipsreferences/win-categorization.md- Multi-dimensional win classification frameworkreferences/manager-perspective.md- What managers look for, how to align
Related Skills
career-strategy- Level expectations, progression paths, and career planningcareer-strategy- Internal vs external growth decisionsinterview-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-strategyskill 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