Copilot cli plugin support doc#54116
Open
Caoxuyang wants to merge 19 commits into
Open
Conversation
Replace manual MCP/agent setup doc with plugin-based workflow covering: - Java and .NET support (not .NET only) - Plugin installation via marketplace (no manual agent.md or MCP config) - Three-phase workflow (assess → plan → execute) - Enterprise playbook for policies, target architectures, and guardrails - Multiple workflow modes (broad intent, specific task, existing plan, headless) - Common scenarios and troubleshooting Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Remove Java references — this doc covers .NET modernization only. Updated title, capabilities, prerequisites, scenarios, playbook examples, and troubleshooting to be .NET-specific. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
These were referenced by the manual MCP/agent setup workflow which has been replaced by the plugin-based approach. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Show two ways to activate the agent: from terminal startup and from inside an existing Copilot CLI session via /agent command. Added IMPORTANT callout emphasizing agent must be selected first. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…table Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Merge duplicate Azure migration rows into single .NET migration to Azure row - Remove .NET SDK prerequisite — Appcat installs it automatically - Change verification step from /agent to /plugin list - Remove trailing comma in rulebook example Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Rename "Working with Assessment" → "Assessment: Comprehensive guide..." - Reorder docs logically: Overview → Quickstart → Assessment guide → Predefined Tasks → Containerize → Deploy → Coding Agent → CLI → Sample → FAQ Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
New tab for the GitHub Copilot modernization plugin in Copilot CLI covering: plugin installation, assessment, full modernization, specific tasks, unattended execution, enterprise rulebook, and validation. Switched pivot group to copilot-modernization-install which already includes the copilot-cli pivot. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
joint work with azure storage team
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
dotnet-policy-service
Bot
added
dotnet-azure/svc
community-contribution
Contributor
There was a problem hiding this comment.
Pull request overview
Note
Copilot was unable to run its full agentic suite in this review.
Updates Modernization for .NET documentation to support a new “Copilot CLI” quickstart experience and to refresh Copilot CLI plugin guidance.
Changes:
- Added a new zone pivot group and wired the app modernization quickstart to use it (including a new Copilot CLI pivot include).
- Reorganized Azure TOC entries and retitled the assessment guide for consistency.
- Rewrote/expanded the Copilot CLI support article to focus on the plugin workflow, playbooks, and troubleshooting.
Reviewed changes
Copilot reviewed 7 out of 11 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/zone-pivot-groups.yml | Adds a new zone pivot group for modernization migration scenarios. |
| docs/azure/toc.yml | Reorders/renames entries and moves FAQ placement in the App Modernization section. |
| docs/azure/migration/appmod/working-with-assessment.md | Renames the page title to “Assessment …” for consistency with TOC. |
| docs/azure/migration/appmod/quickstart.md | Switches to the new pivot group and adds a Copilot CLI zone include. |
| docs/azure/migration/appmod/predefined-tasks.md | Adds best-practices context to the Blob Storage task description. |
| docs/azure/migration/appmod/includes/quickstart-copilot-cli.md | New include with step-by-step Copilot CLI plugin quickstart content. |
| docs/azure/migration/appmod/copilot-cli-support.md | Refreshes the Copilot CLI plugin article (install/update/usage/playbooks/troubleshooting). |
Comments suppressed due to low confidence (1)
docs/azure/migration/appmod/copilot-cli-support.md:1
- This table repeats the same
||prefix issue, which is likely to break table rendering. Switch to standard Markdown table formatting with single|delimiters.
---
Comment on lines
+61
to
+70
| - id: copilot-modernization-migrate | ||
| title: Development environment | ||
| prompt: Choose your development environment | ||
| pivots: | ||
| - id: visualstudio | ||
| title: Visual Studio | ||
| - id: vscode | ||
| title: Visual Studio Code | ||
| - id: copilot-cli | ||
| title: GitHub Copilot CLI |
|
|
||
| 1. In a terminal, navigate to the .NET project folder containing the code you want to work on. | ||
| 1. Run `copilot` to start Copilot CLI. | ||
| 1. In a terminal, run `copilot` to start Copilot CLI. |
|
|
||
| :::image type="content" source="./media/copilot-cli-entrance.png" lightbox="./media/copilot-cli-entrance.png" alt-text="Screenshot of modernization entrance in Copilot CLI."::: | ||
| 1. Add the marketplace and install the plugin: | ||
|
|
|
|
||
| Choose one of the options: | ||
| 1. Verify the plugin is installed by listing installed plugins: | ||
|
|
Comment on lines
+24
to
+28
| | Capability | Description | | ||
| |---|---| | ||
| | **.NET migration to Azure** | Assess and migrate .NET applications to Azure services (Service Bus, Azure SQL, Redis, Key Vault, Application Insights, Managed Identity), including NuGet security audits and ASP.NET-to-Azure migrations | | ||
| | **CVE and vulnerability fixing** | Scan and fix CVE vulnerabilities in NuGet dependencies | | ||
| | **Application rearchitecture** | Structural rewrites such as monolith-to-microservices decomposition, legacy UI modernization, and module extraction | |
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.
Summary
Describe your changes here.
Fixes #Issue_Number (if available)
Internal previews