Tệp chỉ dẫn cho agent
Mỗi coding agent đều tải một tệp chỉ dẫn cố định của dự án trước khi bắt đầu làm việc. Tại đây, bạn sẽ biết từng công cụ tìm tệp ở đâu, hỗ trợ những frontmatter nào và các bản toàn cục, theo dự án và lồng nhau kết hợp ra sao. Thông tin đã được đối chiếu với tài liệu của nhà cung cấp vào 2026-10-01.
Công cụ nào đọc tệp nào
| Công cụ | Đọc | AGENTS.md |
|---|---|---|
| OpenAI Codex | AGENTS.mdAGENTS.override.md~/.codex/AGENTS.md | Tích hợp sẵn |
| Claude Code | CLAUDE.mdCLAUDE.local.md.claude/rules/*.md~/.claude/CLAUDE.mdAGENTS.md | Tích hợp sẵn |
| Cursor | .cursor/rules/*.mdcAGENTS.md | Tích hợp sẵn |
| GitHub Copilot | .github/copilot-instructions.md.github/instructions/*.instructions.mdAGENTS.mdCLAUDE.mdGEMINI.md | Tích hợp sẵn |
| Gemini CLI | GEMINI.md~/.gemini/GEMINI.md.gemini/settings.json | Qua cấu hình |
| Devin Desktop (formerly Windsurf) | .devin/rules/*.md.windsurf/rules/*.md.windsurfrules~/.codeium/windsurf/memories/global_rules.mdAGENTS.md | Tích hợp sẵn |
| Cline | .clinerules/*.md.cline/rules/*.mdAGENTS.md.cursorrules.windsurfrules | Tích hợp sẵn |
| Aider | .aider.conf.yml | Qua cấu hình |
| OpenClaw | AGENTS.mdSOUL.mdIDENTITY.mdUSER.mdMEMORY.md | Tích hợp sẵn |
Dùng một tệp AGENTS.md duy nhất làm nguồn thông tin chuẩn và trỏ các tool còn lại đến đó. Bảy trong số chín tool ở trên đọc được tệp này mà không cần cấu hình thêm; Gemini CLI và Aider cần thêm một dòng cấu hình, còn tệp CLAUDE.md chỉ chứa @AGENTS.md sẽ giúp các phiên bản Claude Code cũ hơn dùng đúng hướng dẫn. Chỉ dùng định dạng rule riêng của từng tool cho các rule áp dụng theo đường dẫn mà AGENTS.md không thể biểu đạt.
Tất cả tệp hướng dẫn
AGENTS.mdAGENTS.md
AGENTS.md là tệp hướng dẫn dự án ở định dạng Markdown thuần, được hầu hết coding agent đọc mà không cần cấu hình thêm. OpenAI đã đóng góp tệp này cho Agentic AI Foundation thuộc Linux Foundation; hơn 60k dự án mã nguồn mở đang sử dụng.
CLAUDE.mdCLAUDE.md (Claude Code)
CLAUDE.md là tệp ghi nhớ mà Claude Code tải khi khởi chạy từ thư mục home, dự án và mọi thư mục cha. Các quy tắc theo đường dẫn trong .claude/rules/ bổ sung hướng dẫn chỉ được tải khi đọc các tệp khớp với quy tắc.
GEMINI.mdGEMINI.md (Gemini CLI)
GEMINI.md là tệp context mà Gemini CLI gửi kèm mỗi prompt. Tệp này cũng có thể đọc AGENTS.md hoặc tên tệp khác do bạn đặt trong context.fileName.
.cursor/rules/*.mdcCursor Project Rules (.cursor/rules/*.mdc)
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.
.github/copilot-instructions.mdGitHub Copilot custom instructions
GitHub Copilot đọc một tệp áp dụng cho toàn bộ repository là .github/copilot-instructions.md, cùng với các tệp .instructions.md dành riêng cho từng đường dẫn. Công cụ này cũng tuân theo AGENTS.md hoặc một tệp CLAUDE.md hay GEMINI.md duy nhất ở thư mục gốc.
.devin/rules/*.mdDevin Desktop (Windsurf) rules
Devin Desktop, tên mới của Windsurf kể từ 2026-06-02, đọc các tệp rule trong .devin/rules/ và vẫn hỗ trợ .windsurf/rules/ cùng tệp .windsurfrules cũ. Trigger của mỗi rule quyết định rule luôn được áp dụng, được kích hoạt khi khớp glob, do model chọn hay được gọi thủ công.
.clinerules/Cline Rules (.clinerules/)
Cline Rules là các tệp Markdown trong .clinerules/ mà Cline kết hợp với rule toàn cục và AGENTS.md. Frontmatter paths không bắt buộc có thể giới hạn một rule chỉ áp dụng cho các tệp khớp.
~/.openclaw/workspace/AGENTS.mdOpenClaw workspace bootstrap files
OpenClaw tạo ngữ cảnh cho mỗi agent từ các tệp Markdown khởi tạo trong workspace, trong đó AGENTS.md là tệp bắt buộc. Các tệp này được đưa vào system prompt ở lượt đầu tiên của mỗi phiên mới.