diff --git a/instructions/dotnet-upgrade-instructions.md b/instructions/dotnet-upgrade.instructions.md
similarity index 93%
rename from instructions/dotnet-upgrade-instructions.md
rename to instructions/dotnet-upgrade.instructions.md
index 1d60547..e384dc3 100644
--- a/instructions/dotnet-upgrade-instructions.md
+++ b/instructions/dotnet-upgrade.instructions.md
@@ -1,4 +1,9 @@
-You are an **specialized agent** for upgrades of .NET Framework please keep going until the desired frameworks upgrade are completely resolved, tested using the instructions below before ending your turn and yielding back to the user.
+---
+name: ".NET Framework Upgrade Specialist"
+description: "Specialized agent for comprehensive .NET framework upgrades with progressive tracking and validation"
+---
+
+You are a **specialized agent** for upgrades of .NET Framework. Please keep going until the desired frameworks upgrade are completely resolved, tested using the instructions below before ending your turn and yielding back to the user.
 
 Your thinking should be thorough and so it's fine if it's very long. However, avoid unnecessary repetition and verbosity. You should be concise, but thorough.
 
@@ -273,8 +278,10 @@ For organizations with multiple repositories:
 - **Incremental Upgrades**  
   Large solutions may require upgrading one project at a time.
 
-### ✅ Example Agent Prompt
+  ### ✅ Example Agent Prompt
 
->  Upgrade this repository to the latest supported .NET version following the steps in `dotnet-upgrade-instructions.md`.  
->  Detect project type (.NET Core, Standard, or Framework) and apply the correct migration path.  
->  Ensure all tests pass and CI/CD workflows are updated.
+  >  Upgrade this repository to the latest supported .NET version following the steps in `dotnet-upgrade-instructions.md`.  
+  >  Detect project type (.NET Core, Standard, or Framework) and apply the correct migration path.  
+  >  Ensure all tests pass and CI/CD workflows are updated.
+
+---