Protocol
Let a colleague rehearse the runbook without your missing context
The missing step is usually obvious to the person who forgot to write it.
Before you use it
- Use when
- A procedure looks complete to its author but must work for another qualified operator.
Keep this limit in mind
- Never create uncontrolled production failures to test documentation. A runbook cannot replace prerequisite training, access or judgment.
An idea to explore.
Try this idea.
Inspect the example, try the idea in your situation, then check your next move.
Why it matters
Give a colleague a safe practice scenario and the documented starting conditions. Observe where they need information that exists only in your head. Use the rehearsal to repair the procedure, including expected results and escalation points, rather than grading the colleague for not reading your mind.
Steps
- Choose an isolated or simulated case with a safe reset and clear stop conditions.
- Let the colleague follow the documented route; record needed prompts and ambiguous steps.
- Revise the runbook and repeat the affected part with the agreed support level.
An example
A new support engineer rehearses a failed import. The exercise reveals that the runbook never identifies which log belongs to the processing attempt.
Check your result
The colleague can reach the expected result or correctly escalate using the stated prerequisites and support.
Save and practise this idea
My learning
Read. Recall. Repeat.
Save this idea and return to it on any device.
Keep exploring
Connected ideas
You are readingLet a colleague rehearse the runbook without your missing context
Ideas that link here
These ideas link to this one. Check their conditions and limits before use.
Useful with this ideaPractice recovering from mistakes where mistakes are safe
Evidence and sources
The SRE on-call account uses practical exercises and incident role-play alongside documented playbooks, including semi-independent onboarding exercises.
Testing a runbook with a colleague is an editorial extension; the source does not isolate its causal effect on incident outcomes.
Being On-Call · Training roadmap; Afterword; Maintaining Playbooks
All sources (1)
Edition and review
Version 0.1.0
No review details are supplied for this edition.