A handoff message works when the reader can finish the job without asking you a single question. Four things make that possible: where the work stands right now, the next action in plain words, what you want done for each way it can go, and the one item that waits for you.
Most handoffs get three of those. The one that goes missing is the decisions, so the reader wakes up fully briefed and completely stuck.
The reason is not laziness. Deciding the branches is the only part of a handoff that costs you anything, because every one of them is you agreeing in advance to live with a call you will not be awake for.
The four parts of a message someone can act on
An actionable handoff answers the questions the reader would otherwise have to send you, in roughly the order they would ask them.
- Where the work stands right now, in one line, in the present tense.
- The next action, written as something a person can start today.
- Your call for each way the thing can go.
- The one item nobody should touch until you are back.
Everything else is background. Background is welcome at the bottom, where it costs nobody anything.
Order matters more than completeness. Put the state and the action at the top and everything underneath gets read by someone who has already started moving; bury them and the whole message gets read before any of it gets done.
Write the state, not the story
Open with where things stand right now, not with what you did all afternoon.
Here is the story version: "Spent most of today on the billing bug, tried a few things, went back and forth with support, still digging." It is honest. It is also unusable.
Here is the state version: "Billing bug reproduces on staging, never on live. It only fires on invoices with no tax line." Same afternoon. Now somebody else can carry it.
Present tense does the editing for you. Anything you cannot say is true at this moment is either history or hope, and neither one helps a reader who has to act. The same instinct is what separates a standup update people read from a list of activities.
Give the next action a verb
The next action has to be something a person could start without first working out what you meant.
"Look at the invoice thing" is a topic. "Reply to Dana approving invoice 4102, then close the ticket" is an action. Topics travel badly overnight, because the reader has to reconstruct your intent from a noun, and reconstruction is exactly where the round trip is born.
Put whatever the action needs in the same line as the action. Someone hunting for the link you mentioned, in a channel they were never added to, has already lost the hour you were trying to hand them.
Decide the branches before you sleep
Write down what you want to happen for each way the work can go, so silence never blocks anybody.
Three lines usually covers it:
- "If the tests pass, ship it. You do not need me for that."
- "If the client answers before noon, book the call for Thursday."
- "If it breaks the same way as yesterday, park it and I will take it back."
Handing over authority is not the hard part, and I have made that case already for the longer kind of handover. The hard part is that authority granted in the abstract does not survive contact with a real fork in the road. "Use your judgment" gets read as "check with me first". A named branch with a named answer cannot be read that way.
You will get some branches wrong. A wrong call that moved is almost always cheaper than a right call that sat still, and the branch you guessed badly is easy to reverse when you wake up. If the choice genuinely needs a person, that is a different message, and it needs to be a real request for a decision rather than a paragraph hoping someone volunteers.
Say the one thing that has to wait
Name the single item nobody should touch until you are back, and say why in about six words.
"Do not push to live without me, the rollback is manual." That is the whole line. It takes seconds to write and it makes every other permission in the message believable, because open-ended permission with no edges reads as carelessness and careful people ignore it.
Keep the stop list at one item where you can. A handoff with five red lines has quietly told the reader to do nothing at all.
Tell them which paths are dead
Tell the reader which paths are dead, or they will walk down every one of them again.
Two lines is plenty. "Not a caching problem, already checked." "The retry logic is fine, I read it twice."
This is the cheapest gift in the whole message, and it is the part people skip, because ruled-out work feels like failure and nobody wants to write down their failures at the end of a long day. It is the opposite of failure. Two lines of dead ends are usually the most valuable thing in the message, and I still leave them out more often than I put them in, generally on the days they would have saved somebody the most time.
One message, one place, timed for their morning
Put the whole handoff in a single message, in the place the reader already opens without being told to.
Split it across a channel, a document, and a ticket comment and you have written a scavenger hunt. Send it before you close the laptop, not when you remember it at midnight, because a handoff that lands after their day has started is a status report about work that already went sideways.
End of day is also when writing gets worst. Sentences get shorter, context gets assumed, and the reader you are writing for is the one person who has none of it. This is the moment where I lean on Unvent, because rewriting the message where I am already typing it is the difference between sending my tired shorthand and sending something a stranger can use.
One habit worth stealing. Read the handoff back as though you have never seen the project, and mark the first place you would have to ask a question. Then answer that question in the message. It takes a minute. The alternative is somebody sitting on their hands until you wake up.
Readable by someone who was not there
Unvent rewrites what you are typing, right where you are typing it, so the note you leave at the end of a long day still makes sense to someone reading it cold. The work keeps moving while you are asleep.
Add Unvent to Chrome