AL plan guidance (preview)
This is BCQuality's host-native adapter for applying knowledge to an existing
AL development plan. It is a preview: the underlying contract may change based
on pilot feedback. It is not a BCQuality action skill and contains no routing
or knowledge-selection policy. Its only responsibility is to translate the
caller's request into an Entry task context and execute the resulting dispatch.
The adapter is read-only. It never creates or rewrites the plan, edits source,
writes generated files into the caller's repository, runs tests, or implements
the change.
Execute
- Resolve
PLUGIN_ROOT to the directory containing this plugin's root
plugin.json. This file is
PLUGIN_ROOT/skills/al-plan-guidance/SKILL.md; when the host does not
expose the plugin root, resolve it two levels above this file.
- Identify the caller's existing plan: a plan file path, plan text in the
request, or a plan the caller explicitly identifies in the conversation. If
no plan is available, ask the caller for one. Do not generate a plan; this
skill enriches an existing one.
- Build the
task-context required by PLUGIN_ROOT/skills/entry.md:
- Copy the caller's actual request verbatim into
goal.
- Set
inputs-available to development-plan, plus repository when the
caller's AL repository or app folder is readable. Pass the complete plan
content as development-plan and the repository path as repository;
for a request in the caller's working directory, use that directory.
- Set
technologies: [al].
- Pass
bc-version, countries, and application-area only when supplied
or reliably determined from the plan or repository.
- If
BCQUALITY_ENABLED_LAYERS is set, split its comma-separated value and
pass the trimmed, non-empty entries as enabled-layers; otherwise omit the
field and let Entry apply its default.
- If
BCQUALITY_DISABLED_SKILLS is set, split its comma-separated value and
pass the trimmed, non-empty entries as disabled-skills; otherwise omit
the field.
- Read and execute
PLUGIN_ROOT/skills/entry.md exactly as written, including
its Preparation step. Entry is authoritative for index freshness, routing,
defaults, and failure behavior; this adapter must not duplicate or weaken
those rules. Resolve every repo-relative path Entry names against
PLUGIN_ROOT, not the caller's working directory. Run Preparation's index
build as pwsh PLUGIN_ROOT/tools/Build-KnowledgeIndex.ps1. If PLUGIN_ROOT
is inside the caller's repository, pass -IndexPath to a location outside
that repository and supply the resulting index path to the dispatched skill.
If pwsh is unavailable or the build fails, continue with READ's
path-based discovery; a failed build is not empty knowledge.
- Follow Entry's How the agent uses the dispatch instructions. Invoke only
the returned action skills, pass each dispatch entry's exact input subset,
and read
PLUGIN_ROOT/skills/read.md and PLUGIN_ROOT/skills/do.md on
demand.
- Return each dispatched development guidance report unchanged. If Entry
returns
no-match or failed, return its dispatch record unchanged.
The internal microsoft/skills/development/al-development-plan.md action skill
selects and converts the applicable knowledge. This adapter never selects
articles itself.
Using the result
Give the guidance report to the agent implementing the plan, together with the
plan itself. After implementation, review the completed change with
al-code-review; the guidance report is input to the work, not proof that the
result is correct.
Layer selection is not a deny mechanism
A plugin install ships the whole BCQuality tree, so enabled-layers here can
only narrow discovery: the files of a layer left out of the list still exist
on disk. Treat BCQUALITY_ENABLED_LAYERS as a selection filter, never as a
security boundary. A host that needs a genuine deny mechanism must prune the
installed tree itself.
1---2name: al-plan-guidance3description: Preview. Enrich an existing Business Central AL development plan with applicable BCQuality guidance before implementation, without changing the plan or repository. Use when the caller supplies a plan file or plan text for an AL change.4metadata:5 source: https://skillmd.com/skills/microsoft/al-plan-guidance6---78# AL plan guidance (preview)910This is BCQuality's host-native adapter for applying knowledge to an existing11AL development plan. It is a preview: the underlying contract may change based12on pilot feedback. It is not a BCQuality action skill and contains no routing13or knowledge-selection policy. Its only responsibility is to translate the14caller's request into an Entry task context and execute the resulting dispatch.1516The adapter is read-only. It never creates or rewrites the plan, edits source,17writes generated files into the caller's repository, runs tests, or implements18the change.1920## Execute21221. Resolve `PLUGIN_ROOT` to the directory containing this plugin's root23 `plugin.json`. This file is24 `PLUGIN_ROOT/skills/al-plan-guidance/SKILL.md`; when the host does not25 expose the plugin root, resolve it two levels above this file.262. Identify the caller's existing plan: a plan file path, plan text in the27 request, or a plan the caller explicitly identifies in the conversation. If28 no plan is available, ask the caller for one. Do not generate a plan; this29 skill enriches an existing one.303. Build the `task-context` required by `PLUGIN_ROOT/skills/entry.md`:31 - Copy the caller's actual request verbatim into `goal`.32 - Set `inputs-available` to `development-plan`, plus `repository` when the33 caller's AL repository or app folder is readable. Pass the complete plan34 content as `development-plan` and the repository path as `repository`;35 for a request in the caller's working directory, use that directory.36 - Set `technologies: [al]`.37 - Pass `bc-version`, `countries`, and `application-area` only when supplied38 or reliably determined from the plan or repository.39 - If `BCQUALITY_ENABLED_LAYERS` is set, split its comma-separated value and40 pass the trimmed, non-empty entries as `enabled-layers`; otherwise omit the41 field and let Entry apply its default.42 - If `BCQUALITY_DISABLED_SKILLS` is set, split its comma-separated value and43 pass the trimmed, non-empty entries as `disabled-skills`; otherwise omit44 the field.454. Read and execute `PLUGIN_ROOT/skills/entry.md` exactly as written, including46 its Preparation step. Entry is authoritative for index freshness, routing,47 defaults, and failure behavior; this adapter must not duplicate or weaken48 those rules. Resolve every repo-relative path Entry names against49 `PLUGIN_ROOT`, not the caller's working directory. Run Preparation's index50 build as `pwsh PLUGIN_ROOT/tools/Build-KnowledgeIndex.ps1`. If `PLUGIN_ROOT`51 is inside the caller's repository, pass `-IndexPath` to a location outside52 that repository and supply the resulting index path to the dispatched skill.53 If `pwsh` is unavailable or the build fails, continue with READ's54 path-based discovery; a failed build is not empty knowledge.555. Follow Entry's **How the agent uses the dispatch** instructions. Invoke only56 the returned action skills, pass each dispatch entry's exact input subset,57 and read `PLUGIN_ROOT/skills/read.md` and `PLUGIN_ROOT/skills/do.md` on58 demand.596. Return each dispatched development guidance report unchanged. If Entry60 returns `no-match` or `failed`, return its dispatch record unchanged.6162The internal `microsoft/skills/development/al-development-plan.md` action skill63selects and converts the applicable knowledge. This adapter never selects64articles itself.6566## Using the result6768Give the guidance report to the agent implementing the plan, together with the69plan itself. After implementation, review the completed change with70`al-code-review`; the guidance report is input to the work, not proof that the71result is correct.7273## Layer selection is not a deny mechanism7475A plugin install ships the whole BCQuality tree, so `enabled-layers` here can76only narrow *discovery*: the files of a layer left out of the list still exist77on disk. Treat `BCQUALITY_ENABLED_LAYERS` as a selection filter, never as a78security boundary. A host that needs a genuine deny mechanism must prune the79installed tree itself.