From 67281fca855603cc14a4742d4e4457fde36a92ae Mon Sep 17 00:00:00 2001 From: "Andy De George (from Dev Box)" Date: Tue, 7 Jul 2026 10:26:15 -0700 Subject: [PATCH 1/9] Update GHCP AppMod docs: scenarios, platforms, and titles - Fix VS component name to 'GitHub Copilot app modernization' - Fix VS Code extension search name to 'GitHub Copilot modernization for .NET' - Add new scenarios: Aspire integration, Aspire version upgrade, WebForms-to-Blazor - Add .NET Framework 4.8.1 as supported upgrade target - Add Azure SDK migration skill and LINQ to SQL to EF Core skill - Remove execution-log.md references (file removed in agent v1.0.1087) - Update ms.date on all modified articles Fixes #54663 Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../best-practices.md | 2 +- .../concepts.md | 3 +- .../customization.md | 2 +- .../github-copilot-app-modernization/faq.yml | 13 ++++---- .../how-to-upgrade-with-github-copilot.md | 2 +- .../install.md | 8 ++--- .../overview.md | 17 ++++++----- .../scenarios-and-skills.md | 30 +++++++++++++++---- .../troubleshooting.md | 6 ++-- .../working-with-agent.md | 5 ++-- 10 files changed, 54 insertions(+), 34 deletions(-) diff --git a/docs/core/porting/github-copilot-app-modernization/best-practices.md b/docs/core/porting/github-copilot-app-modernization/best-practices.md index 4607b10e7d8bb..78325af1d934c 100644 --- a/docs/core/porting/github-copilot-app-modernization/best-practices.md +++ b/docs/core/porting/github-copilot-app-modernization/best-practices.md @@ -2,7 +2,7 @@ title: Best practices for GitHub Copilot modernization description: "Learn best practices for using GitHub Copilot modernization to upgrade .NET projects, including preparation, collaboration tips, common pitfalls, and recovery strategies." ms.topic: best-practice -ms.date: 04/06/2026 +ms.date: 07/07/2026 ai-usage: ai-assisted #customer intent: As a developer, I want to follow best practices when using GitHub Copilot modernization so that I can get the best results from my .NET upgrades and avoid common problems. diff --git a/docs/core/porting/github-copilot-app-modernization/concepts.md b/docs/core/porting/github-copilot-app-modernization/concepts.md index db536c222c65f..25e0466d52534 100644 --- a/docs/core/porting/github-copilot-app-modernization/concepts.md +++ b/docs/core/porting/github-copilot-app-modernization/concepts.md @@ -2,7 +2,7 @@ title: GitHub Copilot modernization core concepts description: "Learn the key concepts behind GitHub Copilot modernization, including scenarios, skills, tasks, the three-stage workflow, state management, and flow modes." ms.topic: concept-article -ms.date: 04/06/2026 +ms.date: 07/07/2026 ai-usage: ai-assisted #customer intent: As a developer, I want to understand the core concepts of GitHub Copilot modernization so that I can use the agent effectively and get the best results from my upgrades. @@ -158,7 +158,6 @@ The agent maintains persistent state so you can stop and resume at any time. Eve | `upgrade-options.md` | Confirmed upgrade decisions | | `plan.md` | The upgrade plan with strategy and task descriptions | | `tasks.md` | Visual progress dashboard showing task status | -| `execution-log.md` | Detailed log of all changes and decisions | | `tasks/{taskId}/task.md` | Per-task scope and context | | `tasks/{taskId}/progress-details.md` | Per-task execution notes and results | diff --git a/docs/core/porting/github-copilot-app-modernization/customization.md b/docs/core/porting/github-copilot-app-modernization/customization.md index 7a679fb353b4e..e126092689312 100644 --- a/docs/core/porting/github-copilot-app-modernization/customization.md +++ b/docs/core/porting/github-copilot-app-modernization/customization.md @@ -2,7 +2,7 @@ title: Customize GitHub Copilot modernization description: "Learn how to customize GitHub Copilot modernization with custom skills, custom scenarios, scenario artifact edits, and chat instructions to encode your team's upgrade patterns." ms.topic: concept-article -ms.date: 04/06/2026 +ms.date: 07/07/2026 ai-usage: ai-assisted #customer intent: As a developer, I want to customize GitHub Copilot modernization so that I can encode my team's upgrade patterns, enforce coding standards during upgrades, and define custom upgrade workflows. diff --git a/docs/core/porting/github-copilot-app-modernization/faq.yml b/docs/core/porting/github-copilot-app-modernization/faq.yml index fd1d58d4c79f7..3471296e35120 100644 --- a/docs/core/porting/github-copilot-app-modernization/faq.yml +++ b/docs/core/porting/github-copilot-app-modernization/faq.yml @@ -4,7 +4,7 @@ metadata: description: "This article answers frequently asked questions about GitHub Copilot modernization for .NET." titleSuffix: "" ms.topic: faq - ms.date: 04/06/2026 + ms.date: 07/07/2026 title: GitHub Copilot modernization FAQ summary: | @@ -102,11 +102,12 @@ sections: answer: | The agent supports the following upgrade paths: - | Source | Target | - |------------------------------|-----------------| - | .NET Framework (any version) | .NET 8 or later | - | .NET Core 1.x–3.x | .NET 8 or later | - | .NET 5 or later | .NET 8 or later | + | Source | Target | + |------------------------------|---------------------------| + | .NET Framework (any version) | .NET 8 or later | + | .NET Framework (any version) | .NET Framework 4.8.1 | + | .NET Core 1.x–3.x | .NET 8 or later | + | .NET 5 or later | .NET 8 or later | - question: Can I use the agent offline? answer: | diff --git a/docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md b/docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md index 45ee2ed5011c9..444c1cb80f74c 100644 --- a/docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md +++ b/docs/core/porting/github-copilot-app-modernization/how-to-upgrade-with-github-copilot.md @@ -2,7 +2,7 @@ title: How to upgrade a .NET app with GitHub Copilot modernization description: "Learn how to upgrade your .NET applications to newer versions using GitHub Copilot modernization. This step-by-step guide covers assessment and the three-stage workflow: assessment, planning, and execution." ms.topic: how-to -ms.date: 04/06/2026 +ms.date: 07/07/2026 ai-usage: ai-assisted #customer intent: As a developer, I want to upgrade my .NET app using GitHub Copilot modernization so that I can modernize my codebase efficiently with AI assistance through a structured three-stage process. diff --git a/docs/core/porting/github-copilot-app-modernization/install.md b/docs/core/porting/github-copilot-app-modernization/install.md index c950cdc87bd2c..a1a72ca30ed7f 100644 --- a/docs/core/porting/github-copilot-app-modernization/install.md +++ b/docs/core/porting/github-copilot-app-modernization/install.md @@ -2,7 +2,7 @@ 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: 04/06/2026 +ms.date: 07/07/2026 ai-usage: ai-assisted zone_pivot_groups: copilot-modernization-install @@ -22,14 +22,14 @@ 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 modernization**. +- [.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, so you don't need to install it separately. Enable the **GitHub Copilot** and **GitHub Copilot modernization** optional components in the **.NET desktop development** workload through the Visual Studio Installer. +Visual Studio includes GitHub Copilot modernization, 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 @@ -51,7 +51,7 @@ Before you install, make sure you have: ## Install 1. In Visual Studio Code, open the **Extensions** view (Ctrl+Shift+X). -1. Search for **GitHub Copilot modernization**. +1. Search for **GitHub Copilot modernization for .NET**. 1. Select **Install**. The extension automatically acquires the .NET SDK if it's missing, registers tools, and adds the agent to Copilot Chat as `modernize-dotnet`. diff --git a/docs/core/porting/github-copilot-app-modernization/overview.md b/docs/core/porting/github-copilot-app-modernization/overview.md index 91c758cf5f272..02e2af6e0fbb8 100644 --- a/docs/core/porting/github-copilot-app-modernization/overview.md +++ b/docs/core/porting/github-copilot-app-modernization/overview.md @@ -3,7 +3,7 @@ title: GitHub Copilot modernization overview description: "Learn about GitHub Copilot modernization, a Copilot agent available across Visual Studio, Visual Studio Code, GitHub Copilot CLI, and GitHub.com that upgrades .NET projects and migrates apps to Azure." titleSuffix: "" ms.topic: overview -ms.date: 04/06/2026 +ms.date: 07/07/2026 ai-usage: ai-assisted #customer intent: As a developer, I want to learn about what GitHub Copilot modernization is, so that I understand its capabilities and how I can take advantage of it. @@ -36,6 +36,9 @@ The agent provides multiple end-to-end modernization workflows called _scenarios | **SqlClient upgrade** | Upgrades from System.Data.SqlClient to Microsoft.Data.SqlClient. | _"Update SqlClient"_ | | **Azure Functions upgrade** | Upgrades Azure Functions from in-process to isolated worker model. | _"Upgrade my Azure Functions"_ | | **Semantic Kernel to Agents** | Upgrades Semantic Kernel Agents to Microsoft Agent Framework. | _"Upgrade my SK agents"_ | +| **Aspire integration** | Adds .NET Aspire support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | +| **Aspire version upgrade** | Upgrades existing Aspire applications to newer versions. | _"Upgrade my Aspire version"_ | +| **WebForms-to-Blazor upgrade** | Upgrades ASP.NET Web Forms applications to Blazor. | _"Migrate my Web Forms app to Blazor"_ | For a full reference of all scenarios and 30+ built-in upgrade skills, see [Scenarios and skills reference](scenarios-and-skills.md). @@ -73,11 +76,12 @@ To start an upgrade, see [Upgrade a .NET app with GitHub Copilot modernization]( The agent supports the following upgrade paths: -| Source | Target | -|------------------------------|-----------------| -| .NET Framework (any version) | .NET 8 or later | -| .NET Core 1.x–3.x | .NET 8 or later | -| .NET 5 or later | .NET 8 or later | +| Source | Target | +|------------------------------|---------------------------| +| .NET Framework (any version) | .NET 8 or later | +| .NET Framework (any version) | .NET Framework 4.8.1 | +| .NET Core 1.x–3.x | .NET 8 or later | +| .NET 5 or later | .NET 8 or later | ## Migrate .NET projects to Azure @@ -193,7 +197,6 @@ The agent stores all upgrade state in `.github/upgrades/{scenarioId}/`. The fold | `plan.md` | Ordered task plan | | `tasks.md` | Live progress dashboard | | `scenario-instructions.md` | Agent's persistent memory, including preferences, decisions, and custom instructions | -| `execution-log.md` | Detailed audit trail of all changes | | `tasks/{taskId}/task.md` | Per-task scope and context | | `tasks/{taskId}/progress-details.md` | Per-task execution notes and results | diff --git a/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md b/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md index 2c9ffa8556ec0..89d3d4e379e22 100644 --- a/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md +++ b/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md @@ -2,7 +2,7 @@ title: GitHub Copilot modernization scenarios and skills description: "Complete reference of all scenarios and built-in upgrade skills available in GitHub Copilot modernization for .NET, organized by domain." ms.topic: reference -ms.date: 04/06/2026 +ms.date: 07/07/2026 ai-usage: ai-assisted #customer intent: As a developer, I want to see all the scenarios and skills that GitHub Copilot modernization supports so that I can understand which upgrade tasks the agent can handle for me. @@ -33,6 +33,9 @@ Scenarios are the agent's top-level upgrade workflows. When you start a conversa | [**SqlClient upgrade**](#sqlclient-upgrade) | Upgrades System.Data.SqlClient to Microsoft.Data.SqlClient. | _"Update SqlClient to the modern package"_ | | [**Azure Functions upgrade**](#azure-functions-upgrade) | Upgrades Azure Functions from in-process to isolated worker model. | _"Upgrade my Azure Functions"_ | | [**Semantic Kernel to Agents**](#semantic-kernel-to-microsoft-agent-framework) | Upgrades from SK Agents to Microsoft Agent Framework. | _"Upgrade my SK agents"_ | +| [**Aspire integration**](#aspire-integration) | Adds .NET Aspire support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | +| [**Aspire version upgrade**](#aspire-version-upgrade) | Upgrades existing Aspire applications to newer versions. | _"Upgrade my Aspire version"_ | +| [**WebForms-to-Blazor upgrade**](#webforms-to-blazor-upgrade) | Upgrades ASP.NET Web Forms applications to Blazor. | _"Migrate my Web Forms app to Blazor"_ | For an end-to-end walkthrough, see [Core concepts](concepts.md). @@ -40,11 +43,12 @@ For an end-to-end walkthrough, see [Core concepts](concepts.md). The most common scenario. Upgrades your projects from any older .NET variant to the latest: -| Source | Target | -|------------------------------|-----------------| -| .NET Framework (any version) | .NET 8 or later | -| .NET Core 1.x–3.x | .NET 8 or later | -| .NET 5 or later | .NET 8 or later | +| Source | Target | +|------------------------------|---------------------------| +| .NET Framework (any version) | .NET 8 or later | +| .NET Framework (any version) | .NET Framework 4.8.1 | +| .NET Core 1.x–3.x | .NET 8 or later | +| .NET 5 or later | .NET 8 or later | The agent analyzes your dependency graph, checks NuGet compatibility, identifies breaking changes, and creates a task plan using the best strategy for your solution (bottom-up, top-down, or all-at-once). If your projects need format conversions, the agent handles them automatically as part of the upgrade. @@ -68,6 +72,18 @@ Upgrades Azure Functions from the in-process hosting model to the isolated worke Upgrades from Semantic Kernel Agents (`ChatCompletionAgent`, `OpenAIAssistantAgent`) to [Microsoft Agent Framework](/agent-framework/overview/). Updates packages and API patterns. +### Aspire integration + +Adds .NET Aspire support to existing applications for inner-loop development and Azure deployment. Configures the Aspire orchestration layer and integrates with the Aspire CLI agent. + +### Aspire version upgrade + +Upgrades existing .NET Aspire applications to newer versions of Aspire. Handles package updates, configuration changes, and breaking API changes between Aspire versions. + +### WebForms-to-Blazor upgrade + +Upgrades ASP.NET Web Forms applications to Blazor using native Blazor and HTML5 patterns. Converts Web Forms pages, controls, and code-behind to Blazor components. + ## Upgrade skills: common General-purpose upgrade skills that apply across project types. @@ -94,6 +110,7 @@ Skills for upgrading data access layers, including Entity Framework, LINQ to SQL | **Upgrading EDMX to Code-First** | Converts EF6 Database-First (`.edmx`) models to EF Core Code-First. Scaffolds entities from the database. | | **Upgrading EF DbContext** | Registers `DbContext` in ASP.NET Core dependency injection. Handles both EF6 to EF Core and existing EF Core patterns. | | **Upgrading EF6 Code-First to EF Core** | Upgrades EF6 Code-First to EF Core. Swaps packages, updates namespaces, and replaces `EntityTypeConfiguration` and `DbModelBuilder`. | +| **Upgrading LINQ to SQL to EF Core** | Migrates LINQ to SQL (`System.Data.Linq`) data access to Entity Framework Core. | | **Upgrading to Microsoft.Data.SqlClient** | Upgrades from `System.Data.SqlClient`. Handles the `Encrypt=true` default change and connection string differences. | ## Upgrade skills: web and ASP.NET @@ -147,6 +164,7 @@ Skills for upgrading ASP.NET Framework applications to ASP.NET Core. | **Upgrading Azure Functions Startup** | Upgrades Azure Functions from the in-process `Startup` class to isolated worker model with `Program.cs`. | | **Upgrading Azure Functions to v2** | Upgrades Azure Functions to the v2 hosting pattern using `IHostApplicationBuilder`. | | **Upgrading Azure Key Vault** | Upgrades legacy Azure Key Vault SDK to the modern `Azure.Security.KeyVault` libraries. | +| **Upgrading Azure SDK** | Upgrades legacy Azure SDK dependencies to the latest `Azure.*` libraries. | | **Upgrading Azure Service Bus** | Upgrades legacy Azure Service Bus SDK to the modern `Azure.Messaging.ServiceBus` library. | | **Upgrading Azure Storage** | Upgrades legacy Azure Storage SDK to the modern `Azure.Storage` libraries. | diff --git a/docs/core/porting/github-copilot-app-modernization/troubleshooting.md b/docs/core/porting/github-copilot-app-modernization/troubleshooting.md index 109f3c49b7074..bf283b154e662 100644 --- a/docs/core/porting/github-copilot-app-modernization/troubleshooting.md +++ b/docs/core/porting/github-copilot-app-modernization/troubleshooting.md @@ -2,7 +2,7 @@ title: Troubleshoot GitHub Copilot modernization description: "Find solutions to common problems when you use GitHub Copilot modernization for .NET, including workflow, build, Git, performance, and customization issues." ms.topic: troubleshooting-general -ms.date: 04/06/2026 +ms.date: 07/07/2026 ai-usage: ai-assisted #customer intent: As a developer, I want to troubleshoot issues with GitHub Copilot modernization so that I can resolve problems and continue my .NET upgrade. @@ -76,7 +76,7 @@ These issues relate to build failures, NuGet restore problems, and code generati 1. Tell the agent about the failure. The agent analyzes errors automatically. 1. If the agent can't resolve the issue, revert the last commit (`git revert HEAD`) and ask the agent to try a different approach. -1. For complex failures, check `execution-log.md` to understand what the agent changed and in what order. +1. For complex failures, check `tasks/{taskId}/progress-details.md` to understand what the agent changed and in what order. ### NuGet restore fails @@ -185,7 +185,7 @@ These issues relate to custom skills and scenario instruction files. When something isn't working as expected: 1. **Ask the agent:** Ask _"What went wrong with the last task?"_ The agent can often explain what happened and suggest next steps. -1. **Review the execution log:** Open `execution-log.md` in `.github/upgrades/{scenarioId}/`. The log shows a chronological record of what the agent did, including any errors it encountered. +1. **Review the task progress:** Open `tasks/{taskId}/progress-details.md` in `.github/upgrades/{scenarioId}/`. The progress details show what the agent did, including any errors it encountered. 1. **File an issue:** If you've found a bug or the agent consistently fails at something, file an issue at the [@modernize-dotnet GitHub repository](https://github.com/dotnet/modernize-dotnet). ## Related content diff --git a/docs/core/porting/github-copilot-app-modernization/working-with-agent.md b/docs/core/porting/github-copilot-app-modernization/working-with-agent.md index a5491edc99c78..b8052fef3a733 100644 --- a/docs/core/porting/github-copilot-app-modernization/working-with-agent.md +++ b/docs/core/porting/github-copilot-app-modernization/working-with-agent.md @@ -2,7 +2,7 @@ title: Work with GitHub Copilot modernization description: "Learn how to collaborate effectively with GitHub Copilot modernization, including communication patterns, teaching preferences, mid-session corrections, and multi-session workflows." ms.topic: concept-article -ms.date: 04/06/2026 +ms.date: 07/07/2026 ai-usage: ai-assisted #customer intent: As a developer, I want to learn how to work effectively with the GitHub Copilot modernization agent so that I can get the best results from my .NET upgrade. @@ -196,7 +196,6 @@ The agent maintains several files in `.github/upgrades/{scenarioId}/` that give | File | What it shows | |---|---| | `tasks.md` | Visual progress overview with all tasks, status indicators (✅ done, 🔄 in progress, ⬜ pending), and a progress bar | -| `execution-log.md` | Complete chronological audit trail of every action the agent took, when, and what happened | | `assessment.md` | The initial analysis of your solution, including dependencies, breaking changes, and upgrade complexity | | `scenario-instructions.md` | Your preferences and the agent's learned decisions | | `tasks/{taskId}/progress-details.md` | Per-task details: build errors encountered, how they were resolved, test results, and decisions made | @@ -230,7 +229,7 @@ Large upgrades, such as a 20-project solution, a complex framework upgrade, or a ### Tips for multi-session work - **Commit the state folder.** Push `.github/upgrades/` to your branch to back up the folder and make it visible to your team. -- **Review between sessions.** Read `tasks.md` and `execution-log.md` to refresh your memory on what happened in the last session. +- **Review between sessions.** Read `tasks.md` to refresh your memory on what happened in the last session. - **Update preferences as you learn.** If you discover something in testing that should change the agent's approach, tell the agent at the start of the next session. ## Ask for help From 9586563a9dce54d2740ad4cc49b33a96fb8d3d64 Mon Sep 17 00:00:00 2001 From: "Andy De George (from Dev Box)" Date: Tue, 7 Jul 2026 12:31:10 -0700 Subject: [PATCH 2/9] Extract upgrade paths table into include file Move the repeated supported upgrade paths table into includes/supported-upgrade-paths.md and reference it from overview.md, scenarios-and-skills.md, and faq.yml. Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- .../github-copilot-app-modernization/faq.yml | 7 +------ .../includes/supported-upgrade-paths.md | 13 +++++++++++++ .../github-copilot-app-modernization/overview.md | 7 +------ .../scenarios-and-skills.md | 7 +------ 4 files changed, 16 insertions(+), 18 deletions(-) create mode 100644 docs/core/porting/github-copilot-app-modernization/includes/supported-upgrade-paths.md diff --git a/docs/core/porting/github-copilot-app-modernization/faq.yml b/docs/core/porting/github-copilot-app-modernization/faq.yml index 3471296e35120..9e1fe02c9ece5 100644 --- a/docs/core/porting/github-copilot-app-modernization/faq.yml +++ b/docs/core/porting/github-copilot-app-modernization/faq.yml @@ -102,12 +102,7 @@ sections: answer: | The agent supports the following upgrade paths: - | Source | Target | - |------------------------------|---------------------------| - | .NET Framework (any version) | .NET 8 or later | - | .NET Framework (any version) | .NET Framework 4.8.1 | - | .NET Core 1.x–3.x | .NET 8 or later | - | .NET 5 or later | .NET 8 or later | + [!INCLUDE[supported-upgrade-paths](./includes/supported-upgrade-paths.md)] - question: Can I use the agent offline? answer: | diff --git a/docs/core/porting/github-copilot-app-modernization/includes/supported-upgrade-paths.md b/docs/core/porting/github-copilot-app-modernization/includes/supported-upgrade-paths.md new file mode 100644 index 0000000000000..d47407d58ab80 --- /dev/null +++ b/docs/core/porting/github-copilot-app-modernization/includes/supported-upgrade-paths.md @@ -0,0 +1,13 @@ +--- +author: adegeo +ms.author: adegeo +ms.date: 07/07/2026 +ms.topic: include +--- + +| Source | Target | +|------------------------------|---------------------------| +| .NET Framework (any version) | .NET 8 or later | +| .NET Framework (any version) | .NET Framework 4.8.1 | +| .NET Core 1.x–3.x | .NET 8 or later | +| .NET 5 or later | .NET 8 or later | diff --git a/docs/core/porting/github-copilot-app-modernization/overview.md b/docs/core/porting/github-copilot-app-modernization/overview.md index 02e2af6e0fbb8..ed712bd030612 100644 --- a/docs/core/porting/github-copilot-app-modernization/overview.md +++ b/docs/core/porting/github-copilot-app-modernization/overview.md @@ -76,12 +76,7 @@ To start an upgrade, see [Upgrade a .NET app with GitHub Copilot modernization]( The agent supports the following upgrade paths: -| Source | Target | -|------------------------------|---------------------------| -| .NET Framework (any version) | .NET 8 or later | -| .NET Framework (any version) | .NET Framework 4.8.1 | -| .NET Core 1.x–3.x | .NET 8 or later | -| .NET 5 or later | .NET 8 or later | +[!INCLUDE[supported-upgrade-paths](./includes/supported-upgrade-paths.md)] ## Migrate .NET projects to Azure diff --git a/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md b/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md index 89d3d4e379e22..b6f87e98ce960 100644 --- a/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md +++ b/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md @@ -43,12 +43,7 @@ For an end-to-end walkthrough, see [Core concepts](concepts.md). The most common scenario. Upgrades your projects from any older .NET variant to the latest: -| Source | Target | -|------------------------------|---------------------------| -| .NET Framework (any version) | .NET 8 or later | -| .NET Framework (any version) | .NET Framework 4.8.1 | -| .NET Core 1.x–3.x | .NET 8 or later | -| .NET 5 or later | .NET 8 or later | +[!INCLUDE[supported-upgrade-paths](./includes/supported-upgrade-paths.md)] The agent analyzes your dependency graph, checks NuGet compatibility, identifies breaking changes, and creates a task plan using the best strategy for your solution (bottom-up, top-down, or all-at-once). If your projects need format conversions, the agent handles them automatically as part of the upgrade. From 7b60cc6048ace1a73d711a0bd60f90187de5530b Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 7 Jul 2026 12:32:42 -0700 Subject: [PATCH 3/9] Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- .../github-copilot-app-modernization/troubleshooting.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/core/porting/github-copilot-app-modernization/troubleshooting.md b/docs/core/porting/github-copilot-app-modernization/troubleshooting.md index bf283b154e662..b6cc517146375 100644 --- a/docs/core/porting/github-copilot-app-modernization/troubleshooting.md +++ b/docs/core/porting/github-copilot-app-modernization/troubleshooting.md @@ -76,7 +76,7 @@ These issues relate to build failures, NuGet restore problems, and code generati 1. Tell the agent about the failure. The agent analyzes errors automatically. 1. If the agent can't resolve the issue, revert the last commit (`git revert HEAD`) and ask the agent to try a different approach. -1. For complex failures, check `tasks/{taskId}/progress-details.md` to understand what the agent changed and in what order. +1. For complex failures, check `tasks.md` to find the failing task ID, and then review `tasks/{taskId}/progress-details.md` to understand what the agent changed and in what order. ### NuGet restore fails @@ -185,7 +185,7 @@ These issues relate to custom skills and scenario instruction files. When something isn't working as expected: 1. **Ask the agent:** Ask _"What went wrong with the last task?"_ The agent can often explain what happened and suggest next steps. -1. **Review the task progress:** Open `tasks/{taskId}/progress-details.md` in `.github/upgrades/{scenarioId}/`. The progress details show what the agent did, including any errors it encountered. +1. **Review the task progress:** Open `tasks.md` in `.github/upgrades/{scenarioId}/` to find the last task ID, and then open `tasks/{taskId}/progress-details.md`. The progress details show what the agent did, including any errors it encountered. 1. **File an issue:** If you've found a bug or the agent consistently fails at something, file an issue at the [@modernize-dotnet GitHub repository](https://github.com/dotnet/modernize-dotnet). ## Related content From 1ed59cf27bd423cae14839f1af669b74311aa078 Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Tue, 7 Jul 2026 12:47:54 -0700 Subject: [PATCH 4/9] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/core/porting/github-copilot-app-modernization/install.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/porting/github-copilot-app-modernization/install.md b/docs/core/porting/github-copilot-app-modernization/install.md index a1a72ca30ed7f..caa9515cceaa2 100644 --- a/docs/core/porting/github-copilot-app-modernization/install.md +++ b/docs/core/porting/github-copilot-app-modernization/install.md @@ -29,7 +29,7 @@ Before you install, make sure you have: ## Install -Visual Studio includes GitHub Copilot modernization, 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. +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 From 373e20c02c0cc9303a54531204a38dc4494c3c6c Mon Sep 17 00:00:00 2001 From: "Andy De George (from Dev Box)" Date: Tue, 7 Jul 2026 14:58:20 -0700 Subject: [PATCH 5/9] Change pivot --- .../install.md | 39 ++++++++++++------- .../overview.md | 2 +- docs/zone-pivot-groups.yml | 4 +- 3 files changed, 28 insertions(+), 17 deletions(-) diff --git a/docs/core/porting/github-copilot-app-modernization/install.md b/docs/core/porting/github-copilot-app-modernization/install.md index caa9515cceaa2..078a0ae6e48e7 100644 --- a/docs/core/porting/github-copilot-app-modernization/install.md +++ b/docs/core/porting/github-copilot-app-modernization/install.md @@ -51,15 +51,20 @@ Before you install, make sure you have: ## Install 1. In Visual Studio Code, open the **Extensions** view (Ctrl+Shift+X). -1. Search for **GitHub Copilot modernization for .NET**. +1. Search for **GitHub Copilot upgrade**. 1. Select **Install**. -The extension automatically acquires the .NET SDK if it's missing, registers tools, and adds the agent to Copilot Chat as `modernize-dotnet`. +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 **GitHub Copilot Chat** and type `@modernize-dotnet`. +1. Open the **GitHub Copilot Chat** window. +1. Send `@upgrade` in chat and see if it responds. + + \-or- + + Select the `Agent` dropdown and find the `Upgrade` entry. ::: zone-end @@ -69,7 +74,7 @@ The extension automatically acquires the .NET SDK if it's missing, registers too Before you install, make sure you have: -- GitHub Copilot CLI installed. +- [GitHub Copilot CLI](gh.io/cli) installed. - GitHub Copilot subscription (paid or free). ## Install @@ -81,40 +86,46 @@ To install: 1. Add the marketplace plugin: ```console - /plugin marketplace add dotnet/modernize-dotnet + /plugin marketplace add microsoft/upgrade-agent-plugins ``` 1. Install the plugin: ```console - /plugin install modernize-dotnet@modernize-dotnet-plugins + /plugin install upgrade-agent@upgrade-agent-plugins ``` ## Verify the installation -Run `/agent` to confirm that `modernize-dotnet` appears in the agent list. +Run `/agent` to confirm that `upgrade-agent` appears in the agent list. ::: zone-end -::: zone pivot="github-com" +::: zone pivot="github-copilot-app" ## Prerequisites Before you install, make sure you have: -- GitHub Copilot Enterprise or Business subscription with coding agents enabled. -- Repository admin access. +- [GitHub Copilot app](gh.io/app) installed. +- GitHub Copilot subscription (paid or free). ## Install -Add the custom coding agent to your repository: +To install: -1. Review [adding custom coding agents to your repository](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents). -1. Add the `modernize-dotnet` agent. See the [coding agent README](https://github.com/dotnet/modernize-dotnet/blob/main/coding-agent/README.md) for details. +1. Click on [this link](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. 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. ## Verify the installation -Confirm that the `modernize-dotnet` agent appears as an available coding agent in your repository. +Run `/agent` to confirm that `upgrade-agent:upgrade` appears in the agent list. + +-or- + +Select the **Default agent** dropdown and find the **Upgrade** entry. ::: zone-end diff --git a/docs/core/porting/github-copilot-app-modernization/overview.md b/docs/core/porting/github-copilot-app-modernization/overview.md index ed712bd030612..7128217151cb0 100644 --- a/docs/core/porting/github-copilot-app-modernization/overview.md +++ b/docs/core/porting/github-copilot-app-modernization/overview.md @@ -48,7 +48,7 @@ Microsoft values your feedback and uses it to improve the agent. Leave feedback - In Visual Studio, use the [Suggest a feature](/visualstudio/ide/suggest-a-feature) and [Report a problem](/visualstudio/ide/report-a-problem) options. -- File an issue at the [@modernize-dotnet GitHub repository](https://github.com/dotnet/modernize-dotnet). +- File an issue at the [Upgrade Agent GitHub repository](https://github.com/microsoft/upgrade-agent-plugins). ## Prerequisites diff --git a/docs/zone-pivot-groups.yml b/docs/zone-pivot-groups.yml index 1020b5f41f480..1225143c188f2 100644 --- a/docs/zone-pivot-groups.yml +++ b/docs/zone-pivot-groups.yml @@ -56,8 +56,8 @@ groups: title: Visual Studio Code - id: copilot-cli title: GitHub Copilot CLI - - id: github-com - title: GitHub.com + - id: github-copilot-app + title: GitHub Copilot app - id: copilot-modernization-migrate title: Development environment prompt: Choose your development environment From ccf1c36546373e1d4a0213ea725e0a31393a8b94 Mon Sep 17 00:00:00 2001 From: "Andy De George (from Dev Box)" Date: Tue, 7 Jul 2026 15:01:32 -0700 Subject: [PATCH 6/9] Fix link --- docs/core/porting/github-copilot-app-modernization/install.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/core/porting/github-copilot-app-modernization/install.md b/docs/core/porting/github-copilot-app-modernization/install.md index 078a0ae6e48e7..db18f1c8cfb86 100644 --- a/docs/core/porting/github-copilot-app-modernization/install.md +++ b/docs/core/porting/github-copilot-app-modernization/install.md @@ -74,7 +74,7 @@ The extension automatically acquires the .NET SDK if it's missing, registers too Before you install, make sure you have: -- [GitHub Copilot CLI](gh.io/cli) installed. +- [GitHub Copilot CLI](https://gh.io/cli) installed. - GitHub Copilot subscription (paid or free). ## Install @@ -107,7 +107,7 @@ Run `/agent` to confirm that `upgrade-agent` appears in the agent list. Before you install, make sure you have: -- [GitHub Copilot app](gh.io/app) installed. +- [GitHub Copilot app](https://gh.io/app) installed. - GitHub Copilot subscription (paid or free). ## Install From 46a432d498fb6034704b5231f02e85cc6567cc24 Mon Sep 17 00:00:00 2001 From: "Andy De George (from Dev Box)" Date: Tue, 7 Jul 2026 16:15:04 -0700 Subject: [PATCH 7/9] Update install instructions --- .../porting/github-copilot-app-modernization/install.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/core/porting/github-copilot-app-modernization/install.md b/docs/core/porting/github-copilot-app-modernization/install.md index db18f1c8cfb86..ea1e3ead2e7bb 100644 --- a/docs/core/porting/github-copilot-app-modernization/install.md +++ b/docs/core/porting/github-copilot-app-modernization/install.md @@ -50,6 +50,8 @@ Before you install, make sure you have: ## Install +Install through the Visual Studio Code: + 1. In Visual Studio Code, open the **Extensions** view (Ctrl+Shift+X). 1. Search for **GitHub Copilot upgrade**. 1. Select **Install**. @@ -79,7 +81,7 @@ Before you install, make sure you have: ## Install -To install: +Install through the GitHub Copilot CLI: 1. Open the GitHub Copilot chat window. @@ -112,7 +114,7 @@ Before you install, make sure you have: ## Install -To install: +Install through the GitHub Copilot app: 1. Click on [this link](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. In the **Add plugin marketplace?** dialog, select **Allow**. From a7e384385747fc914ce6c29e5e27b2f1f1bc45c7 Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Wed, 8 Jul 2026 08:23:52 -0700 Subject: [PATCH 8/9] Apply suggestions from code review Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --- .../porting/github-copilot-app-modernization/install.md | 4 ++-- .../porting/github-copilot-app-modernization/overview.md | 2 +- .../scenarios-and-skills.md | 6 +++--- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/core/porting/github-copilot-app-modernization/install.md b/docs/core/porting/github-copilot-app-modernization/install.md index ea1e3ead2e7bb..b0c264cbfaf72 100644 --- a/docs/core/porting/github-copilot-app-modernization/install.md +++ b/docs/core/porting/github-copilot-app-modernization/install.md @@ -50,7 +50,7 @@ Before you install, make sure you have: ## Install -Install through the Visual Studio Code: +Install as a Visual Studio Code extension: 1. In Visual Studio Code, open the **Extensions** view (Ctrl+Shift+X). 1. Search for **GitHub Copilot upgrade**. @@ -116,7 +116,7 @@ Before you install, make sure you have: Install through the GitHub Copilot app: -1. Click on [this link](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=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. 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. diff --git a/docs/core/porting/github-copilot-app-modernization/overview.md b/docs/core/porting/github-copilot-app-modernization/overview.md index 7128217151cb0..14297194b8c58 100644 --- a/docs/core/porting/github-copilot-app-modernization/overview.md +++ b/docs/core/porting/github-copilot-app-modernization/overview.md @@ -36,7 +36,7 @@ The agent provides multiple end-to-end modernization workflows called _scenarios | **SqlClient upgrade** | Upgrades from System.Data.SqlClient to Microsoft.Data.SqlClient. | _"Update SqlClient"_ | | **Azure Functions upgrade** | Upgrades Azure Functions from in-process to isolated worker model. | _"Upgrade my Azure Functions"_ | | **Semantic Kernel to Agents** | Upgrades Semantic Kernel Agents to Microsoft Agent Framework. | _"Upgrade my SK agents"_ | -| **Aspire integration** | Adds .NET Aspire support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | +| **Aspire integration** | Adds [Aspire](https://aspire.dev) support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | | **Aspire version upgrade** | Upgrades existing Aspire applications to newer versions. | _"Upgrade my Aspire version"_ | | **WebForms-to-Blazor upgrade** | Upgrades ASP.NET Web Forms applications to Blazor. | _"Migrate my Web Forms app to Blazor"_ | diff --git a/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md b/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md index b6f87e98ce960..131537a9215e6 100644 --- a/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md +++ b/docs/core/porting/github-copilot-app-modernization/scenarios-and-skills.md @@ -33,7 +33,7 @@ Scenarios are the agent's top-level upgrade workflows. When you start a conversa | [**SqlClient upgrade**](#sqlclient-upgrade) | Upgrades System.Data.SqlClient to Microsoft.Data.SqlClient. | _"Update SqlClient to the modern package"_ | | [**Azure Functions upgrade**](#azure-functions-upgrade) | Upgrades Azure Functions from in-process to isolated worker model. | _"Upgrade my Azure Functions"_ | | [**Semantic Kernel to Agents**](#semantic-kernel-to-microsoft-agent-framework) | Upgrades from SK Agents to Microsoft Agent Framework. | _"Upgrade my SK agents"_ | -| [**Aspire integration**](#aspire-integration) | Adds .NET Aspire support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | +| [**Aspire integration**](#aspire-integration) | Adds [Aspire](https://aspire.dev) support for inner-loop and Azure deployment. | _"Add Aspire to my app"_ | | [**Aspire version upgrade**](#aspire-version-upgrade) | Upgrades existing Aspire applications to newer versions. | _"Upgrade my Aspire version"_ | | [**WebForms-to-Blazor upgrade**](#webforms-to-blazor-upgrade) | Upgrades ASP.NET Web Forms applications to Blazor. | _"Migrate my Web Forms app to Blazor"_ | @@ -69,11 +69,11 @@ Upgrades from Semantic Kernel Agents (`ChatCompletionAgent`, `OpenAIAssistantAge ### Aspire integration -Adds .NET Aspire support to existing applications for inner-loop development and Azure deployment. Configures the Aspire orchestration layer and integrates with the Aspire CLI agent. +Adds [Aspire](https://aspire.dev) support to existing applications for inner-loop development and Azure deployment. Configures the Aspire orchestration layer and integrates with the Aspire CLI agent. ### Aspire version upgrade -Upgrades existing .NET Aspire applications to newer versions of Aspire. Handles package updates, configuration changes, and breaking API changes between Aspire versions. +Upgrades existing Aspire applications to newer versions of Aspire. Handles package updates, configuration changes, and breaking API changes between Aspire versions. ### WebForms-to-Blazor upgrade From e6a1927651103fabe0dc4eb26a78004184f7aa3c Mon Sep 17 00:00:00 2001 From: "Andy (Steve) De George" <67293991+adegeo@users.noreply.github.com> Date: Wed, 8 Jul 2026 08:27:30 -0700 Subject: [PATCH 9/9] Apply suggestions from code review Co-authored-by: Wade Pickett --- docs/core/porting/github-copilot-app-modernization/install.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/core/porting/github-copilot-app-modernization/install.md b/docs/core/porting/github-copilot-app-modernization/install.md index b0c264cbfaf72..38684cf6fc96b 100644 --- a/docs/core/porting/github-copilot-app-modernization/install.md +++ b/docs/core/porting/github-copilot-app-modernization/install.md @@ -62,9 +62,9 @@ The extension automatically acquires the .NET SDK if it's missing, registers too 1. Open a project in Visual Studio Code. 1. Open the **GitHub Copilot Chat** window. -1. Send `@upgrade` in chat and see if it responds. +1. Send `@upgrade` in chat and confirm the agent responds. - \-or- + -or- Select the `Agent` dropdown and find the `Upgrade` entry.