.claude/rules.md file not automatically read at session start
Resolved 💬 2 comments Opened Feb 3, 2026 by CShen-101-solution Closed Feb 3, 2026
Problem
The .claude/rules.md file is not being consistently read at the beginning of sessions, despite documentation suggesting project-specific rules should be automatically respected.
Expected Behavior
- Claude should automatically read
.claude/rules.mdat the start of every session - Rules in this file should take highest priority over default behavior
- User shouldn't need to manually remind Claude to check rules
Actual Behavior
.claude/rules.mdexists with clear instructions including: "Before answering ANY question or performing ANY action in this repository, Claude MUST read this entire file first"- Claude proceeds with tasks without reading the file
- User must explicitly instruct Claude to "check the rules" multiple times
- Even then, Claude often ignores the instruction until repeatedly reminded
Impact
- Claude uses incorrect workflows (e.g., wrong PR creation commands)
- Violates project conventions repeatedly (e.g., missing required PR settings like auto-complete, squash merge)
- Wastes user time correcting mistakes that should have been prevented
- Undermines confidence in the
.claude/rules.mdfeature
Example Scenario
User has comprehensive .claude/rules.md file specifying:
- Specific PR creation workflow with required parameters
- Required PR description format
- Policy configuration requirements
Despite:
- Rules file existing with explicit instructions
- Rules file header stating it MUST be read before ANY action
- User explicitly instructing "check your rules first" before taking action
Claude still proceeded without reading the rules and created PR incorrectly, requiring manual correction.
Request
Make .claude/rules.md truly automatic through one of these approaches:
- System-level prompt injection that automatically includes rules content at session start
- Mandatory pre-task file reading that cannot be skipped
- Hard requirement to read rules file before any tool execution
The current implementation appears to rely on Claude voluntarily reading the file, which is unreliable.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗