AGENTS.md standard support in Copilot Chat in VS Code [GA] (#57874)

Author: hubwriter

content/copilot/how-tos/configure-custom-instructions/add-repository-instructions.md

@@ -221,7 +221,7 @@ Once saved, these instructions will apply to the current project in Eclipse that
 
 * **Agent instructions** are used by AI agents.
 
- You can create one or more `AGENTS.md` files, stored anywhere within the repository. When {% data variables.product.prodname_copilot_short %} is working, the nearest `AGENTS.md` file in the directory tree will take precedence. For more information, see the [openai/agents.md repository](https://github.com/openai/agents.md).
+ {% data reusables.copilot.custom-instructions-agents %}
 
  Alternatively, you can use a single `CLAUDE.md` or `GEMINI.md` file stored in the root of the repository.
 
@@ -257,7 +257,10 @@ Once saved, these instructions will apply to the current project in Eclipse that
 
 * **Agent instructions** are used by AI agents.
 
- For {% data variables.copilot.copilot_chat_short %} in {% data variables.product.prodname_vscode_shortname %}, instructions must be in a file called `AGENTS.md` in the root of the workspace. For more information, see the [openai/agents.md repository](https://github.com/openai/agents.md).
+ {% data reusables.copilot.custom-instructions-agents %}
+
+  > [!NOTE]
+ > Support of `AGENTS.md` files outside of the workspace root is currently turned off by default. For details of how to enable this feature, see [Use custom instructions in VS Code](https://code.visualstudio.com/docs/copilot/customization/custom-instructions#_use-an-agentsmd-file) in the {% data variables.product.prodname_vscode_shortname %} documentation.
 
 ## Creating repository-wide custom instructions
 

data/reusables/copilot/custom-instructions-agents.md

@@ -0,0 +1 @@
+You can create one or more `AGENTS.md` files, stored anywhere within the repository. When {% data variables.product.prodname_copilot_short %} is working, the nearest `AGENTS.md` file in the directory tree will take precedence. For more information, see the [openai/agents.md repository](https://github.com/openai/agents.md).

data/reusables/copilot/repository-custom-instructions-support.md

@@ -20,7 +20,7 @@ The following table shows which {% data variables.product.prodname_copilot_short
 
 **1:** Repository-wide instructions (using the `.github/copilot-instructions.md` file).<br>
 **2:** Repository-wide instructions and path-specific instructions (using `.github/instructions/**/NAME.instructions.md` files).<br>
-**3:** Repository-wide instructions, path-specific instructions, and a single `AGENTS.md` file in the root of the workspace.<br>
+**3:** Repository-wide instructions, path-specific instructions, and agent instructions (using `AGENTS.md` files).<br>
 **4:** Repository-wide instructions, path-specific instructions, and agent instructions (using `AGENTS.md`, `CLAUDE.md` or `GEMINI.md` files).<br>
 **X:** Custom instructions are not supported.<br>
 **N/A:** Feature not available on this platform.