Repository navigation
[5.3.0] - 2026-11-10
Changed — workflows ship as skills instead of prompt files
- Cause: VS Code Copilot harness sessions do not load
*.prompt.mdfiles; prompt files
run only in the Local harness, which VS Code is retiring. VS Code offered to convert the
11 installed ALDC prompts ("Convert Prompt to Skills"), which would have left
unmanaged copies without tools, model or agent selection. - The 10 workflows are now canonical skills at
skills/<name>/SKILL.mdwith
disable-model-invocation: true, invoked as/al-spec-create,/al-build,
/al-pr-prepare,/al-memory-create,/al-context-create,/al-initialize,
/al-agent-create,/al-agent-task,/al-agent-instructionsand/al-agent-test.
Dotted names become hyphens, the names Copilot CLI, Codex and Claude Code already used. - Removed
al-agent.build-instructions: it was byte-identical toal-agent.instructions
and nothing referenced it. - Skills cannot set
tools,modeloragent. A workflow now runs with the tools
of the agent that invokes it; the Chat profiles keep adding each workflow's scope
and native-tool guidance to its body./al-spec-createroutes to AL Spec Agent
through its body, as it already did when a host could not honour theagent:field. - Agents and instructions now say
/al-spec-createinstead of@workspace use al-spec.create, which was not a valid invocation. - Updating an installation removes the
.github/prompts/files it installed, with a
recoverable backup, also when the earlier release left no receipt (it uses
known-installations.json). A prompt you customized stays in place and is reported
as a collision on every update;--forceretires it with a recoverable backup. scripts/workflows.js(no dependencies) is the workflow list for the installer, the
Chat profiles and the CLI/Codex generators. The VS Code extension must package it.- Doctor recognises
skills/al-spec-create/SKILL.mdand still diagnoses 5.2.x layouts. - The collection manifest gains
kind: skill; the validator rejects a skill whose
name has dots or differs from its folder (VS Code skips those silently). - Not verified in a host:
/al-*commands appearing in VS Code (Local and Copilot
harnesses) after an update, and the Migrations view no longer listing ALDC prompts.
Removed — Claude Code edition 5.3.0 drops the duplicate workflow skill
/aldc:al-agent-build-instructionsis gone from the maintained Claude Code plugin. It
was the adapter of the removedal-agent.build-instructionsand did the same as
/aldc:al-agent-instructions, which stays. The plugin now ships 10 workflow skills.- Payload relocked; the Claude edition moves from 5.2.1 to 5.3.0. Its other workflow
skills are unchanged and still name the prompt file each one was adapted from. - Not verified in a host: the command list after
claude plugin update.
What's Changed
- Prepare ALDC 5.2.1 for Copilot Chat by @javiarmesto in #149
- Ship the ten workflows as skills instead of prompt files by @javiarmesto in #150
Full Changelog: v5.2.1...v5.3.0