Let me tell you about two engineers. Call them Priya and Dan.
Priya is exceptional. She debugs things no one else can debug. She reads proposals and spots the flaw on page two that everyone else missed on page twelve. She is quietly, consistently the most technically capable person on her team. She's also been at Senior level for four years. Every review cycle, her manager says something like: "Priya does great work. We just need to see more scope." She is not sure what that means.
Dan is good. Not as sharp as Priya, and he knows it. But Dan sends a weekly email to the team summarizing what shipped. Dan presents at the all-hands. When something goes sideways, Dan writes the post-mortem and circulates it widely, positioning the team's response as decisive. Dan was promoted to Staff last quarter. His manager said he "demonstrated organizational impact."
Priya is furious. You might be furious reading this. But here's the uncomfortable truth that took me years to accept:
Dan didn't game the system. He understood it. Priya didn't fail at engineering. She failed at making her engineering legible to the people who decide her fate.
This chapter is about that system — what it actually is, how it actually works, and why the belief that "my work speaks for itself" is the single most career-limiting idea you can carry into a top-tier engineering org.
The Lie We Were Told
Most engineers grew up in school with a clean deal: do the work, get the grade. The rubric is the rubric. Two plus two is four regardless of whether you smiled at the teacher. Math doesn't care about your communication skills.
This was a fine model for school. It is a catastrophic model for your career.
The belief that talent and output are automatically recognized is so deeply embedded in engineering culture that it's almost invisible. It's the water we swim in. We call it meritocracy — the idea that the best engineers rise, the mediocre ones plateau, and the system is essentially just.
But here's what meritocracy actually requires to function: perfect information. Every evaluator needs to know exactly what you did, exactly how hard it was, and exactly what would have gone wrong without you. In the real world, none of that is true. Your manager has twelve direct reports, is managing up to their own skip-level, and is in six meetings a day. They know a fraction of what you actually did. They evaluate based on what surfaces to them — and what surfaces is rarely the most technically impressive work. It's the most visible work.
Meritocracy assumes perfect information. But your manager only sees a small slice of your work. What gets through that filter isn't "the best work." It's the most legible, visible, and narratively coherent work. If you optimize for quality and nothing else, you are optimizing for a system that doesn't exist.
This isn't a cynical take. It's not saying the system is corrupt or that hard work doesn't matter. Hard work matters enormously. But hard work is the price of admission. Everyone at your level works hard. The question is: who else knows it?
The Two-Layer Reality of Engineering Orgs
Here's a mental model that will reframe everything: every engineering organization runs on two parallel layers simultaneously.
Layer 1 is the technical layer. This is the code, the systems, the architecture. It's the thing you were hired to do. This layer is largely objective. Either the service is up or it isn't. Either the migration succeeded or it didn't. Either the system scales or it falls over at 10x traffic.
Layer 2 is the social layer. This is the narrative, the perception, the politics. Who is seen as a leader? Whose judgment is trusted? Who gets called into the important rooms? This layer is largely subjective. It's shaped by communication, relationships, timing, and visibility.
Most engineers spend 95% of their energy on Layer 1. They treat Layer 2 as either optional, distasteful, or someone else's job. This is a mistake — not because Layer 1 doesn't matter, but because your Layer 1 work only survives and compounds if it's recognized at Layer 2.
Imagine you wrote the best piece of code of your career. It shaved 40% off latency. It reduced on-call burden by half. It will save the company $2M a year in infrastructure costs. Then imagine nobody ever heard about it. Your manager retired. The team was reorganized. The PR got merged without fanfare. Two years later, during your promotion review, someone asks "what's your biggest impact?"
That code still runs in prod. But for the purposes of your career, it might as well not exist.
Impact that isn't communicated is impact that didn't happen — at least for the purposes of the only people who can change your trajectory.
Perception Precedes Reality. Always.
Here's something that surprised me when I first noticed it: in most engineering orgs, the promotion decision happens in your manager's head months before the official review cycle starts. By the time your promo packet lands in a calibration meeting, it's not an open question — it's a confirmation exercise. Either your manager is already advocating for you or they're not. The packet just provides the paperwork.
What shapes the perception that's already formed before the review? A thousand small data points, accumulated over months: who spoke up in that architecture review, who sent that clear status update during the incident, who got mentioned by the PM as being especially helpful, who their peers describe as "the person I'd go to for X."
These moments don't feel like career-defining moments when they happen. They feel like Tuesday. But they are the raw material out of which your reputation is built.
Your reputation is not built during performance reviews. It's built on ordinary Tuesdays, in small moments, through consistent behavior that other people notice and remember.
This is actually good news, once you see it clearly. It means the game isn't rigged. It means you have a thousand chances to shape how people see you. It's not one big swing — it's daily, small, compounding acts of communication and presence.
The Two Ladders
Let's make this concrete with another model. Imagine your career progress depends on climbing two different ladders simultaneously. You need both. Letting either one fall behind will stall you.
Ladder 1: Technical Depth. This is what you know and what you can build. It includes your understanding of systems, your ability to debug, your architectural judgment, your domain expertise. It earns you respect from other engineers. It makes you capable of delivering results. Without this, you're a fraud. There's no shortcut here.
Ladder 2: Organizational Leverage. This is how well you move the organization — your ability to communicate clearly, build trust, influence decisions, and be seen as someone who makes the people around them better. It earns you respect from leadership. It multiplies the impact of Ladder 1. Without this, you're invisible.
- Great work that no one hears about
- Promotions that never come
- "Needs more scope" feedback with no guidance
- Smart opinions that get ignored in meetings
- Others get credit for ideas you originated
- Work that gets recognized at the right level
- Promotions that feel earned and timed well
- Clear sponsorship from people above you
- Your proposals get traction with leadership
- People attribute wins to you correctly
Notice I'm not saying High Ladder 2, Low Ladder 1 is the goal. That's a different failure mode — the smooth talker who can't actually ship. Those people get found out too, eventually. The goal is both. Together. At the same time.
The reason most engineers struggle with this is cultural. Engineering culture idolizes Ladder 1 and is quietly suspicious of Ladder 2. "Political" is a slur in most engineering orgs. "Self-promoter" is an insult. The highest compliment is "he just puts his head down and ships." We built a culture that rewards exactly the behavior that makes people invisible to the people who matter.
Why "The Code Speaks for Itself" Is Dangerous
Let's be precise about why this specific belief is so costly.
When you believe the code speaks for itself, you make a series of choices: you skip the post-meeting summary email, because the decision was obvious. You don't write up that refactor, because the PR description explains it. You stay quiet in the all-hands, because your work will show up in the metrics eventually. You don't push back when someone else presents your idea, because you know who really thought of it.
Each of these choices feels fine in isolation. Collectively, they add up to a career where your contributions are systematically undervalued because they are systematically under-communicated.
Your manager has perfect knowledge of their own communication and effort. They have partial knowledge of yours — filtered through what you tell them, what they observe in meetings, and what they hear from others.
If you communicate less than average, you will be evaluated as below average, regardless of how far above average your actual work is. The evaluation is of the signal received, not the work done.
I've watched this play out dozens of times. An engineer will be genuinely puzzled that a peer got promoted over them. "But I built X, and they didn't even touch that codebase." Maybe true. But their peer presented X at the all-hands. Their peer wrote the internal blog post about the architecture decisions behind X. Their peer was on the incident call that validated X was production-ready. Who does leadership think of when they think of X? Not you.
But Isn't This Just... Politics?
I know what some of you are thinking. This sounds like office politics. I didn't become an engineer to play politics. I became an engineer to build things.
Fair. But let's separate two things that often get conflated.
Politics — in the pejorative sense — means advancing yourself at the expense of others. Taking credit you don't deserve. Backstabbing. Building alliances to marginalize someone. This is real, it exists, and it's genuinely corrosive. Don't do it.
Communication — which is what we're actually talking about — means making your real work legible to the people who need to understand it. Writing clearly about what you shipped and why it mattered. Speaking up in meetings when you have something worth saying. Making sure the people who should know about your work, know about your work.
These are not the same thing. One is manipulative. The other is a professional responsibility. If you built something that solves a hard problem and you don't tell anyone about it, that's not modesty. That's negligence — to yourself, to your team who could learn from it, and to the organization that funded it.
Communicating your impact is not self-promotion. It's closing the information gap between what you know about your work and what others need to know to make good decisions about your career and their systems.
The Meta-Skill Under Everything
Here's where I want to land before we move on.
Everything in this book flows from one insight: the engineers who thrive at the highest levels in competitive orgs are the ones who develop a second skill in parallel with their technical craft. Call it organizational fluency — the ability to operate effectively inside the human system, not just the technical one.
Organizational fluency is not a personality type. It's not something you're born with. It is a set of learnable behaviors. Writing clearly. Speaking concisely. Building trust consistently. Reading a room. Choosing the right projects. These are skills. You can get better at them the same way you get better at debugging — by paying attention, by practicing deliberately, and by getting feedback.
The engineers who dismiss this — who double down on the meritocracy myth — don't just plateau. They get increasingly bitter as they watch people they believe are less skilled than them get promoted, get opportunities, get the interesting projects. They develop a narrative that the system is broken. Sometimes the system is broken. But more often, they're playing one game while being evaluated on another.
-
Your work is the floor, not the ceiling. Technical excellence is required to get into the game. It is not sufficient to win it. Everyone you're competing with works hard. The differentiator is almost never the code.
-
Perception is not a distortion of reality. It is a parallel reality. In the context of your career, what people believe about your contribution is as real as your contribution. Arguing otherwise won't change the promotion outcome.
-
You have two jobs: build things and make the building legible. Every senior engineer who's figured this out does both, consistently. They don't do one or the other. The communication is not a tax on the engineering — it is part of the engineering.
-
The system is not perfectly fair, but it is learnable. You cannot control every factor. You can control how visible your impact is, how trustworthy you appear, how clearly you communicate. That is enough to move the needle significantly.
What Changes From Here
If you accept even 60% of what's in this chapter, something important shifts. You stop treating communication as overhead and start treating it as infrastructure. You start asking, of every piece of work you do: who needs to understand this, and does the way I'm sharing it make it easy for them?
You stop resenting the Dan in your org and start learning from him — specifically, the things he does to make his work visible. Not the empty self-promotion parts. The parts where he genuinely helps others understand what the team is doing and why it matters.
And you start seeing the next few years of your career not as a waiting room where you accumulate enough achievements to finally get noticed, but as an active project — one where you are building both the technical and the social infrastructure needed to do your best work and have it matter.
The rest of this book is a manual for that project.
Chapter 1 — Key Takeaways
- Meritocracy requires perfect information — which doesn't exist. Evaluation is based on perceived impact, not actual impact.
- Two ladders, not one: Technical depth and organizational leverage. Optimizing only one will stall you.
- Perception precedes reality in every promotion cycle. The decision is mostly made before the official review begins.
- "The code speaks for itself" is false and costly. Code without communication is impact that disappears.
- Communication is not politics. It's closing the gap between what you know and what decision-makers need to know.
- Organizational fluency is a skill — learnable, practiceable, and as important as any technical skill past Senior level.