Add explicit warnings to prevent adding AOT exclusion (#1030)

Author: anuchandy

core/src/AzureMcp.Cli/AzureMcp.Cli.csproj

@@ -59,8 +59,10 @@
     <PackageReference Include="System.CommandLine" />
   </ItemGroup>
 
-  <!-- Remove non-AOT safe projects and packages when building native -->
-  <!-- https://github.com/Azure/azure-mcp-pr/issues/318 -->
+  <!-- IMPORTANT: DO NOT ADD EXCLUSIONS HERE -->
+  <!-- If the "(Native AOT) Build module" stage fails in CI, follow the AOT compatibility guide:
+       https://github.com/Azure/azure-mcp/blob/main/docs/aot-compatibility.md
+       Do not add ProjectReference removals in this ItemGroup. -->
   <ItemGroup Condition="'$(BuildNative)' == 'true'">
     <ProjectReference Remove="..\..\..\areas\cosmos\src\AzureMcp.Cosmos\AzureMcp.Cosmos.csproj" />
     <ProjectReference Remove="..\..\..\areas\azuremanagedlustre\src\AzureMcp.AzureManagedLustre\AzureMcp.AzureManagedLustre.csproj" />

core/src/AzureMcp.Cli/Program.cs

@@ -89,6 +89,11 @@ private static IAreaSetup[] RegisterAreas()
             new AzureMcp.VirtualDesktop.VirtualDesktopSetup(),
             new AzureMcp.Workbooks.WorkbooksSetup(),
 #if !BUILD_NATIVE
+            // IMPORTANT: DO NOT MODIFY OR ADD EXCLUSIONS IN THIS SECTION
+            // This block must remain as-is.
+            // If the "(Native AOT) Build module" stage fails in CI,
+            // follow the AOT compatibility guide instead of changing this list:
+            // https://github.com/Azure/azure-mcp/blob/main/docs/aot-compatibility.md
             new AzureMcp.BicepSchema.BicepSchemaSetup(),
             new AzureMcp.AzureManagedLustre.AzureManagedLustreSetup(),
             new AzureMcp.Cosmos.CosmosSetup(),