From 2fb4df588e9145d7de8c4a3103e0ec2ed2e7fcb2 Mon Sep 17 00:00:00 2001
From: Matteo Collina <hello@matteocollina.com>
Date: Mon, 6 Apr 2026 11:55:26 +0200
Subject: [PATCH] meta: ignore AI assistants files

Ignore CLAUDE.md and AGENTS.md in .gitignore, and exclude
them from markdown and ESLint linting.
---
 .gitignore        | 4 ++++
 Makefile          | 2 +-
 eslint.config.mjs | 1 +
 3 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index d283bce868da6c..0b8f1a405bda3a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -160,6 +160,10 @@ cmake_install.cmake
 install_manifest.txt
 *.cbp
 
+# === Rules for AI assistants ===
+CLAUDE.md
+AGENTS.md
+
 # === Global Rules ===
 # Keep last to avoid being excluded
 *.pyc
diff --git a/Makefile b/Makefile
index 231bbe11f4c011..a7a899db731edd 100644
--- a/Makefile
+++ b/Makefile
@@ -1403,7 +1403,7 @@ else
 LINT_MD_NEWER = -newer tools/.mdlintstamp
 endif
 
-LINT_MD_TARGETS = doc src lib benchmark test tools/doc tools/icu $(wildcard *.md)
+LINT_MD_TARGETS = doc src lib benchmark test tools/doc tools/icu $(filter-out CLAUDE.md AGENTS.md,$(wildcard *.md))
 LINT_MD_FILES = $(shell $(FIND) $(LINT_MD_TARGETS) -type f \
 	! -path '*node_modules*' ! -path 'test/fixtures/*' -name '*.md' \
 	$(LINT_MD_NEWER))
diff --git a/eslint.config.mjs b/eslint.config.mjs
index 86cbf2b56dd668..1286fa0c46ad4e 100644
--- a/eslint.config.mjs
+++ b/eslint.config.mjs
@@ -394,6 +394,7 @@ export default [
   // #region markdown config
   {
     files: ['**/*.md'],
+    ignores: ['CLAUDE.md', 'AGENTS.md'],
     plugins: {
       markdown,
     },