.claude/rules/ should exclude README.md from automatic loading
Summary
All .md files in .claude/rules/ are automatically loaded as rules and injected into the system prompt. This includes README.md, which is conventionally a human-readable documentation file, not an instruction for the AI.
Problem
README.mdis a widely recognized convention for directory-level documentation intended for humans browsing the repository- When placed in
.claude/rules/, it gets loaded as a rule alongside actual rule files, consuming context window tokens unnecessarily - There is no way to exclude specific files from automatic loading
Expected Behavior
README.md (and possibly readme.md) in .claude/rules/ should be excluded from automatic rule loading by default, as it is not intended as an AI instruction.
Suggested Solution
Exclude README.md (case-insensitive) from the auto-loading mechanism in .claude/rules/. This is the simplest approach and aligns with the established convention that README.md serves as human documentation.
Workaround
Currently, the only workaround is to not place README.md in .claude/rules/ at all (move it elsewhere or delete it).
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗