QuotaCheap Playbook

Cursor Rules: biến convention repo thành hướng dẫn bền cho coding agent

Tìm hiểu Cursor Rules theo docs chính thức: project rules, user rules, team rules, AGENTS.md, .mdc frontmatter, alwaysApply, globs, description và cách dùn…

Rules giúp Cursor Agent nhận instruction ổn định ở prompt level: project rules, user rules, team rules và AGENTS.md. Đây là cách viết rules để agent bớt đoán và team review dễ hơn.

Hướng dẫn Cursor Rules theo docs chính thức: các loại rules, .cursor/rules, .mdc frontmatter, alwaysApply, globs, description, AGENTS.md, anti-pattern khi viết rules và workflow áp dụng rules cho team dùng coding agent.

Cursor Rules là phần nhiều team bỏ qua khi mới dùng Cursor Agent.

Họ bắt đầu bằng prompt dài: “hãy đọc repo trước, đừng sửa generated files, dùng style hiện có, test trước khi kết luận, không thêm dependency nếu chưa cần”.

Prompt đó đúng, nhưng nếu lần nào cũng phải gõ lại thì workflow chưa trưởng thành.

Rules giải quyết đúng vấn đề này.

Theo Cursor Docs, rules cung cấp system level instructions cho Agent.

Chúng bundle prompts, scripts và workflow để dễ quản lý và share trong team.

Vì language model không giữ memory giữa các completion, rules đưa context bền vào prompt level.

Nói đơn giản: Cursor Rules là cách biến convention repo thành instruction có version control.

Khi agent bước vào task, nó không bắt đầu từ zero.

Nó có một “sổ tay repo” nói rõ cách codebase này muốn được chỉnh sửa.

Bài này đi theo Cursor Rules docs, không bịa thêm tính năng.

Mục tiêu là giúp developer viết rules thực dụng: đủ cụ thể để giảm hallucination, đủ ngắn để không đốt context, đủ có cấu trúc để team maintain được.

Vì sao coding agent cần rules?

Con người làm trong một repo lâu ngày sẽ nhớ nhiều thứ không nằm trong README: API response shape nào không được đổi vì mobile app đang phụ thuộc.

Folder nào là generated code không được sửa tay.

Pattern nào team đã bỏ nhưng vẫn còn legacy.

Test nào cần chạy khi sửa billing.

Component nào phải dùng design token thay vì hardcode màu.

Migration nào phải backward compatible.

Coding agent không có ký ức đó nếu bạn không đưa vào context.

Nó có thể đọc code và suy luận, nhưng sẽ mất thời gian, tốn token và đôi khi suy luận sai.

Rules giúp đưa phần “tri thức vận hành” này vào trước.

Cursor Docs nói rules được include ở đầu model context khi applied.

Điều này quan trọng: rule không phải tài liệu nằm im trong repo để agent tình cờ đọc.