dotnet · adegeo · Jul 30, 2026 · Jul 30, 2026 · Jul 30, 2026 · Jul 30, 2026
@@ -16,14 +16,6 @@
             "source_path_from_root": "/docs/azure/dotnet-howto-migrate-vm.md",
             "redirect_url": "/dotnet/azure/migration/vm"
         },
-        {
-            "source_path_from_root": "/docs/azure/migration/appmod/overview.md",
-            "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization-overview?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json"
-        },
-        {
-            "source_path_from_root": "/docs/azure/migration/appmod/faq.md",
-            "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization-faq?toc=/dotnet/azure/toc.json&bc=/dotnet/breadcrumb/toc.json"
-        },
         {
             "source_path_from_root": "/docs/azure/migration/appmod/coding-agent-support.md",
             "redirect_url": "/dotnet/azure/migration/appmod/cloud-agent-support"

@@ -1332,15 +1332,63 @@
     },
     {
       "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization-faq.yml",
-      "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/faq"
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/faq"
     },
     {
       "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization-overview.md",
-      "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/overview"
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/overview"
+    },
+    {
+      "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/best-practices.md",
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/best-practices"
+    },
+    {
+      "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/concepts.md",
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/concepts"
+    },
+    {
+      "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/customization.md",
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/customization"
+    },
+    {
+      "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/faq.yml",
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/faq"
+    },
+    {
+      "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/how-to-custom-upgrade-instructions.md",
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/how-to-custom-upgrade-instructions"
+    },
+    {
+      "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md",
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/how-to-upgrade-with-github-copilot"
+    },
+    {
+      "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/index.yml",
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/"
+    },
+    {
+      "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/install.md",
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/install"
+    },
+    {
+      "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/overview.md",
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/overview"
+    },
+    {
+      "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md",
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/scenarios-and-skills"
+    },
+    {
+      "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/troubleshooting.md",
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/troubleshooting"
+    },
+    {
+      "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization/working-with-agent.md",
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/working-with-agent"
     },
     {
       "source_path_from_root": "/docs/core/porting/how-to-upgrade-with-github-copilot.md",
-      "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot"
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/how-to-upgrade-with-github-copilot"
     },
     {
       "source_path_from_root": "/docs/core/porting/libraries.md",
@@ -1360,15 +1408,15 @@
     },
     {
       "source_path_from_root": "/docs/core/porting/upgrade-assistant-install-legacy.md",
-      "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/overview"
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/overview"
     },
     {
       "source_path_from_root": "/docs/core/porting/upgrade-assistant-uwp-framework.md",
       "redirect_url": "/windows/apps/windows-app-sdk/migrate-to-windows-app-sdk/upgrade-assistant"
     },
     {
       "source_path_from_root": "/docs/core/porting/upgrade-assistant-wcf.md",
-      "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/overview"
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/overview"
     },
     {
       "source_path_from_root": "/docs/core/porting/upgrade-assistant-winforms-framework.md",
@@ -1397,7 +1445,7 @@
     },
     {
       "source_path_from_root": "/docs/core/porting/github-copilot-app-modernization-install.md",
-      "redirect_url": "/dotnet/core/porting/github-copilot-app-modernization/overview"
+      "redirect_url": "/dotnet/core/porting/github-copilot-upgrade/overview"
     },
     {
       "source_path_from_root": "/docs/core/preview3/tools/csproj.md",

@@ -23,7 +23,7 @@ In this quickstart, you learn how to containerize your project using GitHub Copi
 
 Before you begin, make sure you have:
 
-[!INCLUDE [github-copilot-app-modernization-prereqs](../../../includes/github-copilot-app-modernization-prereqs.md)]
+[!INCLUDE [github-copilot-app-modernization-prereqs](./includes/github-copilot-app-modernization-prereqs.md)]
 
 ## Containerize your project
 

@@ -14,7 +14,7 @@ In this quickstart, you learn how to deploy your project to Azure with GitHub Co
 
 ## Prerequisites
 
-[!INCLUDE [github-copilot-app-modernization-prereqs](../../../includes/github-copilot-app-modernization-prereqs.md)]
+[!INCLUDE [github-copilot-app-modernization-prereqs](./includes/github-copilot-app-modernization-prereqs.md)]
 
 ## Deploy your project
 

@@ -4,7 +4,8 @@ metadata:
   description: "This article answers frequently asked questions about GitHub Copilot modernization for .NET."
   titleSuffix: ""
   ms.topic: faq
-  ms.date: 07/07/2026
+  ms.date: 07/30/2026
+  ms.custom: devx-track-dotnet
 
 title: GitHub Copilot modernization FAQ
 summary: |
@@ -27,7 +28,7 @@ sections:
     questions:
       - question: What can the agent do?
         answer: |
-          GitHub Copilot modernization helps you upgrade your .NET (.NET, .NET Core, and .NET Framework) projects to newer versions of .NET. It also helps modernize services for Azure, upgrades dependencies, and fixes errors in code after the upgrade. The agent performs the following steps in a Copilot chat session:
+          GitHub Copilot modernization is focused on migrating and modernizing your .NET applications for Azure. It helps assess your app for Azure readiness, generates a migration plan, and guides you through the steps to deploy your app to Azure. The agent performs the following steps in a Copilot chat session:
 
           - Analyzes your projects and proposes a modernization plan.
           - Runs a series of tasks to modernize your projects according to the plan.
@@ -36,6 +37,8 @@ sections:
           - Reports progress and allows access to code changes and logs.
           - Learns from your interactions during the session to improve subsequent transformations.
 
+          To upgrade your .NET projects to newer versions of .NET, GitHub Copilot modernization uses the [GitHub Copilot upgrade agent](../../../core/porting/github-copilot-upgrade/overview.md).
+
       - question: What limitations are there?
         answer: |
           - The agent requires a local Git repository.
@@ -52,7 +55,7 @@ sections:
 
       - question: Can I customize or guide the agent?
         answer: |
-          The agent uses customization Copilot provides, such as instruction files and skills. Customization is based on what your Copilot supports. The agent includes 30+ built-in modernization skills that load automatically based on the technologies detected in your codebase. You can also create custom skills and scenarios. For more information, see [Apply custom upgrade instructions](how-to-custom-upgrade-instructions.md).
+          The agent uses customization Copilot provides, such as instruction files and skills. Customization is based on what your Copilot supports. The agent includes 30+ built-in modernization skills that load automatically based on the technologies detected in your codebase. You can also create custom skills and scenarios.
 
           If you manually adjust a fix, provide additional instructions in chat, or update the Markdown in the plan file, the agent learns from that interaction in the short term. Preferences and decisions are saved to `scenario-instructions.md` in the `.github/upgrades/` folder so they persist across sessions.
 
@@ -75,47 +78,6 @@ sections:
         answer: |
           Yes. In Visual Studio, select **Help** > **Privacy** > **Privacy Settings** > **"No, I would not like to participate."** Telemetry settings might vary by development environment. Check your tool's privacy settings for more information.
 
-  - name: Upgrade .NET apps
-    questions:
-      - question: What can the agent upgrade?
-        answer: |
-          GitHub Copilot modernization helps you upgrade your .NET projects or modernize them for Azure. The agent supports multiple scenarios beyond framework upgrades, including Aspire integration, SDK-style conversion, Newtonsoft.Json upgrade, SqlClient upgrade, Azure Functions upgrade, and Semantic Kernel to Microsoft Agent Framework upgrade. For a full reference, see [Scenarios and skills reference](scenarios-and-skills.md).
-
-          The agent works with these project types:
-
-          - Azure Functions
-          - Console apps and class libraries
-          - Web technologies such as:
-            - MVC
-            - Blazor
-            - Razor Pages
-            - Web API
-            - ASP.NET Web Forms
-          - Desktop technologies such as Windows Forms, Windows Presentation Foundation, and WinUI
-          - .NET MAUI and Xamarin
-          - Test projects such as MSTest, NUnit, and xUnit
-          - .NET Framework projects
-
-          The agent supports both C# and Visual Basic.
-
-      - question: What .NET versions can I upgrade to?
-        answer: |
-          The agent supports the following upgrade paths:
-
-          [!INCLUDE[supported-upgrade-paths](./includes/supported-upgrade-paths.md)]
-
-      - question: Can I use the agent offline?
-        answer: |
-          No. The agent requires an internet connection and the GitHub Copilot cloud infrastructure. The agent works with all Copilot subscription tiers, including the free tier.
-
-      - question: Does the agent modify files outside the solution?
-        answer: |
-          No. The agent only modifies files within your workspace and the `.github/upgrades/` folder. Custom task data stays in your repository.
-
-      - question: Can I partially accept the agent's changes?
-        answer: |
-          Yes. Because each task is committed separately, you can cherry-pick specific commits by using standard Git commands. Review the commit history with `git log --oneline` and use `git cherry-pick` to select individual changes.
-
   - name: Migrate to Azure
     questions:
       - question: What can the agent migrate?

@@ -1,9 +1,9 @@
 ---
-author: adegeo
-ms.author: adegeo
-ms.date: 03/04/2026
+author: alexwolfmsft
+ms.author: alexwolf
+ms.date: 07/30/2026
 ms.topic: include
-# Shared by Azure.NET app mod and .NET app mod
+# Shared by Azure .NET app modernization articles
 ---
 
 - Windows Operating System.
@@ -23,4 +23,4 @@ ms.topic: include
 - Code must be written in C#.
 
 > [!NOTE]
-> These prerequisites apply to Visual Studio. For other development environments, see [Install GitHub Copilot modernization](../core/porting/github-copilot-app-modernization/install.md).
+> These prerequisites apply to Visual Studio. For other development environments, see [Install GitHub Copilot modernization](../install.md).
@@ -5,7 +5,7 @@ ms.date: 01/22/2026
 
 ## Prerequisites
 
-[!INCLUDE [github-copilot-app-modernization-prereqs](../../../../includes/github-copilot-app-modernization-prereqs.md)]
+[!INCLUDE [github-copilot-app-modernization-prereqs](./github-copilot-app-modernization-prereqs.md)]
 
 ## Assess app readiness
 
@@ -95,4 +95,4 @@ Choose one of the predefined options and send it in the chat:
 
 - [Working with assessment](../working-with-assessment.md)
 - [Predefined Tasks](../predefined-tasks.md)
-- [Frequently Asked Questions](../../../../core/porting/github-copilot-app-modernization/faq.yml)
+- [Frequently Asked Questions](../faq.yml)
@@ -0,0 +1,133 @@
+---
+title: Install GitHub Copilot modernization
+description: "Learn how to install and set up GitHub Copilot modernization across Visual Studio, Visual Studio Code, GitHub Copilot CLI, and GitHub.com."
+ms.topic: install-set-up-deploy
+ms.date: 07/30/2026
+ms.custom: devx-track-dotnet
+ai-usage: ai-assisted
+zone_pivot_groups: copilot-modernization-install
+
+#customer intent: As a developer, I want to install GitHub Copilot modernization so that I can modernize my .NET applications.
+
+---
+
+# Install GitHub Copilot modernization
+
+GitHub Copilot modernization works across multiple development environments. Choose your preferred environment to install and set up GitHub Copilot modernization.
+
+::: zone pivot="visualstudio"
+
+## Prerequisites
+
+Before you install, make sure you have:
+
+- Windows operating system.
+- [Visual Studio 2026](https://visualstudio.microsoft.com/downloads/) (or Visual Studio 2022 version 17.14.17+).
+- [.NET desktop development workload](/visualstudio/install/modify-visual-studio?view=visualstudio&preserve-view=true#change-workloads-or-individual-components) with these optional components enabled: **GitHub Copilot**, **GitHub Copilot app modernization**.
+- GitHub Copilot subscription (paid or free).
+- [Sign in to Visual Studio with a GitHub account](/visualstudio/ide/work-with-github-accounts) that has [Copilot access](https://docs.github.com/copilot/get-started/plans#ready-to-choose-a-plan).
+- Code written in C# or Visual Basic.
+
+## Install
+
+Visual Studio includes GitHub Copilot modernization through the **GitHub Copilot app modernization** optional component, so you don't need to install it separately. Enable the **GitHub Copilot** and **GitHub Copilot app modernization** optional components in the **.NET desktop development** workload through the Visual Studio Installer.
+
+## Verify the installation
+
+1. Open a solution in Visual Studio.
+1. Right-click a project in **Solution Explorer** and select **Modernize**, or open **GitHub Copilot Chat** and type `@Modernize`.
+
+::: zone-end
+
+::: zone pivot="vscode"
+
+## Prerequisites
+
+Before you install, make sure you have:
+
+- Visual Studio Code.
+- GitHub Copilot extension installed.
+- GitHub Copilot subscription (paid or free).
+
+## Install
+
+Install as a Visual Studio Code extension:
+
+1. In Visual Studio Code, open the **Extensions** view (<kbd>Ctrl+Shift+X</kbd>).
+1. Search for **GitHub Copilot modernization**.
+1. Select **Install**.
+
+## Verify the installation
+
+1. Open a project in Visual Studio Code.
+1. Open the **GitHub Copilot Chat** view.
+1. Send `@modernize` in chat and confirm the agent responds.
+
+   -or-
+
+   Select the **Agent** picker and find the `Modernize` entry.
+
+::: zone-end
+
+::: zone pivot="copilot-cli"
+
+## Prerequisites
+
+Before you install, make sure you have:
+
+- [GitHub Copilot CLI](https://gh.io/cli) installed.
+- GitHub Copilot subscription (paid or free).
+
+## Install
+
+Install through the GitHub Copilot CLI:
+
+1. Open the GitHub Copilot chat window.
+
+1. Add the marketplace plugin:
+
+   ```console
+   /plugin marketplace add microsoft/github-copilot-modernization
+   ```
+
+1. Install the plugin:
+
+   ```console
+   /plugin install github-copilot-modernization@github-copilot-modernization
+   ```
+
+## Verify the installation
+
+Run `/plugin list` to confirm that `github-copilot-modernization@github-copilot-modernization` appears in the list.
+
+::: zone-end
+
+::: zone pivot="github-copilot-app"
+
+## Prerequisites
+
+Before you install, make sure you have:
+
+- [GitHub Copilot app](https://gh.io/app) installed.
+- GitHub Copilot subscription (paid or free).
+
+## Install
+
+Install through the GitHub Copilot app:
+
+1. Click [https://github.com/copilot/app/launch](https://github.com/copilot/app/launch?entry_point=modernization_agent_dotnetdocs&open=ghapp%3A%2F%2Fplugins%2Fmarketplace%2Fadd%3Fsource%3Dmicrosoft%2Fgithub-copilot-modernization) to automatically open the **Settings** > **Plugins** window in the GitHub Copilot app.
+1. In the **Add plugin marketplace?** dialog, select **Allow**.
+1. In the **Plugins** window, select **Add marketplace**.
+1. Expand the **github-copilot-modernization** entry and select **Install** on the **github-copilot-modernization** plugin.
+
+## Verify the installation
+
+Run `/agent` to confirm that the new agent appears in the agent list.
+
+::: zone-end
+
+## Related content
+
+- [GitHub Copilot modernization FAQ](faq.yml)
+- [Quickstart: Assess and migrate a .NET project with GitHub Copilot modernization for .NET](quickstart.md)
+- [Application assessment with GitHub Copilot modernization](working-with-assessment.md)