Every engineering organization above 30 people eventually faces the same problem. Promotion conversations get longer. Different managers grade the same engineer differently. New hires can't tell what "Senior" means at your company. And the recurring question in every leadership meeting becomes some version of "how do we make sure this is fair?"
The standard answer — build a skills matrix — is right. The execution is usually wrong. Most engineering matrices either die quietly in a Notion folder six months after launch, or they harden into bureaucratic checklists that engineers game and managers resent. The matrix is one of those artifacts where the implementation details determine everything.
This guide is a template you can actually use, plus the parts that most matrix guides skip: how to write behaviors that survive calibration, what to do about AI coding assistants in 2026, and the failure modes you should design against from day one.
The Anatomy of a Working Matrix
A useful matrix has three components: skill areas (the rows, what you're measuring), levels (the columns, the career stages you support), and behavioral examples (the cells, what "good" looks like at each intersection). Each of these has a right number.
Fewer than six skill areas and the matrix becomes too coarse to support meaningful conversations. More than ten and reviewers stop reading and start pattern-matching. Levels follow the same logic — under five and adjacent levels become too far apart to calibrate; over seven and the gradations stop meaning anything in practice. The behaviors-per-cell number is the most overlooked. Three to five concrete observable behaviors per cell is enough to ground a conversation; fewer makes the cell ambiguous, more makes it a checklist.
The 8 Skill Areas to Include
After looking at the engineering matrices that companies in our culture directory publish openly — and the ones we've seen leaked from companies that don't — eight skill areas show up almost everywhere. The names vary; the underlying competencies don't.
- Technical execution. Can you ship complex code that works, on time, with the quality the system requires? At higher levels: can you make others ship faster?
- Code quality and craft. Readability, testing, documentation, judgment about when to invest in quality vs. ship. The bar shifts dramatically with AI assistance — see the section below.
- Architecture and systems design. Designing systems that scale, integrate cleanly, and don't paint future engineers into corners. This is the skill area where the IC and EM tracks diverge most clearly.
- Reliability and operations. Can you build, deploy, monitor, and debug production systems? At Senior+ this includes incident leadership and proactive reliability work.
- Product sense. Do you make decisions a user would thank you for? At higher levels: do you push back on PMs when the spec is wrong?
- Collaboration and communication. Written and verbal. Code reviews. Design docs. Cross-team coordination. The most underrated promotion blocker for technically strong engineers.
- Leadership and influence. Distinct from people management. At Staff+ this is the dominant skill area — how you influence decisions outside your direct authority.
- Ownership and judgment. The hard-to-measure one. Do you take responsibility for outcomes, not just tasks? Do you raise concerns early? Do you make calls under uncertainty?
What's not on the list: Specific technologies (React, Postgres, AWS), seniority signals dressed up as competencies ("Strategic thinking"), and anything you can't observe in normal work. Tech-stack proficiency belongs in interview rubrics, not the skills matrix. Vague terms like "strategic" belong nowhere — they're an unfalsifiability tax on every calibration meeting.
The Level Framework
Six IC levels is the common shape, though small companies should compress to four. Here's a working template you can rename to match your existing nomenclature.
| Level | Scope | Time horizon | Influence |
|---|---|---|---|
| IC1 / Junior | A clearly-scoped task | Days to weeks | Self, with mentor support |
| IC2 / Engineer | A feature within a team | Weeks | Self & pairs reliably |
| IC3 / Senior Engineer | A complete system area | Months | Within own team |
| IC4 / Senior+ or Tech Lead | A team's technical direction | Quarters | Team + adjacent stakeholders |
| IC5 / Staff Engineer | Cross-team systems or platform | 2–4 quarters | Multiple teams, sets standards |
| IC6 / Principal Engineer | Organization-wide | 1–2 years | Org-level technical strategy |
The progression rule that holds across every working matrix we've seen: each level approximately doubles the scope, the time horizon, and the blast radius of decisions. That's the test you apply when you can't decide between two adjacent levels — is the engineer operating at roughly twice the scope, horizon, and influence of the lower level? If not, they're still at the lower level, regardless of years of tenure.
Behavioral Examples That Hold Up
The most common matrix failure is writing behaviors that sound impressive but can't be observed. "Demonstrates technical leadership" is unfalsifiable. "Has written and shipped at least one design doc this half that was used by an adjacent team to make a decision" is observable. The difference is the difference between a matrix that works and one that gets ignored.
Here are working behavioral examples for two contrasting levels in three of the most important skill areas. These are templates; replace specifics with your stack and your business.
Technical execution
IC3 / SeniorThe Senior engineer is the workhorse level for most teams. The behaviors that signal "operating at Senior" are concrete and observable:
- Owns features end-to-end from scoping through deployment without needing day-to-day oversight
- Estimates project timelines within ~30% accuracy; flags slippage proactively before deadlines
- Debugs complex production issues that span multiple services, including incidents that originated before they joined the team
- Uses AI coding assistants (Cursor, Claude Code) to ship faster and reviews generated code critically before merging — doesn't accept AI output uncritically
Technical execution
IC5 / StaffAt Staff, technical execution shifts from "ship complex code" to "make others ship complex code reliably." The execution skill area starts to merge with leadership:
- Identifies execution bottlenecks at the team level and resolves them through code, tooling, or process changes — not just by working harder personally
- Authors or contributes substantively to design docs that adjacent teams adopt as the basis for their own decisions
- Sets technical standards for AI-augmented development in their org: code review norms, agent usage policies, when to accept generated code and when to write by hand
- Recovers struggling projects without taking over — through coaching, unblocking, and selective intervention
Architecture and systems design
IC3 / Senior- Designs systems within their team's scope that hold up to a 5x load increase without rearchitecture
- Writes design docs with explicit trade-off analysis and at least one rejected alternative
- Knows the failure modes of the systems they design; documents and tests them
- Asks "what does this look like in two years" before committing to architectural choices
Architecture and systems design
IC5 / Staff- Designs systems that span multiple teams; navigates the technical and organizational constraints of cross-team work
- Authors the design docs that shape org-wide platform decisions; their judgment is sought before major architecture changes
- Recognizes which architectural decisions are reversible and which are not, and treats them differently
- Coaches other engineers through architecture work without taking the design over
Collaboration and communication
IC3 / Senior- Writes code reviews that improve the reviewed engineer's skill, not just the code
- Disagrees with senior engineers in writing without being defensive or dismissive
- Surfaces problems early in 1:1s and writes-ups, not after the deadline slips
- Pairs effectively with juniors; teaches without taking over the keyboard
Collaboration and communication
IC5 / Staff- Communicates technical work to non-engineering executives in language that lands — without dumbing down
- Resolves cross-team conflicts through structured technical conversations, not by escalating
- Sets the standard for the team's written communication norms (design docs, RFCs, post-mortems)
- Mentors Senior engineers on the communication patterns required to operate at Staff
What Changes in the AI-Augmented Era
Most engineering matrices written before 2024 are now subtly broken. The skills they reward at Junior and Mid — "writes correct CRUD code from a spec," "debugs error messages quickly," "produces unit tests for new code" — are exactly the skills AI coding assistants now perform competently. A matrix that hasn't been updated for the AI era will over-promote engineers who lean on AI without judgment and under-promote engineers who do the harder work of technical direction.
The fix is not to add an "AI proficiency" skill area. The fix is to weave AI-augmented judgment into the existing skill areas, especially at the lower and middle levels. Three specific updates:
- Technical execution at Junior and Mid should explicitly include "reviews AI-generated code critically before merging" and "knows when to write by hand instead of accepting AI output."
- Code quality at every level should reward consistency of the codebase as AI-generated contributions accumulate — the new failure mode is "thousand-cuts inconsistency" from accepting whatever the AI produces in each PR.
- Architecture at Senior+ should reward the engineer's ability to maintain system coherence in the face of AI-amplified contribution volume. The volume of code shipped per engineer is up; the cognitive overhead of keeping a system coherent is up faster.
Don't separate "AI" from "engineering." Treat it like you'd treat any other productivity tool — what matters is the engineer's judgment and the system's coherence, not whether they typed each line by hand. For a deeper take on what AI tooling means for engineering teams, see our guide on LLM inference optimization and the AI agent evaluation guide.
Calibration: Where Matrices Live or Die
A matrix is only as good as the calibration process around it. The matrix itself doesn't promote anyone — calibration meetings do. Three patterns separate the calibrations that work from the ones that produce resentful engineers.
Pattern 1: Holistic, not checklist. Promotions should require a sustained pattern of behavior across multiple cells, not isolated artifacts. An engineer who once led a cross-team project isn't a Staff engineer; an engineer who's consistently operating at the cross-team scope across multiple skill areas is. Resist the "but they checked the box" framing. The matrix is a guide to a conversation, not a substitute for one.
Pattern 2: Examples before judgment. In calibration, force the discussion to start with specific evidence ("here's the design doc Maria wrote that Team B is now using") before any level judgment. Manager intuition about who's "obviously a Senior" is wrong often enough that it shouldn't drive the conversation; specific evidence drives it.
Pattern 3: Inter-manager calibration is non-optional. Single-manager promotions calibrate to that manager's bar, not the company's. The minimum bar for a healthy promotion process is two managers reviewing the case together; the better bar is a small panel that reviews promotions in batches across the org each cycle.
The matrix-as-checklist failure mode: The single most common way a skills matrix fails is when engineers start engineering for the cells instead of for the company. ("I need a cross-team influence example this half — let me find one.") The matrix has failed at the moment behavior becomes performance for the matrix rather than work that genuinely warrants the level. Guard against this with holistic calibration, narrative-based promotion packets, and a willingness to deny a promotion that "technically checked the boxes" but didn't represent real growth.
Rolling Out Your Matrix Without Causing a Revolt
The rollout matters more than the document. We've seen well-designed matrices die because engineers experienced them as a top-down judgment imposed on existing work, and we've seen mediocre matrices succeed because the rollout brought engineers into the process. A few practical notes:
- Co-author with senior ICs. Not just EMs. The IC perspective on what "operating at Staff" actually looks like is the perspective the matrix has to represent.
- Map current engineers to the new matrix before publishing. If you publish a matrix and ten existing Staff engineers don't map cleanly to Staff under the new rubric, the matrix is wrong, not the engineers.
- Hold a "first calibration is no-stakes" cycle. Use the first calibration as a learning exercise — no promotions, no demotions, just practice using the rubric.
- Update annually. The matrix is a living document. The AI-era updates we described above wouldn't exist in a 2022 matrix; the 2028 version will have updates we can't predict today. Treat it as code, not stone.
The Bottom Line for Engineering Leaders
A skills matrix is one of the highest-leverage artifacts in an engineering org. Done well, it makes promotions defensible, hiring rubrics consistent, and growth conversations concrete. Done badly, it becomes a bureaucratic checklist that engineers resent and managers ignore.
The pattern that works in 2026: 8 skill areas, 6 levels, 3–5 observable behaviors per cell, AI-augmented judgment baked into the existing skill areas rather than walled off, and a calibration process that prioritizes evidence and inter-manager review over manager intuition. The template is the easy part; the discipline of using it well is the hard part.
See how engineering-driven companies structure their teams
Browse engineering-led cultures across our directory — with culture profiles, leveling philosophy, and team structure context you can use as benchmarks when designing your own framework.
Get Your Company Listed → See Engineering-Driven Cultures →