Vì Sao Phải Chia Hai Tầng Nạp Rule?

Một skill chỉ chạy khi model tự quyết định gọi nó — nghĩa là bất kỳ rule nào chỉ nằm trong một skill đều là "nạp best-effort", có thể bị bỏ qua nếu model không nghĩ tới việc gọi skill đó. AkiDevRule xử lý vấn đề này bằng cách tách rõ hai cơ chế nạp khác nhau thay vì coi tất cả rule như nhau.

Tầng Core — Nạp Cứng Qua Harness, Không Qua Model

Bốn file index.md, RULE-agent-behavior.md, RULE-coding.md và RULE-pattern-core.md được @-import thẳng vào ~/.claude/CLAUDE.md — file này được harness Claude Code đọc cơ học ngay khi phiên khởi động, không cần model tự chọn gọi skill nào. Đây là những rule duy nhất áp dụng cho mọi tác vụ, kể cả tác vụ không đụng tới code. Cái giá phải trả là bốn file này chiếm context ở mọi phiên, kể cả phiên không cần chúng — nhưng đó là cái giá có chủ đích cho một sự bảo đảm chắc chắn.

RULE-agent-behavior.md mang các quy tắc như: giao tiếp trước khi hành động (một câu hỏi không phải một yêu cầu thực thi), báo cáo dày đặc thông tin thay vì dài dòng, ranh giới quyết định (khi nào cần hỏi trước khi làm), và kỷ luật ghi nhớ. RULE-coding.md mang triết lý mã nguồn: single-maintainer-friendly, MVP-first, DRY nhưng không trừu tượng hoá sớm, comment là phương án cuối. RULE-pattern-core.md mang 8 quy luật kiến trúc phổ quát: Single Source of Truth, Rule of Three, Single Responsibility, Open/Closed, composition, module boundary, đặt tên theo vai trò, và nguyên tắc "một luồng tự nhiên thay vì chồng guard".

Tầng Contextual — Skill akirule Định Tuyến Theo Tín Hiệu

Mọi rule còn lại — RULE-docs.md, RULE-content-write.md, RULE-stack-akiNuxtCf.md, RULE-stack-tauri.md, RULE-ui-pattern.md, RULE-seo.md, RULE-release.md, RULE-db-design.md, RULE-biz.md, cộng các METHOD-*.md (deep-think, flow-audit, zero-trust-audit, ux-psych, proportionality, subtraction-audit) — chỉ nạp khi skill akirule được gọi và một tín hiệu khớp (loại file đang sửa, chủ đề tác vụ). Độ nhạy tín hiệu được cố tình đặt cao: thà nạp thừa tốn vài token còn hơn bỏ sót và hành xử sai. Gõ "nạp full" hoặc "load all rules" để nạp toàn bộ corpus một lượt bất kể tín hiệu.

Ba file RULE-seo.md, RULE-release.md và RULE-stack-akiNuxtCf.md trộn lẫn rule phổ quát với nội dung riêng của hệ sinh thái AkiNuxtCf (API usePageSeo, schema releases.json, quy ước tên component...). Phần riêng đó được cô lập vào nhóm cuối cùng trong mỗi file, đánh dấu ⟨Aki⟩ — vẫn nằm trong repo public và vẫn tự nạp, nhưng đánh dấu rõ phần nào sẽ bị cắt nếu có bản xuất bản công khai thuần tuý.

Địa Chỉ Hoá Rule: topic.A1

Mỗi file rule/method được tổ chức theo nhóm A/B/C và mục đánh số bên trong, ví dụ coding.B2 (thay đổi code có sẵn), stack.C1 (tên component chuẩn hoá) — cho phép trích dẫn chính xác một quy tắc mà không cần đổi tên file hay đụng tới cơ chế định tuyến. topic chính là tên file sau khi bỏ tiền tố RULE-/METHOD-.

10 Skill Theo Chuẩn Mở SKILL.md

SKILL.md là một chuẩn mở có nhiều CLI cùng đọc được, nên bộ 10 skill của AkiDevRule (akirule, akiflow, akithink, akihtmlreport, akihelp, akigitcommit, akilint, akiship, aki-article-writer, akidevsync-notes) được đồng bộ nguyên vẹn sang cả Antigravity, Codex CLI, Kiro CLI và Grok CLI, không chỉ Claude Code. Trong đó, akiflow là hội đồng agent do một "lead" điều phối cho việc cần nhiều loại phán đoán khác nhau, còn akiship chạy trọn quy trình release từ đầu đến cuối theo hợp đồng tự chủ có điểm dừng rõ ràng (mơ hồ lịch sử public, việc không thể phân loại, hoặc mâu thuẫn thiết kế).

5 Agent — Quyền Ghi Bị Giới Hạn Bằng Cơ Chế, Không Phải Lời Hứa

5 file agent (aki-hands, aki-judge, aki-conduct, aki-challenger, aki-maker) được viết theo đúng định dạng ~/.claude/agents/ của Claude Code, nên ba thuộc tính vốn chỉ là văn xuôi giờ trở thành cơ học: quyền chỉ-đọc được thực thi bằng cách trường tools: đơn giản là không liệt kê Edit/Write, mức model được khai báo tường minh trong model: thay vì tuỳ hứng giữa chừng, và một seat chưa được định nghĩa thì đơn giản là không thể triệu tập. Trong 5 agent này, chỉ aki-maker được cấp Edit/Write — bốn agent còn lại kể cả aki-conduct (agent kiểm tra rule có được tuân thủ hay không) đều chỉ đọc.

Vì định dạng agent-định-nghĩa hiện chỉ có một CLI hỗ trợ (Claude Code), 5 agent này chỉ đồng bộ cho Claude Code, khác với bộ skill đồng bộ đa CLI. Tìm hiểu tổng quan sản phẩm tại AkiDevRule Là Gì? hoặc cách cài đặt tại Cài Đặt AkiDevRule Cho Claude Code. Mã nguồn và tài liệu kỹ thuật đầy đủ tại github.com/lacvietanh/akidevrule.