Working template

Automation handover and completion record

A companion to Making automation easy to verify and hand over.

Download the text file to fill it in with your own details, or print a blank copy.

Fill in the handover once, then use the run record for significant executions and exceptions. Keep credentials in approved storage; reference their location without copying them.

Handover

Workflow / owner / alternate:  

Business purpose and who depends on the output:  

Trigger (schedule, event, manual) and expected frequency:  

Input scope / intended outcome:  

Systems read / systems written, with the identity used for each:  

Unrelated state that must remain unchanged:  

Version / configuration / runbook references:  

Where failures are reported and who is notified:  

Stop and recovery procedure:  

Credential storage location, owner, and rotation date:  

Change procedure (who approves a change, where it is tested, how it is rolled back):  

Run record

Run ID / time Attempted action Destination response Authoritative verification Exception Next owner / action

Retry rule

Duplicate consequence:  

Supported duplicate protection or pre-check:  

When to stop and escalate:  

Second-person exercise

  • [ ] Locate the current version and configuration.
  • [ ] Perform an ordinary run.
  • [ ] Explain its completion evidence.
  • [ ] Recognize and resolve a known failure.
  • [ ] Resume without duplicating completed work.
  • [ ] Stop the workflow and identify affected partial work.
  • [ ] Find the credential location and confirm who can rotate it.
  • [ ] State what would happen if the workflow silently stopped running for a week.

Observed handover gaps and owners:  

Log access / retention:  

Health check

Question Answer Evidence
Did every expected run in the period happen?
Were all failures noticed by a person within the agreed time?
How many manual corrections were needed?
Are any credentials or interfaces due to expire before the next review?

Common failure modes

  • The automation runs under the builder's personal account and stops when they leave.
  • Failures are logged but nothing tells a person.
  • A retry after a timeout creates a duplicate the destination cannot detect.
  • The runbook describes the original version, not the one in production.

Review cadence / next review:  

Retirement trigger and who decides:  

This record covers operability and handover. It does not judge whether the workflow should exist; use the complexity review for that.