.png){kind=avatar}
A transferable workflow runbook needs 13 parts: purpose, scope, ownership, inputs, data, rules, states, evidence, exceptions, integrations, tests, recovery, and change and performance management. Configuration screenshots alone cannot tell another team how to operate or change the system.
Use this checklist to document the current production version and assign an owner and review date to every section.
Source review: August 28, 2026. Adapt documentation to your organization's legal, security, audit, records, and compliance requirements.
1. Purpose and outcome
State why the workflow exists, who it serves, what outcome it produces, and which constraints it must preserve. Include the current version, effective date, business owner, and authoritative policy references.
2. Scope and boundaries
Define the trigger, entry criteria, completion and cancellation states, upstream sources, downstream handoffs, included business units, and explicit exclusions. Document how out-of-scope work is redirected.
3. Roles and decision rights
List the requester, operator, reviewer, approver, administrator, system owner, data owner, integration owner, support owner, and escalation authority. For each role, state what it may view, edit, assign, decide, export, configure, and override.
4. Inputs and validation
Describe required fields and documents, field definitions, formats, validation rules, conditional questions, identity requirements, and incomplete-submission treatment. Link each material input to the business rule that needs it.
5. Data and records
Identify the source of truth, identifiers, sensitive data, retention rules, data-quality checks, derived values, exports, and downstream copies. Explain how duplicates, corrections, and deleted source records are handled.
6. Rules and authority
Maintain a decision table for routing, thresholds, specialist reviews, service targets, escalations, and actions. Each rule needs an owner, authority source, version, effective date, and boundary tests.
For approvals, the approval policy template shows how to map a clause to inputs, logic, states, evidence, and tests.
7. States and transitions
Name every meaningful state and the events that move work between them. Record who can trigger each transition, the required evidence, the notification, and any downstream action. Include terminal and failure states.
8. Decision and activity evidence
Specify what the workflow records for submission, assignment, review, return, approval, rejection, override, escalation, data change, and system action. The approval audit-trail guide explains how to reconstruct an individual decision.
9. Exceptions and escalations
List known exceptions, detection signals, owners, allowed decisions, resolution steps, service targets, and communication paths. Include absent approvers, missing evidence, policy conflicts, duplicate requests, changed facts, and integration failure.
10. Integrations and dependencies
For every connection, document the systems, data exchanged, trigger, authentication owner, expected response, timeout, retry behavior, duplicate protection, monitoring, and reconciliation. Note the dependency's support contact and change-notification path.
11. Test catalog
Maintain test cases for normal paths, boundaries, permissions, exceptions, unavailable roles, integration failures, recovery, and historical reconstruction. Record test data, expected result, actual result, reviewer, date, and release version.
12. Failure and recovery
Explain how operators detect a failure, stop repeated actions, preserve evidence, continue urgent work, restore service, reconcile records, and close the incident. Include the current manual continuity procedure and the last time it was tested.
13. Change, support, and performance
Document the change-request process, approval authority, impact analysis, test requirement, release record, treatment of open requests, monitoring window, and recovery trigger. Name support hours, triage ownership, and escalation contacts.
Define performance measures such as complete-first-time rate, queue time, active handling time, return rate, exception rate, overdue work, and rework. Record definitions so another team can reproduce them.
Separate five documents that serve different jobs
- Policy and authority register: Explains what decisions are permitted and by whom.
- Operating runbook: Explains how people run the workflow.
- Configuration register: Explains how approved rules, fields, states, and actions are implemented.
- Test and release record: Proves that a specific version was reviewed and deployed.
- Decision history: Reconstructs what happened to each request.
These documents should link to each other, but they should not be collapsed into one unreadable file. Different owners and review cycles may apply.
Use the transfer test
Ask a qualified person who did not build the workflow to perform five tasks using only the documentation and approved access:
- Explain the purpose, boundary, owner, and current version.
- Process a normal case and a known exception.
- Reconstruct why a completed case reached its result.
- Diagnose a simulated failed integration and follow the continuity path.
- Propose a rule change and identify its affected fields, states, roles, tests, and open requests.
Record where the person had to ask the original builder. Those questions reveal documentation gaps and hidden operating knowledge.
Use Formaloo configuration as evidence, not as the whole runbook
Formaloo's Logic map helps teams inspect conditions and paths in a form. Advanced logic defines conditions and actions. Capture those views in the configuration register and map them to approved business rules.
Keep the human-readable policy, ownership model, exception catalog, integration contract, recovery procedure, and release record outside the builder. Update documentation in the same change packet as the configuration. A production release is incomplete when the runbook still describes the previous version.
Make the workflow operable beyond its builder
If you need to turn undocumented operational knowledge into a governed workflow your team can run and improve, book a Formaloo demo.
