.claude/rules/ should exclude README.md from automatic loading

Resolved 💬 4 comments Opened Feb 18, 2026 by RyoHirota68 Closed Mar 18, 2026

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.md is 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).

View original on GitHub ↗

This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗