Migrate GitHub Copilot agent from .github/copilot-instructions.md to AGENTS.md

Agent-Logs-Url: https://github.com/ColdBox/coldbox-cli/sessions/deaea2fc-b65c-4413-9924-2e4df9bfd7a3

Co-authored-by: lmajano <137111+lmajano@users.noreply.github.com>

Author: Copilot

AI_INTEGRATION.md

@@ -188,7 +188,7 @@ graph LR
 
     Root --> Agents["Agent Configs"]
     Agents --> Claude["CLAUDE.md"]
-    Agents --> Copilot[".github/copilot-instructions.md"]
+    Agents --> Copilot["AGENTS.md (shared)"]
     Agents --> Cursor[".cursorrules"]
     Agents --> Other["+ 3 more agents"]
 
@@ -203,9 +203,8 @@ graph LR
 Additionally, agent configuration files are created for you (paths defined in `AgentRegistry.cfc`):
 
 * `CLAUDE.md` - Claude Desktop/Code assistant (points to `AGENTS.md` via `@AGENTS.md`)
-* `.github/copilot-instructions.md` - GitHub Copilot
+* `AGENTS.md` - Codex, OpenCode & GitHub Copilot (shared file)
 * `.cursorrules` - Cursor IDE
-* `AGENTS.md` - Codex, OpenCode & Claude (shared file)
 * `GEMINI.md` - Gemini CLI
 
 ### Keeping Resources Updated
@@ -244,7 +243,7 @@ After installation, configure your AI agents:
 
 **GitHub Copilot (VS Code):**
 
-1. Agent configuration is automatically in `.github/copilot-instructions.md`
+1. Agent configuration is automatically in `AGENTS.md`
 2. Reload VS Code window
 3. Copilot will use the instructions automatically
 
@@ -890,7 +889,7 @@ ColdBox AI Integration supports **6 major AI agents** with automatic configurati
 | Agent              | Config File                       | Description                    |
 | ------------------ | --------------------------------- | ------------------------------ |
 | **Claude**         | `CLAUDE.md` → `AGENTS.md`         | Claude Desktop and Claude Code |
-| **GitHub Copilot** | `.github/copilot-instructions.md` | VS Code Copilot integration    |
+| **GitHub Copilot** | `AGENTS.md` (shared)              | VS Code Copilot integration    |
 | **Cursor**         | `.cursorrules`                    | Cursor IDE rules               |
 | **Codex**          | `AGENTS.md` (shared)              | Codex AI assistant             |
 | **Gemini**         | `GEMINI.md`                       | Gemini CLI integration         |
@@ -952,7 +951,7 @@ graph TB
 
     subgraph "Agent Configurations"
         Guidelines --> ClaudeConfig["CLAUDE.md"]
-        Guidelines --> CopilotConfig[".github/copilot-instructions.md"]
+        Guidelines --> CopilotConfig["AGENTS.md (shared)"]
         Guidelines --> CursorConfig[".cursorrules"]
         Guidelines --> CodexConfig["AGENTS.md"]
         Guidelines --> GeminiConfig["GEMINI.md"]

README.md

@@ -625,7 +625,7 @@ coldbox ai agents remove cursor       # Remove an agent
 coldbox ai agents refresh             # Regenerate all configurations
 ```
 
-**Supported Agents**: Claude (CLAUDE.md → AGENTS.md), GitHub Copilot (.github/copilot-instructions.md), Cursor (.cursorrules), Codex (AGENTS.md), Gemini (GEMINI.md), OpenCode (AGENTS.md)
+**Supported Agents**: Claude (CLAUDE.md → AGENTS.md), GitHub Copilot (AGENTS.md, shared), Cursor (.cursorrules), Codex (AGENTS.md), Gemini (GEMINI.md), OpenCode (AGENTS.md)
 
 #### Guidelines
 

changelog.md

@@ -11,6 +11,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- **GitHub Copilot migrated to `AGENTS.md`**
+  - GitHub Copilot agent configuration now uses `AGENTS.md` (shared with Codex and OpenCode) instead of `.github/copilot-instructions.md`
+  - Follows the [Agents.md standard](https://github.blog/changelog/2025-08-28-copilot-coding-agent-now-supports-agents-md-custom-instructions/) now supported by GitHub Copilot
+  - Provides a single source of truth for Copilot, Codex, and OpenCode agents
+  - Existing `.github/copilot-instructions.md` files are not removed automatically; run `coldbox ai refresh` to write the updated location
+
 - **AI Directory Structure Standardized**
   - Renamed `/.ai/` directory to `/.agents/` to follow BoxLang skill repository conventions
   - All generated agent configurations, guidelines, and skills now use `/.agents/` instead of `/.ai/`
@@ -140,7 +146,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ##### Multi-Agent Support (6 Agents)
 
-- **Supported Agents**: Claude (`CLAUDE.md`), GitHub Copilot (`.github/copilot-instructions.md`), Cursor (`.cursorrules`), Codex (`AGENTS.md`), Gemini (`GEMINI.md`), OpenCode (`AGENTS.md`)
+- **Supported Agents**: Claude (`CLAUDE.md`), GitHub Copilot (`AGENTS.md`, shared), Cursor (`.cursorrules`), Codex (`AGENTS.md`), Gemini (`GEMINI.md`), OpenCode (`AGENTS.md`)
 - Layout-specific templates (modern, flat)
 - Project context detection (Vite, Docker, ORM, Migrations)
 - Agents commands: `list`, `add`, `remove`, `active`, `open`

commands/coldbox/ai/agents/help.cfc

@@ -46,7 +46,7 @@ component excludeFromHelp=true extends="coldbox-cli.models.BaseCommand" {
 			.line()
 			.yellowLine( "Note: Each agent creates its own configuration file:" )
 			.line( "  Claude: CLAUDE.md" )
-			.line( "  Copilot: .github/copilot-instructions.md" )
+			.line( "  Copilot: AGENTS.md (shared)" )
 			.line( "  Cursor: .cursorrules" )
 			.line()
 	}

models/AgentRegistry.cfc

@@ -1,6 +1,6 @@
 /**
  * Registry for AI agent configurations
- * Manages agent-specific files (CLAUDE.md, .github/copilot-instructions.md, etc.)
+ * Manages agent-specific files (CLAUDE.md, AGENTS.md, .cursorrules, etc.)
  */
 component singleton {
 
@@ -22,7 +22,7 @@ component singleton {
 		]
 		AGENT_FILES = {
 			"claude"   : "CLAUDE.md",
-			"copilot"  : ".github/copilot-instructions.md",
+			"copilot"  : "AGENTS.md",
 			"cursor"   : ".cursorrules",
 			"codex"    : "AGENTS.md",
 			"gemini"   : "GEMINI.md",
@@ -262,7 +262,7 @@ component singleton {
 			case "claude":
 				return "#arguments.directory#/CLAUDE.md"
 			case "copilot":
-				return "#arguments.directory#/.github/copilot-instructions.md"
+				return "#arguments.directory#/AGENTS.md"
 			case "cursor":
 				return "#arguments.directory#/.cursorrules"
 			case "codex":