Most on-call disasters don't start during the on-call shift — they start at the handoff.
Engineer A closed the ticket in their head, muttered something in a hallway, and went on leave. Engineer B inherited a sleeping pager with three landmines inside it. Monday morning an alert fires, and B discovers the failing replication job that A has been babysitting all week — from scratch, at 8:47am, while the pager is still screaming.
The fix costs nothing: a five-minute written handoff with five things in it. Here's the checklist we run, and the note template you can paste tonight.
The handoff note — five things, always
- Written, not verbal. Ever. "I told Dave about the cron job" is not a handoff — it's a rumor. If it isn't in the handoff note, the next engineer doesn't know it, and in three weeks nobody will.
- State of the world, in one paragraph. What's degraded, what's flapping, what was fixed this week and how. Under five lines.
- Open items with owners and deadlines. The paused migration, the cert expiring Thursday, the vendor ticket nobody answered since Tuesday. Name, date, next action.
- Known flaky alerts, with the tell. "pvc-alert flaps at 3am — it's the NFS mount, ignore unless it persists 15+ min." This single line converts 80% of night pages back into sleep.
- In-flight changes and their landmines. Anything deployed, flagged, or disabled this week — plus what to do if it misbehaves. Nobody should discover a feature flag during an incident.
The seven lines you can paste tonight
ON-CALL HANDOFF — <date> — from <name> to <name>
STATE: everything up. Dashboard link. One degraded thing: <what>.
FLAKY: <alert> flaps <when> — <why> — ignore unless <condition>.
OPEN: 1) <item> — owner <who> — due <when> — next step <what>.
CHANGES: <what shipped / got disabled> — if it misbehaves: <action>.
WAITING: <vendor/team> owes us <answer> since <date>.
ESCALATE TO: <name> for <area>, <name> for <area>. If unsure: <name>.
Two minutes to write, ten seconds to read — and it survives holidays, sick days, and people quitting. A hallway conversation survives none of those.
The rules that make it stick
- Same time, every time. A fixed handoff slot means the note is expected, not discovered.
- Fifteen minutes synchronous, then written. Talk is fine for tone; the note is the artifact. If only the talk happened, the handoff didn't happen.
- The receiver asks one question: "what would you warn me about?" Whatever comes out goes in the note verbatim. Gut feelings capture what tickets don't.
- No new on-call starts blind. First day on-call? The outgoing engineer shadows the first alert hour.
- Review the note in the postmortem. When an incident traces back to a missed handoff item, add it to the template. The note is a living control, not a ritual.
If your rotation is held together by hallway conversations, the free On-Call Handoff Checklist (part of 40+ free ops templates at HIVE80lab ops notes) takes two minutes to adopt.
And when you're ready for the full pack — rotation schedule, escalation matrix, and the on-call runbook — the Ops Starter Kit Vol. 2 ($27) has it. Launch week: 30% off any paid kit with code HIVE-LAUNCH30.
Top comments (0)