diff --git a/README.md b/README.md
index f4b3afd..f07f479 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,8 @@ This repo is your personal Claude Code setup, versioned and reproducible across
 
 ```
 claude-config/
-├── CLAUDE.md              # Global coding preferences (style, rules, workflow)
+├── CLAUDE.global.md       # Global coding preferences — deployed as ~/.claude/CLAUDE.md
+├── CLAUDE.md              # Project-scope instructions (this repo only)
 ├── settings.json          # Global permissions (deny / ask / allow rules)
 ├── install.sh             # Bootstrap: Claude Code CLI + auth + submodules + link + plugins
 ├── install-plugins.sh     # One-shot installer: prerequisites + all plugins
diff --git a/rules/README.md b/rules/README.md
index c9d8860..4321cee 100644
--- a/rules/README.md
+++ b/rules/README.md
@@ -4,30 +4,6 @@ paths: ["rules/**"]
 
 # rules/
 
-Modular instruction files loaded by Claude Code alongside `CLAUDE.md`.
-Symlinked to `~/.claude/rules` by `link.sh`, same model as `agents/`,
-`skills/`, `lib/`.
-
-## What belongs here
-
-One rule = one file = one concern. Candidates: instructions that are
-self-contained enough to live outside `CLAUDE.md`'s main flow, or that
-tooling generates/owns.
-
-Rules support an optional `paths:` YAML frontmatter (glob list). A rule
-WITH `paths` loads lazily — only when Claude reads a file matching a
-glob; a rule WITHOUT it loads at session start, same cost as CLAUDE.md.
-So: extract from CLAUDE.md only what can be path-scoped (the token win)
-or what is generated; always-on doctrine stays in CLAUDE.md.
-Docs: https://code.claude.com/docs/en/memory.md#path-specific-rules
-
-## Machine-owned files (gitignored, regenerated)
-
-- `context7.md` — DELETED BY DESIGN (BDR-053, 2026-07-06): `ctx7 setup
-  --claude --cli` still writes it, but install-plugins.sh STEP ctx7
-  purges it right after — the find-docs skill is the single ctx7
-  surface; the rule was a ~490 tok/session session-start duplicate
-  (job1 F10). If it reappears (manual `ctx7 setup`), delete it or
-  re-run `make plugin`.
-
-Hand-written rules ARE tracked — add them normally.
+User-scope rules, deployed to `~/.claude/rules` by `link.sh`.
+Maintenance doctrine (what belongs here, lazy-load `paths:` semantics,
+machine-owned files): see `CLAUDE.md` (project scope) at the repo root.