Ngày tạo: Cập nhật:
AkiDevRule — Claude Code + Antigravity agent baseline

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 | bash

Script 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ự động

Bộ định tuyến rule thông minh, chạy mọi hội thoại; ẩn khỏi menu /.

akiflow

/akiflow

Pipeline 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

/akithink

Phiê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

/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

/akigitcommit

Biế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: AkiDEVAki Dev Sync.

Câu hỏi thường gặp

AkiDevRule là gì?
AkiDevRule (trước đây tên AkiClaudeDoc) là gói baseline mã nguồn mở dùng chung cho Claude Code và Antigravity/Gemini. Chỉ một lệnh cài, nó biến môi trường agent mới tinh 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, mỗi skill làm sắc một việc.
Cài AkiDevRule như thế nào?
Chạy: curl -fsSL https://raw.githubusercontent.com/lacvietanh/akidevrule/master/install.sh | bash (lưu ý nhánh là master, không phải main). Ngoài ra có thể chạy bash install.sh từ bản checkout local. Script cố tình đơn giản — nên kiểm tra trước khi chạy.
Vì sao đổi tên từ AkiClaudeDoc?
Ngày 27/07/2026, repo đổi tên AkiClaudeDoc → akidevrule vì phạm vi mở rộng: không còn chỉ phục vụ Claude Code mà sinh từ một nguồn rule trung lập agent duy nhất, dùng chung cho cả Claude Code và Antigravity/Gemini. Link GitHub cũ tự động redirect sang tên mới.
AkiDevRule cài những gì và cài vào đâu?
payload/* được đồng bộ vào ~/.aki/claudedoc/ (loại trừ ref-ECC/), gồm index.md, mười hai file RULE-* và ba file METHOD-*. Các skill trong claude/skills/* được chép vào ~/.claude/skills/. Trình cài cũng thay ~/.claude/CLAUDE.md bằng bản đóng gói (sao lưu trước), tạo ~/.claude/CLAUDE.local.md chỉ khi chưa có (không bao giờ ghi đè sau đó — nơi để rule riêng từng máy), cập nhật ~/.claude/settings.json và cài hook aki-update-check.py.
akirule quyết định nạp rule nào, khi nào, ra sao?
Ba tầng với độ nhạy cố tình cao (thà nạp thừa vài token còn hơn sai hành vi). Tầng 1 core nạp mọi hội thoại: 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 là các METHOD phân tích (flow-audit, deep-think, ux-psych), chỉ nạp khi tác vụ thật sự cần phân tích.
Nó có tự động cập nhật máy tôi không?
Không. Nó chỉ báo, không tự cài. Một hook SessionStart so CHANGELOG đã cài với bản public (tối đa 1 lần/24h, thất bại thì im lặng, không chặn); khi có bản mới nó chỉ in phần thay đổi và lệnh cập nhật thủ công (git pull && bash install.sh). Repo Git là nguồn chân lý — không phải auto-updater, daemon hay package manager.
Gỡ AkiDevRule thế nào?
Xóa: rm -rf ~/.aki/claudedoc; rm -rf ~/.claude/skills/{akirule,akiflow,akithink,akihtmlreport,akihelp,akigitcommit}; rm -f ~/.claude/hooks/aki-update-check.py. Sau đó xóa khối AkiDevRule trong ~/.claude/CLAUDE.md và các mục của nó (permission, skillOverrides, hook SessionStart) trong ~/.claude/settings.json nếu muốn.

Một lệnh. Cùng baseline. Repo Git là nguồn chân lý.

Xem trên GitHub