---
name: promotion-preparation
description: Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.
argument-hint: <current-role> <target-role> [key achievements...]
allowed-tools: Read, Glob, Grep, Write, AskUserQuestion, Skill
---

# 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:

1. **Status updates:** Regular, concise updates on progress
2. **Demo your work:** Present at team meetings, tech talks
3. **Document decisions:** Write design docs, ADRs, post-mortems
4. **Share learnings:** Blog posts, knowledge sharing sessions
5. **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

1. **Align on expectations:** What does next level look like specifically?
2. **Share your goals:** Make your promotion aspirations known
3. **Regular check-ins:** Use 1:1s to discuss progress
4. **Ask for feedback:** What gaps exist? What would make the case stronger?
5. **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...]`):

1. **Parse Arguments** - Extract current role, target role, and any key achievements listed.
2. **Gather Context** - If achievements are sparse, ask probing questions about projects delivered, business impact, leadership activities, and growth trajectory.
3. **Load Level Expectations** - Reference `career-strategy` skill for target level competency expectations.
4. **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
5. **Identify Gaps** - Highlight areas where the case could be strengthened with more evidence or development.
6. **Save Results** - Offer to save the promotion case document.

### Assess Readiness Workflow

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

1. **Parse Arguments** - Determine assessment type (promotion readiness, job change readiness, or level assessment).
2. **Gather Self-Assessment Data** - Ask structured questions about current contributions, scope of impact, competency demonstration, and visibility.
3. **Evaluate Against Framework** - Score readiness across competency categories (Technical, Design, Operations, Product, Leadership, Communication).
4. **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
5. **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