al-validate-breaking-changes

Runs AppSource-style breaking-change validation against a cached baseline and flips the task status.

4|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/FBakkensen/bc-agentic-dev-tools-marketplace --skill al-validate-breaking-changes-fbakkensen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: al-validate-breaking-changes
Source: https://github.com/FBakkensen/bc-agentic-dev-tools-marketplace/tree/main/plugins/al-agentic-dev/skills/al-validate-breaking-changes
Command: npx skills add https://github.com/FBakkensen/bc-agentic-dev-tools-marketplace --skill al-validate-breaking-changes-fbakkensen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before merging an AL/Business Central feature, you need to know whether it breaks a previously released public API — something the compile-time AppSourceCop pass cannot fully simulate. This Skill runs the AppSource-style install/upgrade validation against the provisioned baseline release and records the verdict on the feature's final gate task. ## Core Features & Use Cases - Breaking-change gate execution: Runs validate-breaking-changes.ps1 (per-country install/upgrade via Run-AlValidation) against the cached baseline from /al-provision, delegated to a subagent to keep the main session clean. - Exit-code-driven status flip: Maps exit codes to task status — 0 to done, 3 (breaking change detected) or 4/other failures to blocked — editing only the status: frontmatter line. - Human-in-the-loop on breaks: A detected break is treated as an intent decision (intended major bump vs accidental schema change) routed to /al-steer, never auto-fixed or auto-accepted. - Use Case: As the last task of an AL feature, after the per-feature code review passes clean, run this gate to confirm the post-review bytes do not break the released public API before merge. ## Quick Start Run the breaking-change validation task for my current AL feature and update its status based on the result.

Frequently Asked Questions about al-validate-breaking-changes

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

FAQPage Schema
How do I validate breaking changes in AL Business Central apps?

Run the breaking-change gate task, which executes validate-breaking-changes.ps1 to perform AppSource-style per-country install and upgrade validation via Run-AlValidation against the cached baseline release. Exit code 0 means no break; exit 3 means a breaking change was detected.

When should the breaking-change validation task run in an AL feature workflow?

It runs as the feature's last task, depending on the final terminal task, and is opened to ready by the per-feature code review on a clean pass. This ensures it validates the post-review bytes right before merge.

What happens when a breaking change is detected in Business Central validation?

The task is flipped to blocked and routed to /al-steer for a human decision. A detected break is an intent call — intended major version bump versus accidental schema change — so it is never auto-fixed or auto-accepted.

Why does breaking-change validation fail with a contract or prerequisite error?

Exit code 4 indicates a prerequisite failure: an empty or missing baseline cache, missing AppSourceCop.json affixes or countries, or the current app not built. Re-run /al-provision to populate the cache, fix the prerequisite, then re-run the validation.

Can breaking-change validation run without a provisioned baseline cache?

No. The script only reads the baseline cache populated by /al-provision and never downloads it. If the cache is empty or missing, the run fails with a contract error and the task is blocked until the cache is provisioned.