AkiDevRule
AkiDevRule qua AkiMCP: một bộ rule cho mọi MCP client
AkiMCP đưa rule AkiDevRule cho mọi MCP client qua một tool chỉ-đọc, aki__akidevrule_context, nên một chat web không có CLAUDE.md cục bộ vẫn bắt đầu với đúng bộ rule mà Claude Code dùng. Sau đó mọi tool có thể ghi đều từ chối chạy nếu thiếu biên nhận (receipt) mà lệnh gọi này trả về. AkiDevRule (của Lạc Việt Anh, repo lacvietanh/akidevrule) là bộ rule; AkiMCP là server chuyển bộ rule đó tới AI.
Gặp từ chưa biết? Những từ bạn sẽ gặp

MCP client nhận được gì từ aki__akidevrule_context?
MCP client nhận được bộ rule mà AI lập trình phải tuân theo, giao thành một kết quả tool thay vì file trên đĩa. AI rule (airule) là một file Markdown thường, chỉ cho AI lập trình cách làm việc trong dự án của bạn: viết code thế nào, khi nào phải hỏi, thứ gì không được đụng vào. Claude Code đọc CLAUDE.md, Codex đọc AGENTS.md, Gemini CLI đọc GEMINI.md. AkiDevRule đóng gói một bộ rule dùng chung, cài bằng npx @akinet/akidevrule@latest cho Claude Code, Codex, Gemini và Antigravity, Cursor, Kiro, Grok và OpenCode. Giấy phép MIT.
AkiMCP đưa AkiDevRule tới một MCP client bằng cách nào?
Một AI web như Claude, ChatGPT hay Grok không đọc được thư mục home của bạn, nên rule không tự tới được nó. AkiMCP lấp khoảng trống đó bằng ba bước.
- 1Server dặn mọi client, ngay trong instructions lúc khởi tạo, hãy gọi
aki__akidevrule_contextmột lần trước hành động thật đầu tiên, kèmworkingPathtuyệt đối nếu biết. - 2Tool tự ráp rule ngay trong server, từ các file thật đang có: không bắt model đọc từng file, không qua shell. AI nhận một kết quả gồm rule và biên nhận
sha256:…. - 3Sau đó AI chỉ đọc những file route mà tác vụ cần trong
~/.aki/akidevrule(AkiMCP cấp quyền thư mục này và~/.claude), đúng như router trong kết quả dặn.
Chính xác thì kết quả tool gồm những gì?
~/.claude/CLAUDE.mdtoàn cục với các@import được bung đúng chỗ, rồi routerakirule(SKILL.md) cùng bảng định tuyến của nó.- Có
workingPath: các fileCLAUDE.md,CLAUDE.local.md,AGENTS.mdvàGEMINI.mdtừ thư mục đó lên tới thư mục được phép chứa nó, rộng trước, sâu sau. Đường dẫn ngoài thư mục được phép bị từ chối. - Nguồn gốc: mỗi nguồn kèm đường dẫn, kích thước và sha256, một
status(ok,unchanged,degraded,error) và các cảnh báo như import vòng hay thiếu file lõi. - Hai tham số tùy chọn:
modeđặtexact-auditthêm đồ thị import và thứ tự ưu tiên, cònknownReceipttrảunchangedkhông kèm nội dung khi rule chưa đổi.
Nó chỉ đọc: không ghi, không chạy lệnh, không tải URL, và import trỏ tới URL hay dùng biểu thức shell đều bị từ chối.
Rule receipt chặn thế nào một AI đã bỏ qua rule?
Mọi tool AkiMCP không chỉ-đọc đều nhận tham số receipt và từ chối nếu không có receipt hiện hành. Lời từ chối nói rõ phải gọi gì tiếp.
RULE_RECEIPT_MISSING: không gửi receipt.RULE_RECEIPT_STALE: một file rule đã đổi từ lúc cấp.RULE_RECEIPT_UNKNOWN: server này chưa từng cấp, hoặc đã khởi động lại.RULE_RECEIPT_EVICTED: nó đã rơi khỏi 200 receipt được cấp hoặc được dùng gần nhất.- Tool ghi vào một dự án có
CLAUDE.mdhayAGENTS.mdriêng sẽ trả về rule của dự án đó (giới hạn 32 KiB) kèm receipt mới trước, rồi chạy khi được gọi lại. Tool đọc luôn chạy và thêm một dòng nêu tên các file đó.
Hiểu rõ giới hạn: receipt chứng minh rule do server này cấp và chưa đổi, không chứng minh AI đã làm theo. Nó chặn việc quên, không chặn người cố tình giả mạo.
AkiDevRule 3.8.0 đổi gì với người dùng MCP?
AkiDevRule 3.8.0 (20/10/2026) đổi bộ rule mà AI của bạn nhận qua tool này; lệnh gọi aki__akidevrule_context kế tiếp sau khi bạn cập nhật sẽ trả về chúng. Release Notes: AkiDevRule 3.8.0 Release Notes.
Hỏi thì trả lời, ra lệnh thì làm xong
AI trả lời câu hỏi và không sửa file nào. Trước lần ghi đầu tiên, nó phải chỉ ra chính câu chữ của bạn đã ra lệnh, và đã có lệnh thì làm đến cùng, không hỏi lại.
Yêu cầu là toàn bộ phạm vi
Pull request, push, deploy hay tag không ai yêu cầu sẽ không được làm chỉ vì đó là thói quen.
Mục mở mã hóa Q, T, N
Q cần bạn trả lời (im lặng là chặn), T là quyết định AI tự làm trong phạm vi lệnh (im lặng là tiếp tục), N là ghi chú (im lặng không đổi gì). Hết Q là bạn đọc xong.
Rule chỉ tính khi đọc trọn
Đọc một phần file rule không còn được tính, và cổng route trên Claude Code mở rộng nó thành đọc cả file. Cổng đó là hook của Claude Code; MCP client không có hook dựa vào receipt ở trên.
Một file route-map.json
Bản đồ đường dẫn tới rule giờ là file dữ liệu ~/.aki/akidevrule/route-map.json, thay ba bảng chép tay. Từ AkiMCP 3.1.0, lần đầu ghi một loại file trong chat sẽ mang theo các rule mà bản đồ này gán cho nó, nên AI web nhận đúng các rule theo route đó.
Bớt rác, trình cài gọn hơn
File tạm đi vào scratchpad hoặc không được tạo, và trình cài không để lại file *.akidevrule-backup-*. Cấu hình rtk là tùy chọn: câu hỏi mặc định là không, hoặc truyền --rtk.
Làm sao đưa AkiDevRule vào AkiMCP?
Chạy trình cài một lần trên máy chạy AkiMCP (Node.js 18 trở lên), hoặc bấm Install / update ở mục “Install AkiDevRule (optional)” của panel. Chạy lại là cập nhật. Chưa cài AkiDevRule thì tool vẫn trả lời, nhưng với trạng thái degraded vì thiếu file lõi.
# Cài hoặc cập nhật
npx @akinet/akidevrule@latest
# Chỉ kiểm tra, không đổi gì
npx @akinet/akidevrule@latest --check
Nguồn: trang dự án AkiDevRule, repository GitHub, gói npm và Release 3.8.0.