PluginPublic

adobe/aem-cloud-service

All AEM as a Cloud Service skills: component development, Workflow model design, development, triggering, launchers, debugging, and triaging, Dispatcher config authoring, advisory, incident response, performance tuning, and security hardening, Rapid Development Environment (RDE) deployment, log inspection, snapshots, and troubleshooting via `aio aem rde`, Jackrabbit Oak query/index tuning (property, Lucene index definitions), and extracting/inventorying JCR queries (XPath, SQL2, QueryBuilder) across a codebase.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Granite Workflow Engine — Architecture Overview (AEM Cloud Service)

Engine Flow

User / Launcher / API
        ↓
WorkflowSession.startWorkflow(model, data)
        ↓
Sling Event Job created
  topic: com/adobe/granite/workflow/job/**
  (transient: com/adobe/granite/workflow/transient/job/**)
        ↓
JobHandler.process()   ← consumes job, drives step loop
        ↓
For PROCESS nodes:     WorkflowProcess.execute(item, session, args)
For PARTICIPANT nodes: WorkItem persisted → Inbox / Task Management
For EXTERNAL_PROCESS:  ExternalProcessPollingHandler (polling job)
        ↓
On normal return:      workflow advances to next node
On WorkflowException:  retry (up to queue max), then FAILED + Inbox alert

Key Design Points

Consecutive PROCESS steps run in a single thread loop — no job re-queue between them.
Two JCR sessions per job: one for workflow state (/var/workflow/instances), one for payload operations. Keeps payload changes isolated from engine state.
Transient workflows create no JCR node until a retry or external process forces persistence.
InstanceLock serializes concurrent access to the same workflow instance.

Workflow Instance States

State	Meaning
`RUNNING`	Active, steps executing
`SUSPENDED`	Paused at a Participant or Task step awaiting human action
`COMPLETED`	Terminal — all steps completed normally
`ABORTED`	Terminated by admin or a process step
`FAILED`	Exhausted retries; failure inbox item created

OSGi Registration Requirements

SPI Interface	Required Property	Value
`WorkflowProcess`	`process.label`	Display label shown in model editor
`ParticipantStepChooser`	`chooser.label`	Label shown in Dynamic Participant step config
`WorkflowExternalProcess`	`process.label`	Same as WorkflowProcess
`RuleEngine`	(standard OSGi)	Used for OR-split rule evaluation