Workflow Design¶

Library AreaTemplate Library

Current PageWorkflow Design

FocusWorkflow behavior

UseDefine flows, states, and evidence

Repository Areadocs/template-library/design/

← Previous Data Design

Current Workflow Design

Next → Access-Control Design

Template purpose¶

Use this template to define how the system behaves over time.

Workflow design should include normal flows, alternate flows, exception flows, state transitions, human review points, AI-assisted steps, evidence produced, and postconditions.

Project¶

<Project name>

Document control¶

Field	Value
Artifact owner	`<owner>`
Primary reviewers	`<reviewers>`
Status	`<draft / in review / accepted / revised>`
Last updated	`<YYYY-MM-DD>`
Related Engineering Stage	`ES-105 — Detailed Design`
Project workspace target	`docs/project-workspace/design/workflow_design.md`

Workflow register¶

ID	Workflow	Purpose	Actors	Related Requirements	Evidence Produced
WF-001	`<workflow>`	`<purpose>`	`<actors>`	`<requirements>`	`<evidence>`

Workflow details¶

WF-001 — `<Workflow Name>`¶

Field	Value
Purpose	`<purpose>`
Actors	`<actors>`
Related Requirements	`<FR/NFR/C IDs>`
Related Interfaces	`<IF IDs>`
Related Data Entities	`<entities>`
Owner	`<owner>`

Preconditions¶

<precondition>

Main flow¶

<step>
<step>
<step>

Alternate flows¶

ID	Condition	Flow	Evidence
AF-001	`<condition>`	`<alternate flow>`	`<evidence>`

Exception flows¶

ID	Exception	System Response	Evidence
EF-001	`<exception flow>`	`<response>`	`<evidence>`

Human review points¶

Step	Reviewer	Review Decision	Evidence
`<step>`	`<reviewer>`	`<approve / reject / revise / escalate>`	`<evidence>`

AI-assisted steps¶

Step	AI Role	Human Control	Evidence
`<step>`	`<assist / summarize / classify / recommend / generate / none>`	`<review/control>`	`<evidence>`

State transitions¶

From	Event	To	Allowed By	Evidence
`<state>`	`<event>`	`<state>`	`<role / condition / system rule>`	`<evidence>`

Postconditions¶

<postcondition>

Workflow risks¶

Workflow ID	Risk	Mitigation
`<WF-ID>`	`<risk>`	`<mitigation>`

Open workflow questions¶

ID	Question	Owner	Needed By
WFQ-001	`<question>`	`<owner>`	`<date or stage>`

Review checklist¶

[ ] Major workflows are listed.
[ ] Normal, alternate, and exception flows are included.
[ ] State transitions are defined where relevant.
[ ] Human review points are explicit.
[ ] AI-assisted steps are documented where relevant.
[ ] Evidence produced by workflows is identified.
[ ] Workflow risks and open questions are visible.

Continue to Access-Control Design

Define roles, protected actions, protected data, denied behavior, and audit evidence.

Open Access-Control Design →