forked from bchanot/claude
refactor(claude-md): four sections become .claude/rules path rules (phase 0)
This commit is contained in:
1 parent
ce8e60ee7c
commit
433c10d78f
6 files changed
+116
-89
No files matched your search
@@ -0,0 +1,27 @@
|
||||
---
|
||||
paths: ["rules/**", "CLAUDE.global.md"]
|
||||
---
|
||||
|
||||
# rules/ maintenance
|
||||
|
||||
Modular instruction files loaded by Claude Code alongside the global memory.
|
||||
`rules/` is symlinked to `~/.claude/rules` by `link.sh` (user scope, ALL
|
||||
projects). One rule = one file = one concern.
|
||||
|
||||
A rule WITH `paths:` YAML frontmatter (glob list) loads lazily — only when
|
||||
Claude reads a file matching a glob; a rule WITHOUT it loads at session
|
||||
start, same cost as the global memory. Extract from CLAUDE.global.md only
|
||||
what can be path-scoped (the token win) or what is generated; always-on
|
||||
doctrine stays in CLAUDE.global.md. Exception: a standalone user-authored
|
||||
rule set that would bust the 320-line density budget may live here WITHOUT
|
||||
`paths:` (always-on load) — writing-style.md (BDR-085), default-language.md
|
||||
(BDR-118), secure-by-default.md (BDR-120). `paths:` globs match against the
|
||||
CURRENT project's tree — a broad glob (e.g. `rules/**`) can fire in foreign
|
||||
projects; keep rule bodies tiny.
|
||||
Docs: https://code.claude.com/docs/en/memory.md#path-specific-rules
|
||||
|
||||
Machine-owned: `rules/context7.md` is 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. If it reappears (manual `ctx7 setup`), delete it
|
||||
or re-run `make plugin`.
|
||||
Reference in new issue
Block a user