From 35a38631efd43cd19a0110076d12c829c7bbdace Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=9B=B7=E7=94=B5=E8=8A=BD=E8=A1=A3?=
 <zhangyanghaha0407@outlook.com>
Date: Mon, 20 Apr 2026 11:36:54 -0400
Subject: [PATCH] Clarify AGENTS.md vs CLAUDE.md split (N7)

---
 .gitignore |  1 +
 CLAUDE.md  | 14 ++++++++++++++
 2 files changed, 15 insertions(+)

diff --git a/.gitignore b/.gitignore
index 19c95a63..37e81038 100644
--- a/.gitignore
+++ b/.gitignore
@@ -56,6 +56,7 @@ oldreference/
 !/docs/*.md
 !/docs/proposals/*.md
 !/CLAUDE.md
+!/AGENTS.md
 !/.planning/**/*.md
 !/src/main/prompt-builder/**/*.md
 # Bundled Agent Skills ship their SKILL.md / README.md as source of truth.
diff --git a/CLAUDE.md b/CLAUDE.md
index 84eac677..9258996c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -1,3 +1,17 @@
+# CLAUDE.md
+
+> Claude Code–specific entry point. The talk-normal style block and core
+> persona below are intentionally mirrored from `AGENTS.md` so that the Claude
+> Code config loader picks them up at top priority — do not replace with a
+> pointer.
+>
+> For the shared, agent-agnostic principles (engineering constraints, workflow,
+> output specs), `AGENTS.md` is the canonical source. Claude Code–only hooks,
+> permissions, and settings live in `.claude/settings.json` and
+> `.claude/settings.local.json`.
+
+---
+
 4. <!-- talk-normal 0.6.2 -->
 
   Be direct and informative. No filler, no fluff, but give enough to be useful.