# 🚀 HƯỚNG DẪN CÀI ĐẶT & SỬ DỤNG AI AGENT (DEV-VIBE ENGINE)
Chào mừng bạn đến với hệ sinh thái Dev-Vibe Cheatsheet & AI Agent! Đây là bộ khung cấu hình chỉ thị, kỹ năng (Skills) và quy chuẩn làm việc được thiết kế theo tiêu chuẩn của Google Antigravity giúp biến AI trong IDE của bạn (Cursor, VS Code, Windsurf) thành một Senior Engineer thực thụ hiểu rõ dự án của bạn 100%.
Lưu ý: Khi cài đặt bộ cấu hình này, AI Agent sẽ tự động tuân thủ cấu trúc thư mục, quy tắc viết code (sạch, tối ưu, dễ đọc), cách viết test và nghiệp vụ riêng của dự án mà bạn không cần phải viết prompt nhắc nhở lặp đi lặp lại.
---
## 1. Quy Trình Hoạt Động (How it works)
Hệ thống hoạt động dựa trên 3 lớp cấu trúc lõi được cài đặt trực tiếp vào thư mục gốc (Root) của dự án:
1. Rules (GEMINI.md / .antigravityrules): Định nghĩa các quy tắc cốt lõi ("luật chơi" của dự án như: cấm dùng any trong TypeScript, cấm dùng màu tím AI cliché, bắt buộc viết Unit Test).
2. Specialist Agents (agents/): Phân chia AI thành các vai trò chuyên biệt (như frontend-specialist, backend-specialist, database-architect, debugger). Khi bạn sửa file nào, AI tương ứng sẽ tự kích hoạt.
3. Modular Skills (skills/): Các gói kỹ năng đóng gói gồm hướng dẫn và file script bổ trợ (ví dụ: quét lỗ hổng bảo mật, dọn dẹp code thừa, chạy test).
4. Workflows (workflows/): Kịch bản từng bước cho các tác vụ lớn (tạo tính năng /enhance, sửa lỗi /debug, lập kế hoạch /plan).
---
## 2. Hướng Dẫn Cài Đặt Nhanh (Quick Setup)
Cách nhanh nhất và chuẩn xác nhất để khởi tạo toàn bộ cấu hình AI Agent phù hợp với Tech Stack của bạn là sử dụng Dev-Vibe CLI qua lệnh NPX tương tác.
### Bước 1: Khởi chạy CLI
Mở Terminal tại thư mục gốc của dự án và chạy câu lệnh sau:
```bash
npx @vanthiet/dev-vibe@latest
Bước 2: Lựa chọn Tech Stack của bạn
Giao diện dòng lệnh tương tác (Interactive CLI) sẽ hiện lên và hướng dẫn bạn chọn:
Hệ điều hành AI: Chọn "Antigravity IDE" (cho Cursor, VS Code) hoặc "Antigravity CLI" (cho Terminal).
Tech Stack: Chọn ngôn ngữ và framework đang dùng (TypeScript, ReactJS, Next.js, Golang, Spring Boot, Laravel, Mobile frameworks...).
Database & Tools: Chọn hệ quản trị CSDL (Postgres, MongoDB, SQLite) và thư viện UI/Kiểm thử.
Mẹo: CLI sẽ tự động quét dự án hiện tại của bạn để đề xuất các tùy chọn phù hợp nhất, bạn chỉ cần bấm Enter để xác nhận!
