antigravity-ide 4.2.0 → 4.2.1

package/docs/CONTRIBUTING.vi.md

@@ -1,9 +1,6 @@
 # Hướng Dẫn Đóng Góp (Contributing)
 
-Cảm ơn bạn đã quan tâm đến dự án AntiGravity IDE! Chúng tôi luôn chào đón mọi sự đóng góp từ cộng đồng để cùng xây dựng một hệ sinh thái mã nguồn mở vững mạnh. 
-
-> [!NOTE]
-> Khi đóng góp, vui lòng tôn trọng bản quyền và các nguồn tham khảo (References) chính của dự án.
+Cảm ơn bạn đã quan tâm đến dự án Antigravity IDE! Chúng tôi luôn chào đón mọi sự đóng góp từ cộng đồng.
 
 ## 🤝 Quy Tắc Ứng Xử
 Khi tham gia dự án, vui lòng giữ thái độ tôn trọng, lịch sự và chuyên nghiệp.
@@ -29,18 +26,12 @@ Khi tham gia dự án, vui lòng giữ thái độ tôn trọng, lịch sự và
 -   **Kiểm thử**: Đảm bảo chạy `npm test` thành công.
 -   **Lint Code**: Chạy `npm run lint` để code sạch đẹp.
 
-### 4. Quy trình đăng ký Skill/Workflow mới
-Để một Skill hoặc Workflow mới xuất hiện trong Setup Wizard, bạn cần:
-1.  **Skill**: Thêm định dạng vào `cli/logic/skill-definitions.js`.
-2.  **Workflow**: Thêm tên vào `cli/logic/workflow-manager.js`.
-3.  **Lựa chọn (Scale)**: Cấu hình quy mô xuất hiện (Instant/SME/Creative) trong `cli/logic/manifest-manager.js`.
-
 ## 🛠️ Cài Đặt Môi Trường Dev
 
 1.  Clone fork của bạn:
     ```bash
-    git clone https://github.com/your-username/antigravity-ide.git
-    cd antigravity-ide
+    git clone https://github.com/your-username/google-antigravity.git
+    cd google-antigravity
     ```
 2.  Cài đặt thư viện:
     ```bash

package/docs/COPYRIGHT.md

@@ -0,0 +1,57 @@
+# Bản Quyền và Giấy Phép
+
+## 📜 Thông Tin Bản Quyền
+
+**Tên Dự Án**: Google Antigravity (Enhanced Edition)  
+**Chủ Sở Hữu & Bảo Trì**: Dokhacgiakhoa  
+**Năm**: 2026  
+**Giấy Phép**: MIT License
+
+---
+
+## ⚖️ Giấy Phép MIT - Giải Thích Bằng Tiếng Việt
+
+Dự án này được phát hành theo **giấy phép MIT**.
+
+### Quyền Lợi:
+✅ **Sử dụng tự do**: Bạn có thể sử dụng cho cá nhân, thương mại, học tập.  
+✅ **Sao chép và phân phối**: Bạn có thể chia sẻ dự án.  
+✅ **Chỉnh sửa**: Bạn có thể tùy biến code.
+
+### Nghĩa Vụ:
+⚠️ **Giữ nguyên thông báo bản quyền**: Khi phân phối lại.  
+⚠️ **Không bảo hành**: Tác giả không chịu trách nhiệm về lỗi phát sinh.
+
+---
+
+## 🙏 Ghi Nhận & Nguồn Tham Khảo (Credits)
+
+Dự án này do **Dokhacgiakhoa** phát triển và vận hành. Trong quá trình xây dựng, chúng tôi đã tham khảo và kế thừa tri thức từ các nguồn mã nguồn mở sau:
+
+### Nguồn Tham Khảo (Upstream References)
+*Đây là các dự án nguồn mà chúng tôi đã nghiên cứu để xây dựng nên phiên bản này:*
+
+1.  **Antigravity Kit** (by `vudovn`)
+    *   *Vai trò*: Tham khảo cấu trúc Framework và tư duy Agent.
+    *   *Link*: [github.com/vudovn/antigravity-kit](https://github.com/vudovn/antigravity-kit)
+
+2.  **Antigravity Awesome Skills** (by `sickn33`)
+    *   *Vai trò*: Tham khảo cơ sở dữ liệu các kỹ năng (Skills Database).
+    *   *Link*: [github.com/sickn33/antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills)
+
+
+3.  **UI/UX Pro Max** (by `sickn33`)
+    *   *Vai trò*: Tham khảo quy chuẩn thiết kế giao diện cao cấp.
+    *   *Link*: [github.com/sickn33/ui-ux-pro-max](https://github.com/sickn33/ui-ux-pro-max)
+
+> **Lưu ý**: Các tác giả gốc (`vudovn`, `sickn33`) được ghi nhận vì những đóng góp nền tảng cho cộng đồng mã nguồn mở. Tuy nhiên, họ **không trực tiếp tham gia** phát triển, sửa lỗi hay quản lý repository (`Dokhacgiakhoa/google-antigravity`) này.
+
+---
+
+## 📄 Văn Bản Pháp Lý Gốc
+
+Văn bản giấy phép MIT đầy đủ bằng tiếng Anh được lưu tại file [`LICENSE`](./LICENSE).
+
+---
+
+*Verified by Dokhacgiakhoa*

package/docs/DEPLOYMENT.md

@@ -0,0 +1,77 @@
+# Antigravity IDE - Deployment Record
+
+## Package Information
+
+**Package Name:** `antigravity-ide`  
+**Version:** `3.5.13`  
+**Published Date:** January 29, 2026  
+**npm Registry:** https://www.npmjs.com/package/antigravity-ide
+
+---
+
+## Installation Commands
+
+Users can install and use the package via:
+
+### Method 1: NPX (Recommended)
+```bash
+npx antigravity-ide
+# or
+npx antigravity-ide my-project
+```
+
+### Method 2: Global Installation
+```bash
+npm install -g antigravity-ide
+antigravity-ide
+```
+
+---
+
+## Package Statistics
+
+**Files:** 2,660 files  
+**Package Size:** 23.5 MB (compressed)  
+**Unpacked Size:** 41.3 MB  
+**License:** MIT  
+**Author:** Dokhacgiakhoa
+
+---
+
+## Features Included
+
+### Core Components
+- ✅ CLI Tool with interactive prompts
+- ✅ 2,500+ AI Agent Skills
+- ✅ Multiple project templates (Minimal, Standard, Full)
+- ✅ Web Dashboard (Next.js)
+- ✅ Testing Suite
+- ✅ Lab Experiments
+
+### Configuration Options
+- Agent Rules: Strict / Balanced / Flexible
+- Skill Categories: webdev, mobile, devops, security, ai, data
+- Workflows: git, testing, deployment, review
+- Package Managers: npm, pnpm, yarn
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 3.5.13 | 2026-01-29 | Documentation fixes & Smart Install polish |
+| 3.5.0 | 2026-01-29 | Major CLI overhaul & Engine Intelligence |
+| 3.0.0 | 2026-01-29 | Initial public release |
+
+---
+
+## Links
+
+- **npm Package:** https://www.npmjs.com/package/antigravity-ide
+- **GitHub Repository:** https://github.com/Dokhacgiakhoa/google-antigravity
+- **Documentation:** https://github.com/Dokhacgiakhoa/google-antigravity#readme
+
+---
+
+*Last updated: 2026-01-29*

package/docs/{GEMINI_USAGE.md → GEMINI_GUIDE.md}

@@ -1,6 +1,6 @@
 # Using Antigravity IDE with Google Gemini
 
-**All 72 Master Skills (600+ AI Patterns) are fully compatible with Google Gemini AI!**
+**All 550+ skills are fully compatible with Google Gemini AI!**
 
 ## Why Antigravity IDE + Gemini?
 
@@ -8,7 +8,7 @@
 
 | Feature | Benefit for Gemini |
 |---------|-------------------|
-| **72 Master Skills** | Instant expertise in 8 domains (Standard v4.0.8) |
+| **550+ Skills** | Instant expertise in 8 domains |
 | **Universal Format** | No vendor lock-in, works with any Gemini model |
 | **Large Context** | Gemini 1.5 Pro (2M tokens) loads multiple skills easily |
 | **Multimodal Support** | Skills cover text, vision, audio - all Gemini capabilities |
@@ -108,7 +108,7 @@ If a workflow/skill is found in Global, use it as the default.
 ## 📊 Skill Categories Breakdown
 
 ```
-Total: 27 Master Skills (600+ capabilities) across 8 categories
+Total: 550+ skills across 8 categories
 
 Development (180+ skills)
 ├── Frontend (React, Next.js, Vue, Svelte)
@@ -187,7 +187,7 @@ Tools (10+ skills)
 **Option 1: Load All (Gemini Pro)**
 ```javascript
 // Gemini 1.5 Pro has 2M token context
-// Can load multiple Master Skills!
+// Can load ALL 550 skills!
 const allSkills = loadAllSkills(".agent/skills");
 ```
 
@@ -259,7 +259,7 @@ const skills = [
 ## 📚 Resources
 
 - **All Skills**: See [SKILLS.md](./SKILLS.md)
-- **Skill Source**: [antigravity-awesome-skills](https://github.com/Dokhacgiakhoa/antigravity-ide)
+- **Skill Source**: [antigravity-awesome-skills](https://github.com/Dokhacgiakhoa/google-antigravity)
 - **Gemini Docs**: [Google AI Studio](https://ai.google.dev/)
 - **Examples**: Check `/lab` directory
 
@@ -291,4 +291,4 @@ console.log(result.response.text());
 
 ---
 
-**Ready to build with Gemini + 27 Master Skills? Let's go! 🚀**
+**Ready to build with Gemini + 550 skills? Let's go! 🚀**

package/docs/GLOSSARY.md

@@ -0,0 +1,109 @@
+# Antigravity System Glossary 📖
+
+This is the **comprehensive** reference for all Entities, Commands, and Keywords in the Antigravity system.
+Use these keywords to communicate precisely with the AI.
+
+---
+
+## 1. Workflows (Procedures) - Symbol `/`
+*Type this command to START a sequence of actions.*
+
+| Command | Meaning | When to use? |
+| :--- | :--- | :--- |
+| `/audit` | **Quality Audit** | Before handover, scan for security/performance issues. |
+| `/brainstorm` | **Brainstorming** | Stuck? Need AI to suggest solutions/architectures. |
+| `/create` | **Create Project** | Start a new project from scratch. |
+| `/debug` | **Debug** | When code breaks, throw logs here for analysis. |
+| `/deploy` | **Deploy** | Package and push app to Server/Cloud. |
+| `/document` | **Document** | Auto-write README, API Docs from code. |
+| `/enhance` | **Enhance** | Improve UI, or optimize old code. |
+| `/monitor` | **Monitor** | Setup Server/Log monitoring tools. |
+| `/onboard` | **Onboard** | Create guides for new team members. |
+| `/orchestrate` | **Orchestrate** | Call the "Board of Experts" for complex problems. |
+| `/plan` | **Plan** | Analyze requirements -> Generate `implementation_plan.md`. |
+| `/preview` | **Preview** | Dry-run web/app to check UI. |
+| `/security` | **Security Scan** | Deep vulnerability check (Penetration Test). |
+| `/seo` | **SEO Opt** | Help web rank on Google (Meta tags, Sitemap). |
+| `/status` | **Status** | View project progress report. |
+| `/test` | **Test** | Write and run Unit Test/E2E Test. |
+| `/ui-ux-pro-max`| **Elite UI/UX**| Design interfaces like magic (Magic UI/Linear style). |
+
+---
+
+## 2. Rules (Context) - Symbol `@`
+*Type this keyword (or mention name) to INJECT EXPERT CONTEXT.*
+
+| Rule Tag | Expertise | Responsibility |
+| :--- | :--- | :--- |
+| `@backend` | Backend Engineer | Write API, Server Logic, Database. |
+| `@frontend` | Frontend Engineer | Write UI, CSS, Animation, React/Vue. |
+| `@security` | Security Expert | Encryption, Auth, Anti-Hack. |
+| `@debug` | Debug Expert | Log analysis, Root cause finding. |
+| `@business` | BA Expert | Business logic, Enterprise workflows. |
+| `@compliance` | Compliance Lawyer | Check GDPR, HIPAA, PCI-DSS compliance. |
+| `@architecture`| Architect | Review system diargams, Clean Code. |
+| `@gemini` | **Core System** | Root system rules (main config file). |
+
+---
+
+## 3. Agents (Personas)
+*AI can act as these roles automatically, or upon request.*
+
+*   **Orchestrator**: Conductor, Commander-in-chief.
+*   **Project Planner**: Planner.
+*   **Backend Specialist**: Back-end Logic.
+*   **Frontend Specialist**: Front-end UI.
+*   **Mobile Developer**: App (iOS/Android).
+*   **Game Developer**: Game Logic/Physics.
+*   **Cloud Architect**: Cloud Infra (AWS/GCP).
+*   **Performance Optimizer**: Speed Expert.
+*   **Security Auditor**: Security Reviewer.
+*   **SEO Specialist**: Marketing/SEO.
+*   **Quality Inspector**: QA/QC.
+*   **Documentation Writer**: Scribe.
+*   **Test Engineer**: Tester.
+*   **Debugger**: Error Hunter.
+*   **Codebase Expert**: Walking dictionary of the project.
+
+---
+
+## 4. Master Skills (Core Skills)
+*550+ Skills, these are the most used "Endgame" skills.*
+
+| Skill Name | Usage |
+| :--- | :--- |
+| `ai-engineer` | AI Apps, Chatbots, RAG. |
+| `api-documenter` | Write OpenAPI standard docs. |
+| `cloud-architect-master` | Multi-cloud system design. |
+| `database-migration` | Safe Database schema changes. |
+| `deployment-engineer` | CI/CD and Docker. |
+| `full-stack-scaffold` | Production-ready setup. |
+| `modern-web-architect` | Modern Web Arch (Next.js/React). |
+| `security-auditor` | Vulnerability checks. |
+| `seo-expert-kit` | Comprehensive SEO toolkit. |
+| `tdd-master-workflow` | Test-Driven Development flow. |
+| ... | *(And hundreds more in `.agent/skills` folder)* |
+
+---
+
+## 5. Shared Modules (Enterprise Libs)
+*Standard Enterprise modules automatically loaded.*
+
+*   `ai-master`: LLM & RAG Standards.
+*   `api-standards`: API Design Standards.
+*   `compliance`: Legal Protocols.
+*   `database-master`: Database Design Standards.
+*   `design-system`: UI/UX Design System.
+*   `domain-blueprints`: Industry Architectures.
+*   `i18n-master`: Localization.
+*   `infra-blueprints`: Infrastructure (Terraform) templates.
+*   `metrics`: Observability.
+*   `security-armor`: Security Hardening.
+*   `testing-master`: Testing Strategies.
+*   `ui-ux-pro-max`: Advanced UI Interactions.
+
+---
+
+> **Tip**: You don't need to memorize everything.
+> *   Need Action -> Type `/` and Tab.
+> *   Need Expertise -> Type `@` and Tab (or describe "call the backend guy").

package/docs/GLOSSARY.vi.md

@@ -12,33 +12,21 @@ Hãy dùng các từ khóa này để giao tiếp chính xác với AI.
 | :--- | :--- | :--- |
 | `/audit` | **Kiểm toán chất lượng** | Trước khi bàn giao, cần rà soát lỗi bảo mật/hiệu năng. |
 | `/brainstorm` | **Bão não ý tưởng** | Bí ý tưởng, cần AI gợi ý giải pháp/kiến trúc. |
-| `/create` | **Khởi tạo tính năng** | Xây dựng module mới (FE + BE + DB). |
-| `/debug` | **Gỡ lỗi** | Phân tích log lỗi và tìm nguyên nhân. |
-| `/deploy` | **Triển khai** | Đẩy ứng dụng lên Server/Cloud. |
+| `/create` | **Khởi tạo dự án** | Bắt đầu một dự án mới từ con số 0. |
+| `/debug` | **Gỡ lỗi** | Khi code chạy sai, quăng log lỗi cho AI phân tích. |
+| `/deploy` | **Triển khai** | Đóng gói và đẩy ứng dụng lên Server/Cloud. |
 | `/document` | **Viết tài liệu** | Tự động viết README, API Docs từ code. |
-| `/enhance` | **Nâng cấp** | Thay đổi UI hoặc tối ưu logic nhỏ. |
-| `/monitor` | **Giám sát** | Setup công cụ theo dõi hệ thống. |
-| `/onboard` | **Dẫn nhập** | Hướng dẫn cho thành viên mới gia nhập team. |
-| `/orchestrate` | **Điều phối** | Phối hợp nhiều Agent cho task lớn. |
-| `/plan` | **Lập kế hoạch** | Phân tích yêu cầu và thiết kế giải pháp. |
-| `/preview` | **Xem trước** | Chạy thử sản phẩm trong sandbox. |
-| `/security` | **Quét bảo mật** | Kiểm tra lỗ hổng chuyên sâu. |
-| `/seo` | **Tối ưu tìm kiếm** | Đưa web lên Top Search Google/AI. |
-| `/status` | **Trạng thái** | Dashboard tiến độ thực hiện task. |
-| `/test` | **Kiểm thử** | Chạy Unit Test, E2E Test. |
-| `/ui-ux-pro-max`| **Giao diện Đỉnh cao**| Thiết kế UI Premium (Magic UI). |
-| `/update-docs` | **Đồng bộ tài liệu** | Tự động cập nhật /docs sau khi thay đổi code. |
-| `/release-version`| **Phát hành bản mới**| Chốt phiên bản, update stats và chuẩn bị release. |
-| `/api` | **Master API** | Thiết kế chuẩn OpenAPI 3.1. |
-| `/realtime` | **Thời gian thực** | Socket.io, WebRTC, SSE. |
-| `/compliance` | **Pháp lý** | Kiểm tra chuẩn GDPR/HIPAA. |
-| `/mobile` | **Di động** | Phát triển Native App & Optimization. |
-| `/portfolio` | **Trang cá nhân** | Xây dựng Landing Page cá nhân. |
-| `/blog` | **Hệ thống Blog** | Xây dựng module tin tức. |
-| `/visually` | **Trực quan hóa** | Vẽ biểu đồ, sơ đồ luồng. |
-| `/explain` | **Giải thích code** | Tìm hiểu logic sâu của từng module. |
-| `/update` | **Cập nhật Agent** | Tải bộ não mới nhất cho Agent. |
-| `/log-error` | **Nhật ký lỗi** | Tự động ghi lỗi vào ERRORS.md. |
+| `/enhance` | **Nâng cấp** | Muốn sửa UI đẹp hơn, hoặc tối ưu code cũ. |
+| `/monitor` | **Giám sát** | Cài đặt công cụ theo dõi Server/Logs. |
+| `/onboard` | **Dẫn nhập** | Tạo tài liệu hướng dẫn cho thành viên mới (Newbie). |
+| `/orchestrate` | **Điều phối** | Gọi "Hội đồng chuyên gia" giải quyết bài toán lớn. |
+| `/plan` | **Lập kế hoạch** | Phân tích yêu cầu -> Ra file `implementation_plan.md`. |
+| `/preview` | **Xem trước** | Chạy thử web/app để xem giao diện. |
+| `/security` | **Quét bảo mật** | Kiểm tra lỗ hổng chuyên sâu (Penetration Test). |
+| `/seo` | **Tối ưu tìm kiếm** | Giúp web lên Top Google (Meta tags, Sitemap). |
+| `/status` | **Trạng thái** | Xem báo cáo tiến độ dự án. |
+| `/test` | **Kiểm thử** | Viết và chạy Unit Test/E2E Test. |
+| `/ui-ux-pro-max`| **Giao diện Đỉnh cao**| Thiết kế UI đẹp như tranh vẽ (Magic UI/Linear). |
 
 ---
 
@@ -59,30 +47,23 @@ Hãy dùng các từ khóa này để giao tiếp chính xác với AI.
 ---
 
 ## 3. Agents (Những nhân cách AI)
-*Mỗi dự án v4.0 có 22 vai diễn chuyên gia:*
-
-*   **Orchestrator**: Nhạc trưởng điều phối đa agent.
-*   **Project Planner**: Lập kế hoạch & quản lý Backlog.
-*   **Product Manager**: Quản lý sản phẩm & lộ trình.
-*   **Product Owner**: Đại diện giá trị nghiệp vụ.
-*   **Backend Specialist**: Lập trình viên phía máy chủ.
-*   **Frontend Specialist**: Kiến trúc sư giao diện.
-*   **Mobile Developer**: Phát triển ứng dụng di động.
-*   **Game Developer**: Phát triển Game & Logic đồ họa.
-*   **Cloud Architect**: Kiến trúc sư hạ tầng đám mây.
-*   **DevOps Engineer**: Kỹ sư vận hành & CI/CD.
-*   **Database Architect**: Chuyên gia thiết kế dữ liệu.
-*   **Security Auditor**: Chuyên gia kiểm tra bảo mật.
-*   **Penetration Tester**: Hacker mũ trắng (Pentest).
-*   **Quality Inspector**: Giám sát tiêu chuẩn chất lượng.
-*   **QA Automation Engineer**: Kỹ sư kiểm thử tự động.
-*   **Test Engineer**: Kỹ sư kiểm tra tính năng.
+*AI có thể tự đóng các vai này trong quá trình làm việc, hoặc bạn yêu cầu.*
+
+*   **Orchestrator**: Nhạc trưởng, tổng chỉ huy.
+*   **Project Planner**: Người lập kế hoạch, chia việc.
+*   **Backend Specialist**: Chuyên Back-end.
+*   **Frontend Specialist**: Chuyên Front-end.
+*   **Mobile Developer**: Chuyên App (iOS/Android).
+*   **Game Developer**: Chuyên làm Game.
+*   **Cloud Architect**: Kiến trúc sư Cloud (AWS/GCP).
 *   **Performance Optimizer**: Chuyên gia tối ưu tốc độ.
-*   **SEO Specialist**: Chuyên gia tối ưu tìm kiếm.
-*   **Documentation Writer**: Chuyên gia viết tài liệu.
-*   **Explorer Agent**: Agent nghiên cứu & thám hiểm code.
-*   **Code Archaeologist**: Chuyên gia phân tích code cũ.
-*   **Debugger**: Thám tử săn lỗi (Sherlock Holmes).
+*   **Security Auditor**: Chuyên gia rà soát bảo mật.
+*   **SEO Specialist**: Chuyên gia Marketing/SEO.
+*   **Quality Inspector**: Người kiểm tra chất lượng (QA).
+*   **Documentation Writer**: Thư ký viết tài liệu.
+*   **Test Engineer**: Kỹ sư kiểm thử.
+*   **Debugger**: Thám tử săn lỗi.
+*   **Codebase Expert**: Cuốn từ điển sống của dự án.
 
 ---
 

package/docs/HOW_ANTIGRAVITY_THINKS.vi.md

@@ -16,7 +16,7 @@ Khi user bắt đầu một phiên làm việc:
     *   *Luật lệ*: Tôi biết những gì ĐƯỢC làm và CẤM làm (ví dụ: cấm xóa DB).
 2.  **Nạp Kỹ năng (Skill Injection)**:
     *   Dựa vào yêu cầu user (ví dụ: "Code React"), tôi tự động vào kho `.agent/skills` để lôi cổ thằng `nextjs-react-expert` ra dùng.
-    *   Tôi không nạp hết 72 Master Skills (tràn bộ nhớ), chỉ nạp cái cần thiết (Lazy Loading).
+    *   Tôi không nạp hết 550 skill (tràn bộ nhớ), chỉ nạp cái cần thiết (Lazy Loading).
 
 ## 2. Quy Trình Xử Lý Một Yêu Cầu (The Thinking Process)
 

package/docs/MASTER_GUIDE.md

@@ -0,0 +1,103 @@
+# 🛰️ Antigravity IDE - Master Operations Guide
+**Version**: 3.5.54 (Enterprise Multi-Agent Edition)
+**Language**: Tiếng Việt (Giao diện) - English (Technical)
+
+Chào mừng bạn đến với hệ thống Antigravity IDE đã được "độ" lên mức tối đa. Đây không còn là một công cụ lập trình thông thường, mà là một **Phòng tác chiến AI** với đầy đủ tri thức nghiệp vụ và dây chuyền sản xuất chuyên nghiệp.
+
+---
+
+## 🛠️ 1. Tiền đề (Prerequisites)
+Để hệ thống hoạt động với 100% công suất, bạn nên cài đặt:
+- **Node.js**: Để chạy lệnh cài đặt và quản lý gói.
+- **Python 3.x**: (**Khuyên dùng**) Để các Skill thực thi được các kịch bản tự động như Scanners, Evaluators.
+
+## 🚀 2. Khởi động nhanh (Quick Start)
+
+Để cài đặt hoặc cập nhật hệ thống lên mức Global (toàn cục), hãy sử dụng các lệnh sau:
+
+- **Cài đặt mới**: `npx antigravity-ide` (Cài vào thư mục hiện tại) hoặc `npx antigravity-ide [tên-dự-án]`.
+- **Cập nhật tính năng**: `npx antigravity-ide update` (Bảo tồn nội dung custom).
+
+---
+
+## 🏎️ 2. Chế độ Động cơ (Engine Modes)
+Antigravity hỗ trợ hai chế độ vận hành linh hoạt tùy theo nhu cầu dự án:
+
+- **Standard Mode (Node.js)**: 
+  - *Mục tiêu*: Nhẹ nhàng, tốc độ, Zero-Config.
+  - *Sử dụng*: Phù hợp dự án Web, Portfolio, SaaS vừa và nhỏ.
+  - *Yêu cầu*: Chỉ cần Node.js (đã có sẵn khi dùng npx).
+- **Advanced Mode (Python)**:
+  - *Mục tiêu*: Chuyên sâu, Bảo mật cao, AI phức tạp.
+  - *Sử dụng*: Phù hợp dự án Enterprise, Big Data, Pentest.
+  - *Yêu cầu*: Cần cài đặt Python 3.x trên hệ thống.
+
+Hệ thống sẽ tự động ưu tiên gọi công cụ tương ứng với chế độ bạn đã chọn trong `.config.json`.
+
+---
+
+## 🧠 3. Triết lý vận hành: Quy trình PDCA
+Hệ thống hoạt động theo chu kỳ quản trị 4 bước để đảm bảo không bao giờ có code lỗi hoặc thiết kế cẩu thả:
+
+1.  **🔴 PLAN (Planner)**: Sử dụng `/plan` để Agent phác thảo PRD và bản kế hoạch chi tiết (Task Breakdown). **Bạn duyệt xong Agent mới được làm.**
+2.  **🔵 DO (Workers)**: Các chuyên gia (Backend, Frontend, Security, DB) sẽ thi công song song dựa trên bản kế hoạch đã duyệt.
+3.  **🟡 CHECK (Inspector)**: `quality-inspector` sẽ thanh tra code dựa trên bộ chỉ số `metrics` và danh sách `scenarios` kiểm thử.
+4.  **🟢 ACT (Orchestrator)**: `orchestrator` tổng hợp báo cáo và đưa ra quyết định cuối cùng (Merge code hoặc yêu cầu Worker sửa lại).
+
+---
+
+## 🎭 3. Hệ thống Agent Chuyên gia (Specialist Agents)
+
+Mỗi Agent trong hệ thống đều có "não bộ" riêng được nạp qua các file `.md` trong kho Global:
+
+- **`project-planner`**: Kiến trúc sư trưởng, người viết PRD và chia nhỏ task.
+- **`backend-specialist`**: Phù thủy Server/API, tuân thủ tuyệt đối API Standards và 3NF Database.
+- **`frontend-specialist`**: Nghệ sĩ giao diện, chuyên gia về Premium UI/UX và Micro-interactions.
+- **`security-auditor`**: Hiệp sĩ bảo vệ, soi lỗi XSS, SQL Injection qua bộ `security-armor`.
+- **`quality-inspector`**: Thanh tra viên, người "bắt lỗi" dựa trên benchmarks và scenarios.
+- **`orchestrator`**: Vị thuyền trưởng điều phối toàn bộ luồng công việc.
+
+---
+
+## 📚 4. Kho tài nguyên Shared (`.shared/`)
+Đây là nơi lưu trữ "DNA" của hệ thống, giúp Agent thông minh hơn theo thời gian:
+
+| Th mục | Nội dung |
+| :--- | :--- |
+| `domain-blueprints` | Tri thức nghiệp vụ: Fintech, Healthcare, Logistics, F&B, Real Estate... |
+| `api-standards` | Chuẩn giao tiếp: Response format, Error codes, Auth patterns, Naming. |
+| `database-master` | Các Schema mẫu chuẩn 3NF cho Auth, E-commerce, CMS. |
+| `design-system` | Presets thẩm mỹ (Luxury, Tech, Soft) và quy chuẩn Micro-interactions. |
+| `security-armor` | Bộ quy tắc "bất khả xâm phạm" cho ứng dụng. |
+| `testing-master` | Kho kịch bản kiểm thử (Test Scenarios) cho các luồng thanh toán, đăng nhập. |
+| `compliance` | Mẫu pháp lý: Chính sách bảo mật (Privacy Policy) và Điều khoản (TOS). |
+| `metrics` | Các chỉ số Benchmarks về tốc độ và chất lượng code. |
+| `core` | Hệ điều hành (OS) của Agent: Tính cách cốt lõi, Cấu trúc dự án mẫu (Archetypes). |
+
+---
+
+## ⌨️ 5. Hệ thống lệnh Slash Command (`/`)
+
+Sử dụng phím **`/`** trong khung chat để kích hoạt các Workflow chuyên sâu:
+
+- `/brainstorm`: Lên ý tưởng, cấu trúc dự án.
+- `/create`: Khởi tạo dự án mới, App Builder.
+- `/plan`: Lập kế hoạch, phân rã tác vụ.
+- `/ui-ux-pro-max`: Thiết kế giao diện Premium.
+- `/orchestrate`: Điều phối đa Agent phức tạp.
+- `/audit`: Kiểm định chất lượng toàn diện (Security, SEO).
+- `/security`: Hardening & Bảo mật chuyên sâu.
+- `/seo`: Tối ưu hóa tìm kiếm & Growth.
+- `/onboard`: Hướng dẫn thành viên mới.
+- `/document`: Tự động viết tài liệu.
+- `/monitor`: Thiết lập giám sát vận hành.
+- `/status`: Xem Dashboard tiến độ.
+
+---
+
+## 🛡️ 6. Nguyên tắc "Vỏ Việt - Lõi Anh"
+- **Giao tiếp với người dùng**: Ưu tiên tiếng Việt súc tích, chuyên nghiệp.
+- **Tư duy Kỹ thuật**: Sử dụng tiếng Anh cho biến, hàm, kiến trúc để Agent đạt hiệu suất cao nhất và code dễ bảo trì toàn cầu.
+
+---
+**Antigravity IDE - Sẵn sàng bẻ gãy mọi quy luật trọng lực để đưa dự án của bạn lên tầm cao mới.** 🚀🛰️