DocumentationAEM as a Cloud ServiceUser Guide

Refactoring Tools Overview

Last update: June 4, 2025
  • Applies to:
  • Experience Manager as a Cloud Service

Refactoring Tools streamline the process of updating existing AEM projects to be compatible with AEM as a Cloud Service (AEMaaCS). These tools automate common refactoring and modernization tasks and are integrated with the Cloud Acceleration Manager (CAM) for a seamless experience.

Previously available only as CLI utilities, Refactoring Tools now provide a unified interface with features like automated inspection, configuration generation, and job execution — reducing manual overhead and improving visibility.

Inspection Workflow

The Inspection Workflow simplifies the preparation process for running refactoring tools.

Key Features:

  • Automatic Trigger – Uploading a project automatically starts the inspection.
  • Configuration Generation – The tools inspect the uploaded source code and generate the necessary configurations.
  • Payload Submission – These configurations are passed directly to the selected tools for execution.

Available Refactoring Tools

Repository Modernizer

The Repository Modernizer restructures your AEM project’s repository layout and content to align with AEMaaCS standards and best practices. It replaces the legacy repository modernization tool with enhanced automation and accuracy.

Code Transformer

The Code Transformer uses intelligent pattern recognition and AI-driven analysis to detect and update code segments that are incompatible with AEMaaCS. This tool simplifies the migration effort and reduces manual code changes.

Refactoring Workflow Phases

The Refactoring Tools follow a structured two-phase process:

Phase 1: Upload Your Source Code

  • Upload your source code (in ZIP format) using the CAM interface.
  • Once uploaded, the Inspection Workflow is automatically triggered to analyze the project and prepare it for tool execution.
NOTE
During the inspection process, uploading another project is not permitted.

Phase 2: Trigger a Refactoring Job

After a successful inspection, you can run one or more refactoring tools:

  • Run Repository Modernizer – Executes repository modernization.
  • Run Code Transformer – Runs code transformation based on inspection output.
  • Run All Tools Together – Executes all available tools in a single operation.
NOTE
Refactoring jobs can only be started after the source code has been successfully uploaded and inspected.
NOTE
Users can trigger multiple refactoring jobs parallelly, but each job will be executed separately.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab