From 4d91c4e08c14ae8995eb96e085a6e3cd0b5b49ef Mon Sep 17 00:00:00 2001
From: BREW <81044362+b-re-w@users.noreply.github.com>
Date: Sat, 3 Oct 2026 19:13:35 +0900
Subject: [PATCH] Chore: Drop CLAUDE.md; Claude Code reads AGENTS.md directly

The maintainer's instruction (2026-10-03): current Claude Code supports
AGENTS.md, so the one-line pointer file (`@AGENTS.md`) is gone. AGENTS.md
section 17 no longer describes it, and the release tooling's test and README
use PROJECT.md instead as their example of a root Markdown file that main
drops. python-multiplatform did the same in its #97.

deleted: CLAUDE.md.
documentation corrected: AGENTS.md section 17, tools/release/README.md.
test changed: test-sync-release.sh seeds PROJECT.md in place of CLAUDE.md;
49 passed, 0 failed. The pytest suite does not touch these files.

Refs #56
---
 AGENTS.md                          | 4 ++--
 CLAUDE.md                          | 1 -
 tools/release/README.md            | 2 +-
 tools/release/test-sync-release.sh | 4 ++--
 4 files changed, 5 insertions(+), 6 deletions(-)
 delete mode 100644 CLAUDE.md

diff --git a/AGENTS.md b/AGENTS.md
index cc11c49..3df1803 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -222,6 +222,6 @@ worktree so a test can see it. Read it in place.
 - `docs/guide/` is the bilingual GitHub Pages site. Every visible string exists in English and
   Korean. `python3 tools/check_guide.py` is its test; run it after any guide change.
 - No Markdown files directly under `docs/` other than `INTENT.md` and `SPEC.md`; other documents go
-  in a topic subdirectory. `README.md` must not link to `AGENTS.md`, `PROJECT.md`, `CLAUDE.md`,
+  in a topic subdirectory. `README.md` must not link to `AGENTS.md`, `PROJECT.md`,
   `docs/INTENT.md` or `docs/SPEC.md` — those files do not exist on `main`.
-- `CLAUDE.md` contains exactly one line, `@AGENTS.md`. Rules go in this file.
+- There is no `CLAUDE.md`: Claude Code reads this file directly. Rules go here.
diff --git a/CLAUDE.md b/CLAUDE.md
deleted file mode 100644
index 43c994c..0000000
--- a/CLAUDE.md
+++ /dev/null
@@ -1 +0,0 @@
-@AGENTS.md
diff --git a/tools/release/README.md b/tools/release/README.md
index b3243ca..9cf1d89 100644
--- a/tools/release/README.md
+++ b/tools/release/README.md
@@ -25,7 +25,7 @@ ignored and overwritten.
 
 ## What is dropped on release
 
-- every `*.md` at the repository root except `README.md` (including `CLAUDE.md`, `AGENTS.md`)
+- every `*.md` at the repository root except `README.md` (including `AGENTS.md`, `PROJECT.md`)
 - every `*.md` directly inside `docs/`
 
 Kept: everything else, including Markdown in `docs/<subfolder>/` and nested `README.md` files.
diff --git a/tools/release/test-sync-release.sh b/tools/release/test-sync-release.sh
index cba1d31..15dbf8f 100755
--- a/tools/release/test-sync-release.sh
+++ b/tools/release/test-sync-release.sh
@@ -23,7 +23,7 @@ mkdir -p "$R" && cd "$R" || exit 1
 git init -q -b develop .
 git config user.name t; git config user.email t@example.com
 mkdir -p docs/guide docs/sub sub/deeper
-for f in README.md CLAUDE.md AGENTS.md ROADMAP.md docs/a.md docs/b.md \
+for f in README.md PROJECT.md AGENTS.md ROADMAP.md docs/a.md docs/b.md \
          docs/sub/c.md docs/guide/index.html docs/x.png sub/README.md \
          sub/deeper/notes.md build.gradle.kts LICENSE; do
   echo "$f" > "$f"
@@ -58,7 +58,7 @@ for p in README.md docs/sub/c.md docs/guide/index.html docs/x.png sub/README.md
          sub/deeper/notes.md build.gradle.kts LICENSE; do
   check "kept: $p" in_rel "$p"
 done
-for p in CLAUDE.md AGENTS.md ROADMAP.md docs/a.md docs/b.md; do
+for p in PROJECT.md AGENTS.md ROADMAP.md docs/a.md docs/b.md; do
   check "dropped: $p" bash -c "! git cat-file -e release:$p"
 done
 check "release README is the committed one" test "$(git show release:README.md)" = "README.md"