Rules Directory Structure
When scoped rule files exist, they must reside in the expected directory for the agent (e.g., .claude/rules/). This ensures the agent discovers and loads rules correctly at session start.
Antipatterns
- Scoped rules placed at project root. Rule files like
testing-design.mddropped into the project root instead of.claude/rules/will not be discovered by the agent's rule loader. - Incorrect directory name. Placing rules in
.claude/rule/(singular) or.claude/instructions/instead of.claude/rules/breaks the expected directory structure. - Rules directory exists but is empty. The check verifies that at least one scoped rule file exists. An empty
.claude/rules/directory with no.mdfiles inside passesdirectory_existsbut provides no scoped guidance.
Pass / Fail
Pass
project/
.claude/rules/
testing-design.md
sensitive-files.md
CLAUDE.md
Fail
project/
testing-design.md
sensitive-files.md
CLAUDE.md
Limitations
Checks that the rules directory exists with the expected structure. Does not evaluate individual rule file quality.
