Technical leadership standards
Criteria verified as of August 2026. Re-verify on the web before committing to anything (§8).
1. Scope and triggers
Covers the decisions taken by whoever leads technically and the artifacts in which they are
written down: career tracks and the real scope of each level, staff+ role archetypes, who decides what
and how fast, the decision record, the design document and the design review, technical debt
as a budget line, the individual conversation and performance evaluation, team
sizing and its dependencies, and the resolution of technical disagreements.
Triggers: "career ladder", "level ladder", "senior/staff/principal", "IC vs. management",
"staff archetype", "tech lead", "ADR", "decision record", "one-way door",
"reversible", "design document", "design doc", "design review", "technical RFC", "technical
debt", "refactor budget", "blameless postmortem", "1:1", "feedback", "performance
review", "individual productivity metrics", "lines of code", "commits per person",
"DORA per engineer", "SPACE", "cognitive load", "Team Topologies", "team size",
"inter-team dependencies", "technical disagreement", "disagree and commit", "responsibility without
authority".
Guiding principle: technical leadership is a set of decisions and artifacts, not a character
trait. It is not evaluated by how the person is perceived, but by what exists in writing and by
what the team achieves: decisions recorded with their reversibility, designs reviewed before
building, interfaces between teams defined, debt with an assigned budget and people with
specific, dated feedback. A falsifiable test applicable to any claim about leadership:
name the artifact it produces, who reads it and which decision it changes. If it cannot be named, the
claim is motivational and does not get written here.
Hard corollary: "lead by example", "foster trust" and phrases of the same genre fix
nothing. They are not criteria, they are decoration. Their actionable equivalent always exists and is the only thing
this document accepts: "every architecture decision lives in an ADR with declared
reversibility", "the postmortem names no people and the leader defends it to management in writing".
Not applicable:
technical-hiring-standards: reciprocal and strict. Here you decide what profile is needed,
why, and which gap in the team it fills (§3.7); there how a candidate is measured — rubric,
exercise format, method validity, bias, legal regime and onboarding. One-sentence boundary:
leadership defines the role; the selection process is the measuring instrument.
project-management-standards (already written): delivery, the plan, the commitment, the
estimate, the risk and the stakeholders are theirs, including the record of management
decisions. Here the technical decision and team development. Boundary: if the question
is "when will it be ready and with what risk?", it is theirs; if it is "how is it built and who decides it?",
it is ours. The decision record format is the same in both (§3.3) so as not to fork
the repository.
product-discovery-standards: what gets built and why — problem,
user, hypothesis, prioritisation by value and the decision to kill an idea. Here the what is not decided.
enterprise-architecture-standards: architecture governance for the
organisation, capability roadmap and application portfolio. Here the scope is the team
and its immediate neighbourhood, not the company. Reciprocal declared in their §1.
software-architecture-patterns-standards and refactoring-tech-debt-standards (already written):
the technical criteria are theirs — which pattern applies, when a module is refactored
and with which technique. Here only the decision to invest in it, its budget and how it is defended
(§3.5). Both already declare the reciprocal in their §1.
microservices-architecture-standards: service boundaries and concrete contracts. Here, the
organisational reflection of those boundaries (§3.6).
code-review-standards (already written): the review criteria are theirs — what blocks, how
the comment is written, what a high-risk change requires. Here only the rule that review
is not used as an instrument of power (§3.8) and who arbitrates the disagreement that review
does not close.
testing-qa-standards: test strategy and gates. Here, the decision to fund it.
sre-practice-standards: SLOs, error budget, on-call, capacity and the DORA metrics are
theirs. Here, solely, that DORA is a system measure and its individual use is forbidden
(§3.9, §7).
incident-management-standards: the incident process and the blameless postmortem are theirs
— roles, timeline, actions. Here what corresponds to leadership and only that: protecting the
blameless postmortem when there is pressure from above to name a culprit (§3.10).
platform-engineering-standards (already written): the platform as an internal product, its
paved road, its SLOs and its adoption. Here, the decision to create the team and what load is
transferred to it.
itsm-itil-standards: service, catalogue and continuous operation.
grc-compliance-standards: regulatory framework, formal evidence, segregation of duties.
ai-agent-workflow-standards (already written): the team policy on coding
agents is theirs — which task is delegated, instruction files, permissions, review of the
diff, attribution. Here only the decision to adopt it, who pays its organisational cost and which
metrics are NOT used to justify it (§3.11).
knowledge-management-standards: where documentation lives and how it is
kept alive. Here, the obligation that the decision be written down.
2. Default decisions
Verify on the web the status of the cited sources before relying on them (§8).
| Decision |
Default |
Justifiable alternative |
| What distinguishes one level from another |
Scope of impact, type of decision and time horizon (§3.1) |
Never years of experience and never mastery of a technology |
| Career track |
Two tracks with parity of level, scope and pay, published |
A single track only in organisations with < 15 engineers, and declaring it |
| Staff+ work assignment |
By declared archetype (§3.2), agreed with the person and revisable |
— |
| Record of technical decisions |
ADR mandatory, Nygard format, in the repository of the affected code |
A central record only if the decision crosses several repositories |
| Decision speed |
Derived from reversibility (§3.3): reversible → fast and at the lowest level; irreversible → informed and higher up |
— |
| Before building anything non-trivial |
A reviewed design document with acceptance criteria (§3.4) |
A throwaway prototype with a time box, if the problem is that it is not understood |
| Technical debt |
An explicit and recurring budget line, with its unit of measure (§3.5) |
Never "when there is time" |
| Measure of a technical leader |
The team's result: delivery, reliability, autonomy, recorded decisions |
— |
| The leader's contact with the code |
The minimum sufficient to judge (§3.8): reviewing, reading the design, touching the system periodically |
— |
| Individual productivity metric |
It does not exist. Forbidden (§7) |
Qualitative evaluation with written and dated evidence |
| 1:1 cadence |
Weekly or fortnightly, the report's agenda, never a status report (§3.9) |
— |
| Team size |
Stable, with bounded load and a single owner for each system (§3.6) |
— |
| Technical disagreement |
Resolved with data, with a deadline, and closed with disagree-and-commit (§3.7) |
Escalation only after exhausting the bounded experiment |
Sources: what is cited and with what caveat
- ✅ One-way / two-way doors. Primary source: Jeff Bezos, 2015 letter to Amazon
shareholders (
ir.aboutamazon.com, PDF). Verbatim (extracted from the official PDF,
not from a summary): "Some decisions are consequential and irreversible or nearly
irreversible – one-way doors – and these decisions must be made methodically, carefully, slowly,
with great deliberation and consultation. If you walk through and don't like what you see on the
other side, you can't get back to where you were before. We can call these Type 1 decisions. But
most decisions aren't like that – they are changeable, reversible – they're two-way doors. If
you've made a suboptimal Type 2 decision, you don't have to live with the consequences for that
long. You can reopen the door and go back through. Type 2 decisions can and should be made quickly
by high judgment individuals or small groups." And the diagnosis that matters here: "As
organizations get larger, there seems to be a tendency to use the heavy-weight Type 1
decision-making process on most decisions, including many Type 2 decisions. The end result of this
is slowness, unthoughtful risk aversion, failure to experiment sufficiently, and consequently
diminished invention." Declared discrepancy: numerous secondary sources place the framework
in the 2016 letter; that is incorrect — the Type 1 / Type 2 terminology appears in the 2015 one.
The 2016 one contains related material (disagree and commit), which is a different thing.
- ✅ ADR. Primary source: Michael Nygard, "Documenting Architecture Decisions", 15-Nov-2011,
originally published on the Relevance/ThinkRelevance blog and today at
cognitect.com. A five-section
template: Title (a short noun phrase with a sequential number that is never reused),
Status (proposed / accepted / deprecated / superseded by ADR-NNNN), Context (the forces
at play, in neutral language), Decision, Consequences (positive and negative). Derived
rule: an accepted ADR is not edited; if the conclusion changes, a new one is written that
supersedes the previous one and updates its status.
- ⚠️ Staff+ archetypes. A published reference taxonomy does exist: Will Larson, Staff
Engineer: Leadership beyond the management track (2021) and its origin in the open
(
lethain.com/staff-engineer-archetypes/, staffeng.com/guides/staff-archetypes/). Four
archetypes: tech lead, architect, solver, right hand. Explicit caveat: it is
a descriptive taxonomy observed in fast-growing technology companies, not a
research result, and it has published criticism from practitioners (Sean Goedecke: the
archetypes exist but are bad advice as a career target, because solver and right hand
depend on accumulated trust and cannot be pursued directly; Alex Ewerlöf: they should not
be used as job titles). Permitted use: vocabulary for distributing work and clarifying
expectations. Forbidden use: turning them into levels, titles or boxes on a ladder.
- ⚠️ Team cognitive load. Original source John Sweller, "Cognitive load during problem
solving: Effects on learning", Cognitive Science 12(2):257-285 (1988) — a theory of
individual learning and instructional design. Its transfer to teams is from Matthew Skelton and
Manuel Pais, Team Topologies (2019). Treat it as a useful analogy, not as a validated measurement,
exactly as in
platform-engineering-standards §6.4: team cognitive load has
no measurable unit, the sum of individual loads is not a construct defined in the original
theory, and DevOps academic literature points out that the book provides no scientific evidence
and rests on experience and cases. It is useful for deciding how systems are distributed between teams; it is
not useful as a number on a slide.
- ✅ SPACE. Nicole Forsgren, Margaret-Anne Storey, Chandra Maddila, Thomas Zimmermann, Brian
Houck and Jenna Butler, "The SPACE of Developer Productivity: There's more to it than you think",
ACM Queue 19(1):20-48 (2021), DOI 10.1145/3454122.3454124 (also in CACM). Five
dimensions: satisfaction and well-being, performance, activity, communication and collaboration,
efficiency and flow. The operational rule taken from it: measure at least three dimensions at
once, combining objective metrics and a survey; activity never in isolation to reward
or penalise. Declared discrepancy and usage warning: the claim circulates that "SPACE
measures the individual and DORA the team" — that is a misreading: one of the myths the article
itself dismantles is that productivity is only individual performance, and its central thesis is
that it is not captured by a single metric nor by activity data. It has not been possible to retrieve the
full text verbatim (ACM Queue and CACM return 403 to automated download): the
formulations above come from consistent secondary sources and must be checked against
the original article before quoting them literally (§8).
- ✅ DORA as a system measure. The four metrics measure team and system delivery,
not people. Report 2025: State of AI-assisted Software Development (
dora.dev/dora-report-2025/,
~5,000 professionals); report 2026: The ROI of AI-Assisted Software Development (InfoQ
coverage, May-2026). Caveat about the 2026 one: there is published criticism that, compared with the
research rigour of previous editions, it is largely a set of speculative
recommendations. Cite the edition and the year; never a bare "DORA says".
Famous figures: what is NOT used as data
This domain is saturated with numbers that circulate with no locatable primary study or with
dismantled methodology. These are expressly discarded:
- ❌ The "10x programmer". Origin: Sackman, Erikson and Grant, "Exploratory Experimental Studies
Comparing Online and Offline Programming Performance", CACM 11(1):3-11, Jan-1968. Methodological
refutation: Lutz Prechelt, "The 28:1 Grant/Sackman legend is misleading, or: How large is
interpersonal variation really?", Technical Report 1999-18, Universität Karlsruhe, Dec-1999
(
page.mi.fu-berlin.de/prechelt/Biblio/varianceTR.pdf). Flaws in the original: 12 subjects,
trivial tasks of a mathematical nature, and a mix of low-level and high-level language
programmers in the same group, which inflates the best/worst ratio. Prechelt reanalyses a much
larger dataset and argues that comparing the best with the worst is the wrong comparison: against
the median of the worst quartile versus that of the best, the ratio rarely exceeds 4, and the
standard deviation/mean ratio is around 0.5. Permitted use: "there is substantial
interpersonal variation, of the order of 2-4x depending on the task, with overlapping distributions". Forbidden use:
"10x", and above all using it to justify pay, staffing or redundancies.
- ❌ "An interruption costs 23 minutes and 15 seconds". The paper that backs it does not
exist. The paper that gets cited, Mark, González and Harris, "No Task Left Behind? Examining the
Nature of Fragmented Work", CHI '05, measures the probability of resuming a task on the same day
and does not contain that figure. The other one usually cited, "The Cost of Interrupted Work: More
Speed and Stress", finds that interrupted subjects completed the tasks faster,
with more stress. The figure comes from a 2006 interview with Gloria Mark, not from a peer-reviewed
article. It is not written, not even with caveats. What is defensible without a figure: fragmentation has a cost
and the argument for protecting blocks of work does not need an invented number.
- ❌ "70 % of the variance in team engagement is determined by the manager" (Gallup, State
of the American Manager, 2015). Proprietary analysis, not peer reviewed, with no raw data
published, and with two interpretation problems that its diffusion ignores: it refers to variance
between teams (it is not an individual-level claim), and the "manager effect" absorbs everything
that clusters at team level (function, location, load, staffing). It is not used as data to
justify a decision.
- ❌ "People leave managers, not companies" (First, Break All the Rules, Gallup). There is a published
refutation from Culture Amp (2017) over 175 teams: people do leave bad managers, but it is not
the first reason, and in bad organisations having a good or bad manager barely changes the decision to
leave. The weak version holds ("the manager's quality is one of the factors, conditional on
the organisation being decent"); the slogan does not.
- ❌ Turnover percentages attributed to a "bad manager" and the cost of a bad hire
expressed as a multiple of salary (§
technical-hiring-standards): discarded for the same
reason, there in detail.
General rule: a figure with no primary study, year, sample and method does not go into a document,
a slide or a budget request. If the argument only stands with the figure, the
argument was bad.
3. Structure and conventions
3.1 Career tracks: what actually changes
What changes when you move up a level is not "the level": it is three observable variables.
| Variable |
Senior |
Staff |
Principal |
| Scope of impact |
Their team and the system they answer for |
Several teams, or a critical area the organisation depends on |
The engineering organisation or a cross-cutting capability |
| Type of decision |
How it is implemented; chooses between known options |
Which options exist; defines the problem and the interfaces |
What is stopped; irreversible decisions and trade-offs between areas |
| Time horizon |
Weeks to a quarter |
Quarters to a year |
One to several years |
| Required evidence |
Systems delivered and operable |
Other people's designs improved, decisions recorded, people levelled up |
Changes of direction the organisation followed and that can be traced |
Hard rules:
- The ladder is published. A ladder only the manager knows is not a ladder, it is a retroactive
excuse. Public references exist so as not to start from zero — Rent the Runway (2015, with
Camille Fournier as CTO), Dropbox, CircleCI, Square, Kickstarter, aggregated at
progression.fyi and github.com/bmoeskau/engineering-ladders. They are adapted, not copied: someone
else's ladder describes someone else's organisation.
- Real parity between tracks. The individual contributor track and the management one have the same
level ceiling, the same salary band and the same presence in decision-making forums. Without those
three, the technical track is decorative and everyone knows it within six months.
- Managing is not a promotion, it is a change of job. The work, the measure and the skill are
different. Operational corollary: there is a declared way back, and using it is not a failure
recordable in the evaluation.
- The level is assigned on written evidence, not on seniority and not on likeability. If the evidence cannot
be written down with dated facts, there is no level.
- No level is defined by a technology. "Kubernetes senior" is not a level, it is a
dependency on a tool with an expiry date.
3.2 Staff+ archetypes: what they are really for
They serve one purpose, and that is why they are here: avoiding assigning work the person cannot
do from where they are. Taxonomy and caveats in §2.
| Archetype |
Work that belongs to them |
Work that destroys their impact |
| Tech lead |
Approach and execution of one team, alongside the manager |
Being the bottleneck for the decisions of another three teams |
| Architect |
Direction, quality and approach of one critical area, with a multi-year horizon |
Firefighting outside their area; making their area depend on their presence |
| Solver |
Going into a hard, bounded problem and coming out with the path resolved |
Becoming the permanent owner of what they fixed |
| Right hand |
Extending an executive's reach in a large organisation |
Existing in an organisation that does not need one: it reproduces hierarchy without adding judgement |
Rules:
- The archetype is agreed in writing with the person and is reviewed (by default, every six months or
when the project changes). A solver who gets handed the maintenance of everything they touched
stops being a solver within a quarter.
- Architect and right hand only appear at a certain scale. Larson observes them emerging around
~100 and ~1,000 engineers respectively. Creating them earlier manufactures a decision layer with no
problem to solve.
- FORBIDDEN to use them as titles or as levels on the ladder (§7).
3.3 Decisions: what is decided, who decides and how fast
Who decides, by default:
| Type of decision |
Decided by |
Consulted |
Recorded in |
| Implementation inside a module of the team's own |
Whoever implements it |
The PR reviewer |
The code and the PR |
| Choice of library or pattern within the team |
The team, the tech lead arbitrates |
— |
The repository's ADR |
| Contract or interface between two teams |
Both teams, jointly |
The area's architect |
ADR + versioned contract (api-design-standards) |
| A new technology in the organisation, or the retirement of an existing one |
Staff+ level or architecture, with published criteria |
Platform, security, FinOps |
ADR + inventory |
| A scope or date commitment |
Not this skill |
— |
project-management-standards |
| Acceptance of a regulatory risk |
Whoever has the formal authority |
— |
grc-compliance-standards |
The ADR is an obligation, not a courtesy. Minimum rule: if a technical decision is going to condition the
work of someone who was not in the conversation, it gets written. Nygard format (§2), in the
affected repository, numbered and not editable once accepted.
Speed is set by reversibility, not by perceived importance (Bezos 2015, verbatim in §2):
|
One-way door (Type 1) |
Two-way door (Type 2) |
| Typical examples |
Public data model, identity scheme, API format exposed to third parties, lossy migration, choice of a vendor with an expensive exit |
Internal library, folder structure, internal log format, test framework |
| Speed |
Slow, deliberate, informed: design document, alternatives evaluated, formal review |
Fast, by the person or the small group closest to the problem |
| Level that decides |
Higher up, with consultation |
The lowest possible |
| Cost of being wrong |
High and permanent |
Low: the door reopens |
- Every ADR carries a
reversibilidad field with an explicit value. Without it, the organisation treats
everything as Type 1 and grinds to a halt — the failure the 2015 letter itself describes.
- The classification can be challenged, but in writing and with an argument. "This is irreversible"
is a falsifiable claim: you ask for the estimated cost of reverting it.
- A Type 2 decision that has been under discussion for three weeks already cost more than being wrong. Rule:
a time box, and if it expires, the person with the responsibility decides and it is recorded.
3.4 Design document and design review
The design review is the point in the cycle where a mistake is still cheap. Afterwards there is
code, dependencies, migrated data and people who have already defended it in public.
When a design document is mandatory (any one is enough):
- The decision crosses a team boundary or creates/changes an interface between teams.
- It is a one-way door (§3.3).
- It touches personal data, authentication, authorisation, cryptography or money.
- The estimated effort exceeds a threshold the team publishes (by default: two person-weeks).
- A technology the organisation does not yet operate is introduced.
Minimum template. A document without sections 5, 6 and 8 is sent back unreviewed.
# Diseño: <nombre> Autor: <persona> Estado: borrador|en revisión|aceptado|sustituido
1. Problema # qué falla hoy, con evidencia observable (dato, incidente, ticket)
2. Restricciones # plazo, presupuesto, normativa, compatibilidad, equipo disponible
3. No objetivos # lo que este diseño explícitamente NO resuelve
4. Propuesta # la solución, con el diagrama mínimo que la explique
5. Alternativas descartadas # >=2, con el motivo del descarte. Sin esto no hay diseño, hay preferencia
6. Criterios de aceptación # falsables y medibles: cómo se sabrá que funcionó, y cuándo se mira
7. Impacto # migración, compatibilidad hacia atrás, coste recurrente, operabilidad, seguridad
8. Reversibilidad # Tipo 1 o Tipo 2, y coste estimado de revertir
9. Riesgos abiertos # con dueño
Review rules:
- The problem is reviewed before the solution. If the reviewers do not agree on the
problem, discussing the solution is wasted time and it always ends in aesthetics.
- Mandatory pre-reading, with a deadline (48 h by default). A meeting where the document is read
live is a reading meeting, not a review.
- Comments are labelled as blocking or non-blocking, just as in code review
(
code-review-standards). A reviewer who marks nothing as blocking has approved.
- The review ends with a decision and a date, not with "let's keep talking". The
valid states are: accepted, accepted with listed conditions, rejected with a reason, or postponed with
a date and with what remains to be found out.
- The accepted document becomes an ADR or links to one. A design that leaves no trace of a decision
gets discussed again in six months.
- Acceptance criteria with a check date. They are revisited when due: if they were not met,
that is information about how the team designs, and it is the cheapest input there is for improving.
3.5 Technical debt: a business decision with a budget
The technical criteria —what to refactor, with which technique and with which test net— belong to
refactoring-tech-debt-standards (already written). Here only the decision to invest and
how it is defended.
- Debt is recorded like any other work, in the same backlog, with an owner and with the
cost it imposes today — not with adjectives. Admissible formulation: "every change in the
billing module requires touching four places and last quarter it generated 3 of the 7 incidents".
Inadmissible formulation: "the code is bad".
- Distinguish deliberate debt from degradation. Deliberate debt was incurred with a recorded
decision and a review date (if it does not have one, it was not a decision: it was an oversight).
Degradation is silent accumulation and is detected by symptom, not by opinion.
- An explicit and recurring budget. A percentage of capacity per cycle is declared,
published and protected the way a committed date is protected. A percentage that gets cancelled in
the first quarter under pressure was not a budget: it was an intention.
- How it is defended to whoever pays — and this is what always fails. Technical debt is not
defended as code quality: it is defended with the cost the business is already paying, in
its vocabulary. Arguments that work because they are verifiable:
- Lead time: the same change takes X in this module and Y in the rest.
- Reliability: the proportion of incidents concentrated in the component
(
incident-management-standards provides the datum).
- Direct cost: oversized infrastructure, licences, hours of manual operation
(
finops-standards).
- Risk with a name: an unsupported dependency, a version with no security patches
(
vulnerability-management-standards), regulatory non-compliance (grc-compliance-standards).
- The option that is lost: what will not be doable, and when, if it is not touched.
- A refactor request with none of those five arguments is rejected, whoever makes
it. And it is rejected here, inside engineering, before the business rejects it: credibility
is spent once.
- Never "a refactor release" that delivers nothing. Debt work is delivered in
increments with an observable effect; if it cannot be split, the problem is the design of the
intervention, not the calendar.
3.6 The team as a system
- A single owner per system. A system with no named owner is maintained by whoever had the bad luck
of touching it last. Two owners is zero owners.
- Bounded load, in the analogical sense of cognitive load (§2, with its caveat): a team
answers for as many systems as it can understand, operate and improve. An operational and
falsifiable test that requires no invented metric: can the team deploy, diagnose in
production and explain the data model of every system it answers for, without depending on one
specific person? If not, the load exceeds the team — the scope is reduced or extraneous load
is transferred to the platform (
platform-engineering-standards).
- Stable teams. Reorganising teams resets system knowledge and trust
relationships. Every reorganisation is justified in writing with the problem it solves and its expected
cost, or it is not done.
- Size: small enough that everyone knows everyone's work, large enough
to sustain an on-call rota without burning anyone (
sre-practice-standards fixes the latter).
Adding people to a saturated team adds coordination before it adds capacity
(project-management-standards §6).
- Inter-team dependencies: they are managed by interface, not by meeting. Preference, in order:
(1) eliminate the dependency, (2) decouple with an interface contract and a simulator, (3) sequence
with a mutual commitment from the providing team, (4) escalate. Adding a recurring
sync meeting is choosing (4) and calling it (3).
- The team's structure and the system's converge (Conway). Practical consequence: if you
want a different architecture, you have to change the team boundaries, not just the
diagram.
3.7 Technical conflict
A technical disagreement with no procedure gets resolved by hierarchy or by exhaustion, and both
produce the worst decision available. Procedure, in this order and with a deadline:
- Make the disagreement explicit: each side writes, in one paragraph, what they defend and what evidence
would make them change their mind. Whoever cannot answer the second has no technical position,
they have a preference — and preferences do not block.
- Find the datum: prototype, measurement, load test, review of a past incident. With
a fixed time box agreed beforehand.
- If the datum does not discriminate (a real tie), whoever answers for the consequences decides —
normally the owner of the affected system — and it is recorded in an ADR with the alternatives and the
tie declared.
- Disagree and commit, as an explicit team rule. Reference: Amazon's leadership
principle "Have Backbone; Disagree and Commit" (
amazon.jobs) — the obligation to challenge the
decision respectfully even when it is uncomfortable, and full commitment once it is taken. The term is
older than Amazon (Intel, constructive confrontation). The local rule, which is what applies:
once the decision is closed, nobody passively sabotages it or reopens it in corridors; it is reopened
only with new evidence and through the same channel.
- When it is escalated: when the disagreement crosses the boundary of two teams and blocks work for more
than a week, or when it involves a security, legal or personal-data risk. Escalating is not
losing: escalating late is.
- A disagreement that repeats is an organisational design problem, not a people problem: the
boundaries of responsibility are badly drawn (§3.6).
3.8 The technical leader's work that is not writing code
Their value is measured in the team's result, not in their own output. Direct consequences:
if the most productive person on the team is the leader, the team is underused; if the leader
is on the critical path of every delivery, they are a SPOF with holidays.
Work that is theirs, and that produces leverage:
- Unblocking: identifying who is stuck and why, and getting it out of the way. It is the highest-return
activity of the job and the first one sacrificed when the leader starts programming.
- Defining interfaces between teams before two teams build against different
assumptions (§3.6).
- Reviewing other people's designs and decisions (§3.4) — not rewriting them.
- Writing what the organisation will need to remember: ADRs, context, criteria.
- Creating the conditions for someone else to take the decision, and accepting that they take it differently from how
the leader would have taken it if the result is acceptable. A leader who only delegates the decisions that
would have matched their own has delegated nothing.
- Developing people (§3.9): it is work with a calendar, not a by-product.
The opposite trap, and it is just as real: the leader who stops touching the code loses the ability
to judge. With no contact with the system, other people's estimates become uncheckable, designs
get approved out of trust in the person and not because of the content, and technical debt becomes
a story with no evidence. Non-negotiable operational minimum:
- Review code properly and regularly (
code-review-standards), including changes they do not
fully understand, which is where you learn where the system is.
- Be in the on-call rotation if the team has one, or at least take part in incident
response (
incident-management-standards).
- Take real work, but never on the critical path: internal tooling, fixes,
tests, the task nobody wants. FORBIDDEN to take the quarter's critical feature:
it turns them into a bottleneck and leaves the team without the developmental part.
- Arbitration rule between the two traps: if the team delivers just as well when the leader is
away for two weeks, the split is correct. It is the only test that matters, and it can be run
literally.
Code review is not used as an instrument of power. Vetoed manifestations: blocking a
PR out of aesthetic preference, demanding your own solution with no technical argument, withholding approval
as leverage in a negotiation unrelated to the diff. The criteria for what blocks belong to
code-review-standards; the obligation that the leader does not distort it belongs here.
3.9 1:1s, feedback and evaluation
The 1:1 belongs to the report. Concrete rules:
- The agenda is set by whoever reports, and it exists before the meeting. If there is no agenda, the default
question is not "how is X going?" but "what is getting in your way most?".
- FORBIDDEN for it to be a status report: the state of the work is in the management system
(
project-management-standards) and consulting it is the leader's responsibility, not minutes of the
person's time.
- A fixed and protected cadence (weekly or fortnightly by default). Cancelling it repeatedly
communicates a priority more clearly than any speech.
- Shared notes and commitments with an owner and a date. A 1:1 with no trace repeats identically for
a year.
- At least once a quarter, the 1:1 is about career: current level, missing evidence,
archetype (§3.2), what work needs to be sought to get there. With the published ladder in front of you.
Feedback:
- Specific, dated and about observable behaviour, not about traits. "In the review of the payments
design on 12 May you closed the discussion before Ana presented her alternative" is
actionable. "You are not very collaborative" is not: what cannot be observed cannot be corrected.
- Close to the event. Feedback saved for six months for the annual review is not feedback: it is an
ambush, and it destroys the credibility of the whole process.
- No surprises in the evaluation. Falsifiable rule: if something appears in the annual review and it is
the first time the person hears it, the failure is the leader's, and it is recorded as such.
- Difficult feedback is given in private, in writing as well as verbally, and with what is expected
differently and by when.
Why individual engineering productivity metrics are counterproductive — and this
is the part you have to be able to defend to management with the source in hand:
- The published position of the sector's reference research. DORA: the four metrics
measure team and system delivery and must not be used to evaluate the performance of
individual engineers; applying them to people creates perverse incentives. SPACE (Forsgren et
al., 2021, §2) dismantles two directly applicable myths: that productivity is activity, and
that it is only individual performance; and it establishes that activity metrics are never used
in isolation to reward or penalise.
- They are trivial to game and gaming them is rational: lines, commits, PRs and points are
free to inflate and the cost of inflating them is paid by someone else (the reviewer, the maintainer).
- They measure the visible and punish the valuable: reviewing, pairing, mentoring, being on call,
deleting code and preventing the unnecessary from being built leave no trace in any counter.
- Engineering work is interdependent: attributing the result to an individual within
a system with queues, dependencies and review is an attribution error, not an imprecise
measurement.
- The alternative that is used: qualitative evaluation with written and dated evidence against
the published ladder (§3.1) — designs, recorded decisions, incidents resolved, people
developed, systems that work without their author. It is more work for the leader. That is the
cost of the job.
3.10 Incidents: what corresponds to leadership
The full process belongs to incident-management-standards. Here only the part that only
leadership can do, and which is where the blameless culture breaks in practice:
- Protecting the blameless postmortem when there is pressure from above to name someone. The
pressure is real and arrives in the form of a reasonable question ("who deployed it?"). The standard
answer, in the same language as whoever asks: the system allowed an individual error
to reach production; that is the defect and that is what gets fixed, because it is the only one that will not
recur. Replacing the person leaves the system identical for the next one.
- Verifiable drafting rule: the postmortem contains no proper names as a cause. If
"X ran Y" appears, it is rewritten as "the procedure allowed Y to be run without confirmation".
- Honest contraindication: blameless does not mean without responsibility. Repeated
negligence, knowingly bypassing controls or acting without authorisation are a conduct matter and are
handled outside the postmortem, through another channel and with HR. Mixing them destroys both.
- The postmortem's actions get funded. A postmortem whose actions do not enter the next
cycle's plan teaches the team that the exercise is theatre, and from then on postmortems
are written to be filed.
- The leader publicly owns the team's failure and publicly attributes the success. It is a
conduct rule with a verifiable effect: without it, nobody reports a problem early.
3.11 Coding agents: what leadership decides
The concrete policy —which task is delegated, instruction files, permissions, review of the diff,
attribution— belongs to ai-agent-workflow-standards. **Here, three
…(truncated)
1---2name: tech-leadership-standards3description: Technical leadership as a set of decisions and artifacts, not a personality trait. Use when defining or applying an engineering career ladder and the IC-versus-manager track, assigning work by Staff+ archetype (tech lead, architect, solver, right hand), writing or reviewing an ADR and classifying a decision as a one-way or two-way door, writing a design document and running a design review with acceptance criteria, deciding who decides and at what level, budgeting technical debt as an explicit business decision, protecting a blameless postmortem under management pressure, running a 1:1 with a report-owned agenda, giving written performance feedback, being asked for individual productivity metrics such as lines of code, commits, velocity or DORA per engineer, citing SPACE or DORA in a measurement argument, sizing a team and its cognitive load in the Team Topologies sense, mapping inter-team dependencies, resolving a technical disagreement and applying disagree-and-commit, deciding whether to adopt coding agent4---56# Technical leadership standards78Criteria verified as of **August 2026**. Re-verify on the web before committing to anything (§8).910## 1. Scope and triggers1112Covers **the decisions taken by whoever leads technically and the artifacts in which they are13written down**: career tracks and the real scope of each level, staff+ role archetypes, who decides what14and how fast, the decision record, the design document and the design review, technical debt15as a budget line, the individual conversation and performance evaluation, team16sizing and its dependencies, and the resolution of technical disagreements.1718Triggers: "career ladder", "level ladder", "senior/staff/principal", "IC vs. management",19"staff archetype", "tech lead", "ADR", "decision record", "one-way door",20"reversible", "design document", "design doc", "design review", "technical RFC", "technical21debt", "refactor budget", "blameless postmortem", "1:1", "feedback", "performance22review", "individual productivity metrics", "lines of code", "commits per person",23"DORA per engineer", "SPACE", "cognitive load", "Team Topologies", "team size",24"inter-team dependencies", "technical disagreement", "disagree and commit", "responsibility without25authority".2627**Guiding principle**: **technical leadership is a set of decisions and artifacts, not a character28trait.** It is not evaluated by how the person is perceived, but by what exists in writing and by29what the team achieves: decisions recorded with their reversibility, designs reviewed before30building, interfaces between teams defined, debt with an assigned budget and people with31specific, dated feedback. **A falsifiable test applicable to any claim about leadership:32name the artifact it produces, who reads it and which decision it changes.** If it cannot be named, the33claim is motivational and does not get written here.3435Hard corollary: **"lead by example", "foster trust" and phrases of the same genre fix36nothing.** They are not criteria, they are decoration. Their actionable equivalent always exists and is the only thing37this document accepts: *"every architecture decision lives in an ADR with declared38reversibility"*, *"the postmortem names no people and the leader defends it to management in writing"*.3940**Not applicable**:41- `technical-hiring-standards`: **reciprocal and strict**. Here you decide **what profile is needed,42 why, and which gap in the team it fills** (§3.7); there **how a candidate is measured** — rubric,43 exercise format, method validity, bias, legal regime and onboarding. One-sentence boundary:44 **leadership defines the role; the selection process is the measuring instrument.**45- `project-management-standards` (**already written**): **delivery, the plan, the commitment, the46 estimate, the risk and the stakeholders are theirs**, including the record of *management*47 decisions. Here the **technical decision** and **team development**. Boundary: if the question48 is *"when will it be ready and with what risk?"*, it is theirs; if it is *"how is it built and who decides it?"*,49 it is ours. **The decision record format is the same in both** (§3.3) so as not to fork50 the repository.51- `product-discovery-standards`: **what gets built and why** — problem,52 user, hypothesis, prioritisation by value and the decision to kill an idea. Here the what is not decided.53- `enterprise-architecture-standards`: architecture governance for the54 organisation, capability roadmap and application portfolio. Here the scope is the team55 and its immediate neighbourhood, not the company. Reciprocal declared in their §1.56- `software-architecture-patterns-standards` and `refactoring-tech-debt-standards` (**already written**):57 **the technical criteria are theirs** — which pattern applies, when a module is refactored58 and with which technique. Here only **the decision to invest in it, its budget and how it is defended**59 (§3.5). Both already declare the reciprocal in their §1.60- `microservices-architecture-standards`: service boundaries and concrete contracts. Here, the61 organisational reflection of those boundaries (§3.6).62- `code-review-standards` (**already written**): **the review criteria are theirs** — what blocks, how63 the comment is written, what a high-risk change requires. Here only the rule that **review64 is not used as an instrument of power** (§3.8) and who arbitrates the disagreement that review65 does not close.66- `testing-qa-standards`: test strategy and gates. Here, the decision to fund it.67- `sre-practice-standards`: **SLOs, *error budget*, on-call, capacity and the DORA metrics are68 theirs**. Here, solely, that **DORA is a system measure and its individual use is forbidden**69 (§3.9, §7).70- `incident-management-standards`: **the incident process and the blameless postmortem are theirs**71 — roles, timeline, actions. Here what corresponds to leadership and only that: **protecting the72 blameless postmortem when there is pressure from above to name a culprit** (§3.10).73- `platform-engineering-standards` (**already written**): **the platform as an internal product**, its74 paved road, its SLOs and its adoption. Here, the decision to create the team and what load is75 transferred to it.76- `itsm-itil-standards`: service, catalogue and continuous operation.77- `grc-compliance-standards`: regulatory framework, formal evidence, segregation of duties.78- `ai-agent-workflow-standards` (**already written**): **the team policy on coding79 agents is theirs** — which task is delegated, instruction files, permissions, review of the80 diff, attribution. Here only **the decision to adopt it, who pays its organisational cost and which81 metrics are NOT used to justify it** (§3.11).82- `knowledge-management-standards`: where documentation lives and how it is83 kept alive. Here, the obligation that the decision be written down.8485## 2. Default decisions8687> Verify on the web the status of the cited sources before relying on them (§8).8889| Decision | Default | Justifiable alternative |90|---|---|---|91| What distinguishes one level from another | **Scope of impact, type of decision and time horizon** (§3.1) | Never years of experience and never mastery of a technology |92| Career track | **Two tracks with parity of level, scope and pay**, published | A single track only in organisations with < 15 engineers, and declaring it |93| Staff+ work assignment | **By declared archetype** (§3.2), agreed with the person and revisable | — |94| Record of technical decisions | **ADR mandatory**, Nygard format, in the repository of the affected code | A central record **only** if the decision crosses several repositories |95| Decision speed | **Derived from reversibility** (§3.3): reversible → fast and at the lowest level; irreversible → informed and higher up | — |96| Before building anything non-trivial | **A reviewed design document** with acceptance criteria (§3.4) | A throwaway prototype with a time box, if the problem is that it is not understood |97| Technical debt | **An explicit and recurring budget line**, with its unit of measure (§3.5) | Never "when there is time" |98| Measure of a technical leader | **The team's result**: delivery, reliability, autonomy, recorded decisions | — |99| The leader's contact with the code | **The minimum sufficient to judge** (§3.8): reviewing, reading the design, touching the system periodically | — |100| Individual productivity metric | **It does not exist.** Forbidden (§7) | Qualitative evaluation with written and dated evidence |101| 1:1 cadence | **Weekly or fortnightly, the report's agenda**, never a status report (§3.9) | — |102| Team size | **Stable, with bounded load and a single owner for each system** (§3.6) | — |103| Technical disagreement | **Resolved with data, with a deadline, and closed with disagree-and-commit** (§3.7) | Escalation **only** after exhausting the bounded experiment |104105### Sources: what is cited and with what caveat106107- ✅ **One-way / two-way doors.** Primary source: **Jeff Bezos, 2015 letter to Amazon108 shareholders** (`ir.aboutamazon.com`, PDF). **Verbatim** (extracted from the official PDF,109 not from a summary): *"Some decisions are consequential and irreversible or nearly110 irreversible – one-way doors – and these decisions must be made methodically, carefully, slowly,111 with great deliberation and consultation. If you walk through and don't like what you see on the112 other side, you can't get back to where you were before. We can call these Type 1 decisions. But113 most decisions aren't like that – they are changeable, reversible – they're two-way doors. If114 you've made a suboptimal Type 2 decision, you don't have to live with the consequences for that115 long. You can reopen the door and go back through. Type 2 decisions can and should be made quickly116 by high judgment individuals or small groups."* And the diagnosis that matters here: *"As117 organizations get larger, there seems to be a tendency to use the heavy-weight Type 1118 decision-making process on most decisions, including many Type 2 decisions. The end result of this119 is slowness, unthoughtful risk aversion, failure to experiment sufficiently, and consequently120 diminished invention."* **Declared discrepancy**: numerous secondary sources place the framework121 in the **2016** letter; that is incorrect — the Type 1 / Type 2 terminology appears in the **2015** one.122 The 2016 one contains related material (*disagree and commit*), which is a different thing.123- ✅ **ADR.** Primary source: **Michael Nygard, "Documenting Architecture Decisions", 15-Nov-2011**,124 originally published on the Relevance/ThinkRelevance blog and today at `cognitect.com`. A five-section125 template: **Title** (a short noun phrase with a sequential number that is never reused),126 **Status** (proposed / accepted / deprecated / superseded by ADR-NNNN), **Context** (the forces127 at play, in neutral language), **Decision**, **Consequences** (positive and negative). Derived128 rule: **an accepted ADR is not edited**; if the conclusion changes, a new one is written that129 supersedes the previous one and updates its status.130- ⚠️ **Staff+ archetypes.** A published reference taxonomy does exist: **Will Larson, *Staff131 Engineer: Leadership beyond the management track* (2021)** and its origin in the open132 (`lethain.com/staff-engineer-archetypes/`, `staffeng.com/guides/staff-archetypes/`). Four133 archetypes: **tech lead**, **architect**, **solver**, **right hand**. **Explicit caveat**: it is134 a **descriptive taxonomy observed in fast-growing technology companies, not a135 research result**, and it has published criticism from practitioners (Sean Goedecke: the136 archetypes exist but are bad advice as a career target, because *solver* and *right hand*137 depend on accumulated trust and cannot be pursued directly; Alex Ewerlöf: they should not138 be used as job titles). **Permitted use: vocabulary for distributing work and clarifying139 expectations. Forbidden use: turning them into levels, titles or boxes on a ladder.**140- ⚠️ **Team cognitive load.** Original source **John Sweller, "Cognitive load during problem141 solving: Effects on learning", *Cognitive Science* 12(2):257-285 (1988)** — a theory of142 **individual learning and instructional design**. Its transfer to teams is from **Matthew Skelton and143 Manuel Pais, *Team Topologies* (2019)**. **Treat it as a useful analogy, not as a validated measurement**,144 exactly as in `platform-engineering-standards` §6.4: team cognitive load **has145 no measurable unit**, the sum of individual loads is not a construct defined in the original146 theory, and DevOps academic literature points out that the book **provides no scientific evidence**147 and rests on experience and cases. It is useful for **deciding how systems are distributed between teams**; it is148 not useful as a number on a slide.149- ✅ **SPACE.** **Nicole Forsgren, Margaret-Anne Storey, Chandra Maddila, Thomas Zimmermann, Brian150 Houck and Jenna Butler, "The SPACE of Developer Productivity: There's more to it than you think",151 *ACM Queue* 19(1):20-48 (2021), DOI 10.1145/3454122.3454124** (also in *CACM*). Five152 dimensions: satisfaction and well-being, performance, activity, communication and collaboration,153 efficiency and flow. The operational rule taken from it: **measure at least three dimensions at154 once, combining objective metrics and a survey**; activity **never in isolation** to reward155 or penalise. **Declared discrepancy and usage warning**: the claim circulates that "SPACE156 measures the individual and DORA the team" — **that is a misreading**: one of the myths the article157 itself dismantles is that productivity is *only* individual performance, and its central thesis is158 that it is not captured by a single metric nor by activity data. **It has not been possible to retrieve the159 full text verbatim** (ACM Queue and CACM return 403 to automated download): the160 formulations above come from consistent secondary sources and **must be checked against161 the original article before quoting them literally** (§8).162- ✅ **DORA as a system measure.** The four metrics measure **team and system delivery**,163 not people. Report **2025: *State of AI-assisted Software Development*** (`dora.dev/dora-report-2025/`,164 ~5,000 professionals); report **2026: *The ROI of AI-Assisted Software Development*** (InfoQ165 coverage, May-2026). **Caveat about the 2026 one**: there is published criticism that, compared with the166 research rigour of previous editions, it is largely a set of speculative167 recommendations. Cite the edition and the year; **never a bare "DORA says"**.168169### Famous figures: what is NOT used as data170171This domain is saturated with numbers that circulate with no locatable primary study or with172dismantled methodology. These are expressly discarded:173174- ❌ **The "10x programmer".** Origin: **Sackman, Erikson and Grant, "Exploratory Experimental Studies175 Comparing Online and Offline Programming Performance", *CACM* 11(1):3-11, Jan-1968**. Methodological176 refutation: **Lutz Prechelt, "The 28:1 Grant/Sackman legend is misleading, or: How large is177 interpersonal variation really?", Technical Report 1999-18, Universität Karlsruhe, Dec-1999**178 (`page.mi.fu-berlin.de/prechelt/Biblio/varianceTR.pdf`). Flaws in the original: **12 subjects**,179 trivial tasks of a mathematical nature, and **a mix of low-level and high-level language180 programmers in the same group**, which inflates the best/worst ratio. Prechelt reanalyses a much181 larger dataset and argues that **comparing the best with the worst is the wrong comparison**: against182 the median of the worst quartile versus that of the best, the ratio **rarely exceeds 4**, and the183 standard deviation/mean ratio is around **0.5**. **Permitted use**: "there is substantial184 interpersonal variation, of the order of 2-4x depending on the task, with overlapping distributions". **Forbidden use**:185 "10x", and above all **using it to justify pay, staffing or redundancies**.186- ❌ **"An interruption costs 23 minutes and 15 seconds".** **The paper that backs it does not187 exist.** The paper that gets cited, **Mark, González and Harris, "No Task Left Behind? Examining the188 Nature of Fragmented Work", CHI '05**, measures the **probability of resuming a task on the same day**189 and **does not contain that figure**. The other one usually cited, *"The Cost of Interrupted Work: More190 Speed and Stress"*, finds that **interrupted subjects completed the tasks faster**,191 with more stress. The figure comes from **a 2006 interview** with Gloria Mark, not from a peer-reviewed192 article. **It is not written, not even with caveats.** What is defensible without a figure: fragmentation has a cost193 and **the argument for protecting blocks of work does not need an invented number**.194- ❌ **"70 % of the variance in team engagement is determined by the manager"** (Gallup, *State195 of the American Manager*, 2015). **Proprietary analysis, not peer reviewed, with no raw data196 published**, and with two interpretation problems that its diffusion ignores: it refers to variance197 **between teams** (it is not an individual-level claim), and the "manager effect" absorbs everything198 that clusters at team level (function, location, load, staffing). **It is not used as data to199 justify a decision.**200- ❌ **"People leave managers, not companies"** (*First, Break All the Rules*, Gallup). There is a published201 refutation from **Culture Amp (2017)** over 175 teams: people do leave bad managers, but **it is not202 the first reason**, and in bad organisations **having a good or bad manager barely changes the decision to203 leave**. The weak version holds ("the manager's quality is *one* of the factors, conditional on204 the organisation being decent"); the slogan does not.205- ❌ **Turnover percentages attributed to a "bad manager"** and **the cost of a bad hire206 expressed as a multiple of salary** (§ `technical-hiring-standards`): discarded for the same207 reason, there in detail.208209**General rule**: **a figure with no primary study, year, sample and method does not go into a document,210a slide or a budget request.** If the argument only stands with the figure, the211argument was bad.212213## 3. Structure and conventions214215### 3.1 Career tracks: what actually changes216217**What changes when you move up a level is not "the level": it is three observable variables.**218219| Variable | Senior | Staff | Principal |220|---|---|---|---|221| **Scope of impact** | Their team and the system they answer for | Several teams, or a critical area the organisation depends on | The engineering organisation or a cross-cutting capability |222| **Type of decision** | How it is implemented; chooses between known options | Which options exist; defines the problem and the interfaces | What is stopped; irreversible decisions and trade-offs between areas |223| **Time horizon** | Weeks to a quarter | Quarters to a year | One to several years |224| **Required evidence** | Systems delivered and operable | Other people's designs improved, decisions recorded, people levelled up | Changes of direction the organisation followed and that can be traced |225226Hard rules:2271. **The ladder is published.** A ladder only the manager knows is not a ladder, it is a retroactive228 excuse. Public references exist so as not to start from zero — **Rent the Runway (2015, with229 Camille Fournier as CTO), Dropbox, CircleCI, Square, Kickstarter**, aggregated at230 `progression.fyi` and `github.com/bmoeskau/engineering-ladders`. **They are adapted, not copied**: someone231 else's ladder describes someone else's organisation.2322. **Real parity between tracks.** The individual contributor track and the management one have **the same233 level ceiling, the same salary band and the same presence in decision-making forums**. Without those234 three, the technical track is decorative and everyone knows it within six months.2353. **Managing is not a promotion, it is a change of job.** The work, the measure and the skill are236 different. Operational corollary: **there is a declared way back**, and using it is not a failure237 recordable in the evaluation.2384. **The level is assigned on written evidence**, not on seniority and not on likeability. If the evidence cannot239 be written down with dated facts, there is no level.2405. **No level is defined by a technology.** "Kubernetes senior" is not a level, it is a241 dependency on a tool with an expiry date.242243### 3.2 Staff+ archetypes: what they are really for244245They serve one purpose, and that is why they are here: **avoiding assigning work the person cannot246do from where they are.** Taxonomy and caveats in §2.247248| Archetype | Work that belongs to them | Work that destroys their impact |249|---|---|---|250| **Tech lead** | Approach and execution of **one** team, alongside the manager | Being the bottleneck for the decisions of another three teams |251| **Architect** | Direction, quality and approach of **one critical area**, with a multi-year horizon | Firefighting outside their area; making their area depend on their presence |252| **Solver** | Going into a hard, bounded problem and coming out with the path resolved | Becoming the permanent owner of what they fixed |253| **Right hand** | Extending an executive's reach in a large organisation | Existing in an organisation that does not need one: it reproduces hierarchy without adding judgement |254255Rules:256- **The archetype is agreed in writing with the person and is reviewed** (by default, every six months or257 when the project changes). A *solver* who gets handed the maintenance of everything they touched258 stops being a *solver* within a quarter.259- **Architect and right hand only appear at a certain scale.** Larson observes them emerging around260 ~100 and ~1,000 engineers respectively. **Creating them earlier manufactures a decision layer with no261 problem to solve.**262- **FORBIDDEN to use them as titles** or as levels on the ladder (§7).263264### 3.3 Decisions: what is decided, who decides and how fast265266**Who decides, by default:**267268| Type of decision | Decided by | Consulted | Recorded in |269|---|---|---|---|270| Implementation inside a module of the team's own | **Whoever implements it** | The PR reviewer | The code and the PR |271| Choice of library or pattern within the team | **The team**, the tech lead arbitrates | — | **The repository's ADR** |272| Contract or interface between two teams | **Both teams, jointly** | The area's architect | **ADR + versioned contract** (`api-design-standards`) |273| A new technology in the organisation, or the retirement of an existing one | **Staff+ level or architecture**, with published criteria | Platform, security, FinOps | **ADR + inventory** |274| A scope or date commitment | **Not this skill** | — | `project-management-standards` |275| Acceptance of a regulatory risk | **Whoever has the formal authority** | — | `grc-compliance-standards` |276277**The ADR is an obligation, not a courtesy.** Minimum rule: **if a technical decision is going to condition the278work of someone who was not in the conversation, it gets written.** Nygard format (§2), in the279affected repository, numbered and not editable once accepted.280281**Speed is set by reversibility, not by perceived importance** (Bezos 2015, verbatim in §2):282283| | One-way door (Type 1) | Two-way door (Type 2) |284|---|---|---|285| Typical examples | Public data model, identity scheme, API format exposed to third parties, lossy migration, choice of a vendor with an expensive exit | Internal library, folder structure, internal log format, test framework |286| Speed | **Slow, deliberate, informed**: design document, alternatives evaluated, formal review | **Fast**, by the person or the small group closest to the problem |287| Level that decides | Higher up, with consultation | The lowest possible |288| Cost of being wrong | High and permanent | Low: the door reopens |289290- **Every ADR carries a `reversibilidad` field with an explicit value.** Without it, the organisation treats291 everything as Type 1 and grinds to a halt — the failure the 2015 letter itself describes.292- **The classification can be challenged, but in writing and with an argument.** "This is irreversible"293 is a falsifiable claim: you ask for the estimated cost of reverting it.294- **A Type 2 decision that has been under discussion for three weeks already cost more than being wrong.** Rule:295 a time box, and if it expires, the person with the responsibility decides and it is recorded.296297### 3.4 Design document and design review298299**The design review is the point in the cycle where a mistake is still cheap.** Afterwards there is300code, dependencies, migrated data and people who have already defended it in public.301302**When a design document is mandatory** (any one is enough):303- The decision crosses a team boundary or creates/changes an interface between teams.304- It is a one-way door (§3.3).305- It touches personal data, authentication, authorisation, cryptography or money.306- The estimated effort exceeds a threshold the team publishes (by default: **two person-weeks**).307- A technology the organisation does not yet operate is introduced.308309**Minimum template. A document without sections 5, 6 and 8 is sent back unreviewed.**310311```markdown312# Diseño: <nombre> Autor: <persona> Estado: borrador|en revisión|aceptado|sustituido3131. Problema # qué falla hoy, con evidencia observable (dato, incidente, ticket)3142. Restricciones # plazo, presupuesto, normativa, compatibilidad, equipo disponible3153. No objetivos # lo que este diseño explícitamente NO resuelve3164. Propuesta # la solución, con el diagrama mínimo que la explique3175. Alternativas descartadas # >=2, con el motivo del descarte. Sin esto no hay diseño, hay preferencia3186. Criterios de aceptación # falsables y medibles: cómo se sabrá que funcionó, y cuándo se mira3197. Impacto # migración, compatibilidad hacia atrás, coste recurrente, operabilidad, seguridad3208. Reversibilidad # Tipo 1 o Tipo 2, y coste estimado de revertir3219. Riesgos abiertos # con dueño322```323324**Review rules:**325- **The problem is reviewed before the solution.** If the reviewers do not agree on the326 problem, discussing the solution is wasted time and it always ends in aesthetics.327- **Mandatory pre-reading, with a deadline** (48 h by default). A meeting where the document is read328 live is a reading meeting, not a review.329- **Comments are labelled as blocking or non-blocking**, just as in code review330 (`code-review-standards`). A reviewer who marks nothing as blocking has approved.331- **The review ends with a decision and a date, not with "let's keep talking".** The332 valid states are: accepted, accepted with listed conditions, rejected with a reason, or postponed with333 a date and with what remains to be found out.334- **The accepted document becomes an ADR or links to one.** A design that leaves no trace of a decision335 gets discussed again in six months.336- **Acceptance criteria with a check date.** They are revisited when due: if they were not met,337 that is information about how the team designs, and it is the cheapest input there is for improving.338339### 3.5 Technical debt: a business decision with a budget340341The technical criteria —what to refactor, with which technique and with which test net— belong to342`refactoring-tech-debt-standards` (**already written**). **Here only the decision to invest and343how it is defended.**3443451. **Debt is recorded like any other work**, in the same backlog, with an owner and with the346 **cost it imposes today** — not with adjectives. Admissible formulation: *"every change in the347 billing module requires touching four places and last quarter it generated 3 of the 7 incidents"*.348 Inadmissible formulation: *"the code is bad"*.3492. **Distinguish deliberate debt from degradation.** Deliberate debt was incurred with a recorded350 decision and a review date (if it does not have one, it was not a decision: it was an oversight).351 Degradation is silent accumulation and is detected by symptom, not by opinion.3523. **An explicit and recurring budget.** A percentage of capacity per cycle is declared,353 published and **protected the way a committed date is protected**. A percentage that gets cancelled in354 the first quarter under pressure was not a budget: it was an intention.3554. **How it is defended to whoever pays — and this is what always fails.** Technical debt is not356 defended as code quality: **it is defended with the cost the business is already paying**, in357 its vocabulary. Arguments that work because they are verifiable:358 - **Lead time**: the same change takes X in this module and Y in the rest.359 - **Reliability**: the proportion of incidents concentrated in the component360 (`incident-management-standards` provides the datum).361 - **Direct cost**: oversized infrastructure, licences, hours of manual operation362 (`finops-standards`).363 - **Risk with a name**: an unsupported dependency, a version with no security patches364 (`vulnerability-management-standards`), regulatory non-compliance (`grc-compliance-standards`).365 - **The option that is lost**: what will not be doable, and when, if it is not touched.3665. **A refactor request with none of those five arguments is rejected**, whoever makes367 it. And it is rejected here, inside engineering, before the business rejects it: **credibility368 is spent once**.3696. **Never "a refactor release" that delivers nothing.** Debt work is delivered in370 increments with an observable effect; if it cannot be split, the problem is the design of the371 intervention, not the calendar.372373### 3.6 The team as a system374375- **A single owner per system.** A system with no named owner is maintained by whoever had the bad luck376 of touching it last. Two owners is zero owners.377- **Bounded load, in the analogical sense of cognitive load** (§2, with its caveat): a team378 answers for as many systems as it can **understand, operate and improve**. An operational and379 falsifiable test that requires no invented metric: *can the team deploy, diagnose in380 production and explain the data model of every system it answers for, without depending on one381 specific person?* If not, the load exceeds the team — the scope is reduced or extraneous load382 is transferred to the platform (`platform-engineering-standards`).383- **Stable teams.** Reorganising teams resets system knowledge and trust384 relationships. **Every reorganisation is justified in writing with the problem it solves and its expected385 cost**, or it is not done.386- **Size**: small enough that everyone knows everyone's work, large enough387 to sustain an on-call rota without burning anyone (`sre-practice-standards` fixes the latter).388 **Adding people to a saturated team adds coordination before it adds capacity**389 (`project-management-standards` §6).390- **Inter-team dependencies: they are managed by interface, not by meeting.** Preference, in order:391 (1) eliminate the dependency, (2) decouple with an interface contract and a simulator, (3) sequence392 with a mutual commitment from the providing team, (4) escalate. **Adding a recurring393 sync meeting is choosing (4) and calling it (3).**394- **The team's structure and the system's converge** (Conway). Practical consequence: **if you395 want a different architecture, you have to change the team boundaries, not just the396 diagram.**397398### 3.7 Technical conflict399400**A technical disagreement with no procedure gets resolved by hierarchy or by exhaustion, and both401produce the worst decision available.** Procedure, in this order and with a deadline:4024031. **Make the disagreement explicit**: each side writes, in one paragraph, what they defend and **what evidence404 would make them change their mind**. Whoever cannot answer the second has no technical position,405 they have a preference — and preferences do not block.4062. **Find the datum**: prototype, measurement, load test, review of a past incident. **With407 a fixed time box agreed beforehand.**4083. **If the datum does not discriminate** (a real tie), **whoever answers for the consequences** decides —409 normally the owner of the affected system — and it is recorded in an ADR with the alternatives and the410 tie declared.4114. **Disagree and commit, as an explicit team rule.** Reference: Amazon's leadership412 principle **"Have Backbone; Disagree and Commit"** (`amazon.jobs`) — the obligation to challenge the413 decision respectfully even when it is uncomfortable, and **full commitment once it is taken**. The term is414 older than Amazon (Intel, *constructive confrontation*). The local rule, which is what applies:415 **once the decision is closed, nobody passively sabotages it or reopens it in corridors**; it is reopened416 only with new evidence and through the same channel.4175. **When it is escalated**: when the disagreement crosses the boundary of two teams and blocks work for more418 than a week, or when it involves a security, legal or personal-data risk. **Escalating is not419 losing**: escalating late is.4206. **A disagreement that repeats is an organisational design problem**, not a people problem: the421 boundaries of responsibility are badly drawn (§3.6).422423### 3.8 The technical leader's work that is not writing code424425**Their value is measured in the team's result, not in their own *output*.** Direct consequences:426if the most productive person on the team is the leader, the team is underused; if the leader427is on the critical path of every delivery, they are a SPOF with holidays.428429Work that is theirs, and that produces leverage:430- **Unblocking**: identifying who is stuck and why, and getting it out of the way. It is the highest-return431 activity of the job and the first one sacrificed when the leader starts programming.432- **Defining interfaces between teams** before two teams build against different433 assumptions (§3.6).434- **Reviewing other people's designs and decisions** (§3.4) — not rewriting them.435- **Writing what the organisation will need to remember**: ADRs, context, criteria.436- **Creating the conditions for someone else to take the decision**, and accepting that they take it differently from how437 the leader would have taken it if the result is acceptable. **A leader who only delegates the decisions that438 would have matched their own has delegated nothing.**439- **Developing people** (§3.9): it is work with a calendar, not a by-product.440441**The opposite trap, and it is just as real: the leader who stops touching the code loses the ability442to judge.** With no contact with the system, other people's estimates become uncheckable, designs443get approved out of trust in the person and not because of the content, and technical debt becomes444a story with no evidence. **Non-negotiable operational minimum:**445- Review code properly and regularly (`code-review-standards`), including changes they do not446 fully understand, which is where you learn where the system is.447- **Be in the on-call rotation** if the team has one, or at least take part in incident448 response (`incident-management-standards`).449- **Take real work, but never on the critical path**: internal tooling, fixes,450 tests, the task nobody wants. **FORBIDDEN to take the quarter's critical feature**:451 it turns them into a bottleneck and leaves the team without the developmental part.452- Arbitration rule between the two traps: **if the team delivers just as well when the leader is453 away for two weeks, the split is correct.** It is the only test that matters, and it can be run454 literally.455456**Code review is not used as an instrument of power.** Vetoed manifestations: blocking a457PR out of aesthetic preference, demanding your own solution with no technical argument, withholding approval458as leverage in a negotiation unrelated to the diff. The criteria for what blocks belong to459`code-review-standards`; **the obligation that the leader does not distort it belongs here**.460461### 3.9 1:1s, feedback and evaluation462463**The 1:1 belongs to the report.** Concrete rules:464- **The agenda is set by whoever reports**, and it exists before the meeting. If there is no agenda, the default465 question is not "how is X going?" but **"what is getting in your way most?"**.466- **FORBIDDEN for it to be a status report**: the state of the work is in the management system467 (`project-management-standards`) and consulting it is the leader's responsibility, not minutes of the468 person's time.469- **A fixed and protected cadence** (weekly or fortnightly by default). **Cancelling it repeatedly470 communicates a priority more clearly than any speech.**471- **Shared notes and commitments with an owner and a date.** A 1:1 with no trace repeats identically for472 a year.473- At least once a quarter, the 1:1 is about **career**: current level, missing evidence,474 archetype (§3.2), what work needs to be sought to get there. With the published ladder in front of you.475476**Feedback:**477- **Specific, dated and about observable behaviour**, not about traits. *"In the review of the payments478 design on 12 May you closed the discussion before Ana presented her alternative"* is479 actionable. *"You are not very collaborative"* is not: what cannot be observed cannot be corrected.480- **Close to the event.** Feedback saved for six months for the annual review is not feedback: it is an481 ambush, and it destroys the credibility of the whole process.482- **No surprises in the evaluation.** Falsifiable rule: **if something appears in the annual review and it is483 the first time the person hears it, the failure is the leader's, and it is recorded as such.**484- Difficult feedback is given in private, in writing as well as verbally, and **with what is expected485 differently and by when**.486487**Why individual engineering productivity metrics are counterproductive** — and this488is the part you have to be able to defend to management with the source in hand:4891. **The published position of the sector's reference research.** **DORA**: the four metrics490 measure **team and system delivery** and must not be used to evaluate the performance of491 individual engineers; applying them to people creates perverse incentives. **SPACE** (Forsgren et492 al., 2021, §2) dismantles two directly applicable myths: that productivity is activity, and493 that it is **only** individual performance; and it establishes that **activity metrics are never used494 in isolation to reward or penalise**.4952. **They are trivial to game and gaming them is rational**: lines, commits, PRs and points are496 free to inflate and the cost of inflating them is paid by someone else (the reviewer, the maintainer).4973. **They measure the visible and punish the valuable**: reviewing, pairing, mentoring, being on call,498 deleting code and preventing the unnecessary from being built leave no trace in any counter.4994. **Engineering work is interdependent**: attributing the result to an individual within500 a system with queues, dependencies and review is an attribution error, not an imprecise501 measurement.5025. **The alternative that is used**: qualitative evaluation **with written and dated evidence** against503 the published ladder (§3.1) — designs, recorded decisions, incidents resolved, people504 developed, systems that work without their author. **It is more work for the leader. That is the505 cost of the job.**506507### 3.10 Incidents: what corresponds to leadership508509The full process belongs to `incident-management-standards`. **Here only the part that only510leadership can do, and which is where the blameless culture breaks in practice:**511- **Protecting the blameless postmortem when there is pressure from above to name someone.** The512 pressure is real and arrives in the form of a reasonable question ("who deployed it?"). The standard513 answer, in the same language as whoever asks: **the system allowed an individual error514 to reach production; that is the defect and that is what gets fixed, because it is the only one that will not515 recur.** Replacing the person leaves the system identical for the next one.516- **Verifiable drafting rule**: **the postmortem contains no proper names as a cause.** If517 "X ran Y" appears, it is rewritten as "the procedure allowed Y to be run without confirmation".518- **Honest contraindication**: blameless **does not mean without responsibility**. Repeated519 negligence, knowingly bypassing controls or acting without authorisation are a conduct matter and are520 handled **outside the postmortem, through another channel and with HR.** Mixing them destroys both.521- **The postmortem's actions get funded.** A postmortem whose actions do not enter the next522 cycle's plan teaches the team that the exercise is theatre, and from then on postmortems523 are written to be filed.524- **The leader publicly owns the team's failure and publicly attributes the success.** It is a525 conduct rule with a verifiable effect: without it, nobody reports a problem early.526527### 3.11 Coding agents: what leadership decides528529The concrete policy —which task is delegated, instruction files, permissions, review of the diff,530attribution— belongs to `ai-agent-workflow-standards`. **Here, three 531532…(truncated)