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)
@@ -2,11 +2,12 @@
 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/07/2026
+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 upgrade my .NET applications.
+#customer intent: As a developer, I want to install GitHub Copilot modernization so that I can modernize my .NET applications.
 
 ---
 
@@ -53,20 +54,18 @@ Before you install, make sure you have:
 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 upgrade**.
+1. Search for **GitHub Copilot modernization**.
 1. Select **Install**.
 
-The extension automatically acquires the .NET SDK if it's missing, registers tools, and adds the agent to Copilot Chat as `Upgrade`.
-
 ## Verify the installation
 
 1. Open a project in Visual Studio Code.
 1. Open the **GitHub Copilot Chat** view.
-1. Send `@upgrade` in chat and confirm the agent responds.
+1. Send `@modernize` in chat and confirm the agent responds.
 
    -or-
 
-   Select the **Agent** picker and find the `Upgrade` entry.
+   Select the **Agent** picker and find the `Modernize` entry.
 
 ::: zone-end
 
@@ -88,18 +87,18 @@ Install through the GitHub Copilot CLI:
 1. Add the marketplace plugin:
 
    ```console
-   /plugin marketplace add microsoft/upgrade-agent-plugins
+   /plugin marketplace add microsoft/github-copilot-modernization
    ```
 
 1. Install the plugin:
 
    ```console
-   /plugin install upgrade-agent@upgrade-agent-plugins
+   /plugin install github-copilot-modernization@github-copilot-modernization
    ```
 
 ## Verify the installation
 
-Run `/agent` to confirm that `upgrade-agent` appears in the agent list.
+Run `/plugin list` to confirm that `github-copilot-modernization@github-copilot-modernization` appears in the list.
 
 ::: zone-end
 
@@ -116,24 +115,19 @@ Before you install, make sure you have:
 
 Install through the GitHub Copilot app:
 
-1. Click [https://github.com/copilot/app/launch](https://github.com/copilot/app/launch?entry_point=upgrade_agent_docs&open=ghapp%3A%2F%2Fplugins%2Fmarketplace%2Fadd%3Fsource%3Dmicrosoft%2Fupgrade-agent-plugins) to automatically open the **Settings** > **Plugins** window in 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 **upgrade-agent-plugins** entry and select **Install** on the **upgrade-agent** plugin.
+1. Expand the **github-copilot-modernization** entry and select **Install** on the **github-copilot-modernization** plugin.
 
 ## Verify the installation
 
-Run `/agent` to confirm that `upgrade-agent:upgrade` appears in the agent list.
-
--or-
-
-Select the **Default agent** picker and find the **Upgrade** entry.
+Run `/agent` to confirm that the new agent appears in the agent list.
 
 ::: zone-end
 
 ## Related content
 
-- [What is GitHub Copilot modernization?](overview.md)
-- [Upgrade a .NET app with GitHub Copilot modernization](how-to-upgrade-with-github-copilot.md)
-- [Core concepts](concepts.md)
 - [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)