Skip to content
syntaqx

Leadership, chapter 02 of 09

Onboarding

Getting a new engineer to a merged change in week one: access ready on day one, a buddy, a written 30/60/90 plan, real starter tasks, and on-call by stages.

3 min readUpdated

A good hire is only the start; onboarding is where a team finds out how much of its knowledge is written down. A new engineer stuck for three days on local setup isn't a slow learner; they've found a README that's wrong, an undocumented dependency, or a credential only one person can issue. Treat every snag as a bug in the team, because the next hire will hit it too.

The goal I set: a merged change to production in the first week. A typo fix through the real pipeline proves the setup works, the access is in place and the review and deploy path is understood, and it gives the new person something done instead of a week of reading.

Ready Before Day One#

Accounts, laptop, repository access, chat, the on-call tool, the cloud console with the right (limited) permissions: all requested before the start date. A first day spent filing access tickets tells the new person nobody prepared for them. Keep the access list as a checklist in the repository, and every new hire adds what was missing.

One Command to Run It#

The README should take someone from a fresh clone to a running system with one command, as Code Ownership requires. If setup is ten manual steps in a wiki, the first job of the new hire, with a buddy, is to fix that. It's the most valuable onboarding task there is: they're the only person on the team who can still see what's confusing.

A Buddy, Not Just a Manager#

Pair each new engineer with a buddy: a peer, not their manager, whose explicit job for the first weeks is answering questions. New people hesitate to ask "obvious" things of a manager or a busy senior engineer, and an unasked question becomes an hour lost. Budget real time for it; a buddy with a full sprint of their own will be too busy to help.

A Written 30/60/90 Plan#

A short written plan, agreed in the first week, says what success looks like at 30, 60 and 90 days:

By Typically
30 days Shipping small changes independently, understands the team's systems and how work flows
60 days Owning a meaningful piece of work end to end, contributing in reviews and design discussions
90 days Working at the level they were hired for, and starting on-call

Writing it down answers "how am I doing?", the question every new hire carries and few ask, and gives the manager something concrete to check in against.

Real Work, Early#

Starter tasks should be real: a small feature, a bug users hit, a gap in monitoring, an annoying manual step to automate. The Google SRE book makes the same case for its new engineers: ownership of something small beats a queue of repetitive tickets, because it teaches how the pieces fit together. Avoid the "read the codebase for two weeks" start; people learn a system by changing it.

The Docs Are the Onboarding Path#

The best onboarding program is documentation good enough that a new engineer finds answers without asking. This playbook is exactly that: "how we do things here", learned by reading instead of by being corrected in review. Where the docs are wrong or missing, the new hire fixes them; they're the best-placed person to notice.

On-Call by Stages#

Nobody should take their first page alone at 3 a.m. Bring new engineers into on-call gradually: read past postmortems and runbooks, shadow a rotation (receive the pages, don't own them), reverse-shadow (lead while an experienced engineer watches), then take the rotation with a clear escalation path. The SRE book calls the move to on-call "a milestone in a new SRE's career", and it should feel like one.

Ask How It Went#

At 30 and 90 days, ask what was confusing, what was missing and what they'd change, then change it. The feedback is unusually honest and cheap, because the person still remembers not knowing.

References#

In practice