About aem-workflow
aem-workflow is a skill that routes AEM Cloud Service workflow requests to specialist guidance for design, development, triggering, launchers, debugging, and triage. It also defines Cloud Service constraints and delegates broad requests to an orchestrator.
Key features
- 01Intent-based specialist routing
- 02Workflow model design guidance
- 03Custom process step development
- 04Workflow triggering and launcher setup
- 05Debugging and incident triage
- 06Cloud Service implementation constraints
Use cases
- 01Designing models with steps, splits, and variables
- 02Implementing a custom WorkflowProcess step
- 03Starting workflows or configuring launchers
- 04Investigating failed or stuck workflow instances
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ adobe/ skills --skill aem-workflowAfter installing, type/aem-workflowin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
README.mdworkflow-debugging/reference.mdworkflow-development/references/workflow-development/participant-step-patterns.mdprocess-step-patterns.mdvariables-and-metadata.mdworkflow-development/references/workflow-foundation/api-reference.mdarchitecture-overview.mdcloud-service-guardrails.mdjcr-paths-reference.mdquick-start-guide.mdREADME.mdworkflow-launchers/references/workflow-foundation/api-reference.mdarchitecture-overview.mdcloud-service-guardrails.mdjcr-paths-reference.mdquick-start-guide.mdREADME.mdworkflow-launchers/references/workflow-launchers/condition-patterns.mdlauncher-config-reference.mdworkflow-model-design/references/workflow-foundation/api-reference.mdarchitecture-overview.mdcloud-service-guardrails.mdjcr-paths-reference.mdquick-start-guide.mdREADME.mdworkflow-model-design/references/workflow-model-design/model-design-patterns.mdmodel-xml-reference.mdstep-types-catalog.mdworkflow-orchestrator/references/workflow-foundation/api-reference.mdarchitecture-overview.mdDetails
From the project READMEAEM Cloud Service 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 | 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, Splunk queries, data gathering checklist | 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.
Cloud Service Constraints
| Constraint | Detail |
|---|---|
| No JMX | No retryFailedWorkItems, countStaleWorkflows, restartStaleWorkflows, purgeCompleted via JMX |
/libs is immutable | Never write to /libs; use /conf/global/ or /apps/ overlays |
| Model design-time path | /conf/global/settings/workflow/models/<id> |
| Model runtime path (for API calls) | /var/workflow/models/<id> |
| Launcher config path | /conf/global/settings/workflow/launcher/config/ |
| Service users | Always use workflow-process-service sub-service; never admin credentials |
| OSGi annotations | DS R6 (@Component, @Reference from org.osgi.service.component.annotations) |
| Deploy via | Cloud Manager pipeline — no Package Manager in production |
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, and HTTP API
- workflow-launchers/SKILL.md — launcher configuration, JCR event binding, and OOTB overlay
- workflow-debugging/SKILL.md — stuck workflows, failed steps, thread pools, Sling Jobs, and purge
- workflow-triaging/SKILL.md — symptom classification, log patterns, Splunk queries, and data gathering
- workflow-orchestrator/SKILL.md — full lifecycle orchestration across all skills
Comments
Markdown supported