Workflow Specification

Owner: [Owner]
Status: [Draft/In review/Approved]
Version: [Version]
Target release: [Date or milestone]

Problem or decision: [Problem, decision, or outcome governed by this specification]
Reviewers: [Roles responsible for technical, product, security, and operational review]

1. Workflow goal

[State and entry condition]

2. Actors and permissions

[Event payload and idempotency key]

3. State model

[Guard and rejection reason]

4. Events and guards

[Timeout and retry limit]

5. Actions and side effects

[Compensating action]

6. Retries and timeouts

[Terminal evidence and owner]

7. Compensation

[Compensation: record the behavior, data, constraints, edge cases, ownership, and acceptance evidence that apply to this Workflow Specification]

8. Observability

[Observability: record the behavior, data, constraints, edge cases, ownership, and acceptance evidence that apply to this Workflow Specification]

9. Acceptance

[Acceptance: record the behavior, data, constraints, edge cases, ownership, and acceptance evidence that apply to this Workflow Specification]

• [Given context, when action, then observable result]
• [Owner, environment, evidence, and sign-off condition]

Review and Change Control

[Reviewers, decision owner, unresolved questions, linked evidence, approval date, and change history]