aem-workflow

Single entry point for all AEM 6.5 LTS Workflow skills. Covers workflow model design, custom process step and participant chooser development, launcher configuration, workflow triggering, and producti

SKILL.md

GitHub

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

  1. Match the user's request to one row in the Intent Router table above.
  2. Read the linked SKILL.md for that specialist skill.
  3. Follow the workflow, references, and output contract defined in that skill.
  4. 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