Mỗi công cụ coding AI đều muốn có một file Markdown với các quy tắc dự án của bạn. Nhưng tất cả đều muốn một file Markdown khác nhau.

Nếu bạn đang sử dụng nhiều công cụ AI (và hầu hết nhà phát triển đều như vậy), điều này nhanh chóng trở nên khó hiểu. Đây là hướng dẫn đầy đủ về các file bạn cần và những gì đặt trong từng file.

Tổng Quan Các File

File	Công Cụ	Vị Trí	Phạm Vi
`AGENTS.md`	Phổ quát (tất cả công cụ)	Thư mục gốc dự án	Quy tắc chung cho tất cả AI agent
`CLAUDE.md`	Claude Code	Thư mục gốc dự án	Hướng dẫn đặc thù cho Claude
`.cursor/rules/*.md`	Cursor	Thư mục `.cursor/rules/`	Quy tắc đặc thù cho Cursor
`.github/copilot-instructions.md`	GitHub Copilot	Thư mục `.github/`	Hướng dẫn đặc thù cho Copilot

AGENTS.md: Tiêu Chuẩn Phổ Quát

Tốt nhất cho: Nhóm sử dụng nhiều công cụ AI, dự án mã nguồn mở

AGENTS.md là thứ gần nhất với tiêu chuẩn phổ quát hiện tại. Nó được sử dụng bởi hơn 60.000 kho và được quản lý bởi Agentic AI Foundation của Linux Foundation.

Đặt các hướng dẫn chung vào đây — những điều mà mọi công cụ AI nên biết: cấu trúc và kiến trúc dự án, lệnh build và test, quy ước coding.

CLAUDE.md: Bộ Nhớ Của Claude Code

Tốt nhất cho: Người dùng Claude Code

CLAUDE.md được đọc tự động khi bắt đầu mỗi phiên Claude Code. Sử dụng cho: tinh chỉnh hành vi đặc thù của Claude, các tính năng chỉ Claude Code hỗ trợ.

Mẫu được khuyến nghị: quy tắc chung trong AGENTS.md, bổ sung đặc thù Claude trong CLAUDE.md.

Thiết Lập Được Khuyến Nghị

your-project/
  AGENTS.md              # Chung: lệnh build, kiến trúc, quy ước
  CLAUDE.md              # Claude: tùy chọn bộ nhớ, sử dụng công cụ
  .cursor/rules/style.md # Cursor: hành vi composer
  .github/copilot-instructions.md  # Copilot

Những Gì Cần Đưa Vào Quy Tắc

Luôn bao gồm: Cách build và chạy dự án, cách chạy test, quyết định kiến trúc chính, tùy chọn coding style.

Bỏ qua: Tính năng ngôn ngữ hiển nhiên, thứ AI đã biết, quy tắc quá chi tiết.

Xây Dựng Quy Tắc AI Với Bối Cảnh Web

Viết file hướng dẫn AI tốt thường cần tham chiếu tài liệu bên ngoài, hướng dẫn coding style. Sử dụng Save để chuyển đổi trang tài liệu sang Markdown, tham chiếu các phần liên quan trong AGENTS.md.

Save chuyển đổi bất kỳ trang web nào sang Markdown sạch — hoàn hảo để xây dựng tài liệu tham khảo mà trợ lý coding AI của bạn cần. Dùng thử Save miễn phí.