AkiDevRule
Mã nguồn mởMột lệnh biến môi trường Claude Code hoặc Antigravity mới tinh thành baseline làm việc đầy đủ của Aki.
github.com/lacvietanh/akidevrule · Nhánh master · Claude Code + Antigravity
Trước đây tên AkiClaudeDoc — đổi tên 27/07/2026.
AkiDevRule (trước đây AkiClaudeDoc) là gói baseline agent mã nguồn mở (giấy phép MIT, công khai từ 22/05/2026), dùng chung cho Claude Code và Antigravity/Gemini. Một lệnh cài duy nhất biến môi trường agent mới thành baseline làm việc đầy đủ của Aki: một kho rule chung tự nạp đúng thời điểm, cùng một bộ sáu skill nhỏ gọn — mỗi skill làm một việc thật sắc. Kho rule theo quy ước đặt tên chặt (RULE-* là ràng buộc, METHOD-* là khung tư duy) và được skill akirule định tuyến theo ba tầng. Repo GitHub là nguồn chân lý duy nhất. Nó không phải auto-updater, daemon, package manager hay control plane.
Cài đặt — một lệnh duy nhất (nhánh master)
curl -fsSL https://raw.githubusercontent.com/lacvietanh/akidevrule/master/install.sh | bashScript cố tình đơn giản — nên đọc trước khi chạy.
- Cài một lệnh curl (nhánh master), hoặc bash install.sh từ bản checkout local
- Dùng chung cho Claude Code và Antigravity/Gemini — sinh từ một nguồn rule trung lập agent duy nhất
- Kho rule tự định tuyến: 12 file RULE-* (ràng buộc) + 3 METHOD-* (khung phân tích) + index.md
- Bộ định tuyến akirule ba tầng, độ nhạy cố tình cao — thà nạp thừa còn hơn sai hành vi
- Sáu skill, mỗi skill làm sắc một việc: akirule, akiflow, akithink, akihtmlreport, akihelp, akigitcommit
- Thông báo cập nhật chỉ báo — không tự tải, không tự cài, không daemon
- Mã nguồn mở (giấy phép MIT) từ 22/05/2026 — repo GitHub là nguồn chân lý
- Đổi tên từ AkiClaudeDoc → akidevrule ngày 27/07/2026, mở rộng phạm vi sang Antigravity
Điểm cốt lõi
Cài một lệnh, baseline đầy đủ
Một lệnh curl biến môi trường Claude Code hoặc Antigravity mới thành baseline làm việc đầy đủ của Aki. Cũng có thể chạy bash install.sh từ bản checkout local. Script cố tình đơn giản để bạn tự kiểm tra trước khi chạy.
Một nguồn, hai agent
Kho rule sinh từ một nguồn trung lập agent duy nhất, dùng chung cho cả Claude Code và Antigravity/Gemini — không phải hai bộ rule tách rời dễ trôi lệch nhau. Đổi tên từ AkiClaudeDoc sang akidevrule (27/07/2026) đánh dấu đúng bước mở rộng phạm vi này.
Kho rule tự định tuyến theo tên
Quy ước đặt tên chặt: RULE-*.md là ràng buộc (điều agent phải/không được làm — behavior, coding, docs, content, stack, UI, SEO, release, DB design, business); METHOD-*.md là khung tư duy phân tích, nặng, chỉ nạp khi tác vụ thật sự cần; index.md giữ manifest, thứ tự ưu tiên và chính sách gắn dự án.
Bộ định tuyến akirule ba tầng
akirule định tuyến với độ nhạy cố tình cao (thà nạp thừa): Tầng 1 core nạp mọi hội thoại (index.md, RULE-agent-behavior, RULE-coding) qua cú pháp embed @path; Tầng 2 contextual đọc khi khớp tín hiệu; Tầng 3 là các METHOD phân tích. Không có "harness magic" — Tầng 2–3 chỉ là chỉ dẫn bảo agent Read file từ ~/.aki/claudedoc/ khi tín hiệu khớp.
akiflow — pipeline giao việc đa agent theo cấp độ
Skill mới nhất: một cổng phân cấp (sizing gate) nghiêm ngặt xếp yêu cầu vào Tier 0 (làm trực tiếp, mặc định), Tier 1 (Architect lập kế hoạch + Reviewer phản biện), hoặc Tier 2 (thêm cố vấn business/UX) — chỉ triệu tập đúng những chuyên gia tầng đó cần, bàn giao qua file docs/ chứ không qua ngữ cảnh chat.
Sáu skill, mỗi skill làm sắc một việc
akirule (bộ định tuyến rule tự động), akiflow (pipeline giao việc đa agent theo cấp độ), akithink (phiên tư duy sâu 5 pha, kết thúc bằng decision record trong docs/), akihtmlreport (đúc phân tích dày trong hội thoại thành một REPORT.html tự chứa), akihelp (giới thiệu hệ thống Aki đã cài, dựng lúc chạy nên không bao giờ lỗi thời), akigitcommit (biến working tree lộn xộn thành vài commit Conventional gọn gàng, stage theo path, không bao giờ git add -A hay tự push).
Một bộ não, hai chế độ tư duy
METHOD-deep-think.md là một bộ não phân tích duy nhất (đào mục tiêu, first principles, phê phán bắt buộc, lăng kính techbiz có điều kiện) dùng hai cách: Passive — akirule tự nạp inline khi tác vụ thường chạm tín hiệu ("có nên…", "có đáng…"), áp dụng ngắn, tối đa một câu hỏi làm rõ; Active — chạy /akithink để đi qua đúng METHOD đó theo protocol 5 pha ở độ sâu tối đa.
Thông báo cập nhật — chỉ báo, không tự cài
Một hook SessionStart so CHANGELOG.md đã cài với bản public trên repo (tối đa 1 lần/24h, thất bại thì im lặng, không chặn). Khi bản remote mới hơn, nó chỉ in phần thay đổi và lệnh cập nhật thủ công (git pull && bash install.sh). Nó không bao giờ tự tải hay tự cài bất cứ thứ gì.
Bộ định tuyến akirule — ba tầng
Tầng 1 — Core
Nạp mọi hội thoại qua embed @path: index.md, RULE-agent-behavior.md, RULE-coding.md.
Tầng 2 — Contextual
Đọc khi khớp tín hiệu: design-core, docs, content-write, stack-akiNuxtCf, stack-tauri, ui-pattern, seo, release, db-design, biz.
Tầng 3 — Methods
Khung phân tích, chỉ nạp khi tác vụ thật sự cần: METHOD-flow-audit, METHOD-deep-think, METHOD-ux-psych.
Sáu skill, mỗi skill làm sắc một việc
akirule
tự độngBộ định tuyến rule thông minh, chạy mọi hội thoại; ẩn khỏi menu /.
akiflow
/akiflowPipeline giao việc đa agent theo cấp độ — Tier 0 trực tiếp, Tier 1 Architect + Reviewer, Tier 2 thêm cố vấn business/UX.
akithink
/akithinkPhiên tư duy sâu 5 pha, kết thúc bằng decision record trong docs/.
akihtmlreport
/akihtmlreportĐúc phân tích dày trong hội thoại thành một REPORT.html tự chứa.
akihelp
/akihelpGiới thiệu hệ thống Aki đã cài, dựng lúc chạy nên không bao giờ lỗi thời.
akigitcommit
/akigitcommitBiến working tree lộn xộn thành vài commit Conventional gọn; stage theo path, không git add -A, không tự push.
Người phát triển
Lạc Việt Anh — người sáng lập hệ sinh thái Aki. AkiDevRule đúc kết cách anh làm việc cùng agent AI (Claude Code, Antigravity) trên toàn hệ sinh thái thành một baseline dùng chung, và phát hành mã nguồn mở theo giấy phép MIT để cộng đồng có thể tham khảo, tái sử dụng.
AkiDevRule thuộc lớp công cụ dev của hệ sinh thái, gắn với AkiDEV (dev.akitao.com) — nơi đặt trang docs và bản wrapper cài đặt. Xem thêm các dự án liên quan: AkiDEV và Aki Dev Sync.
Câu hỏi thường gặp
AkiDevRule là gì?
Cài AkiDevRule như thế nào?
Vì sao đổi tên từ AkiClaudeDoc?
AkiDevRule cài những gì và cài vào đâu?
akirule quyết định nạp rule nào, khi nào, ra sao?
Nó có tự động cập nhật máy tôi không?
Gỡ AkiDevRule thế nào?
Một lệnh. Cùng baseline. Repo Git là nguồn chân lý.
Xem trên GitHub