Skip to content

Feat/skill workflow launchers 65 lts#135

Open
akankshajain18 wants to merge 4 commits into
mainfrom
feat/skill-workflow-launchers-65-lts
Open

Feat/skill workflow launchers 65 lts#135
akankshajain18 wants to merge 4 commits into
mainfrom
feat/skill-workflow-launchers-65-lts

Conversation

@akankshajain18
Copy link
Copy Markdown
Collaborator

@akankshajain18 akankshajain18 commented May 15, 2026

Description

Audits and updates the AEM 6.5 LTS workflow-launchers skill against cq:WorkflowLauncher runtime behavior on AEM 6.5 LTS. Imports validated content for SKILL.md and
pattern references, consolidates duplicated foundation refs to the canonical copies under workflow-orchestrator, corrects a runtime-impacting loop-prevention bug, and
aligns the OOTB Launchers catalog and excludeList documentation with what /libs/settings/workflow/launcher/config/ actually contains.

Related Issue

Delete workflow-foundation as content was duplicate to workflow-launcher

Motivation and Context

The workflow-launchers skill ships to customer IDEs as authoritative guidance for configuring cq:WorkflowLauncher nodes on AEM 6.5 LTS. Routine audit against a live
AEM 6.5 LTS instance surfaced four classes of issue in the prior content, each of which would lead a customer to a wrong configuration:

How Has This Been Tested?

Verified against AEM instance.

Screenshots (if appropriate):

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)

Checklist:

  • I have signed the Adobe Open Source CLA.
  • My code follows the code style of this project.
  • My change requires a change to the documentation.
  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING document.
  • I have added tests to cover my changes.
  • All new and existing tests passed.

akankshajain18 and others added 4 commits May 15, 2026 08:15
Updates the workflow-launchers skill for AEM 6.5 LTS with validated
content covering launcher configuration, condition patterns, and
JCR-event-driven workflow triggering. SKILL.md now references the
canonical foundation refs hosted under workflow-orchestrator instead
of local duplicates.

- SKILL.md: expanded launcher configuration guidance; loop-prevention
  guardrail clarified (WorkflowSession vs JCR Session disambiguation);
  IDE-LLM consumability improvements; foundation ref links re-pointed
  to workflow-orchestrator canonical copies
- condition-patterns.md: ECMAScript (Rhino) terminology corrected;
  pattern coverage tightened
- launcher-config-reference.md: cq:WorkflowLauncher property
  reference expanded; consumability improvements

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…launchers (AEM 6.5 LTS)

The 6 foundation reference files under workflow-launchers/references/
workflow-foundation/ duplicated the canonical copies hosted in
workflow-orchestrator/references/workflow-foundation/. SKILL.md links
were re-pointed to the canonical copies in the previous commit, so
the local duplicates are now orphaned.

Deletes:
- 65-lts-guardrails.md
- README.md
- api-reference.md
- architecture-overview.md
- jcr-paths-reference.md
- quick-start-guide.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…low-launchers (AEM 6.5 LTS)

The skill instructed setUserData("workflowmanager") for loop prevention.
AEM's WorkflowLauncherListener does not recognize that string. The
correct value is "changedByWorkflowProcess", which matches
HandlerBase.WORKFLOW_SESSION_USERDATA in
com.adobe.granite.workflow.core and is the default member of the OSGi
config property granite.workflow.launcher.globally.exluded.event.user.data
that the launcher reads at startup.

- SKILL.md: setUserData("workflowmanager") -> "changedByWorkflowProcess"
  in the loop-prevention guardrail (2 occurrences in same line)
- condition-patterns.md: setUserData("workflowmanager") ->
  "changedByWorkflowProcess" in the Java snippet; rewrote the comment
  to correctly distinguish the OSGi config-property name from the
  userData value

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
…nd condition shorthand in workflow-launchers (AEM 6.5 LTS)

Audit findings verified against AEM 6.5 LTS localhost:4505 OOTB
launchers under /libs/settings/workflow/launcher/config/:

- SKILL.md "Common OOTB Launchers" table: dam_update_asset_create
  does not exist (actual: update_asset_create); dam_update_asset_modify
  does not exist (actual: update_asset_mod); dam_xmp_writeback trigger
  description corrected to PROPERTY_CHANGED (eventType=16) on
  nt:unstructured at /jcr:content/metadata; update_page_version_*
  removed (not present in /libs, /conf, or /apps on a baseline 6.5 LTS
  install). Table expanded with eventType, nodetype, glob, and
  workflow columns
- SKILL.md and launcher-config-reference.md: excludeList type
  corrected from String[] to String (single comma-separated value);
  description expanded to document the two entry formats — bare JCR
  property names and the event-user-data:<value> prefix that excludes
  events tagged with a specific JCR observation userData
- launcher-config-reference.md: document the singular `condition`
  shorthand alongside the plural `conditions` array; both forms are
  accepted at startup
- condition-patterns.md: loop-prevention comment rewritten to explain
  the changedByWorkflowProcess value via the customer-visible OSGi
  config property granite.workflow.launcher.globally.exluded.event.
  user.data (visible in Felix Console)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

Tessl Skill Lint

⚠️ edge-delivery-services — 2 warning(s)
⚠ .tileignore is deprecated. Rename it to .tesslignore; the legacy filename will be removed in a future release.
⚠ Skill 'code-review': SKILL.md is approximately 10315 tokens (recommended maximum: 5000). Consider moving detailed content to separate reference files.

Context Cost

Skills
  - analyze-and-plan: 120 front-loaded, 1.6k-4.4k on-demand tokens
  - create-site: 79 front-loaded, 2.7k on-demand tokens
  - authoring-analysis: 52 front-loaded, 3.2k on-demand tokens
  - block-collection-and-party: 71 front-loaded, 4.8k on-demand tokens
  - block-inventory: 60 front-loaded, 2.2k on-demand tokens
  - building-blocks: 75 front-loaded, 2.3k-6.7k on-demand tokens
  - code-review: 60 front-loaded, 10.3k-13.1k on-demand tokens
  - content-driven-development: 74 front-loaded, 3.7k-8.6k on-demand tokens
  - content-modeling: 61 front-loaded, 2.4k-9.1k on-demand tokens
  - da-auth: 94 front-loaded, 1.2k on-demand tokens
  - docs-search: 75 front-loaded, 1.8k on-demand tokens
  - find-test-content: 52 front-loaded, 1.7k on-demand tokens
  - generate-import-html: 49 front-loaded, 2.3k-11k on-demand tokens
  - identify-page-structure: 59 front-loaded, 1.6k on-demand tokens
  - page-decomposition: 58 front-loaded, 2.1k on-demand tokens
  - page-import: 75 front-loaded, 1.8k on-demand tokens
  - preview-import: 46 front-loaded, 1.2k-4.9k on-demand tokens
  - scrape-webpage: 54 front-loaded, 1.3k-3.9k on-demand tokens
  - testing-blocks: 86 front-loaded, 2.5k-8.2k on-demand tokens
  - ue-component-model: 186 front-loaded, 2.4k-11.1k on-demand tokens

Total: 1.5k front-loaded, 53k-104.1k on-demand tokens

✔ Tile adobe/aem-edge-delivery-services@0.1.0 is valid
⚠️ stardust — 6 warning(s)
⚠ Found 34 orphaned file(s) not linked from manifest entrypoints:
- skills/direct/reference/direction-format.md
- skills/direct/reference/palette-picker.md
- skills/direct/reference/palettes/README.md
- skills/extract/reference/brand-review-template.md
- skills/extract/reference/brand-surface.md
- skills/extract/reference/current-state-schema.md
- skills/extract/reference/ia-extraction.md
- skills/extract/reference/playwright-recipe.md
- skills/migrate/reference/asset-bundling.md
- skills/migrate/reference/content-preservation.md
- skills/migrate/reference/metadata-and-jsonld.md
- skills/migrate/reference/migration-procedure.md
- skills/migrate/reference/template-and-module-rendering.md
- skills/prepare-migration/SKILL.md
- skills/prototype/fixtures/composition-delta-good.md
- skills/prototype/fixtures/composition-delta-trivial.md
- skills/prototype/reference/anti-template-bank.md
- skills/prototype/reference/approval-fold-back.md
- skills/prototype/reference/canon-extraction.md
- skills/prototype/reference/fidelity-refined-pass.md
- skills/prototype/reference/mobile-nav-collapse.md
- skills/prototype/reference/page-shape-brief.md
- skills/prototype/reference/proposed-file-shell.md
- skills/prototype/reference/publish-sample.md
- skills/stardust/reference/artifact-map.md
- skills/stardust/reference/data-attributes.md
- skills/stardust/reference/divergence-toolkit.md
- skills/stardust/reference/impeccable-command-map.md
- skills/stardust/reference/intent-dimensions.md
- skills/stardust/reference/intent-examples.md
- skills/stardust/reference/intent-reasoning.md
- skills/stardust/reference/migrate-output-format.md
- skills/stardust/reference/state-machine.md
- skills/stardust/reference/token-contract.md
⚠ Found 6 skill file(s) outside spec directories (references/, assets/, scripts/):
- skills/direct/reference/palettes/library.json
- skills/prototype/fixtures/mobile-nav-broken-example.html
- skills/prototype/fixtures/mobile-nav-collapse-example.html
- skills/prototype/fixtures/mobile-nav-audit.mjs
- skills/migrate/fixtures/pagemap-audit.mjs
- skills/migrate/fixtures/file-protocol-audit.mjs
⚠ Skill 'extract': SKILL.md is approximately 7994 tokens (recommended maximum: 5000). Consider moving detailed content to separate reference files.
⚠ Skill 'direct': SKILL.md is approximately 15590 tokens (recommended maximum: 5000). Consider moving detailed content to separate reference files.
⚠ Skill 'prototype': SKILL.md is approximately 13260 tokens (recommended maximum: 5000). Consider moving detailed content to separate reference files.
⚠ Skill 'migrate': SKILL.md is approximately 5385 tokens (recommended maximum: 5000). Consider moving detailed content to separate reference files.

Context Cost

Skills
  - stardust: 33 front-loaded, 1.5k on-demand tokens
  - extract: 45 front-loaded, 8k on-demand tokens
  - direct: 96 front-loaded, 15.6k on-demand tokens
  - prototype: 90 front-loaded, 13.3k on-demand tokens
  - migrate: 65 front-loaded, 5.4k on-demand tokens

Total: 329 front-loaded, 43.7k on-demand tokens

✔ Tile adobe/stardust@0.7.1 is valid

✅ All 2 tile(s) lint passed with 8 warning(s) total.

Updated by tessl-lint for commit 4ba1087.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant