Rules theo đường dẫn cho việc nạp quy ước có điều kiện

Những điều bạn cần biết

Rules theo đường dẫn là cơ chế áp dụng quy ước có điều kiện dựa trên việc bạn đang chỉnh sửa file nào. Chúng giải quyết một vấn đề mà cả CLAUDE.md ở gốc lẫn CLAUDE.md cấp thư mục đều xử lý không tốt: các quy ước phải áp dụng cho một loại file cụ thể nằm rải rác trên nhiều thư mục.

Rules theo đường dẫn hoạt động như thế nào

Các file rule nằm trong thư mục .claude/rules/. Mỗi file chứa frontmatter YAML với trường paths chỉ định các glob pattern. Các rule bên trong file chỉ nạp khi bạn đang chỉnh sửa các file khớp với những pattern đó.

yamlCopy

---
paths: ["terraform/**/*"]
---
# Terraform Conventions
 
- Use snake_case for all resource names
- Tag every resource with environment and team labels
- Never hardcode AMI IDs — use data sources
- All modules must have a variables.tf, outputs.tf, and README.md

Khi bạn chỉnh sửa một file khớp terraform/**/*, các rule này tự động nạp. Khi bạn chỉnh sửa một component React hay một handler API, chúng không nạp. Các rule vô hình cho đến khi liên quan.

Glob pattern khớp trên toàn bộ codebase

Đây là ưu điểm then chốt. Một glob pattern như **/*.test.tsx bắt được mọi file test trong codebase, bất kể nó nằm ở thư mục nào. Xét một cấu trúc dự án điển hình:

src/ components/ Button.tsx Button.test.tsx api/ auth.ts auth.test.ts utils/ format.ts format.test.ts pages/ dashboard/ Dashboard.tsx Dashboard.test.tsx

Các file test nằm cạnh file nguồn của chúng trên bốn thư mục khác nhau. Một rule theo đường dẫn với paths: ["**/*.test.tsx", "**/*.test.ts"] áp dụng cùng quy ước test cho tất cả các file này, một cách tự động.

Tại sao không dùng CLAUDE.md cấp thư mục?

Một CLAUDE.md cấp thư mục chỉ áp dụng cho các file trong thư mục đó. Để áp dụng quy ước test cho các file test nằm rải rác trên 50+ thư mục, bạn sẽ phải đặt một file CLAUDE.md trong từng thư mục chứa test. Điều đó có nghĩa là:

• 50+ bản sao của cùng một bộ quy ước
• Mỗi thư mục mới có test lại cần thêm một bản sao
• Bất kỳ thay đổi quy ước nào cũng đòi hỏi cập nhật cả 50+ file
• Sự lệch pha là điều không tránh khỏi khi một số bản sao bị bỏ sót

Rules theo đường dẫn với glob pattern loại bỏ hoàn toàn vấn đề này. Một file, một pattern, bao phủ toàn bộ.

Tại sao không dùng CLAUDE.md ở gốc?

CLAUDE.md ở gốc nạp cho mọi phiên, bất kể bạn đang chỉnh sửa file nào. Nếu các quy ước Terraform của bạn nằm trong CLAUDE.md ở gốc, chúng vẫn tiêu tốn token ngay cả khi bạn đang chỉnh sửa các component React. Nếu các quy ước test của bạn nằm ở gốc, chúng vẫn nạp khi bạn đang viết handler API.

Ví dụ thực tế về file rule

Quy ước test trên toàn bộ codebase:

yamlCopy

---
paths: ["**/*.test.ts", "**/*.test.tsx", "**/*.spec.ts", "**/*.spec.tsx"]
---
# Test Conventions
 
- Use describe/it blocks with descriptive names that read as sentences
- Each test file must have at least one happy path and one error case
- Use factory functions for test data, not inline object literals
- Mock external services at the module boundary, not individual functions
- Assert behaviour, not implementation details

Quy ước API cho mọi route handler:

yamlCopy

---
paths: ["src/api/**/*", "**/routes/**/*", "**/*.controller.ts"]
---
# API Conventions
 
- All endpoints return { data, error, metadata } response shape
- Use Zod schemas for request validation at the handler boundary
- Log request ID on every error response
- Rate limiting configuration must be explicit, not inherited from defaults

Quy ước infrastructure-as-code:

yamlCopy

---
paths: ["terraform/**/*", "**/*.tf", "infrastructure/**/*"]
---
# Infrastructure Conventions
 
- State files must reference remote backends, never local
- Use workspaces for environment separation
- Every module must be versioned with a CHANGELOG

Khi nào dùng cách tiếp cận nào

Đề thi thường xuyên đưa ra kịch bản file test nằm cạnh file nguồn trên nhiều thư mục. Câu trả lời luôn là rules theo đường dẫn với glob pattern.

Bẫy thi

Tình huống luyện tập

Không tìm thấy câu hỏi luyện tập "q-3-3-001".

Bài tập thực hành

Nguồn tham khảo

• Claude Code Memory and Rules Documentation — Anthropic
• Claude Certified Architect Foundations Exam Guide — Task Statement 3.3 — Anthropic
• Claude Certified Architect Foundations Exam Guide — Sample Question 6 — Anthropic