Rule cho AI coding agent: CLAUDE.md, AGENTS.md và Agent Skills
Rule cho AI coding agent là các file như CLAUDE.md, AGENTS.md và Agent Skills giúp agent bám kiến trúc, bớt lặp lệnh. Vì sao nhồi quá nhiều rule lại phản tác dụng và cách làm đúng.
Rule cho AI coding agent (rule cho ai coding agent) là những chỉ dẫn bền vững bạn đặt sẵn để agent lập trình — Claude Code, Cursor, Codex, Antigravity — bám đúng kiến trúc, quy ước và lệnh build/test của dự án, thay vì phải nhắc lại mỗi phiên. Ba dạng phổ biến nhất lúc này là file CLAUDE.md, file AGENTS.md và Agent Skills. Cả ba đều nhắm một đích: tiêm quy tắc xác định vào một agent vốn phi xác định.
CLAUDE.md và AGENTS.md khác gì nhau?
CLAUDE.md do Claude Code phổ biến: một file markdown ở gốc repo cung cấp bối cảnh dự án, lệnh build/test và ràng buộc hành vi. AGENTS.md là chuẩn chung đa công cụ, được nhiều trình hỗ trợ (Codex, Cursor, Copilot, Gemini CLI, Windsurf, Zed) — một file cấu hình cho nhiều agent. Nhiều đội giữ cả hai: CLAUDE.md cho Claude Code, AGENTS.md cho phần còn lại, hoặc import chéo để khỏi trôi lệch.
Vì sao nhồi quá nhiều rule lại làm agent tệ đi?
Nhiều người than "AI bỏ qua rule của tôi". Gốc rễ thường là hai lỗi đối nghịch: rule nhét hết vào một file khổng lồ nuốt sạch ngữ cảnh (token bloat) khiến model loãng; hoặc rule giấu trong một skill không bao giờ được gọi nên chưa từng được nạp.
Nguyên tắc: rule nào bắt buộc phải đúng mọi lúc thì phải nằm ở chỗ luôn được nạp (như @-import trong CLAUDE.md); cái nào để router quyết định thì chỉ là best-effort. Nhồi thêm không bằng đặt đúng chỗ.
Agent Skills: nạp rule đúng lúc thay vì nhồi hết
Agent Skills giải bài toán token bloat bằng tiết lộ dần (progressive disclosure): agent chỉ giữ sẵn phần mô tả ngắn của mỗi skill, và chỉ nạp toàn bộ nội dung khi tác vụ khớp tín hiệu. Một bộ router đọc tín hiệu trong lời yêu cầu rồi mới kéo đúng rule cần — giữ ngữ cảnh gọn mà vẫn đủ luật.
Làm sao có baseline rule tốt mà không mất công tự dựng?
AkiDevRule là một baseline mã nguồn mở (MIT) làm sẵn việc này cho Claude Code và Antigravity: cài một lệnh, bạn có một kho rule tự định tuyến theo tín hiệu (bốn file core luôn nạp qua @-import, phần còn lại đọc khi khớp), cùng mười skill mỗi skill làm sắc một việc. Đúng triết lý ở trên: luật bắt buộc thì @-import, luật theo bối cảnh thì router.
Viết rule tốt không chỉ là thêm luật mà là quản trị agent: chống tự duyệt vai (role-collapse), chống nịnh (sycophancy) và cổng kích hoạt cho hội đồng agent. Đọc thêm giải pháp chống sycophancy và cổng kích hoạt agent council.