From f71d36dbfc9760646f2918d9efb0865d0a2b8595 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 27 Mar 2026 10:23:03 +0000
Subject: [PATCH 1/2] Initial plan


From 8d9e4e102123654c111ccb23fe40dcffc84fd6c3 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 27 Mar 2026 10:27:07 +0000
Subject: [PATCH 2/2] Make CLAUDE.md point to AGENTS.md via @AGENTS.md
 directive

Agent-Logs-Url: https://github.com/ColdBox/coldbox-cli/sessions/785ea4ed-69ec-4c40-9eb3-3ed6e0ae4012

Co-authored-by: lmajano <137111+lmajano@users.noreply.github.com>
---
 AI_INTEGRATION.md        | 6 +++---
 README.md                | 2 +-
 changelog.md             | 2 ++
 models/AgentRegistry.cfc | 8 ++++++++
 4 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/AI_INTEGRATION.md b/AI_INTEGRATION.md
index 3f8a73f..9d17d8c 100644
--- a/AI_INTEGRATION.md
+++ b/AI_INTEGRATION.md
@@ -202,10 +202,10 @@ graph LR
 
 Additionally, agent configuration files are created for you (paths defined in `AgentRegistry.cfc`):
 
-* `CLAUDE.md` - Claude Desktop/Code assistant
+* `CLAUDE.md` - Claude Desktop/Code assistant (points to `AGENTS.md` via `@AGENTS.md`)
 * `.github/copilot-instructions.md` - GitHub Copilot
 * `.cursorrules` - Cursor IDE
-* `AGENTS.md` - Codex & OpenCode (shared file)
+* `AGENTS.md` - Codex, OpenCode & Claude (shared file)
 * `GEMINI.md` - Gemini CLI
 
 ### Keeping Resources Updated
@@ -894,7 +894,7 @@ ColdBox AI Integration supports **6 major AI agents** with automatic configurati
 
 | Agent              | Config File                       | Description                    |
 | ------------------ | --------------------------------- | ------------------------------ |
-| **Claude**         | `CLAUDE.md`                       | Claude Desktop and Claude Code |
+| **Claude**         | `CLAUDE.md` → `AGENTS.md`         | Claude Desktop and Claude Code |
 | **GitHub Copilot** | `.github/copilot-instructions.md` | VS Code Copilot integration    |
 | **Cursor**         | `.cursorrules`                    | Cursor IDE rules               |
 | **Codex**          | `AGENTS.md` (shared)              | Codex AI assistant             |
diff --git a/README.md b/README.md
index 8034834..c650473 100644
--- a/README.md
+++ b/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 (AGENTS.md), Gemini (GEMINI.md), OpenCode (AGENTS.md)
+**Supported Agents**: Claude (CLAUDE.md → AGENTS.md), GitHub Copilot (.github/copilot-instructions.md), Cursor (.cursorrules), Codex (AGENTS.md), Gemini (GEMINI.md), OpenCode (AGENTS.md)
 
 #### Guidelines
 
diff --git a/changelog.md b/changelog.md
index 2d62b7d..9660f38 100644
--- a/changelog.md
+++ b/changelog.md
@@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+- `CLAUDE.md` now contains `@AGENTS.md` to point Claude to the shared `AGENTS.md` file, avoiding duplicate content
+
 ## [8.8.0] - 2026-03-12
 
 - Fix invalid aliases
diff --git a/models/AgentRegistry.cfc b/models/AgentRegistry.cfc
index 41717c7..4c2f516 100644
--- a/models/AgentRegistry.cfc
+++ b/models/AgentRegistry.cfc
@@ -153,6 +153,14 @@ component singleton {
 			directoryCreate( configDir )
 		}
 
+		// For Claude, write the full content to AGENTS.md and make CLAUDE.md point to it
+		if ( arguments.agent == "claude" ) {
+			var agentsFilePath = getDirectoryFromPath( configPath ) & "AGENTS.md"
+			fileWrite( agentsFilePath, content )
+			fileWrite( configPath, "@AGENTS.md" )
+			return
+		}
+
 		// Write agent config file
 		fileWrite( configPath, content )
 	}