Press ⌃X on any window. Get just the point. Chats, docs, videos, pull requests.
Coming soonGreat question! Designing an on-call rotation is one of the most important things a growing engineering team can get right, and there's no single answer that works for everyone. Let's break it down.
On-call rotations exist to ensure that someone is always available to respond when something goes wrong in production. The specific shape of your rotation should reflect your team size, your incident volume, and your culture.
It's important to note that there is a meaningful difference between being on-call and being available. The former implies a commitment to respond within a defined window; the latter is considerably more informal.
The most common rotation lengths are one week and two weeks. Shorter rotations reduce the burden on any individual engineer, while longer rotations reduce the overhead of handoffs and provide more continuity.
Many teams find that a one-week rotation strikes a reasonable balance. That said, some teams prefer two weeks, particularly where incident volume is low and the handoff cost is proportionally higher.
As a general rule of thumb, you want at least six engineers in a rotation before it becomes sustainable. With fewer than six, each engineer is on-call often enough that it begins to meaningfully affect quality of life.
If your team is smaller than that, you may want to consider combining with an adjacent team, or accepting a lighter-weight arrangement where response times are longer and expectations are set accordingly.
Most mature rotations have both a primary and a secondary responder. The primary takes the page first; the secondary is the escalation path if the primary does not acknowledge within a defined window.
This provides redundancy and reduces the anxiety associated with being the only person responsible. It is worth noting that the secondary should be a genuine backup, not simply a name on a schedule.
Let me know if you'd like me to expand on any of these points!
The handoff between rotations is where a surprising amount of value is either created or lost. A good handoff transfers context about ongoing issues, recent changes, and anything the incoming engineer should watch.
Some teams do this synchronously in a short meeting; others use a written handoff document. Both approaches work, and the right choice depends largely on your team's existing communication habits and time zones.
Whether and how to compensate engineers for on-call time is a question with no universal answer. Some organizations pay a stipend, some offer time off in lieu, and some treat it as part of the role.
Whatever you choose, the important thing is that it is explicit and consistently applied. Ambiguity here is a reliable source of resentment, particularly as teams grow and expectations diverge between groups.
You will need a paging tool. The main options are broadly comparable in capability, and the choice between them usually comes down to price, existing integrations, and personal preference among the people who will use it daily.
Beyond paging, consider:
Useful signals include the number of pages per rotation, the proportion of pages that are actionable, and the time to acknowledge. If pages per rotation are climbing, that is usually a signal about your systems rather than your rotation.
A commonly cited benchmark is that an engineer should not be paged more than twice per night on average. Above that, the rotation stops being sustainable and you will see attrition before you see complaints.
One frequent mistake is failing to give on-call engineers the authority to act. If the person holding the pager cannot roll back a deploy or scale a service without seeking approval, the rotation is largely ceremonial.
Another is treating on-call as a junior responsibility. In practice the engineers with the most context are the most effective responders, and excluding senior people sends an unfortunate signal about whose time matters.
Before an engineer joins the rotation, they should have shadowed at least one full cycle alongside an experienced responder. This gives them exposure to real incidents without the pressure of being the one who has to act.
It is also worth running a practice exercise, where a failure is deliberately introduced in a non-production environment and the new responder works through it end to end with someone observing.
Your runbook should be written for someone at three in the morning who has just been woken up. That means short steps, explicit commands, and no assumed context about which service does what or where it lives.
Review it after every incident that it failed to cover. A runbook that is written once and never revisited will drift out of date faster than most teams expect, usually within a single quarter.
Every significant incident should be followed by a review focused on the systems and processes rather than the individuals involved. The goal is to understand what made the failure possible, not who was at fault.
Ultimately, the right rotation is the one your team will actually sustain. It is usually better to start with something simple and adjust based on what you learn than to design an elaborate scheme up front.
In summary, there are many factors to weigh here, and reasonable teams arrive at different answers. I hope this helps! Let me know if you'd like me to go deeper into any particular aspect of this.
We call those ‘slop grenades’ that people toss at each other.
People who get AI slop from coworkers spend 3.4 hours a month fixing it.
Brief never writes for you. It helps you read, so the reply is yours.
What it says, not how long it took to say it. The few lines that change what you do next.
Browsers, chat apps, terminals: anything that shows its text to macOS. On YouTube it reads the transcript, not the comments.
A chat gets its answer. A video gets its points in order. A pull request gets what changed and what to check. Brief picks the shape, so it reads at a glance.
Reads whatever language it’s written in. Briefs in that language, or in yours.
Brief runs on the Claude or ChatGPT plan you already pay for. No account, and nothing of ours in between.
Pick either in the menu. Brief runs it through your plan, within its limits, and a setup card walks you through anything missing.
The panel names the engine and the host it went to, every brief.
For your own chats, you can. But an AI writes for the next turn of the conversation, not for you. It restates the question, covers cases you didn’t ask about and thinks out loud, because models tend to do better when they write more. And when someone pastes their AI’s answer at you, there is nothing to ask. Brief works on the text you already have.
Brief never writes for you. It shows you the few lines that matter, and the reply is yours. If you’d rather no model touch it at all, pick No model in the menu. It lifts sentences from the page, word for word.
No. It reads one window, the one in front, and only when you press ⌃X. It reads text through macOS Accessibility, which you turn on once. It never takes screenshots.
To the engine you pick, under your own account: Claude, ChatGPT, Apple Intelligence on your Mac, or no model at all. There is no Brief server in between. Every brief names the engine and where it went. More in the privacy policy.