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.