Shared Workflow Primitives

Summary

Shared workflow primitives are the reusable vocabulary for stateful operations: cases, attempts, artifacts, issues, reviews, approvals, commands, locks, events, identity review, and resumption.

Problem

Every domain can invent its own workflow model, but that makes repair, diagnostics, and UI composition harder across the platform.

Principle

Share primitives when the operational semantics are common, and keep domain models when the root object carries important domain-specific meaning.

Platform Shape

POA is the strongest current consumer of the shared workflow packages. Precon is a reference model with domain-native opportunity state and similar concepts. The platform should converge on shared services where they reduce duplication without erasing important domain ownership.

Source Evidence

• services/workflow
• libs/workflow
• docs/domains/poa.md
• docs/domains/preconstruction.md

Related Reading

• docs/engineering/concepts/cases-issues-events.md
• docs/engineering/concepts/services-expose-capabilities.md