Write workflow notes for the person running the next job. Put the trigger, required inputs, output location, and review step at the top; move background discussion into a separate reference.
Document what to do when an input is missing or a run partially fails. Keep any secret names or credentials out of the notes. Test the notes by asking someone unfamiliar with the workflow to find the next action in under a minute.
Which instruction is hardest to find today?
Akousa