<situation>One sentence: what has gone wrong, and what this runbook gets you to.
Preconditions: what must be running or set up before any step below works.
<setup command, if any>
| Failure class | Where it surfaces | First diagnostic step | Artifacts | Reproduce locally |
|---|---|---|---|---|
<class> |
<workflow · job, or system> |
<the one check that discriminates> |
<path> |
<command, or a link to its section> |
<class> |
<where> |
<first step> |
<path> |
<command> |
<first class>What this failure actually indicates.
<reproduction command>
How to tell a real defect from an environmental failure, and what to do in each case.
<second class>What this failure actually indicates.
<reproduction command>
<link> — why a reader here would want it.