AkiDevRule Là Gì?

AkiDevRule là một bộ rule corpus (kho quy tắc hành vi) cộng với một bộ skill dùng chung, do Lạc Việt Anh phát triển và duy trì công khai trên GitHub. Mục tiêu của nó rất cụ thể: một lệnh cài đặt duy nhất biến một máy mới hoàn toàn thành baseline làm việc đầy đủ cho Claude Code, Antigravity/Gemini, Codex CLI, Kiro CLI và Grok CLI — thay vì phải copy-paste system prompt, rule, và skill riêng lẻ cho từng công cụ AI một cách thủ công và dễ lệch nhau theo thời gian.

Đây không phải một web app hay mini-app chạy trên trình duyệt như phần lớn công cụ khác trong hệ sinh thái AkiNet. AkiDevRule là một công cụ dev-tooling thuần túy, chạy hoàn toàn trong terminal, dành cho người dùng Claude Code và các AI CLI khác — không có giao diện đồ họa, không cần tài khoản, không thu thập dữ liệu.

Vì Sao AkiDevRule Ra Đời?

Khi làm việc song song với nhiều công cụ AI CLI khác nhau, rule hành vi (không tạo commit rác, không tự ý sửa file ngoài phạm vi, cách viết comment, cách xử lý lỗi...) rất dễ bị viết trùng lặp ở nhiều nơi — mỗi công cụ một bản CLAUDE.md, GEMINI.md riêng, chỉnh một chỗ quên chỗ khác. AkiDevRule giải quyết đúng vấn đề Single Source of Truth này: toàn bộ rule được viết một lần trong một repo Git, sau đó installer sinh ra bản phù hợp cho từng CLI đích.

AkiDevRule Cài Đặt Những Gì?

  • Rule corpus (payload/*.md): các file RULE-*.md (ràng buộc hành vi: agent behavior, coding, pattern, docs, content, SEO, release, DB design, biz...) và METHOD-*.md (khung phân tích: deep-think, flow-audit, ux-psych, proportionality...). Với Claude Code, nhóm cốt lõi (RULE-agent-behavior.md, RULE-coding.md, RULE-pattern-core.md, index.md) được nạp cứng qua @-import trong ~/.claude/CLAUDE.md, áp dụng mọi phiên làm việc mà không cần model tự quyết định gọi skill.
  • 10 skill dùng chung theo chuẩn mở SKILL.md: akirule (router rule theo tín hiệu), akiflow (hội đồng agent điều phối), akiship (chạy trọn quy trình release), akigitcommit, akithink, akihelp, akilint, akihtmlreport, aki-article-writer, akidevsync-notes. Vì SKILL.md là chuẩn mở, nhóm skill này đồng bộ được sang cả Codex CLI, Kiro CLI và Grok CLI, không chỉ Claude Code.
  • 5 agent định nghĩa sẵn (Claude Code only, do định dạng agent hiện chỉ có một CLI hỗ trợ): aki-hands (chỉ đọc), aki-judge, aki-conduct, aki-challenger, aki-maker (agent duy nhất được cấp quyền ghi file).

AkiDevRule Cài Ở Đâu Trên Máy?

Installer là một chương trình Python duy nhất (install.py, không phụ thuộc rsync/find/awk), gọi qua install.sh (Unix) hoặc install.ps1 (Windows). Nó đồng bộ rule corpus vào ~/.aki/akidevrule, deploy skill vào ~/.claude/skills/ và các thư mục skill tương ứng của từng CLI, copy 5 agent vào ~/.claude/agents/ theo từng file (không xoá agent của riêng bạn), và cập nhật ~/.claude/CLAUDE.md/settings.json. Mỗi lần đồng bộ chỉ đụng đúng những file/thư mục do AkiDevRule quản lý — không phải một cú xoá nguyên thư mục.

AkiDevRule Có Phải Auto-Updater Không?

Không. Repo Git là nguồn sự thật duy nhất; sửa rule ở đó rồi tự tay chạy lại installer. Máy đã cài chỉ nhận một thông báo (không tự tải, không tự cài) khi bản public có phiên bản mới hơn, kiểm tra tối đa một lần mỗi 24 giờ và fail-silent nếu kiểm tra thất bại.

Cài Đặt Nhanh

curl -fsSL https://raw.githubusercontent.com/lacvietanh/akidevrule/master/install.sh | bash

Xem chi tiết từng bước cài đặt cho macOS, Linux, Windows tại bài Cài Đặt AkiDevRule Cho Claude Code, hoặc tìm hiểu sâu hơn cơ chế nạp rule tại bài Rule Corpus Và Skill Của AkiDevRule Hoạt Động Ra Sao. Mã nguồn đầy đủ, README chi tiết và CHANGELOG tại github.com/lacvietanh/akidevrule.