best-practices

Catalogs reference modules for migrating AEM code to Cloud Service.

1|Updated Apr 14, 2026

Search Tags:#migration #patterns #best-practices #aem-cloud-service #htl #resource-resolver #scr-to-osgi-ds

Ready to run

npx skills add https://github.com/adobe/aem-auth-demo --skill best-practices-adobe

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: best-practices
Source: https://github.com/adobe/aem-auth-demo/tree/main/.agents/skills/best-practices
Command: npx skills add https://github.com/adobe/aem-auth-demo --skill best-practices-adobe

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Teams migrating AEM to Cloud Service need guardrails, references, and transformation modules to ensure Java/OSGi patterns, Asset Manager, replication, and HTL patterns comply with Cloud Service requirements and avoid deprecated APIs.

Core Features & Use Cases

Provides a centralized catalog of best-practice guidelines and pattern-reference modules for migrating AEM code to Cloud Service.
Documents prerequisites, migration patterns (SCR→DS, ResourceResolver, logging, asset API changes, replication, event handling, and HTL lint patterns), and transformation steps.
Serves as a single source of truth for automated tools and manual reviews during Cloud Service migrations.

Quick Start

Consult the best-practices to guide migration and cloud readiness checks before updating AEM components.

Frequently Asked Questions about best-practices

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I migrate AEM code to Cloud Service and ensure it complies with best practices?▼

To migrate AEM code to Cloud Service, consult the centralized catalog of best-practice guidelines and pattern-reference modules to ensure Java/OSGi patterns, Asset Manager, replication, and HTL patterns comply with Cloud Service requirements and avoid deprecated APIs.

What is the SCR to OSGi Declarative Services migration pattern for AEM Cloud Service?▼

The SCR to OSGi Declarative Services migration pattern involves transforming legacy SCR annotations into OSGi DS annotations to meet AEM Cloud Service prerequisites. The best-practices catalog provides reference modules to guide this specific transformation step.

Does AEM Cloud Service migration require updating ResourceResolver and asset API patterns?▼

Yes, AEM Cloud Service migration requires updating ResourceResolver and asset API patterns to avoid deprecated APIs. The best-practices catalog documents prerequisites and transformation steps for these specific Asset Manager changes.

How do I handle HTL lint and event handling patterns during an AEM Cloud Service migration?▼

To handle HTL lint and event handling patterns during an AEM Cloud Service migration, use the catalog of transformation and reference modules. These modules guide developers through automated references and manual reviews for HTL lint concerns and event handling compliance.

What are the limitations of using manual reviews for AEM Cloud Service code migration?▼

Manual reviews for AEM Cloud Service code migration rely on the aem-cloud-service prerequisites and best-practices resources as a single source of truth. While effective for ensuring compliance, they require careful cross-referencing with the catalog to avoid missing deprecated API usage.