The runbook / Part 4

Part 4: Recovering the stuck task

Series index Part 4 of 4

This page is an editable draft outline. Its date is a proposed editorial date. Replace the prompts with reviewed essay text before marking it complete.

Intended argument

Describe a bounded recovery decision based on recorded state, authority, remaining budget, and evidence about the last attempted action.

Essay outline

Observe before resuming

List the evidence needed to distinguish a slow worker, a failed worker, and an action whose result is unknown. Keep observation separate from a recovery action.

Check identity and prior effects

Trace the original task and packet identifiers. Explain how the operator checks whether the previous action already took effect before repeating it.

Authorize a bounded recovery

Name the role that may approve recovery, its permitted action, its attempt limit, and its stop conditions. Preserve the task spending history.

Verify completion or escalate

Define the evidence required to accept the recovered result. State the unresolved conditions that require a human decision.

Evidence to add

Use the following checklist while drafting:

  • Add a hypothetical timeline from the last confirmed state to the recovery decision.
  • Include a case with an uncertain external result and explain why its next action needs investigation.
  • Show how attempt limits and remaining budget are checked without creating a replacement task.

Accompanying artifacts

Use these reference files to copy or adapt the proposed controls:

Complete the essay

Complete these steps before marking the essay complete:

  1. Replace the outline with the essay and verify its claims and examples.
  2. Check the artifact links and remove information that is not intended for public access.
  3. Set the actual publication date and change draft: true to draft: false in the front matter.
  4. Review the change on develop, release it to main, and verify the rendered page. Dates in this series are editorial labels and do not delay the Pages build.

Return to the series overview.