skill-migrate

Migrate AL extensions across Business Central platform versions with upgrade patterns.

99|28|Updated Oct 15, 2025
One-click install
npx skills add https://github.com/javiarmesto/ALDC-AL-Development-Collection --skill skill-migrate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-migrate
Source: https://github.com/javiarmesto/ALDC-AL-Development-Collection/tree/main/claude-plugin/skills/skill-migrate
Command: npx skills add https://github.com/javiarmesto/ALDC-AL-Development-Collection --skill skill-migrate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

AL version migration for Business Central. Use when upgrading extensions between BC versions, handling breaking changes, or implementing rollback strategies.

Core Features & Use Cases

  • App.json platform/runtime updates to target BC versions, dependency alignment, and feature flags.
  • Deprecated code and event signature migrations to maintain compatibility with new BC releases.
  • Upgrade codeunits for data migrations and per-company validation to ensure safe, repeatable upgrades.
  • Rollback planning, risk assessment, and pre/post-migration checks to minimize production impact.

Quick Start

Outline a migration plan and apply upgrade patterns to prepare an AL extension for a BC platform upgrade.

Frequently Asked Questions about skill-migrate

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

FAQPage Schema
How do I handle breaking changes when upgrading AL extensions in Business Central?

To handle breaking changes during a Business Central AL extension upgrade, migrate deprecated code and event signatures to maintain compatibility with the new BC release. Apply upgrade patterns across app.json updates and upgrade codeunits to ensure a smooth transition.

What is the safest way to plan a rollback for a BC platform upgrade?

The safest way to plan a BC platform upgrade rollback is to use idempotent UpgradeTags and per-company validation. This approach ensures safe, repeatable migrations and minimizes production impact through pre/post-migration checks and risk assessment.

How do I update app.json platform and runtime targets for a BC version migration?

To update app.json for a BC version migration, align platform and runtime targets to the new BC version. Ensure dependency alignment and configure feature flags to properly target the BC release and prepare the AL extension for migration.

When do I need upgrade codeunits for AL extension data migration?

You need upgrade codeunits for AL extension data migration when moving extensions across BC platform versions. They handle data migrations and per-company validation, ensuring safe, repeatable upgrades and rollback-ready migrations during the transition.

Does this approach support per-company validation for AL extension migrations?

Yes, this approach supports per-company validation for AL extension migrations. It uses idempotent UpgradeTags to ensure safe, rollback-ready migrations across BC platform versions while addressing breaking changes and deprecations effectively.

Why do AL event signatures need migration during a BC upgrade?

AL event signatures need migration during a BC upgrade to maintain compatibility with new BC releases. Addressing deprecated code and migrating event signatures are essential upgrade patterns to resolve breaking changes and ensure the extension functions correctly.