This project tests Claude Code's path-specific rules feature.
Path-specific rules allow you to automatically load context-specific instructions when working with certain files or directories.
Rules are configured in .claude/rules/ with different YAML frontmatter formats:
.claude/rules/
├── api-paths-quoted-csv.md # paths: "a,b,c" format
├── api-paths-unquoted-csv.md # paths: a,b,c format
├── api-paths-yaml-array.md # paths: YAML array format
├── database.md
└── frontend/
├── react-patterns.md
└── testing.md
- OS: macOS
- Claude Code: v2.1.17 (native)
| File | Format | Example | Loaded |
|---|---|---|---|
api-paths-quoted-csv.md |
Quoted CSV | paths: "src/api/**/*,src/services/**/*" |
✅ |
api-paths-unquoted-csv.md |
Unquoted CSV | paths: src/api/**/*,src/services/**/* |
✅ |
api-paths-yaml-array.md |
YAML Array | paths: - "src/api/**/*" |
❌ |
Conclusion: The documentation shows YAML array format, but only CSV format (with or without quotes) actually works.
Run Claude Code and reference a file to trigger path-specific rules:
claude "refactor @src/api/users.ts"⎿ Read src/api/users.ts (59 lines)
⎿ Loaded .claude/rules/api-paths-quoted-csv.md
⎿ Loaded .claude/rules/api-paths-unquoted-csv.md
When you reference src/api/users.ts, the API standards rules should automatically load.