From dcf52d5026af4d26212195c8b671122e8e5b387c Mon Sep 17 00:00:00 2001
From: Matt Miller <mattmiller@comfy.org>
Date: Wed, 16 Sep 2026 05:04:29 +0000
Subject: [PATCH] chore: adopt AGENTS.md as the agent-instruction source of
 truth

Rename .cursorrules to AGENTS.md (content unchanged; already valid
markdown) and add a root CLAUDE.md shim that imports it, so Claude Code
(which reads only CLAUDE.md) and other agent tools share one source.

Update a stale in-code reference to the renamed policy file.
---
 .cursorrules => AGENTS.md                            | 2 +-
 CLAUDE.md                                            | 2 ++
 docs-generation/scripts/update_param_translations.py | 2 +-
 3 files changed, 4 insertions(+), 2 deletions(-)
 rename .cursorrules => AGENTS.md (99%)
 create mode 100644 CLAUDE.md

diff --git a/.cursorrules b/AGENTS.md
similarity index 99%
rename from .cursorrules
rename to AGENTS.md
index b0eae7e33..4d3897f62 100644
--- a/.cursorrules
+++ b/AGENTS.md
@@ -143,4 +143,4 @@ When users provide language files and request translation to corresponding langu
 | ko.md    | 입력     | 출력     |
 | zh.md    | 输入     | 输出     |
 | ru.md    | Входы    | Выходы   |
-| fa.md    | ورودی‌ها | خروجی‌ها |
\ No newline at end of file
+| fa.md    | ورودی‌ها | خروجی‌ها |
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 000000000..44fa605e2
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,2 @@
+<!-- Agent instructions live in AGENTS.md (the cross-agent standard). This is a Claude Code shim: Claude reads only CLAUDE.md, so the import below pulls AGENTS.md in. Don't add content here — edit AGENTS.md. -->
+@AGENTS.md
diff --git a/docs-generation/scripts/update_param_translations.py b/docs-generation/scripts/update_param_translations.py
index 63c1810fd..86f6d5331 100644
--- a/docs-generation/scripts/update_param_translations.py
+++ b/docs-generation/scripts/update_param_translations.py
@@ -182,7 +182,7 @@ def update_doc_with_translations(doc_file, node_name, lang, frontend_translation
     
     # Update output parameter names
     # DISABLED (2026-09-13): output names are programmatic identifiers and must
-    # stay English per repo policy (enforced by .cursorrules and
+    # stay English per repo policy (enforced by AGENTS.md and
     # _fix_output_names_in_translation in batch_translate_docs.py). Replacing them
     # with frontend display names was regressing the review fixes from PR #145
     # commit 58a9d1c2. Flip this flag only if the policy changes.