The 42 Principles · Principle XVIII

Respect the Next Engineer

Empathy, maintainability, context, clarity, and considering the person who will inherit your decisions.

Respecting the next engineer begins with understanding that no two engineers arrive with the same experience.

We all have strengths, and we all have opportunities to grow. Those differences are shaped by many factors: previous responsibilities, formal training, the quality of past mentorship, exposure to difficult problems, and the level of curiosity a person has brought to the work.

One engineer may be exceptional at troubleshooting but inexperienced with architecture. Another may understand systems deeply but struggle to explain what they know. Someone may have spent years mastering one narrow technology while another has developed broad knowledge across many environments.

None of those differences automatically make one engineer better than another.

They make them different.

By the time someone reaches the engineering level, temperament has usually been tested. The work itself tends to expose people who cannot remain patient, accept correction, work through uncertainty, or take responsibility for their decisions. The engineers who remain may still have different levels of skill, but they have generally demonstrated the ability to learn and contribute.

That deserves respect.

Respecting the next engineer does not mean assuming they already know everything you know. It means refusing to treat unfamiliarity as incompetence.

You may have solved a problem dozens of times that they are encountering for the first time. You may recognize a failure pattern immediately because a similar incident once consumed three days of your life. The next engineer does not yet have access to that experience unless you leave something behind that allows them to benefit from it.

That is where workflows become important.

Not every engineer naturally thinks outside the box. Some people are comfortable experimenting without a clear path. Others work best when the process is defined and the expected outcome is visible. Both can contribute meaningfully.

Every capable engineer can follow a well-designed workflow.

More importantly, the right workflow can teach them how to move beyond it.

A good workflow should not merely say:

Click this button, enter this command, and proceed to the next step.

It should explain what is being tested, what the expected result means, and what decision should follow from each possible outcome.

That turns a checklist into a teaching tool.

An engineer who repeatedly follows a workflow built around observation, validation, and decision-making begins to recognize the reasoning beneath the steps. Eventually, they stop seeing the workflow as a rigid path and begin seeing it as a model for approaching unfamiliar problems.

That is how thinking outside the box can be taught.

You first give someone a reliable box.

You show them how it was constructed, why each wall exists, and what conditions would justify stepping beyond it.

Without that foundation, telling someone to “think outside the box” is not guidance. It is an expectation without instruction.

Respect also means leaving the environment in a condition that allows the next engineer to succeed.

Document what you changed.

Record why you changed it.

Preserve the commands, evidence, assumptions, dependencies, and rollback path.

Do not leave behind a puzzle simply because you were able to solve it.

The next engineer should not have to reverse-engineer your thinking from scattered logs, unexplained settings, or a configuration that only makes sense to the person who created it. Their time is no less valuable than yours.

This does not mean removing every challenge from their path. Engineers grow by solving difficult problems. But there is a difference between a meaningful challenge and unnecessary confusion.

A meaningful challenge develops judgment.

Unnecessary confusion merely wastes time.

Respecting the next engineer also requires humility. The person who follows you may know something you do not. They may see a weakness in your design, identify an assumption you overlooked, or discover a better solution.

Your work should invite improvement rather than defend itself from it.

The goal is not to build something that proves how clever you were.

The goal is to build something another capable person can understand, operate, challenge, and improve.

Respect the next engineer enough to leave them a path—and trust them enough to let them improve it.

The strongest engineering cultures are not built around a few indispensable experts. They are built by people who make their knowledge transferable, their decisions understandable, and their systems supportable.

Respect is not merely how we speak to the engineer standing beside us.

It is what we leave for the engineer who comes after us.


Related Principles

Continue the idea.

These Principles share themes with Principle XVIII.