diff --git a/AI_INTEGRATION.md b/AI_INTEGRATION.md index 6bde730..6e5915c 100644 --- a/AI_INTEGRATION.md +++ b/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"] diff --git a/README.md b/README.md index 6f3320b..d63918d 100644 --- a/README.md +++ b/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 diff --git a/changelog.md b/changelog.md index b9fcd8c..a6e8b2f 100644 --- a/changelog.md +++ b/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` diff --git a/commands/coldbox/ai/agents/help.cfc b/commands/coldbox/ai/agents/help.cfc index a30e899..25ed241 100644 --- a/commands/coldbox/ai/agents/help.cfc +++ b/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() } diff --git a/models/AgentRegistry.cfc b/models/AgentRegistry.cfc index ea211e6..fefcb22 100644 --- a/models/AgentRegistry.cfc +++ b/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":