# Trang 1.1: Tổng quan về Antigravity Kit (Định nghĩa, mục tiêu và lợi ích).

## 1. Antigravity Kit là gì?

**Antigravity Kit** là một bộ mẫu (template) toàn diện dành cho AI Agent, được thiết kế để nâng cao đáng kể năng lực của các trợ lý lập trình AI — đặc biệt là **Google Gemini** (dùng trong môi trường Antigravity CLI).

Bộ kit này không phải là một ứng dụng độc lập. Thay vào đó, nó đóng vai trò là **"não bộ mở rộng"** — một hệ thống quy tắc, kiến thức chuyên sâu và quy trình làm việc được cài đặt vào trong dự án của bạn. Khi AI đọc và hiểu các quy tắc này, nó sẽ hoạt động giống như một chuyên gia thực thụ thay vì một trợ lý AI thông thường.

> **Tóm lại:** Antigravity Kit biến AI trợ lý thành một đội ngũ chuyên gia kỹ thuật hoàn chỉnh, sẵn sàng làm việc cùng bạn theo đúng tiêu chuẩn và quy trình chuyên nghiệp nhất.

## 2. Mục tiêu

Bộ kit được xây dựng với các mục tiêu cụ thể sau:

<div class="my-4 rounded-lg overflow-hidden border border-gray-500/20 [&_thead_tr:first-child_th:first-child]:border-t-0 [&_thead_tr:first-child_th:first-child]:border-l-0 [&_thead_tr:first-child_th:last-child]:border-t-0 [&_thead_tr:first-child_th:last-child]:border-r-0 [&_tbody_tr:last-child_td:first-child]:border-b-0 [&_tbody_tr:last-child_td:first-child]:border-l-0 [&_tbody_tr:last-child_td:last-child]:border-b-0 [&_tbody_tr:last-child_td:last-child]:border-r-0 [&_thead_tr:first-child_th]:border-t-0 [&_tbody_tr:last-child_td]:border-b-0 [&_th:first-child]:border-l-0 [&_td:first-child]:border-l-0 [&_th:last-child]:border-r-0 [&_td:last-child]:border-r-0" id="bkmrk-m%E1%BB%A5c-ti%C3%AAu-m%C3%B4-t%E1%BA%A3-ti%C3%AAu-"><table class="min-w-full border-separate border-spacing-0"><thead><tr><th class="bg-gray-500/20 px-3 py-2 text-left font-medium leading-snug border border-gray-500/20">Mục tiêu</th><th class="bg-gray-500/20 px-3 py-2 text-left font-medium leading-snug border border-gray-500/20">Mô tả</th></tr></thead><tbody><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">**Tiêu chuẩn hóa**</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Đảm bảo AI luôn áp dụng các tiêu chuẩn code, thiết kế và kiến trúc nhất quán trong mọi dự án.</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">**Chuyên môn hóa**</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Trang bị cho AI kiến thức sâu theo từng lĩnh vực (Frontend, Backend, Bảo mật, Mobile...) thay vì kiến thức chung chung.</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">**Tự động hóa**</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Cung cấp các quy trình làm việc (Workflows) được định nghĩa sẵn để AI có thể thực hiện các tác vụ phức tạp một cách có hệ thống.</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">**Tăng tốc**</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Giúp đội ngũ phát triển xây dựng phần mềm nhanh hơn mà không giảm chất lượng.</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">**Phối hợp đa AI**</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Cho phép nhiều AI Agent cùng phối hợp làm việc song song trên một dự án phức tạp.</td></tr></tbody></table>

</div>## 3. Thành phần chính

Antigravity Kit bao gồm **3 thành phần cốt lõi**, được cài đặt vào trong thư mục `.agent/` của mỗi dự án:

### 3.1. Agents (Đặc vụ AI) — 20 Agent

Là các "nhân cách chuyên gia" được cấu hình sẵn để AI có thể đóng vai trò của họ khi cần thiết.

**Ví dụ các Agent tiêu biểu:**

- `frontend-specialist`: Chuyên gia giao diện web (React, Next.js, Tailwind).
- `backend-specialist`: Chuyên gia logic API và máy chủ (Node.js, FastAPI).
- `security-auditor`: Chuyên gia bảo mật, kiểm tra lỗ hổng và OWASP.
- `debugger`: Chuyên gia phân tích và sửa lỗi có hệ thống.
- `project-planner`: Chuyên gia lập kế hoạch và phân rã công việc.
- `orchestrator`: Điều phối nhiều Agent cùng làm việc cho tác vụ phức tạp.
- *(và 14 Agent khác bao gồm Mobile, Game, DevOps, QA, SEO...)*

### 3.2. Skills (Kỹ năng) — 36 Skills

Là các gói kiến thức chuyên sâu mà Agent có thể tải và áp dụng tùy theo từng ngữ cảnh.

**Ví dụ các Skills tiêu biểu:**

- `react-best-practices`: Tối ưu hiệu năng React &amp; Next.js theo tiêu chuẩn Vercel.
- `api-patterns`: Thiết kế API chuẩn REST / GraphQL / tRPC.
- `database-design`: Thiết kế schema, chiến lược index, tối ưu truy vấn.
- `systematic-debugging`: Quy trình 4 bước để tìm và sửa lỗi có bằng chứng.
- `vulnerability-scanner`: Phân tích bảo mật theo OWASP 2025.
- `ui-ux-pro-max`: Bộ 50 phong cách thiết kế giao diện cao cấp.

### 3.3. Workflows (Quy trình làm việc) — 11 Workflows

Là các quy trình được định nghĩa sẵn, kích hoạt bằng **lệnh gạch chéo** (`/`), giúp AI thực hiện toàn bộ một tác vụ phức tạp theo đúng trình tự.

<div class="my-4 rounded-lg overflow-hidden border border-gray-500/20 [&_thead_tr:first-child_th:first-child]:border-t-0 [&_thead_tr:first-child_th:first-child]:border-l-0 [&_thead_tr:first-child_th:last-child]:border-t-0 [&_thead_tr:first-child_th:last-child]:border-r-0 [&_tbody_tr:last-child_td:first-child]:border-b-0 [&_tbody_tr:last-child_td:first-child]:border-l-0 [&_tbody_tr:last-child_td:last-child]:border-b-0 [&_tbody_tr:last-child_td:last-child]:border-r-0 [&_thead_tr:first-child_th]:border-t-0 [&_tbody_tr:last-child_td]:border-b-0 [&_th:first-child]:border-l-0 [&_td:first-child]:border-l-0 [&_th:last-child]:border-r-0 [&_td:last-child]:border-r-0" id="bkmrk-l%E1%BB%87nh-t%C3%A1c-v%E1%BB%A5-%2Fbrainst"><table class="min-w-full border-separate border-spacing-0"><thead><tr><th class="bg-gray-500/20 px-3 py-2 text-left font-medium leading-snug border border-gray-500/20">Lệnh</th><th class="bg-gray-500/20 px-3 py-2 text-left font-medium leading-snug border border-gray-500/20">Tác vụ</th></tr></thead><tbody><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">`/brainstorm`</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Lên ý tưởng và so sánh các giải pháp</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">`/plan`</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Tạo kế hoạch chi tiết trước khi viết code</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">`/create`</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Xây dựng ứng dụng/tính năng mới từ đầu</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">`/enhance`</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Cải tiến và nâng cấp code hiện có</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">`/debug`</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Sửa lỗi theo quy trình 4 giai đoạn</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">`/test`</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Tạo và chạy bộ kiểm thử tự động</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">`/ui-ux-pro-max`</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Tạo landing page chất lượng cao</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">`/deploy`</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Triển khai ứng dụng lên môi trường production</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">`/preview`</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Quản lý server xem trước ở máy cục bộ</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">`/status`</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Xem tổng quan tiến độ dự án</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">`/orchestrate`</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Điều phối nhiều Agent phối hợp cùng lúc</td></tr></tbody></table>

</div>---

## 4. Cách thức hoạt động

Antigravity Kit hoạt động theo nguyên tắc **"Đọc – Hiểu – Áp dụng"**:

**Bước 1: Cài đặt vào dự án.** Khi bạn chạy lệnh cài đặt, một thư mục `.agent/` sẽ được tạo ra trong dự án của bạn. Thư mục này chứa toàn bộ cấu hình cho 20 Agent, 36 Skills và 11 Workflows.

**Bước 2: AI chủ động đọc cấu hình.** Khi bạn mở cuộc trò chuyện với AI trong dự án, AI sẽ đọc các file cấu hình trong thư mục `.agent/` — bao gồm file quy tắc chính `GEMINI.md` và file kiến trúc

<div id="bkmrk--1">  
</div><span class="inline-flex break-all leading-tight">ARCHITECTURE.md</span>.

**Bước 3: Hệ thống Định tuyến thông minh (Intelligent Routing) tự kích hoạt.** Khi bạn đặt câu hỏi hoặc yêu cầu AI làm gì đó, hệ thống sẽ **tự động phân tích** yêu cầu và kích hoạt Agent chuyên gia phù hợp nhất. **Bạn không cần phải gõ tên Agent thủ công.**

```html
Ví dụ:
Bạn: "Thêm xác thực JWT vào API"
AI:  🤖 Đang áp dụng kiến thức của @security-auditor + @backend-specialist...
     [AI phân tích bảo mật và đề xuất triển khai đúng chuẩn]
Bạn: "Sửa lỗi button dark mode bị lẫn màu"
AI:  🤖 Đang áp dụng kiến thức của @frontend-specialist...
     [AI kiểm tra logic CSS và đưa ra fix cụ thể]
```

**Bước 4: Skills được tải tự động theo yêu cầu.** Agent được kích hoạt sẽ chỉ tải đúng các module kiến thức (Skills) cần thiết cho tác vụ hiện tại. Ví dụ: `backend-specialist` khi làm việc với database sẽ tải thêm skill `database-design`, không tải các skill không liên quan.

---

## 5. Lợi ích thực tế

**Đối với lập trình viên cá nhân:**

- Nhận được phản hồi ở mức độ chuyên gia thay vì câu trả lời chung chung.
- Có một "đồng đội AI" hiểu ngữ cảnh dự án và tuân theo tiêu chuẩn nhất quán.
- Tiết kiệm thời gian tra cứu tài liệu và học các pattern mới.

**Đối với đội nhóm phát triển:**

- Đảm bảo mọi thành viên sử dụng AI theo cùng một bộ tiêu chuẩn đã được đội ngũ thống nhất.
- Dễ dàng chia sẻ "kiến thức dự án" giữa các thành viên thông qua việc commit thư mục `.agent/` vào Git.
- Rút ngắn thời gian onboarding cho thành viên mới.

---

## 6. Thống kê nhanh

<div class="my-4 rounded-lg overflow-hidden border border-gray-500/20 [&_thead_tr:first-child_th:first-child]:border-t-0 [&_thead_tr:first-child_th:first-child]:border-l-0 [&_thead_tr:first-child_th:last-child]:border-t-0 [&_thead_tr:first-child_th:last-child]:border-r-0 [&_tbody_tr:last-child_td:first-child]:border-b-0 [&_tbody_tr:last-child_td:first-child]:border-l-0 [&_tbody_tr:last-child_td:last-child]:border-b-0 [&_tbody_tr:last-child_td:last-child]:border-r-0 [&_thead_tr:first-child_th]:border-t-0 [&_tbody_tr:last-child_td]:border-b-0 [&_th:first-child]:border-l-0 [&_td:first-child]:border-l-0 [&_th:last-child]:border-r-0 [&_td:last-child]:border-r-0" id="bkmrk-th%C3%A0nh-ph%E1%BA%A7n-s%E1%BB%91-l%C6%B0%E1%BB%A3ng-"><table class="min-w-full border-separate border-spacing-0"><thead><tr><th class="bg-gray-500/20 px-3 py-2 text-left font-medium leading-snug border border-gray-500/20">Thành phần</th><th class="bg-gray-500/20 px-3 py-2 text-left font-medium leading-snug border border-gray-500/20">Số lượng</th><th class="bg-gray-500/20 px-3 py-2 text-left font-medium leading-snug border border-gray-500/20">Mức độ bao phủ</th></tr></thead><tbody><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">Specialist Agents</td><td class="px-3 py-2 leading-snug border border-gray-500/20">20</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Web, Mobile, Game, DevOps, Security, QA, SEO...</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">Domain Skills</td><td class="px-3 py-2 leading-snug border border-gray-500/20">36</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Frontend, Backend, DB, Testing, Cloud, Architecture...</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">Slash Workflows</td><td class="px-3 py-2 leading-snug border border-gray-500/20">11</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Toàn bộ vòng đời phát triển phần mềm</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">Scripts kiểm tra</td><td class="px-3 py-2 leading-snug border border-gray-500/20">2 Master + 18</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Security, Lint, Schema, Tests, UX, SEO, Lighthouse</td></tr><tr><td class="px-3 py-2 leading-snug border border-gray-500/20">Tổng độ bao phủ</td><td class="px-3 py-2 leading-snug border border-gray-500/20">~90%</td><td class="px-3 py-2 leading-snug border border-gray-500/20">Các lĩnh vực phát triển web và mobile</td></tr></tbody></table>

</div>> **Ghi chú:** Bộ kit này tương thích và được thiết kế để hoạt động tốt nhất với công cụ Antigravity CLI. Tuy nhiên, các Agent và Skill đều là các file Markdown tiêu chuẩn, có thể được áp dụng cho bất kỳ AI Code Assistant nào hỗ trợ đọc file cấu hình từ workspace (như Cursor, Windsurf, GitHub Copilot...).