Copilot cli support doc

docs/azure/migration/appmod/includes/quickstart-copilot-cli.md

@@ -0,0 +1,125 @@
+---
+ms.topic: include
+ms.date: 05/22/2026
+author: alexwolfmsft
+ms.author: alexwolf
+ms.reviewer: alexwolf
+title: GitHub Copilot modernization in Copilot CLI
+description: Learn how to assess .NET app readiness and migrate to Azure with GitHub Copilot modernization plugin in Copilot CLI. Follow step-by-step guidance for seamless modernization.
+---
+
+## Prerequisites
+
+- A GitHub account with an active [GitHub Copilot](https://github.com/features/copilot) subscription under any plan.
+- [Copilot CLI](https://docs.github.com/en/copilot/how-tos/set-up/install-copilot-cli) installed.
+
+## Install the plugin
+
+1. In a terminal, run `copilot` to start Copilot CLI.
+
+    ```bash
+    copilot
+    ```
+
+1. Add the marketplace and install the plugin:
+
+    ```bash
+    copilot plugin marketplace add microsoft/github-copilot-modernization
+    copilot plugin install github-copilot-modernization@github-copilot-modernization
+    ```
+
+1. Verify the plugin is installed:
+
+    ```text
+    /plugin list
+    ```
+
+    You should see `github-copilot-modernization` in the list.
+
+## Assess app readiness
+
+GitHub Copilot modernization assessment helps you find app readiness challenges, learn their impact, and see recommended migration tasks.
+
+1. Clone the [.NET migration copilot samples](https://github.com/Azure-Samples/dotnet-migration-copilot-samples) repository to your computer.
+
+1. Navigate to the **Contoso University** project folder:
+
+    ```bash
+    cd dotnet-migration-copilot-samples/ContosoUniversity
+    ```
+
+1. Start Copilot CLI with the modernization agent:
+
+    ```bash
+    copilot --agent=github-copilot-modernization:modernize
+    ```
+
+    > [!IMPORTANT]
+    > You must select the `github-copilot-modernization:modernize` agent before running any modernization prompts. If you're already in a Copilot CLI session, use `/agent` and select `github-copilot-modernization:modernize` from the list.
+
+1. Ask the agent to assess the application:
+
+    ```text
+    copilot> modernize my application
+    ```
+
+    The agent automatically starts the assessment phase and analyzes your project for migration readiness—including dependencies, frameworks, and Azure migration opportunities.
+
+1. When the assessment finishes, the agent presents a summary of findings and asks: **"Proceed to planning?"**
+
+## Migrate your app
+
+After reviewing the assessment, continue through the planning and execution phases.
+
+### Full modernization (assess → plan → execute)
+
+The agent runs the complete workflow automatically when you confirm each phase:
+
+1. **Assessment** → Review findings → Confirm to proceed
+1. **Planning** → The agent generates a migration plan (`plan.md`) → Review and confirm
+1. **Execution** → The agent routes tasks to specialized executor agents that apply code changes, run builds, and validate results
+
+The agent handles everything—just confirm at each checkpoint.
+
+### Specific migration task
+
+If you already know what you want to migrate, skip the assessment and go straight to execution:
+
+```text
+copilot> migrate from local SQL Server to Azure SQL Database
+```
+
+For multiple tasks, list them:
+
+```text
+copilot> migrate from RabbitMQ to Azure Service Bus and upgrade to .NET 9
+```
+
+### Unattended execution
+
+For fully autonomous execution without prompts, use the `--allow-all` flag:
+
+```bash
+copilot --agent=github-copilot-modernization:modernize --allow-all
+```
+
+### Enterprise rulebook
+
+To embed modernization policies, place Markdown files in the `.github/modernize/rulebook/` directory. During the planning phase, rulebook constraints merge with assessment results—rulebook policies take precedence over assessment recommendations.
+
+For more information, see [Migrate .NET apps to Azure using GitHub Copilot modernization in Copilot CLI](../copilot-cli-support.md#define-enterprise-modernization-policies).
+
+### Validation
+
+After the agent applies code changes, it runs validation checks:
+
+1. Builds the project and resolves any build errors.
+1. Detects Common Vulnerabilities and Exposures (CVEs) in dependencies and fixes them.
+1. Runs tests and fixes any failures.
+
+After all validation checks pass, the agent generates a summary. Review the results and verify:
+
+```bash
+dotnet build
+dotnet test
+```

docs/azure/migration/appmod/predefined-tasks.md

@@ -34,7 +34,7 @@ Modernization for .NET currently supports the following predefined tasks:
 
 - **Migrate to Azure Blob Storage**
 
-  Replace on-premises or cross-cloud object storage, or local file system file I/O, with Azure Blob Storage for unstructured data.
+  Replace on-premises or cross-cloud object storage, or local file system file I/O, with Azure Blob Storage for unstructured data. This migration knowledge was developed in collaboration with the Azure Storage team, drawing on their deep expertise in Blob Storage APIs, authentication patterns, and platform-specific behaviors to ensure the guidance reflects production-grade best practices.
 
 - **Migrate to Microsoft Entra ID**
 

docs/azure/migration/appmod/quickstart.md

@@ -5,7 +5,7 @@ description: Assess and migrate your .NET project with GitHub Copilot. Learn how
 ms.topic: quickstart
 ms.custom: devx-track-dotnet
 ms.date: 01/26/2026
-zone_pivot_groups: ide-set-one
+zone_pivot_groups: copilot-modernization-install
 #customer intent: As a .NET developer, I want to assess my project's migration readiness so that I can identify potential challenges and plan the modernization process effectively.
 ---
 
@@ -24,6 +24,10 @@ In this quickstart, you assess and migrate a .NET project by using GitHub Copilo
 [!INCLUDE [quickstart-vscode](./includes/quickstart-vscode.md)]
 ::: zone-end
 
+::: zone pivot="copilot-cli"
+[!INCLUDE [quickstart-copilot-cli](./includes/quickstart-copilot-cli.md)]
+::: zone-end
+
 ## Next Steps
 
 - [Predefined Tasks](predefined-tasks.md)

docs/azure/migration/appmod/working-with-assessment.md

@@ -1,5 +1,5 @@
 ---
-title: "Working with Assessment: Comprehensive guide to application assessment"
+title: "Assessment: Comprehensive guide to application assessment"
 description: Learn how to effectively work with application assessments in GitHub Copilot modernization, including configuration, interpretation, and report management.
 author: KarlErickson
 ms.author: karler

docs/azure/toc.yml

@@ -28,14 +28,12 @@ items:
       items:
         - name: Overview
           href: ../core/porting/github-copilot-app-modernization/overview.md?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json
-        - name: FAQ
-          href: ../core/porting/github-copilot-app-modernization/faq.yml?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json
-        - name: Predefined Tasks
-          href: ./migration/appmod/predefined-tasks.md
-        - name: Working with assessment
-          href: ./migration/appmod/working-with-assessment.md
         - name: Quickstart - Assess and migrate a .NET project
           href: ./migration/appmod/quickstart.md
+        - name: Assessment guide
+          href: ./migration/appmod/working-with-assessment.md
+        - name: Predefined Tasks
+          href: ./migration/appmod/predefined-tasks.md
         - name: Quickstart - Containerize a .NET project
           href: ./migration/appmod/containerization.md
         - name: Quickstart - Deploy a .NET project to Azure
@@ -46,6 +44,8 @@ items:
           href: ./migration/appmod/copilot-cli-support.md
         - name: Sample - Contoso University
           href: ./migration/appmod/sample.md
+        - name: FAQ
+          href: ../core/porting/github-copilot-app-modernization/faq.yml?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json
     - name: Azure Migrate application and code assessment
       items:
       - name: Overview