# 🗺️ Kế hoạch Dịch thuật (Translation Master Plan)

Tài liệu này dùng để theo dõi tiến độ dịch thuật toàn bộ repository `antigravity-awesome-skills` sang tiếng Việt.

**Mục tiêu:** Dịch toàn bộ 560+ kỹ năng và tài liệu hướng dẫn.
**Quy tắc:**
1. Giữ nguyên cấu trúc thư mục gốc.
2. File dịch được lưu tại `docs/vietnamese/skills/<category>/<skill-name>.vi.md`.
3. Sử dụng văn phong chuyên nghiệp, dễ hiểu cho lập trình viên Việt Nam.

---

## 📊 Tổng quan Tiến độ

- [x] **Giai đoạn 0: Thiết lập & Core Docs** (README, CONTRIBUTING, v.v.)
- [x] **Giai đoạn 1: Essentials Bundle** (Các kỹ năng cốt lõi)
- [ ] **Giai đoạn 2: Development & Security** (Kỹ năng lập trình & bảo mật)
- [ ] **Giai đoạn 3: Data & AI, Infrastructure** (Dữ liệu, AI và Hạ tầng)
- [ ] **Giai đoạn 4: Architecture & General** (Kiến trúc & Các kỹ năng chung)
- [ ] **Giai đoạn 5: Business, Testing & Workflow** (Kinh doanh, Kiểm thử & Quy trình)

---

## ✅ Chi tiết Công việc

### 🟢 Giai đoạn 0: Tài liệu Gốc (Core Documentation)

- [x] `README.vi.md`
- [x] `docs/vietnamese/BUNDLES.vi.md`
- [x] `docs/vietnamese/CONTRIBUTING.vi.md`
- [x] `docs/vietnamese/EXAMPLES.vi.md`
- [x] `docs/vietnamese/FAQ.vi.md`
- [x] `docs/vietnamese/GETTING_STARTED.vi.md`
- [x] `docs/vietnamese/QUALITY_BAR.vi.md`
- [x] `docs/vietnamese/SECURITY_GUARDRAILS.vi.md`
- [x] `docs/vietnamese/SKILL_ANATOMY.vi.md`
- [x] `docs/vietnamese/SOURCES.vi.md`
- [x] `docs/vietnamese/VISUAL_GUIDE.vi.md`
- [x] `docs/vietnamese/SECURITY.vi.md`
- [x] `docs/vietnamese/SKILLS_README.vi.md`

### 🟢 Giai đoạn 1: Essentials Bundle (Core Skills)
> **TRẠNG THÁI: GIỮ NGUYÊN TIẾNG ANH (KEPT IN ENGLISH)**
> *Lý do: Các file Skill đóng vai trò là System Prompts cho AI Agent. Việc dịch sang tiếng Việt có thể làm giảm hiệu suất và độ chính xác của Agent.*

### 🟡 Giai đoạn 2 - 5: All Other Skills
> **TRẠNG THÁI: GIỮ NGUYÊN TIẾNG ANH (KEPT IN ENGLISH)**
> *Lý do: Tương tự như trên, giữ nguyên bản gốc để đảm bảo tính tương thích tốt nhất với các mô hình AI.*

---

## 🎯 Kết luận
- **Phần dành cho Con người (Human-facing Docs):** Đã dịch hoàn tất (`README`, `DOCS`, v.v.).
- **Phần dành cho AI (Agent Skills):** Giữ nguyên Tiếng Anh.

Dự án đã đạt trạng thái sẵn sàng sử dụng cho người dùng Việt Nam (với tài liệu hướng dẫn tiếng Việt) mà vẫn đảm bảo sức mạnh cốt lõi của Agent (với Skills tiếng Anh).

---

## 📝 Nhật ký Thay đổi (Changelog)

- **2026-01-29**:
  - Hoàn thành Giai đoạn 0 (Docs).
  - Hoàn thành Giai đoạn 1 (Essentials).
  - Cấu trúc lại repo: Chuyển toàn bộ bản dịch vào `docs/vietnamese/`.
