Enterprise plugin standards apply to VS Code (#61552)

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Author: isaacmbrown

content/copilot/concepts/agents/about-enterprise-plugin-standards.md

@@ -0,0 +1,53 @@
+---
+title: About enterprise-managed plugin standards
+shortTitle: Enterprise plugin standards
+allowTitleToDifferFromFilename: true
+intro: Enterprise administrators can centrally define plugin policies for users, ensuring consistent plugin availability.
+versions:
+  feature: copilot
+contentType: concepts
+category:
+  - Learn about Copilot
+  - Learn about Copilot CLI
+docsTeamMetrics:
+  - copilot-cli
+redirect_from:
+  - /copilot/concepts/agents/copilot-cli/about-enterprise-plugin-standards
+---
+
+> [!NOTE] This feature is in {% data variables.release-phases.public_preview %} and subject to change.
+
+Enterprise-managed plugin standards allow administrators to **define and enforce policies for plugin availability**. By configuring a `settings.json` file in the enterprise's `.github-private` repository, administrators can specify which plugin marketplaces are available to users and which plugins are installed automatically.
+
+## Where plugin standards apply
+
+Plugin standards apply to all users on the enterprise's {% data variables.product.prodname_copilot_short %} plan, across the following clients:
+
+* **{% data variables.copilot.copilot_cli_short %}**: see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-cli-plugins)
+* **{% data variables.product.prodname_vscode_shortname %}** (version 1.122 and later): see [Agent plugins in {% data variables.product.prodname_vscode_shortname %}](https://code.visualstudio.com/docs/agent-customization/agent-plugins) in the {% data variables.product.prodname_vscode_shortname %} documentation
+
+Users must upgrade to a supported client version for these standards to be applied.
+
+## How plugin standards work
+
+Enterprise plugin standards use a configuration file stored in your enterprise's `.github-private` repository. The configuration is defined in a `settings.json` file at the following path: `.github/copilot/settings.json`.
+
+For plugin standards, the file can define:
+
+* **Known marketplaces**. Plugin marketplaces that are available to users for browsing and installing plugins.
+* **Default-enabled plugins**. Specific plugins that are automatically installed when users authenticate.
+
+When a user authenticates to {% data variables.product.prodname_copilot_short %} in a supported client, the client queries an API endpoint that reads the `settings.json` from the enterprise's `.github-private` repository. The policies defined in the file are then applied to the user's session.
+
+## Why use enterprise-managed plugin standards
+
+Enterprise-managed plugin standards help administrators address several common challenges:
+
+* **Consistency across clients**. Ensure that all developers have access to the same plugins and marketplaces.
+* **Centralized governance**. Manage plugin availability from a single configuration file, rather than relying on individual developers to install the correct plugins.
+* **Version-controlled policies**. Because the configuration lives in a Git repository, all changes to plugin standards are tracked, auditable, and reviewable through pull requests.
+* **Reduced onboarding friction**. New developers automatically receive the enterprise's standard plugins when they authenticate, without any manual setup.
+
+## Next step
+
+To configure enterprise plugin standards, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-plugin-standards).

content/copilot/concepts/agents/copilot-cli/about-enterprise-plugin-standards.md

@@ -12,7 +12,6 @@ children:
   - /about-remote-control
   - /about-custom-agents
   - /about-cli-plugins
-  - /about-enterprise-plugin-standards
   - /autopilot
   - /fleet
   - /research
@@ -24,3 +23,4 @@ contentType: concepts
 docsTeamMetrics:
   - copilot-cli
 ---
+

content/copilot/concepts/agents/copilot-cli/index.md

@@ -12,6 +12,7 @@ children:
   - /code-review
   - /copilot-memory
   - /hooks
+  - /about-enterprise-plugin-standards
   - /about-third-party-coding-agents
   - /agent-apps
   - /openai-codex
@@ -20,3 +21,4 @@ children:
   - /enterprise-management
 contentType: concepts
 ---
+

content/copilot/concepts/agents/index.md

@@ -1,5 +1,5 @@
 ---
-title: Configuring enterprise plugin standards for {% data variables.copilot.copilot_cli_short %}
+title: Configuring enterprise plugin standards
 shortTitle: Configure plugin standards
 allowTitleToDifferFromFilename: true
 intro: 'Configure enterprise plugin standards by defining a `settings.json` file in your enterprise''s `.github-private` repository.'
@@ -14,7 +14,7 @@ category:
 
 > [!NOTE] This feature is in {% data variables.release-phases.public_preview %} and subject to change.
 
-You can apply settings to control users' available plugin marketplaces and default-installed plugins. These settings apply to users on your enterprise's {% data variables.product.prodname_copilot_short %} plan. For more information, see [AUTOTITLE](/copilot/concepts/agents/copilot-cli/about-enterprise-plugin-standards).
+You can apply settings to control users' available plugin marketplaces and default-installed plugins. These settings apply to users on your enterprise's {% data variables.product.prodname_copilot_short %} plan. For more information, see [AUTOTITLE](/copilot/concepts/agents/about-enterprise-plugin-standards).
 
 1. In your enterprise's `.github-private` repository, navigate to the `.github/copilot/` directory. If you don't have a `.github-private` repository yet, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents).
 1. Create or edit the `settings.json` file at `.github/copilot/settings.json`.
@@ -36,11 +36,11 @@ You can apply settings to control users' available plugin marketplaces and defau
    }
    ```
 
-   * `extraKnownMarketplaces`: Defines additional plugin marketplaces available to CLI users. Each entry is a named marketplace object containing a `source` property that specifies the provider (`"github"`) and the repository in `OWNER/REPO` format.
+   * `extraKnownMarketplaces`: Defines additional plugin marketplaces available to users. Each entry is a named marketplace object containing a `source` property that specifies the provider (`"github"`) and the repository in `OWNER/REPO` format.
    * `enabledPlugins`: Defines plugins that are automatically installed for all enterprise users. Each entry uses the format `PLUGIN-NAME@MARKETPLACE-NAME` as the key, with a boolean value of `true` to enable the plugin.
 
 1. Commit and push your changes to the default branch of the `.github-private` repository.
 
-Once the configuration is committed, users will see the specified marketplaces and pre-installed plugins the next time they authenticate with {% data variables.copilot.copilot_cli_short %}.
+Once the configuration is committed, users will see the specified marketplaces and pre-installed plugins the next time they authenticate from a supported client.
 
 If a user does not see these settings, ensure they receive access to {% data variables.product.prodname_copilot_short %} through your enterprise or one of its organizations. If a user receives a license from multiple billing entities, ensure they have selected your enterprise in the "Usage billed to" dropdown in their [personal {% data variables.product.prodname_copilot_short %} settings](https://github.com/settings/copilot/features).

content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-plugin-standards.md

@@ -13,7 +13,7 @@ category:
 
 Enterprise-level {% data variables.copilot.custom_agents_short %} are defined in a specific repository within an organization in your enterprise. Before you can create and use {% data variables.copilot.custom_agents_short %}, you need to create this repository and configure the relevant enterprise settings.
 
-The same `.github-private` repository can also be used to configure enterprise plugin standards for {% data variables.copilot.copilot_cli_short %}. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-plugin-standards).
+The same `.github-private` repository can also be used to configure enterprise plugin standards. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-plugin-standards).
 
 ## Creating a repository for your {% data variables.copilot.custom_agents_short %}