AI ToolingFoundationakidevrule

Claude Code · Antigravity · Smart Router · Rules

akidevrule: Chia Sẻ Rule và Skill Baseline Giữa Các Dự Án

Cách đóng gói rule, skill, và hướng dẫn hệ thống thành gói cài đặt tái sử dụng chung cho cả Claude Code và Antigravity/Gemini.

Cốt lõi: Một mã nguồn (source of truth) duy nhất sinh ra cấu hình tương thích cho cả Claude Code và Antigravity/Gemini. Smart router tự nạp rule cần thiết, 7 skill dùng chung.

Vấn đề: Phân mảnh rule giữa các Agent

Copy-paste thủ công

CLAUDE.md hoặc GEMINI.md bị sao chép tay giữa các dự án, dẫn đến phiên bản lỗi thời (drift) ở từng nơi.

Context bloat

Nạp toàn bộ quy tắc vào mọi session làm cạn token và khiến AI loãng tập trung thay vì chỉ nạp những gì cần.

Mâu thuẫn engine

Claude Code và Antigravity có cách đọc file khác nhau. Viết rule 1 lần nhưng làm sao áp dụng tốt cho cả hai?

Giải pháp: Một gói, một lệnh cài đặt

akidevrule là Git repo chứa toàn bộ rule corpus và skill definition (open standard). Chạy một lệnh để biến máy tính trắng thành môi trường tiêu chuẩn cho 2 agent.

One-line install

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

Wrapper qua dev.akitao.com

curl -fsSL https://dev.akitao.com/claudedoc/install.sh | bash

Hoặc từ local checkout

git clone https://github.com/lacvietanh/akidevrule
cd akidevrule && bash install.sh

Script cố tình đơn giản. Git repo là nguồn sự thật; lệnh cài đặt chỉ là công cụ phân phối file đến đúng vị trí.

Kiến trúc: Phân phối đa Agent

Shared (~/.aki/akidevrule/)

Rule corpus trung lập (Nguồn sự thật).

RULE-*.md: constraint rules
METHOD-*.md: analytical frameworks
agskills/: shared skill tree cho AG

Agent Specific

Cấu hình riêng cho 2 nền tảng.

Claude Code: ~/.claude/skills/ và CLAUDE.md
Antigravity: ~/.gemini/config/rules/ và GEMINI.md overrides

repo/payload/   → install.sh → ~/.aki/akidevrule/ (Raw rules)
repo/skills/    → install.sh → ~/.claude/skills/ VÀ ~/.gemini/config/skills/ (7 SKILLS CHUNG)
repo/claude/    → install.sh → ~/.claude/ (CLAUDE.md)
repo/payload/GEMINI.md → install.sh → ~/.gemini/GEMINI.md (Antigravity Behavior Overrides)

7 Skill Đi Kèm

Bộ công cụ open standard SKILL.md được hỗ trợ trên cả Claude Code và Antigravity.

Skill	Kích hoạt	Mục đích
akirule	tự động, mọi conversation	Smart rule router 3 tầng. Ẩn khỏi menu / theo thiết kế.
akiflow	/akiflow	Agent council có điều phối viên cho quyết định phức tạp. Chứa các subagent chuyên biệt, audit phân luồng, chạy trong workspace riêng.
akithink	/akithink	Phiên deep-think có cấu trúc 5 pha cho quyết định lớn, khó đảo ngược — chốt bằng decision record.
akihtmlreport	/akihtmlreport	Kết tinh phân tích từ hội thoại thành file REPORT.html cực rộng, tự chứa, không rơi rớt chi tiết.
akihelp	/akihelp	Giới thiệu trực tiếp toàn bộ hệ thống Aki đang cài đặt, đọc file thật tại runtime — không bao giờ lỗi thời.
akigitcommit	/akigitcommit	Biến working tree lộn xộn thành Conventional Commit gọn gàng, triage file đang dở dang. Không bao giờ tự push.
aki-article-writer	/aki-article-writer	Pipeline viết bài hoàn chỉnh: research, SEO, schema. Tự động spawn Image Scout subagent chuyên làm ảnh.

Smart Router: 3 tầng load thông minh

Tier 1: Core

Luôn load

Nhúng cứng vào mọi conversation. Load 100% không phụ thuộc tín hiệu.

index.mdRULE-agent-behavior.mdRULE-coding.md

Tier 2: Contextual (on-signal)

On demand

Tự động đọc khi task khớp trigger (độ nhạy cao). Bao gồm cả constraint rules lẫn analytical frameworks.

RULE-design-core.mdRULE-ui-pattern.mdRULE-docs.mdRULE-content-write.mdRULE-stack-*.mdRULE-seo.mdRULE-release.mdRULE-db-design.mdRULE-biz.mdMETHOD-*.md

Tier 3: Full load

On demand

Escape hatch tường minh: gõ đúng cụm này để ép đọc toàn bộ RULE-*.md và METHOD-*.md cùng lúc.

nạp fullload all rules

Một bộ não, hai chế độ: Deep Think

METHOD-deep-think.md là bộ khung phân tích chuẩn (khơi mục tiêu, nguyên tắc đầu tiên, phản biện bắt buộc). Được dùng qua 2 cách:

1. Passive (Bị động) Smart router akirule tự động nạp inline khi hội thoại có tính chất phân tích ("có nên...", "tradeoff ra sao..."). Agent sẽ suy nghĩ ngắn gọn. Nếu nhận thấy quyết định lớn, Agent bị ép phải đề xuất người dùng mở chế độ Active.
2. Active (Chủ động) Người dùng gõ /akithink. Cơ chế này ép cả phiên phải chạy qua 5 pha tương tác khắt khe, kết thúc bằng một file decision record lưu vào tài liệu dự án.

Tương thích cả Claude Code và Gemini

Nền tảng	Điều phối Rules	Đích Cài Đặt Skills	Cấu Hình Gốc
Claude Code	Dùng akirule skill tự nạp rule theo 3 tầng	~/.claude/skills/	CLAUDE.md và settings.json
Antigravity (Gemini)	Đọc GEMINI.md global overrides	Native ~/.gemini/config/skills/	YAML trigger trong config/rules/

Gemini (Antigravity) được override cứng bằng GEMINI.md để vá các điểm yếu đặc thù, trong khi Claude dùng akirule để load động.

Rule Riêng Máy

Installer tạo CLAUDE.local.md và GEMINI.local.md nếu chưa có — không bao giờ ghi đè lại. Đây là nơi chứa quy tắc đặc thù của máy (đường dẫn IDE, Emulator) và luôn tồn tại an toàn qua các lần update.

Update Hook An Toàn

Hook SessionStart tự kiểm tra mã nguồn (chỉ 1 lần/ngày). fail-silent và không chặn session. Nếu có bản mới, nó thông báo báo cập nhật chứ không tự tải, không tự cài.

Mã nguồn & Cài đặt

akidevrule là kho kiến trúc tiêu chuẩn. Hãy xem README để hiểu rành rọt cơ chế smart router, cách tổ chức file và quá trình cài đặt.

github.com/lacvietanh/akidevrule