Skip to content

Copilot cli support doc#54110

Merged
alexwolfmsft merged 19 commits into
dotnet:mainfrom
Caoxuyang:copilot-cli-support-doc
Jun 1, 2026
Merged

Copilot cli support doc#54110
alexwolfmsft merged 19 commits into
dotnet:mainfrom
Caoxuyang:copilot-cli-support-doc

Conversation

@alexwolfmsft

@alexwolfmsft alexwolfmsft commented Jun 1, 2026

Copy link
Copy Markdown
Contributor

This pull request improves the documentation for using GitHub Copilot modernization in Copilot CLI for .NET application migration to Azure. It restructures and expands the main guide, introduces a new quickstart for Copilot CLI, clarifies the workflow and plugin installation, and enhances scenario coverage and best practice references.


Internal previews

📄 File 🔗 Preview link
docs/azure/migration/appmod/copilot-cli-support.md Migrate .NET apps to Azure by using GitHub Copilot modernization in Copilot CLI
docs/azure/migration/appmod/predefined-tasks.md Predefined tasks for GitHub Copilot modernization for .NET
docs/azure/migration/appmod/quickstart.md Quickstart: Assess and migrate a .NET project with GitHub Copilot modernization for .NET
docs/azure/migration/appmod/working-with-assessment.md docs/azure/migration/appmod/working-with-assessment
docs/azure/toc.yml docs/azure/toc
docs/zone-pivot-groups.yml docs/zone-pivot-groups

Xuyang Cao and others added 15 commits May 14, 2026 14:55
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>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings June 1, 2026 19:28
@alexwolfmsft alexwolfmsft requested a review from a team as a code owner June 1, 2026 19:28
@dotnetrepoman dotnetrepoman Bot added this to the June 2026 milestone Jun 1, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request updates the Azure migration documentation set for GitHub Copilot modernization for .NET, adding Copilot CLI coverage and reorganizing navigation so readers can follow an assessment→migration workflow from the Azure docs hub.

Changes:

  • Reorders the Azure TOC entries for Copilot modernization and adds a new “Assessment guide” placement.
  • Updates the main migration quickstart to support a Copilot CLI pivot and adds a new Copilot CLI quickstart include.
  • Restructures and expands the Copilot CLI support article with plugin installation, workflow phases, scenarios, and troubleshooting.

Reviewed changes

Copilot reviewed 6 out of 10 changed files in this pull request and generated 12 comments.

Show a summary per file
File Description
docs/azure/toc.yml Reorders Copilot modernization entries and moves FAQ to the end.
docs/azure/migration/appmod/working-with-assessment.md Renames the page title to better match its role as an assessment guide.
docs/azure/migration/appmod/quickstart.md Switches to the Copilot modernization pivot group and adds a Copilot CLI pivot include.
docs/azure/migration/appmod/predefined-tasks.md Expands the Blob Storage predefined task description.
docs/azure/migration/appmod/includes/quickstart-copilot-cli.md Adds a new Copilot CLI quickstart include for assessment and migration.
docs/azure/migration/appmod/copilot-cli-support.md Rewrites/expands Copilot CLI support guidance, including workflow, playbooks, scenarios, and troubleshooting.

Comment thread docs/azure/migration/appmod/copilot-cli-support.md
Comment thread docs/azure/migration/appmod/copilot-cli-support.md
Comment thread docs/azure/migration/appmod/copilot-cli-support.md Outdated
Comment thread docs/azure/migration/appmod/copilot-cli-support.md
Comment thread docs/azure/migration/appmod/includes/quickstart-copilot-cli.md Outdated
Comment thread docs/azure/migration/appmod/includes/quickstart-copilot-cli.md Outdated
Comment thread docs/azure/migration/appmod/predefined-tasks.md Outdated
Comment thread docs/azure/toc.yml Outdated
Comment thread docs/azure/migration/appmod/copilot-cli-support.md Outdated
Comment thread docs/azure/migration/appmod/copilot-cli-support.md Outdated
alexwolfmsft and others added 4 commits June 1, 2026 15:42
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

@gewarren gewarren left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@alexwolfmsft alexwolfmsft merged commit 49fda5a into dotnet:main Jun 1, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants