docs(ai): move to new azldev emitted instructions and skills, add azldev mcp#17949
Draft
dmcilvaney wants to merge 4 commits into
Draft
docs(ai): move to new azldev emitted instructions and skills, add azldev mcp#17949dmcilvaney wants to merge 4 commits into
dmcilvaney wants to merge 4 commits into
Conversation
dmcilvaney
changed the title
dmcilvaney
force-pushed
the
damcilva/4.0/azldev_emit_skills
branch
from
d9f2a76 to
3e395a2
Compare
dmcilvaney
commented
Jul 8, 2026
| "password": false | ||
| } | ||
| ] | ||
| "inputs": [ |
Contributor
Author
There was a problem hiding this comment.
azldev json output formats differently, this should be a one-time drift (azldev agent setup can add the mcp)
Contributor
There was a problem hiding this comment.
Pull request overview
This PR migrates the repository's AI assistant guidance from the hand-written .github/skills/skill-* skills and verbose .github/instructions/*.md files to a new set of azldev-emitted skills under .agents/skills/azldev-* (generated for azldev v0.1.0), and slims the instruction files down to short "read the relevant azldev skill" pointers. It also registers a new azldev MCP server (azldev advanced mcp) in .vscode/mcp.json. Per the description, this is a first step; a workflow to keep these generated files fresh will follow once the azldev feature ships in a stable release.
Changes:
- Delete the old component-workflow skills (
skill-add/build/remove/update-component,skill-fix-overlay,skill-mock,skill-review-component) and add nine new.agents/skills/azldev-*skills plus a top-levelazldevskill. - Rewrite
comp-toml.instructions.mdandrendered-specs.instructions.mdinto short skill-pointer stubs; addazldev.instructions.mdandreview.instructions.md. - Add the
azldevMCP server to.vscode/mcp.json(and reformat/alphabetize the file); no existing servers removed.
Note (verify before merge): The migration is incomplete with respect to unchanged files. Removing the ## Spec Source Types/## Overlays sections breaks anchor links in .github/copilot-instructions.md, and the deleted skill-* files are still referenced by AGENTS.md, base/comps/AGENTS.md, the azl-*.prompt.md prompts, and spec.instructions.md. Additionally, .github/plugin/plugin.json registers skills only from .github/skills/, while the new skills live in .agents/skills/, so their discovery path should be confirmed.
Reviewed changes
Copilot reviewed 21 out of 21 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
.vscode/mcp.json |
Adds the azldev stdio MCP server; reformats/sorts existing server entries. |
.github/instructions/review.instructions.md |
New repo-wide review instruction pointing to azldev/DEVELOPING.md. |
.github/instructions/azldev.instructions.md |
New instruction scoped to azldev.toml pointing at the azldev skill. |
.github/instructions/comp-toml.instructions.md |
Replaces detailed content with skill pointers (removes anchored sections still linked elsewhere). |
.github/instructions/rendered-specs.instructions.md |
Trims to skill pointers; narrows applyTo to specs/**/*.spec. |
.github/skills/skill-*/SKILL.md (7 files) |
Deleted old component-workflow skills. |
.agents/skills/azldev*/SKILL.md (9 files) |
New azldev-generated skills (v0.1.0) for CLI, comp-toml, overlays, build, add/remove/update-component, image, mock. |
dmcilvaney
force-pushed
the
damcilva/4.0/azldev_emit_skills
branch
from
3e395a2 to
a18ed78
Compare
…dev mcp A new feature of azldev will emit instruction files and skills for using the tool. Update the instructions and skills to the new version. Once the feature is available in a stable release of azldev, a workflow will be added to ensure these instructions are kept fresh.
dmcilvaney
force-pushed
the
damcilva/4.0/azldev_emit_skills
branch
from
a18ed78 to
46101a6
Compare
| Copilot CLI (`.mcp.json`), including the `azldev advanced mcp` server. Run Copilot | ||
| CLI from the repository root so it discovers the project configuration. | ||
|
|
||
| Note: `copilot` supports fully autonomous operation (no interactive mode) with `-p <prompt>`. `--yolo` (same as `--allow-all-tools --allow-all-paths --allow-all-urls`) is an option, but use with extreme caution since it grants the agent unrestricted access to your filesystem and network. For now, it's recommended to use `-i` to at least have visibility into the agent's thought process and tool usage. |
Comment on lines
+66
to
+70
| "microsoft/azure-devops-mcp": { | ||
| "args": [ | ||
| "-y", | ||
| "@azure-devops/mcp@latest", | ||
| "$AZURE_DEVOPS_ORG", |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
A new feature of azldev will emit instruction files and skills for using the tool. Update the instructions and skills to the new version.
Once the feature is available in a stable release of azldev, a workflow will be added to ensure these instructions are kept fresh.