Nếu bạn đã sử dụng trợ lý lập trình AI gần đây, bạn có thể đã nhận thấy điều gì đó: tất cả chúng đều muốn có một tệp Markdown.

GitHub Copilot đọc .github/copilot-instructions.md. Cursor đọc .cursor/rules/. Claude Code đọc CLAUDE.md. Windsurf đọc .windsurf/rules. Google’s Jules đọc JULES.md. Và tiêu chuẩn phổ quát? AGENTS.md --- hiện được sử dụng bởi hơn 60.000 kho lưu trữ mã nguồn mở và được quản lý bởi Agentic AI Foundation của Linux Foundation.

Markdown đã tiến hóa từ định dạng tài liệu thành hệ điều hành cho các tác nhân lập trình AI.

AGENTS.md Là Gì?

AGENTS.md là một tệp Markdown đơn giản, định dạng mở, tồn tại trong kho lưu trữ của bạn và hoạt động như gói tóm tắt cho các tác nhân lập trình AI. Hãy nghĩ về nó như đối tác của README.md:

README.md dành cho con người: bắt đầu nhanh, mô tả dự án, huy hiệu
AGENTS.md dành cho các tác nhân AI: các bước xây dựng, lệnh kiểm tra, quy ước mã, quyết định kiến trúc

Tác nhân đọc tệp gần nhất trong cây thư mục, vì vậy tệp gần nhất sẽ được ưu tiên. Mỗi dự án con có thể cung cấp các hướng dẫn tùy chỉnh.

CLAUDE.md Là Gì?

CLAUDE.md dành riêng cho Claude Code của Anthropic. Nó được đọc tự động vào đầu mỗi phiên và chứa các hướng dẫn dành riêng cho dự án mà bạn nếu không sẽ phải lặp lại trong mỗi lần nhắc.

Một CLAUDE.md tốt thường bao gồm:

Ngữ cảnh dự án: Một dòng mô tả ngắn gọn để Claude hiểu dự án làm gì
Phong cách mã: Sở thích định dạng, quy ước đặt tên, các mẫu cần tuân theo
Lệnh: Cách chạy kiểm tra, xây dựng, lint và triển khai
Ghi chú kiến trúc: Các quyết định chính mà Claude nên tôn trọng

Cách tiếp cận được khuyến nghị: đặt các hướng dẫn chung trong AGENTS.md (để tất cả các công cụ AI đều được hưởng lợi), sau đó thêm các tính năng dành riêng cho Claude vào CLAUDE.md.

Toàn Cảnh Các Tệp Hướng Dẫn AI

Đây là mọi công cụ lập trình AI chính và quy ước Markdown của nó:

Công cụ	Tệp	Định dạng
GitHub Copilot	`.github/copilot-instructions.md`	Markdown
Cursor	`.cursor/rules/*.md`	Markdown
Claude Code	`CLAUDE.md`	Markdown
Windsurf	`.windsurf/rules`	Markdown
Google Jules	`JULES.md`	Markdown
Phổ quát	`AGENTS.md`	Markdown

Chú ý mô hình? Tất cả đều là Markdown. Không có ngoại lệ.

Tại Sao Markdown Thắng

Markdown là định dạng hoàn hảo cho các tệp hướng dẫn AI vì:

LLM hiểu nó một cách tự nhiên --- đây là định dạng phổ biến nhất trong dữ liệu huấn luyện của chúng
Dễ đọc cho con người --- các nhà phát triển có thể xem xét và chỉnh sửa hướng dẫn dễ dàng
Có thể kiểm soát phiên bản --- tồn tại trong git cùng với mã của bạn
Nhẹ --- không có chi phí phân tích, không cần công cụ đặc biệt
Phổ quát --- hoạt động trên mọi công cụ AI, trình soạn thảo và nền tảng

Như Visual Studio Magazine đã nói: trong AI agentic, tất cả đều là về Markdown.

Các Thực Hành Tốt Nhất Để Viết Hướng Dẫn Tác Nhân

Dựa trên phân tích hàng nghìn kho lưu trữ:

Bắt đầu tối thiểu. Chỉ thêm quy tắc khi bạn thấy tác nhân liên tục mắc cùng một lỗi. Các hướng dẫn được chỉ định quá mức có thể gây nhầm lẫn hơn là giúp đỡ.

Cụ thể về các lệnh. Đừng nói “chạy kiểm tra” --- hãy nói pnpm test hoặc pytest -x tests/.

Ghi lại kiến trúc của bạn. Nếu dự án của bạn sử dụng một mẫu cụ thể (như truyền tin giữa content script và service worker), hãy giải thích. Tác nhân không thể suy ra các quyết định kiến trúc từ mã.

Bao gồm những gì KHÔNG nên làm. Các hướng dẫn phủ định hiệu quả đáng ngạc nhiên: “Không bao giờ sửa đổi schema cơ sở dữ liệu trực tiếp” hoặc “Đừng sử dụng class components, luôn sử dụng hooks.”

Save Phù Hợp Vào Thế Giới Này Như Thế Nào

Nếu bạn đang xây dựng các tệp hướng dẫn tác nhân, bạn có thể cũng đang lưu tài liệu tham khảo từ web: trang tài liệu, câu trả lời Stack Overflow, README GitHub, tài liệu tham khảo API.

Save chuyển đổi bất kỳ nguồn web nào sang Markdown sạch chỉ bằng một cú nhấp --- hoàn hảo để xây dựng ngữ cảnh mà các tác nhân AI của bạn cần. Lưu một trang tài liệu, dán Markdown vào AGENTS.md hoặc tài liệu tham khảo của bạn, và trợ lý lập trình AI của bạn ngay lập tức có ngữ cảnh cần thiết.

Quy trình:

Tìm tài liệu hoặc ví dụ mã hữu ích trên web
Nhấp Save để chuyển đổi sang Markdown
Tham khảo hoặc đưa vào tệp hướng dẫn tác nhân của bạn
Trợ lý lập trình AI của bạn hoạt động tốt hơn với mỗi lần lưu

Tương Lai: Markdown Như Bề Mặt Điều Khiển AI

Microsoft và GitHub hiện đang coi Markdown là bề mặt kiểm soát ổn định, có thể kiểm toán cho hành vi AI. Nó không chỉ là tài liệu nữa --- đây là giao diện giữa ý định của con người và thực thi của AI.

Chúng ta thấy các tệp Markdown đóng ba vai trò riêng biệt:

Tài liệu: Giải thích một hệ thống cho con người
Hướng dẫn: Ràng buộc và điều khiển hành vi AI
Kỹ năng: Gói hướng dẫn với tài nguyên để các tác nhân có thể lặp lại quy trình

Xu hướng này chỉ đang tăng tốc. Khi các trợ lý lập trình AI trở nên có khả năng hơn, các tệp Markdown hướng dẫn chúng trở nên quan trọng hơn.

Save chuyển đổi bất kỳ trang web nào thành Markdown sạch chỉ bằng một cú nhấp. Hoàn hảo để xây dựng thư viện tham khảo, thu thập tài liệu và tạo ngữ cảnh cho quy trình lập trình AI của bạn. Dùng thử Save miễn phí.