updated path to instruction files

Author: lmajano

AI_INTEGRATION.md

@@ -201,14 +201,13 @@ graph LR
 
 
 
-Additionally, agent configuration files are created for you:
+Additionally, agent configuration files are created for you (paths defined in `AgentRegistry.cfc`):
 
 * `CLAUDE.md` - Claude Desktop/Code assistant
 * `.github/copilot-instructions.md` - GitHub Copilot
 * `.cursorrules` - Cursor IDE
-* `.codex/instructions.md` - Codex
-* `.gemini/instructions.md` - Gemini CLI
-* `.opencode/instructions.md` - OpenCode
+* `AGENTS.md` - Codex & OpenCode (shared file)
+* `GEMINI.md` - Gemini CLI
 
 ### Keeping Resources Updated
 
@@ -907,14 +906,16 @@ ColdBox AI Integration supports **6 major AI agents** with automatic configurati
 
 ### Supported Agents
 
+> **Note**: Agent configuration paths are centrally managed in `models/AgentRegistry.cfc`
+
 | Agent              | Config File                       | Description                    |
 | ------------------ | --------------------------------- | ------------------------------ |
 | **Claude**         | `CLAUDE.md`                       | Claude Desktop and Claude Code |
 | **GitHub Copilot** | `.github/copilot-instructions.md` | VS Code Copilot integration    |
 | **Cursor**         | `.cursorrules`                    | Cursor IDE rules               |
-| **Codex**          | `.codex/instructions.md`          | Codex AI assistant             |
-| **Gemini**         | `.gemini/instructions.md`         | Gemini CLI integration         |
-| **OpenCode**       | `.opencode/instructions.md`       | OpenCode assistant             |
+| **Codex**          | `AGENTS.md` (shared)              | Codex AI assistant             |
+| **Gemini**         | `GEMINI.md`                       | Gemini CLI integration         |
+| **OpenCode**       | `AGENTS.md` (shared)              | OpenCode assistant             |
 
 ### Agent Configuration
 
@@ -975,9 +976,9 @@ graph TB
         Guidelines --> ClaudeConfig["CLAUDE.md"]
         Guidelines --> CopilotConfig[".github/copilot-instructions.md"]
         Guidelines --> CursorConfig[".cursorrules"]
-        Guidelines --> CodexConfig[".codex/instructions.md"]
-        Guidelines --> GeminiConfig[".gemini/instructions.md"]
-        Guidelines --> OpenCodeConfig[".opencode/instructions.md"]
+        Guidelines --> CodexConfig["AGENTS.md"]
+        Guidelines --> GeminiConfig["GEMINI.md"]
+        Guidelines --> OpenCodeConfig["AGENTS.md"]
 
         Skills --> ClaudeConfig
         Skills --> CopilotConfig
@@ -1772,14 +1773,6 @@ coldbox ai stats
 .ai/skills/custom/
 .ai/manifest.json
 
-# DON'T commit these (regenerated):
-CLAUDE.md
-.github/copilot-instructions.md
-.cursorrules
-.codex/instructions.md
-.gemini/instructions.md
-.opencode/instructions.md
-.mcp.json
 ```
 
 **Team Workflow:**

README.md

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

changelog.md

@@ -60,7 +60,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 (`.codex/instructions.md`), Gemini (`.gemini/instructions.md`), OpenCode (`.opencode/instructions.md`)
+- **Supported Agents**: Claude (`CLAUDE.md`), GitHub Copilot (`.github/copilot-instructions.md`), 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/install.cfc

@@ -66,7 +66,6 @@ component extends="coldbox-cli.models.BaseAICommand" {
 
 			// Success!
 			printSuccess( "🍭  AI integration installed successfully!" );
-			print.line();
 
 			// Show what was installed
 			printInfo( "Guidelines installed: #result.guidelines.len()#" );

commands/coldbox/ai/tree.cfc

@@ -8,6 +8,8 @@
  */
 component extends="coldbox-cli.models.BaseAICommand" {
 
+	property name="agentRegistry" inject="AgentRegistry@coldbox-cli";
+
 	/**
 	 * Run the command
 	 *
@@ -276,14 +278,7 @@ component extends="coldbox-cli.models.BaseAICommand" {
 		var result = {};
 
 		if ( agents.len() ) {
-			var agentFiles = {
-				"claude"   : "CLAUDE.md",
-				"copilot"  : ".github/copilot-instructions.md",
-				"cursor"   : ".cursorrules",
-				"codex"    : ".codex/instructions.md",
-				"gemini"   : ".gemini/instructions.md",
-				"opencode" : ".opencode/instructions.md"
-			};
+			var agentFiles = variables.agentRegistry.AGENT_FILES
 
 			agents.each( ( agent ) => {
 				if ( verbose && structKeyExists( agentFiles, agent ) ) {

models/AgentRegistry.cfc

@@ -24,9 +24,9 @@ component singleton {
 			"claude"   : "CLAUDE.md",
 			"copilot"  : ".github/copilot-instructions.md",
 			"cursor"   : ".cursorrules",
-			"codex"    : ".codex/instructions.md",
-			"gemini"   : ".gemini/instructions.md",
-			"opencode" : ".opencode/instructions.md"
+			"codex"    : "AGENTS.md",
+			"gemini"   : "GEMINI.md",
+			"opencode" : "AGENTS.md"
 		}
 		AGENT_OPTIONS = [
 			{
@@ -183,11 +183,11 @@ component singleton {
 			case "cursor":
 				return "#arguments.directory#/.cursorrules"
 			case "codex":
-				return "#arguments.directory#/.codex/instructions.md"
+				return "#arguments.directory#/AGENTS.md"
 			case "gemini":
-				return "#arguments.directory#/.gemini/instructions.md"
+				return "#arguments.directory#/GEMINI.md"
 			case "opencode":
-				return "#arguments.directory#/.opencode/instructions.md"
+				return "#arguments.directory#/AGENTS.md"
 			default:
 				return "#arguments.directory#/AI_INSTRUCTIONS.md"
 		}