AkiDevRule

Cài một lệnh, baseline đầy đủ

Một lệnh npx @akinet/akidevrule@latest 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 node install.mjs từ bản checkout local (Node 18+). 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, test); METHOD-*.md là khung tư duy phân tích, nặng, chỉ nạp khi tác vụ thật sự cần; từ 3.6.0 không còn file manifest index.md, router akirule là nơi duy nhất liệt kê các route.

Định tuyến theo nghĩa, có cổng chặn

Chỉ hai file thường trú, nạp mọi phiên qua @-import trong CLAUDE.md: RULE-agent-behavior.md và router akirule. Mọi rule khác được định tuyến theo nghĩa của tác vụ (lĩnh vực chạm tới và hành động: tạo, quyết định, audit, ship) bằng bất kỳ ngôn ngữ nào, nên một cách diễn đạt khác vẫn route đúng. Trên Claude Code, hook PreToolUse aki-route-guard bảo đảm bước Read: lần Edit/Write đầu tiên của mỗi loại file (code, .md, CHANGELOG.md, .vue/.css, .rs, .sql, locales/, file test) bị từ chối cho tới khi rule tương ứng đã được đọc sau lần nén ngữ cảnh gần nhất. Hook gặp lỗi thì bỏ qua (fail-open), tắt bằng AKI_ROUTE_GUARD=0. Lượt chỉ đọc, đếm hay giải thích không nạp thêm gì.

akiflow — hội đồng agent do một lead điều phối

Lead ghim nguyên văn lời chủ dự án làm mỏ neo bất biến của phiên, tách yêu cầu thành các hạng mục mà mỗi hạng mục phải trích lại một mảnh của lời đó, rồi triệu tập ghế từ năm agent definition đã cài — mỗi ghế truy được về một yêu cầu, không chọn từ menu. Ba chế độ phân biệt bằng đúng một câu hỏi, cái gì thay đổi bên ngoài phòng họp: discuss, audit (chỉ đọc), execute (chỉ aki-maker được ghi). Script kiểm tra từ chối đóng phiên khi thiếu mỏ neo, khi một yêu cầu không trích được chữ nào, hoặc khi một ghế đã khai báo mà không hề phát biểu.

Mười một skill, mỗi skill làm sắc một việc

akirule (định tuyến rule tự động), akiflow (hội đồng agent), 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 thành một REPORT.html tự chứa), akihelp (giới thiệu hệ thống đã 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, stage theo path, không bao giờ git add -A hay tự push), aki-article-writer (pipeline viết bài kèm subagent riêng đi tìm và xử lý ảnh), akidevsync-notes (đọc/sửa danh sách việc của Aki Dev Sync), akilint (quét cơ học lỗi bẻ dòng và comment lảm nhảm), akiship (chạy trọn nghi thức release bằng một lệnh, tự chủ theo hợp đồng B8, chỉ dừng khi gặp mơ hồ lịch sử công khai hay mâu thuẫn thiết kế), akiopen (bản tóm tắt đầu phiên, chỉ báo những việc còn dở, tối đa bảy mục, chỉ đọc).

Một bộ não, ba 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 ba 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õ; Triggered self-run (mới ở 3.1.0) — tự chạy không tương tác khi gặp một trong sáu điều kiện bắt buộc của agent.A3 (sắp hỏi/leo thang, hành động khó đảo ngược, xung đột rule, …), độ sâu co giãn theo độ khó, kết thúc bằng quyết định-và-báo-cáo hoặc leo thang; 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 (npx @akinet/akidevrule@latest hoặc git pull && node install.mjs). Nó không bao giờ tự tải hay tự cài bất cứ thứ gì.