diff --git a/README.md b/README.md
index 848bea17..f53d631d 100644
--- a/README.md
+++ b/README.md
@@ -45,7 +45,7 @@ Before using the Agent365 CLI, you must create a custom Entra ID app registratio
⚠️ **Important**: Use **Delegated** permissions (you sign in, CLI acts on your behalf), NOT Application permissions (for background services).
-📖 **Detailed Setup Guide**: [docs/guides/custom-client-app-registration.md](docs/guides/custom-client-app-registration.md)
+📖 **Detailed Setup Guide**: [Custom Client App Registration](https://learn.microsoft.com/microsoft-agent-365/developer/custom-client-app-registration)
> **Why is this required?** The CLI needs elevated permissions to create and manage Agent Identity Blueprints in your tenant. You maintain control over which permissions are granted, and the app stays within your tenant's security boundaries.
diff --git a/docs/commands/config-init.md b/docs/commands/config-init.md
index 0986e73d..d54f891f 100644
--- a/docs/commands/config-init.md
+++ b/docs/commands/config-init.md
@@ -113,7 +113,7 @@ Retry (2 attempts remaining)? (Y/n):
```
**Prerequisites**: Before running config init, create your custom client app:
-1. Follow the guide: [Custom Client App Registration](../guides/custom-client-app-registration.md)
+1. Follow the guide: [Custom Client App Registration](https://learn.microsoft.com/microsoft-agent-365/developer/custom-client-app-registration)
2. Copy the **Application (client) ID** from Azure Portal
3. Ensure admin consent is granted for all permissions
4. Enter the ID when prompted during config init
@@ -254,7 +254,7 @@ The wizard automatically populates these fields:
|-------|-------------|--------|---------|
| **clientAppId** | Custom Entra ID app registration Application (client) ID | User provides after creating app | `a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6` |
-**Important**: This must be configured before setup. See [Custom Client App Registration Guide](../guides/custom-client-app-registration.md) for detailed setup instructions.
+**Important**: This must be configured before setup. See [Custom Client App Registration Guide](https://learn.microsoft.com/microsoft-agent-365/developer/custom-client-app-registration) for detailed setup instructions.
### Azure Infrastructure (Auto-detected from Azure CLI)
diff --git a/docs/commands/develop/develop-addpermissions.md b/docs/commands/develop/develop-addpermissions.md
index db1ee51b..dc88df32 100644
--- a/docs/commands/develop/develop-addpermissions.md
+++ b/docs/commands/develop/develop-addpermissions.md
@@ -45,7 +45,7 @@ The application you're adding permissions to can be the **same application** you
**Example**: If your `a365.config.json` has `clientAppId: "12345678-..."`, running `a365 develop add-permissions` will add MCP permissions to that same application.
-> **Note**: The `clientAppId` must be a **client application you create in your Entra ID tenant** with `Application.ReadWrite.All` permission. See the [custom client app registration guide](../../guides/custom-client-app-registration.md) for setup instructions.
+> **Note**: The `clientAppId` must be a **client application you create in your Entra ID tenant** with `Application.ReadWrite.All` permission. See the [custom client app registration guide](https://learn.microsoft.com/microsoft-agent-365/developer/custom-client-app-registration) for setup instructions.
## Prerequisites
diff --git a/src/Microsoft.Agents.A365.DevTools.Cli/Commands/CreateInstanceCommand.cs b/src/Microsoft.Agents.A365.DevTools.Cli/Commands/CreateInstanceCommand.cs
index df050c24..f82bbb26 100644
--- a/src/Microsoft.Agents.A365.DevTools.Cli/Commands/CreateInstanceCommand.cs
+++ b/src/Microsoft.Agents.A365.DevTools.Cli/Commands/CreateInstanceCommand.cs
@@ -541,7 +541,7 @@ private static void LogDeprecationError(ILogger logger, string commandName)
logger.LogError(" 3. Create an agent instance through Microsoft Teams");
logger.LogError("");
logger.LogError("For more information, see:");
- logger.LogError("https://learn.microsoft.com/en-us/microsoft-agent-365/onboard");
+ logger.LogError("https://learn.microsoft.com/microsoft-agent-365/onboard");
logger.LogError("");
}
}
diff --git a/src/Microsoft.Agents.A365.DevTools.Cli/Constants/ConfigConstants.cs b/src/Microsoft.Agents.A365.DevTools.Cli/Constants/ConfigConstants.cs
index f3e05dbe..ba3ec790 100644
--- a/src/Microsoft.Agents.A365.DevTools.Cli/Constants/ConfigConstants.cs
+++ b/src/Microsoft.Agents.A365.DevTools.Cli/Constants/ConfigConstants.cs
@@ -26,7 +26,12 @@ public static class ConfigConstants
///
/// Microsoft Learn documentation URL for Agent 365 CLI setup and usage
///
- public const string Agent365CliDocumentationUrl = "https://learn.microsoft.com/en-us/microsoft-agent-365/developer/agent-365-cli";
+ public const string Agent365CliDocumentationUrl = "https://learn.microsoft.com/microsoft-agent-365/developer/agent-365-cli";
+
+ ///
+ /// Microsoft Learn documentation URL for custom client app registration
+ ///
+ public const string CustomClientAppRegistrationUrl = "https://learn.microsoft.com/microsoft-agent-365/developer/custom-client-app-registration";
///
/// Production Agent 365 Tools Discover endpoint URL
diff --git a/src/Microsoft.Agents.A365.DevTools.Cli/Services/A365CreateInstanceRunner.cs b/src/Microsoft.Agents.A365.DevTools.Cli/Services/A365CreateInstanceRunner.cs
index 9fda06be..452b142a 100644
--- a/src/Microsoft.Agents.A365.DevTools.Cli/Services/A365CreateInstanceRunner.cs
+++ b/src/Microsoft.Agents.A365.DevTools.Cli/Services/A365CreateInstanceRunner.cs
@@ -61,7 +61,7 @@ public async Task RunAsync(
_logger.LogError(" - Work correctly with messaging and event propagation");
_logger.LogError("");
_logger.LogError("Use 'a365 publish' followed by Teams-based hiring instead.");
- _logger.LogError("See: https://learn.microsoft.com/en-us/microsoft-agent-365/onboard");
+ _logger.LogError("See: https://learn.microsoft.com/microsoft-agent-365/onboard");
_logger.LogError("");
return false;
diff --git a/src/Microsoft.Agents.A365.DevTools.Cli/Services/ConfigurationWizardService.cs b/src/Microsoft.Agents.A365.DevTools.Cli/Services/ConfigurationWizardService.cs
index 02fc2315..65381ce3 100644
--- a/src/Microsoft.Agents.A365.DevTools.Cli/Services/ConfigurationWizardService.cs
+++ b/src/Microsoft.Agents.A365.DevTools.Cli/Services/ConfigurationWizardService.cs
@@ -849,7 +849,7 @@ private string GetUsageLocationFromAccount(AzureAccountInfo accountInfo)
Console.WriteLine("Why Delegated? You sign in interactively, CLI acts on your behalf.");
Console.WriteLine("Application permissions are for background services only.");
Console.WriteLine();
- Console.WriteLine("See: https://github.com/microsoft/Agent365-devTools/blob/main/docs/guides/custom-client-app-registration.md");
+ Console.WriteLine($"See: {ConfigConstants.CustomClientAppRegistrationUrl}");
Console.WriteLine("=================================================================");
Console.WriteLine();
diff --git a/src/Microsoft.Agents.A365.DevTools.Cli/Services/Requirements/RequirementChecks/FrontierPreviewRequirementCheck.cs b/src/Microsoft.Agents.A365.DevTools.Cli/Services/Requirements/RequirementChecks/FrontierPreviewRequirementCheck.cs
index b4566fa5..a887f1e3 100644
--- a/src/Microsoft.Agents.A365.DevTools.Cli/Services/Requirements/RequirementChecks/FrontierPreviewRequirementCheck.cs
+++ b/src/Microsoft.Agents.A365.DevTools.Cli/Services/Requirements/RequirementChecks/FrontierPreviewRequirementCheck.cs
@@ -32,8 +32,8 @@ public override Task CheckAsync(Agent365Config config, I
Console.WriteLine(" - Please confirm your tenant is enrolled before continuing.");
Console.WriteLine();
Console.WriteLine("Documentation:");
- Console.WriteLine(" - https://learn.microsoft.com/en-us/microsoft-agent-365/developer/");
- Console.WriteLine(" - https://adoption.microsoft.com/en-us/copilot/frontier-program/");
+ Console.WriteLine(" - https://learn.microsoft.com/microsoft-agent-365/developer/");
+ Console.WriteLine(" - https://adoption.microsoft.com/copilot/frontier-program/");
// Return warning without using base class logging (already logged above)
return Task.FromResult(RequirementCheckResult.Warning(