{
  "schema": "vedokrok.public-item.v1",
  "release_id": "MHC-RPUB-20260920-75ad787a",
  "url": "/knowledge/let-a-colleague-rehearse-the-runbook-without-your-missing-context",
  "id": "MHC-D-RESEARCH-1014",
  "version": "0.1.0",
  "title": "Let a colleague rehearse the runbook without your missing context",
  "summary": "The missing step is usually obvious to the person who forgot to write it.",
  "kind": "protocol",
  "body": "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.",
  "limits": [
    "Never create uncontrolled production failures to test documentation. A runbook cannot replace prerequisite training, access or judgment."
  ],
  "topics": [
    "work-05-transferable-expertise"
  ],
  "intents": [],
  "source_ids": [
    "RS-2B5F7E58BBC9FD5B"
  ],
  "evidence": [
    {
      "claim": "The SRE on-call account uses practical exercises and incident role-play alongside documented playbooks, including semi-independent onboarding exercises.",
      "source_id": "RS-2B5F7E58BBC9FD5B",
      "role": "supports",
      "note": "Testing a runbook with a colleague is an editorial extension; the source does not isolate its causal effect on incident outcomes.",
      "locator": "Training roadmap; Afterword; Maintaining Playbooks"
    }
  ],
  "use_when": [
    "A procedure looks complete to its author but must work for another qualified operator."
  ],
  "avoid_when": [
    "Never create uncontrolled production failures to test documentation. A runbook cannot replace prerequisite training, access or judgment."
  ],
  "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": "The colleague can reach the expected result or correctly escalate using the stated prerequisites and support.",
  "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."
  ],
  "sources": [
    {
      "id": "RS-2B5F7E58BBC9FD5B",
      "title": "Being On-Call",
      "url": "https://sre.google/workbook/on-call/"
    }
  ],
  "relations": [],
  "collections": [
    {
      "id": "RC-D7E536E5F014E0EC",
      "title": "Turn experience into expertise someone else can use",
      "url": "/collections/turn-experience-into-expertise-someone-else-can-use"
    }
  ]
}