---
title: "Cursor Project Rules (.cursor/rules/*.mdc): đường dẫn và định dạng · DotsAgent"
description: "Vị trí của .cursor/rules/*.mdc, định dạng và frontmatter, cách hợp nhất các bản sao toàn cục và lồng nhau, cùng các tool đọc tệp này. Đã kiểm tra ngày 2026-10-01."
url: https://dotsagent.io/vi/instructions/files/cursor-rules
---

.cursor/rules/*.mdc

# Cursor Project Rules (.cursor/rules/*.mdc): vị trí và cách các tool đọc tệp

Project Rules của Cursor là các tệp .mdc trong .cursor/rules/; frontmatter của mỗi tệp quyết định thời điểm áp dụng quy tắc. Cursor cũng đọc AGENTS.md, cùng với User Rules và Team Rules được thiết lập bên ngoài repository.

## Vị trí

- .cursor/rules/**/*.mdc; có thể dùng thư mục con. Các tệp .md thuần trong .cursor/rules sẽ bị bỏ qua.
- AGENTS.md ở thư mục gốc và trong các thư mục lồng nhau.
- User Rules, được thiết lập trong cài đặt Cursor.
- Team Rules, được thiết lập trong bảng điều khiển nhóm.

## Định dạng

Markdown có YAML frontmatter và bắt buộc dùng phần mở rộng .mdc. alwaysApply: true luôn áp dụng quy tắc; globs cùng alwaysApply: false sẽ áp dụng quy tắc khi có tệp khớp nằm trong context; nếu chỉ có description, Agent sẽ tự quyết định. Nếu không có các trường này, quy tắc chỉ áp dụng khi bạn @-mention nó.

Các khóa frontmatter: `description``globs``alwaysApply`

`.cursor/rules/*.mdc`

```
---
description: React component conventions
globs: src/components/**/*.tsx
alwaysApply: false
---

- One component per file, with a named export matching the file name.
- Type props with an interface named after the component plus Props.
- Use the existing CSS modules; no inline style objects.
- Follow @src/components/Button.tsx as the reference pattern.
```

## Thứ tự ưu tiên và hợp nhất

Team Rules, rồi Project Rules, sau đó User Rules. Các quy tắc áp dụng được sẽ hợp nhất; khi có xung đột, nguồn đứng trước sẽ được ưu tiên. Không thể tắt Team Rules bắt buộc. Các tệp AGENTS.md lồng nhau được kết hợp với tệp ở thư mục cha; tệp cụ thể hơn sẽ được ưu tiên.

## Các tool đọc tệp này

| Công cụ | Hỗ trợ |
| --- | --- |
| [Cline](https://docs.cline.bot/features/cline-rules) | Nhận diện tệp .cursorrules cũ. |

## Mẹo

- Phân tách nhiều glob bằng dấu phẩy trong trường globs.
- Giữ mỗi rule dưới 500 dòng và tham chiếu đến tệp bằng @filename thay vì sao chép nội dung vào.
- Rules không ảnh hưởng đến Cursor Tab, còn User Rules không áp dụng cho Inline Edit.
- Tệp .cursorrules cũ không còn được nhắc đến trong tài liệu của Cursor; hãy chuyển tệp này vào .cursor/rules/.

Tạo AGENTS.md và các tệp rule tương ứng cho năm tool từ một biểu mẫu. [Mở trình tạo AGENTS.md →](https://dotsagent.io/vi/instructions)

## Các tệp hướng dẫn khác

[AGENTS.md](https://dotsagent.io/vi/instructions/files/agents-md)

[CLAUDE.md](https://dotsagent.io/vi/instructions/files/claude-md)

[GEMINI.md](https://dotsagent.io/vi/instructions/files/gemini-md)

[.github/copilot-instructions.md](https://dotsagent.io/vi/instructions/files/github-copilot-instructions)

[.devin/rules/*.md](https://dotsagent.io/vi/instructions/files/windsurf-rules)

[.clinerules/](https://dotsagent.io/vi/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/vi/instructions/files/openclaw-workspace)

## Nguồn

1. [cursor.com](https://cursor.com/docs/context/rules)/docs/context/rules

Tài liệu tham khảo độc lập dành cho những người xây dựng AI agent. Không liên kết với bất kỳ nhà cung cấp nào được nêu ở đây.

© 2026 DotsAgent · Dữ liệu được kiểm tra ngày 1 tháng 10, 2026