AEM 6.5 LTS Workflow
Route user requests to the appropriate specialist skill based on intent.
Intent Router
| User Intent |
Skill |
Path |
| Create a workflow model, add steps, design OR/AND splits, configure variables |
Model Design |
workflow-model-design/SKILL.md |
| Implement a custom WorkflowProcess step, ParticipantStepChooser, OSGi service registration |
Development |
workflow-development/SKILL.md |
| Start a workflow from code, HTTP API, Timeline UI, Manage Publication, replication triggers |
Triggering |
workflow-triggering/SKILL.md |
| Configure a launcher, auto-start on asset upload, overlay OOTB launcher |
Launchers |
workflow-launchers/SKILL.md |
| Workflow stuck, failed step, missing Inbox task, stale instances, thread pool exhaustion, purge |
Debugging |
workflow-debugging/SKILL.md |
| Classify a workflow incident, determine required logs, JMX diagnostics, Splunk queries |
Triaging |
workflow-triaging/SKILL.md |
| End-to-end lifecycle or requests spanning multiple concerns |
Orchestrator |
workflow-orchestrator/SKILL.md |
How to Use
- Match the user's request to one row in the Intent Router table above.
- Read the linked SKILL.md for that specialist skill.
- Follow the workflow, references, and output contract defined in that skill.
- For broad or ambiguous requests that span multiple concerns, use the Orchestrator which coordinates across all specialist skills and loads foundation references.
6.5 LTS / AMS Capabilities
| Capability |
Detail |
| JMX |
Full access via Felix Console (/system/console/jmx) or JMX client |
| Retry failed items |
JMX retryFailedWorkItems or Inbox Retry |
| Stale detection |
JMX countStaleWorkflows |
| Stale restart |
JMX restartStaleWorkflows(dryRun=true) then execute |
| Purge |
JMX purgeCompleted(dryRun=true) or Purge Scheduler |
| Log access |
Direct filesystem (crx-quickstart/logs/) or AMS log access |
| Config changes |
Felix Console, OSGi config in repo, or CRX/DE |
6.5 LTS Guardrails
| Rule |
Detail |
Avoid editing /libs |
Use overlays under /apps or store at /conf/global |
| Model design-time path |
/conf/global/settings/workflow/models/<id> (preferred) or /etc/workflow/models/<id> (legacy) |
| Model runtime path (for API calls) |
/var/workflow/models/<id> |
| Launcher config paths |
/conf/global/settings/workflow/launcher/config/ (preferred) |
| Service users |
Use ResourceResolverFactory.getServiceResourceResolver() with a sub-service; avoid loginAdministrative |
| OSGi annotations |
DS R6 preferred; Felix SCR still supported on 6.5 LTS |
| Deploy via |
Package Manager, Maven + Content Package Plugin |
Specialist Skills
- workflow-model-design/SKILL.md — model structure, step types, variables, and model XML
- workflow-development/SKILL.md — WorkflowProcess, ParticipantStepChooser, metadata, and error handling
- workflow-triggering/SKILL.md — Timeline UI, Manage Publication, WorkflowSession API, HTTP API, and replication triggers
- workflow-launchers/SKILL.md — launcher configuration, JCR event binding, and OOTB overlay
- workflow-debugging/SKILL.md — stuck workflows, failed steps, JMX remediation, thread pools, and purge
- workflow-triaging/SKILL.md — symptom classification, JMX diagnostics, log patterns, Splunk queries, and data gathering
- workflow-orchestrator/SKILL.md — full lifecycle orchestration across all skills