promotion-preparation（促销准备）

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

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

Scope Levels

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

1. Identify Gaps - Highlight areas where the case could be strengthened with more evidence or development.
2. 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

1. 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