Java Legacy Azure SDK → Modern Azure SDK

Scenario scope: Upgrade a Maven/Gradle project's Azure SDK dependencies from com.microsoft.azure.* (legacy, end-of-support 2023) to com.azure.* (modern) — source code, build files, tests.

>

This is a source-code modernization flow, not an Azure service/plan/SKU upgrade. Follow the workflow below instead of the top-level azure-upgrade Steps. Do NOT use this for .NET, Python, JavaScript, or Go Azure SDK upgrades.

Upgrade all com.microsoft.azure.* to com.azure.* equivalents in one autonomous session.

You are an expert Azure SDK migration agent. Generate a unique run identifier at the start (format: azure-sdk-upgrade-YYYYMMDD-HHMMSS) and use it throughout all phases.

⚠️ Lazy loading: Do NOT pre-fetch the reference files listed below. Load each one only when its workflow step is reached or its trigger condition fires. Loading them upfront wastes context and causes premature decisions.

Workflow (load references on demand)

Full procedure: per-phase files under ./workflow/ (load each one when entering that phase). Global rules apply to every step: rules/execution-guidelines.md, rules/efficiency.md.

1. Precheck (workflow/phase-1-precheck.md) — Verify Maven/Gradle project, detect JDK/build tools. If git available, create branch java-upgrade/{RUN_ID}. → load ./templates/PLAN_TEMPLATE.md to create plan.md.

• Step-wise rules: rules/execution-guidelines.md (Output directory, Git, Wrapper preference).

1. Plan (workflow/phase-2-plan.md) — Inventory deps and populate plan.md. → load ./INSTRUCTION.md for package mappings.

• Step-wise rules: rules/upgrade-strategy.md (Incremental, Risk-first, Successor preference, Necessary/Meaningful steps).

1. Execute (workflow/phase-3-execute.md) — Migrate build config then source, build/test/fix, commit per step. → load ./templates/PROGRESS_TEMPLATE.md to create progress.md; load ./rules/ before running builds/tests.

• Step-wise rules: rules/review-code-changes.md, rules/upgrade-strategy.md (Automation tools, Temporary errors OK), rules/execution-guidelines.md (Template compliance, Git).

1. Validate (workflow/phase-4-summarize.md) — Apply validation checklist. → load ./templates/SUMMARY_TEMPLATE.md to create summary.md; load ./INSTRUCTION.md#validation.

• Step-wise rules: rules/upgrade-success-criteria.md.

Constraints

• 100% test pass · no premature termination · incremental changes · review each step
• Prefer wrappers (mvnw/gradlew)

Examples

"upgrade legacy azure sdk" → precheck → plan → execute → validate