Engineers don’t ship without a design doc. Why do we hire without one?


01 · STAND-UP

“Before you build, you must understand the problem.”

  • Linus Torvalds, creator of Linux

Every engineer I’ve ever worked with knows this instinctively.

You don’t write code before you understand the system.

You don’t ship before you define what done looks like.

But when it’s time to hire, most engineering teams skip the design doc entirely.

And then wonder why the search falls apart.


02 · SPRINT

Engineers don’t ship without a design doc.

Why do we hire without one?

Every engineering team I’ve worked with has a process for building product.

Define the problem.

Set the constraints.

Align on success criteria.

Then — and only then — start building.

But when it’s time to hire?

Most EMs get handed a job description written by someone else, a recruiter they’ve never met, and a 30-minute slot in their calendar.

No definition of the problem.

No constraints.

No shared picture of what success looks like.

And then everyone wonders why the search takes six months.

Here’s what I’ve started doing with every EM before a search opens.

I ask them to write a candidate design doc.

Not a job description. A design doc.

Who is this person?

What problem do they solve for the team?

What does success look like at 30, 60, 90 days?

What are the hard constraints — the non-negotiables?

What kind of person fails in this environment, and why?

It takes one afternoon.

It saves weeks of misaligned interviewing.

The job description tells candidates what you want.

The candidate design doc tells your team what you’re building.

Those are very different documents.

Most companies only write one of them.


03 · RETROSPECTIVE

✅ What went well

In most cases, great engineering teams notice the the lack of alignment in the first batch of candidates they interview. It is then, and only then, when the pain of hiring begins to feel real. Not during a resume review, but when a group of candidates are on your calendar for 30 minute conversations.

🔧 What could be improved

The candidate design doc is still a foreign concept to most hiring teams. The job description is deeply embedded in the workflow — it’s the default. Getting EMs to replace it with something unfamiliar requires more than a framework. It requires a shift in how they think about hiring altogether.

⚡ One action item before next week

If you’re an EM opening a role right now — try answering these five questions right now, without a meeting:
​
Who is this person? What problem do they solve?
​
What does success look like at 30, 60, 90 days?
​
What are the non-negotiables?
​

Hit reply and tell me where you got stuck. I read every response.

600 1st Ave, Ste 330 PMB 92768, Seattle, WA 98104-2246
​Unsubscribe · Preferences​

the asmbld newsletter.

Weekly stories, tips, and lessons on building a software engineering career in the digital health space. Join the list for jobs, resume prompts, and salary benchmarks in your inbox.

Read more from the asmbld newsletter.

01 · STAND-UP “The most important thing in communication is hearing what isn’t said.” — Peter Drucker Most candidates answer “tell me about yourself” by narrating their resume. The interviewer already has the resume. What they’re actually listening for is whether you understand your own work well enough to explain it to a stranger in ninety seconds. Here’s the framework I developed over ten years working with Engineering Managers. 02 · SPRINT I’ve sat across from a lot of engineers in the...

01 · STAND-UP "Your network is the people who want to see you win." — Sahil Lavingia Most people hear "network" and think LinkedIn requests. Sahil meant something different. He meant the people already watching — who notice a typo in your GitHub repo, who forward your message to someone who books you on a panel. You don't build that in a day. You tend it over years. Start now. 02 · SPRINT The typo that closed a contract A friend messaged me out of nowhere last week. She’d been looking through...

01 · STAND-UP "Feedback is the breakfast of champions." — Ken Blanchard Most teams serve cold coffee and call it a meal. The debrief happens. Someone types two sentences into the ATS. The candidate gets a rejection email written by a lawyer in 2019. "Unfortunately, we moved forward with someone with {insert variable reason}..." And everyone wonders why the next search starts with the same problems. 02 · SPRINT I've been working with a handful of startups for the last 3 months. All of it has...