AkiDevRule

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, RULE-pattern-core) 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/akidevrule/ khi tín hiệu khớp. Đây cũng là lý do bốn file core được nâng lên @-import: một rule chỉ nạp khi model quyết định gọi skill thì không bao giờ là bảo đảm.

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 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ế).

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ì.