antigravity-ide 4.2.0 → 4.2.1

package/LICENSE

@@ -17,39 +17,25 @@ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
 ================================================================================
-UNIVERSAL ACKNOWLEDGEMENTS & REFERENCES
+ACKNOWLEDGEMENTS & REFERENCES
 ================================================================================
 
-This project is authored and maintained by Dokhacgiakhoa.
-Antigravity IDE (Enhanced Edition) draws significant inspiration and inherits 
-open-source knowledge from the following masters and repositories:
+This project is maintained by Dokhacgiakhoa.
+It incorporates concepts and references from the following open source projects:
 
-1. Antigravity Kit (Core Reference)
-   - Original Author: vudovn
+1. Antigravity Kit (Ref: Structure)
+   - Original Author: VUDOVN
    - Link: https://github.com/vudovn/antigravity-kit
 
-2. Antigravity Awesome Skills (Skill Metadata Reference)
+2. Antigravity Awesome Skills (Ref: Skill Data)
    - Original Author: sickn33
    - Link: https://github.com/sickn33/antigravity-awesome-skills
 
-3. UI/UX Pro Max (Design Philosophy Reference)
+3. UI/UX Pro Max (Ref: Design Standards)
    - Original Author: sickn33
    - Link: https://github.com/sickn33/ui-ux-pro-max
 
-4. Model Context Protocol (MCP) standards
-   - Authors: Anthropic & Ecosystem Contributors
-   - Link: https://modelcontextprotocol.io/
-
-5. High-Performance Web Standards
-   - Inspiration: Vercel Engineering & Anthony Fu (antfu)
-
-6. Strategic Knowledge Extraction
-   - Inspiration: Fabric Patterns (danielmiessler)
-
-*Note: All trademarks and copyrights belong to their respective owners. 
-The references above reflect research-level inspiration and antecedent 
-contributions. These parties are not involved in the management of this repository.*
+*Note: The original authors listed above are credited for their antecedent work but are not involved in the maintenance of this derived repository.*

package/README.md

@@ -1,138 +1,108 @@
 <div align="center">
+  <img src="antigravity-ide-logo.svg" alt="AntiGravity IDE Logo" width="120">
 
-# 🛰️ AntiGravity IDE
-### *Advanced Edition • v4.1.30 Meta-Engine*
+  # AntiGravity IDE
+  ### Activate Senior Engineer Mindset for AI
 
-<!-- BADGES: Spaced & Tightly Wrapped to prevent Underlines -->
-<p align="center">
-  <a href="https://www.npmjs.com/package/antigravity-ide"><img src="https://img.shields.io/npm/v/antigravity-ide?color=2ea44f&logo=npm" alt="npm version" /></a>&nbsp;&nbsp;
-  <a href="https://www.npmjs.com/package/antigravity-ide"><img src="https://img.shields.io/npm/dm/antigravity-ide?color=blueviolet&logo=npm" alt="npm downloads" /></a>&nbsp;&nbsp;
-  <a href="https://github.com/Dokhacgiakhoa/antigravity-ide/actions"><img src="https://img.shields.io/github/actions/workflow/status/Dokhacgiakhoa/antigravity-ide/npm-publish.yml?logo=github&label=BUILD" alt="Build Status" /></a>&nbsp;&nbsp;
-  <a href="LICENSE"><img src="https://img.shields.io/npm/l/antigravity-ide?color=orange" alt="License" /></a>
-</p>
+  [English](./README.md) | [Tiếng Việt](./README.vi.md)
 
-<!-- SECOND ROW: Stats -->
-<p align="center">
-  <a href="https://socket.dev/npm/package/antigravity-ide"><img src="https://socket.dev/api/badge/npm/package/antigravity-ide" alt="Socket Badge" /></a>&nbsp;&nbsp;
-  <a href="https://github.com/Dokhacgiakhoa/antigravity-ide"><img src="https://img.shields.io/github/languages/code-size/Dokhacgiakhoa/antigravity-ide?color=blue" alt="Code Size" /></a>
-</p>
+  > **Upgrade your AI Agent from Intern to Lead Engineer.**
+  > 
+  > This is not an editor — it's a **Mindset Installer** that injects professional engineering standards directly into your AI's brain.
 
-<br>
+<a href="https://badge.fury.io/js/antigravity-ide"><img src="https://img.shields.io/npm/v/antigravity-ide?color=red" alt="npm version"></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-orange" alt="License: MIT"></a> <a href="https://npmjs.com/package/antigravity-ide"><img src="https://img.shields.io/npm/dm/antigravity-ide?color=yellow" alt="Downloads"></a> <a href="https://github.com/Dokhacgiakhoa/google-antigravity/stargazers"><img src="https://img.shields.io/github/stars/Dokhacgiakhoa/google-antigravity?color=green" alt="GitHub stars"></a> <a href="https://github.com/Dokhacgiakhoa/google-antigravity/graphs/contributors"><img src="https://img.shields.io/github/contributors/Dokhacgiakhoa/google-antigravity?color=blue" alt="Contributors"></a> <a href="https://github.com/Dokhacgiakhoa/google-antigravity/commits/main"><img src="https://img.shields.io/github/last-commit/Dokhacgiakhoa/google-antigravity?color=blueviolet" alt="Last Commit"></a> <a href="https://github.com/Dokhacgiakhoa/google-antigravity"><img src="https://img.shields.io/github/languages/code-size/Dokhacgiakhoa/google-antigravity?color=ff69b4" alt="Code Size"></a>
 
-**Easy Vibe, Lazy Code. One Command to Rule Them All.**
-
-[Explore Docs](https://antigravity-ide-cli.vercel.app/) • [Github](https://github.com/Dokhacgiakhoa/antigravity-ide) • [Report Bug](https://github.com/Dokhacgiakhoa/antigravity-ide/issues)
-
----
-
-### 📊 System Identity Matrix
-
-| **16** Rules | **573** Skills | **2977** Patterns | **30** Flows | **17** Core Libs |
+| **573** Skills | **38** Specialist Agents | **33** Patterns | **25** Rules | **20** Shared Libs |
 | :---: | :---: | :---: | :---: | :---: |
-| *Governance* | *Operational* | *Advanced AI* | *Standardized* | *Core Libraries* |
+| Enterprise Patterns | Role-Based Personas | PDCA Cycle | Security Armor | Shared Knowledge |
 
 </div>
 
-<br>
-
-## ⚡ Smart Installation (npx)
+---
 
-Antigravity uses a **Dual-Scope Strategy** to ensure absolute stability:
+## 🚀 1. Quick Start
 
-1.  **Global Scope (Project Root)**: Installs `GEMINI.md` (Configuration).
-2.  **Workspace Scope (`.agent/`)**: Installs Rules, Skills, and Workflows (The Brain).
+Scaffold your AI-ready environment in 30 seconds:
 
-```bash
-# ONE COMMAND TO RULE THEM ALL
-npx antigravity-ide [project-name]
+```sh
+npx antigravity-ide@latest
 ```
 
-> [!TIP]
-> **New to npx?** Check our [NPX Installation Guide](docs/INSTALL_NPX_GUIDE.md) for a step-by-step setup.
+### ✨ Setup Wizard (v4.2.1)
+Interactive CLI configuration with 3 defined tiers to match your computational resources:
 
----
-
-## ✨ The Premium Edge (v4.1.30)
-
-Why choose AntiGravity over standard AI wrappers?
-
-| Feature | **AntiGravity IDE** | Standard AI Wrappers |
-| :--- | :--- | :--- |
-| **🧠 Fractal Intelligence** | **573 Core Skills** with 2977 nested tactics | Single-purpose prompts |
-| **🛡️ Watchdog System** | Real-time hang detection & error learning | Direct failures / Silent crashes |
-| **🌊 Scale Adaptive** | Modular DNA for Instant, Creative, or SME | One-size-fits-all |
-| **🛠️ Self-Healing** | Auto-repair logic via unified god command | Manual JSON debugging |
-| **🔒 Provenance** | NPM Signed Builds (Sigstore) | Unverified builds |
-
----
+1.  **🌿 ECO (Basic - 96 Skills)**:
+    - **Target**: Gemini 1.5 Flash / Free Tier users.
+    - **Capabilities**: Essential features (Scaffolding, Patterns, Debugging).
+    - **Performance**: Lightweight, low token consumption, maximum speed.
 
-## 🎯 3 Steps to Your First App
+2.  **🏢 PRO (Professional - 216 Skills)**:
+    - **Target**: Gemini 1.5 Pro / Paid Users.
+    - **Capabilities**: Adds DevOps, Security Audits, Cloud Architecture, TDD workflows.
+    - **Performance**: Balanced power and context usage. Industry standard.
 
-1.  **Launch Terminal**: Open Command Prompt or Powershell.
-2.  **Execute God Command**: `npx antigravity-ide my-app`
-3.  **Talk to the Brain**: Interact with your new Virtual Team.
+3.  **🌌 ULTRA (Enterprise - 573 Skills)**:
+    - **Target**: Gemini 1.5 Ultra / High-Context Models (2M+ tokens).
+    - **Capabilities**: Full Fractal Knowledge. Includes Specialized verticals (Fintech, Edtech), Deep Research, and Multi-Agent Orchestration.
+    - **Performance**: Unlimited power.
 
 ---
 
-## 📂 Visual Brain Structure
+## 2. Documentation & Guides (Included in `docs/`)
+Comprehensive documentation is installed locally with every project. You don't need internet access to master the tool.
 
-A fracture-free, standardized architecture for scalable AI development.
+### 📘 Core Guides
+- **[Quick Install Guide](./docs/INSTALL_NPX_GUIDE.md)**:
+  *Step-by-step installation instructions and troubleshooting for first-time users.*
+- **[Master Guide](./docs/MASTER_GUIDE.md)**:
+  *The philosophy, core concepts, and architectural decisions behind Antigravity.*
+- **[Operational Flow](./docs/OPERATIONAL_FLOW.md)**:
+  *How to effectively run the PDCA (Plan-Do-Check-Act) cycle with AI agents.*
 
-```text
-your-project/
-├── .agent/              # 🧠 THE BRAIN (Fractal Core)
-│   ├── .shared/         # ⛩️ Core Library (API/DB/Security Standards)
-│   ├── rules/           # ⚖️ Governance (Compliance, Context)
-│   ├── skills/          # 🛠️ Mastery (573 Fractal Skills)
-│   └── workflows/       # 🚀 Ops (/create, /debug, /audit)
-└── GEMINI.md            # 📋 Agent Identity & Configuration
-```
+### 📙 Reference Manuals
+- **[Skills Catalog](./docs/SKILLS.md)**:
+  *Complete list of all 573 capabilities, triggers, and usage examples.*
+- **[Agent Roster](./docs/AGENTS_GUIDE.vi.md)**:
+  *Profiles of the 42 Specialist Agents (Frontend, Backend, Security, etc.) available to you.*
+- **[Workflow Library](./docs/WORKFLOW_GUIDE.vi.md)**:
+  *Catalog of 21 standardized workflows (e.g., /plan, /create, /deploy).*
+- **[Rules & Protocols](./docs/RULES_GUIDE.vi.md)**:
+  *Security guardrails, coding standards, and operational laws.*
 
-> [!NOTE]
-> **Scope Definition**: 
-> - **Global**: The CLI Tool (`npx antigravity-ide`) acts as the installer.
-> - **Workspace**: All Rules (`.agent/rules`), Skills, and Workflows are installed **Locally** into your project. This ensures total isolation context.
-
----
+### 🛠️ Support
+- **[Glossary](./docs/GLOSSARY.md)**: *Definitions of terms (Fractal, PDCA, MCP).*
+- **[Troubleshooting](./docs/TROUBLESHOOTING.md)**: *Common issues and solutions.*
 
-## 🚀 Power Commands
-
-| Command | Action | Logic |
-| :--- | :--- | :--- |
-| `npx antigravity-ide .` | **Repair / Sync** | Scans Global (`GEMINI.md`) & Workspace (`.agent`). Fills gaps. |
-| `npx antigravity-ide validate` | **Health Check** | Verifies integrity of both scopes. |
-| `npx antigravity-ide update` | **Upgrade** | Updates Core DNA while respecting Scope boundaries. |
 
 ---
 
-## ❓ Frequent Questions
-
-<details>
-<summary><strong>Q: Is this just another AI wrapper?</strong></summary>
-A: No. Wrappers are stateless. Antigravity installs a **Fractal Memory System** (`.agent` folder) directly into your project. It gives your AI long-term memory, context awareness, and self-correction capabilities.
-</details>
+## 📊 Resource Matrix
 
-<details>
-<summary><strong>Q: What is "Pure Install"?</strong></summary>
-A: Starting from v4.1.23, we stripped all bloat. No internal scripts, no dev dependencies. You get **only** the production artifacts needed to run your AI team.
-</details>
+<div align="center">
 
-<details>
-<summary><strong>Q: Can I customize the Agents?</strong></summary>
-A: Yes. "Agents" are now dynamic personas powered by **Skills**. You can teach them new tricks by adding files to `.agent/skills/` or editing `GEMINI.md`. The system adapts to your instructions instantly.
-</details>
+| Mode | Skills | Agents | Workflows | Rules | Shared Modules |
+| :--- | :---: | :---: | :---: | :---: | :---: |
+| **🌿 ECO** | 151 | 5 | 6 | 2 | 3 |
+| **🏢 PRO** | 296 | 10 | 11 | 5 | 10 |
+| **🌌 ULTRA** | 573 | 38 | 33 | 25 | 20 |
 
-<br>
+</div>
 
----
+## 📂 Project Structure
 
-- **[Gemini Usage Guide](docs/GEMINI_USAGE.md)**: How to configure and use with Google Gemini.
-- **[Master Operations](docs/MASTER_OPERATIONS.md)**: Deep dive into the IDE's core mechanics.
-- **[Publishing Guide](docs/PUBLISHING_GUIDE.md)**: How to release your own Agent packages.
+```text
+project-name/
+├── .agent/           # 🧠 THE BRAIN: Agent DNA, Skills & Rules
+│   ├── .shared/      # ⛩️ Master Knowledge (API, DB, Design)
+│   ├── agents/       # 🎭 Specialist Agent Personas
+│   └── skills/       # 🛠️ 550+ Mission-Ready Skills
+├── src/              # 🏗️ YOUR APPLICATION SOURCE CODE
+├── docs/             # 📘 Offline Documentation
+├── GEMINI.md         # ⚙️ Agent Configuration (Root Context)
+├── ERRORS.md         # 🐛 Auto-generated Error Log
+└── README.md         # 📖 Project Guide
+```
 
 ---
 
-<div align="center">
-  Developed with 💡 by <strong>Dokhacgiakhoa</strong><br>
-  <a href="LICENSE">MIT LICENSE</a>
-</div>
+**Antigravity IDE** - Breaking the laws of gravity to elevate your projects. 🛰️🚀

package/README.vi.md

@@ -1,138 +1,158 @@
 <div align="center">
+  <img src="antigravity-ide-logo.svg" alt="AntiGravity IDE Logo" width="120">
 
-# 🛰️ AntiGravity IDE
-### *Phiên bản Nâng cao • v4.1.30 Meta-Engine*
+  # AntiGravity IDE
+  ### Activate Senior Engineer Mindset for AI
 
-<!-- BADGES: Spaced & Tightly Wrapped to prevent Underlines -->
-<p align="center">
-  <a href="https://www.npmjs.com/package/antigravity-ide"><img src="https://img.shields.io/npm/v/antigravity-ide?color=2ea44f&logo=npm" alt="npm version" /></a>&nbsp;&nbsp;
-  <a href="https://www.npmjs.com/package/antigravity-ide"><img src="https://img.shields.io/npm/dm/antigravity-ide?color=blueviolet&logo=npm" alt="npm downloads" /></a>&nbsp;&nbsp;
-  <a href="https://github.com/Dokhacgiakhoa/antigravity-ide/actions"><img src="https://img.shields.io/github/actions/workflow/status/Dokhacgiakhoa/antigravity-ide/npm-publish.yml?logo=github&label=BUILD" alt="Build Status" /></a>&nbsp;&nbsp;
-  <a href="LICENSE"><img src="https://img.shields.io/npm/l/antigravity-ide?color=orange" alt="License" /></a>
-</p>
+  [English](./README.md) | [Tiếng Việt](./README.vi.md)
 
-<!-- SECOND ROW: Stats -->
-<p align="center">
-  <a href="https://socket.dev/npm/package/antigravity-ide"><img src="https://socket.dev/api/badge/npm/package/antigravity-ide" alt="Socket Badge" /></a>&nbsp;&nbsp;
-  <a href="https://github.com/Dokhacgiakhoa/antigravity-ide"><img src="https://img.shields.io/github/languages/code-size/Dokhacgiakhoa/antigravity-ide?color=blue" alt="Code Size" /></a>
-</p>
+  > **Biến AI Agent từ một Thực tập viên thành Kỹ sư trưởng.**
+  > 
+  > Đây không phải là trình soạn thảo code — Đây là **Hệ điều hành Tư duy** giúp nạp tiêu chuẩn chuyên nghiệp (PDCA, Security, Architecture) trực tiếp vào não bộ AI.
 
-<br>
+<a href="https://badge.fury.io/js/antigravity-ide"><img src="https://img.shields.io/npm/v/antigravity-ide?color=red" alt="npm version"></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-orange" alt="License: MIT"></a> <a href="https://npmjs.com/package/antigravity-ide"><img src="https://img.shields.io/npm/dm/antigravity-ide?color=yellow" alt="Downloads"></a> <a href="https://github.com/Dokhacgiakhoa/google-antigravity/stargazers"><img src="https://img.shields.io/github/stars/Dokhacgiakhoa/google-antigravity?color=green" alt="GitHub stars"></a> <a href="https://github.com/Dokhacgiakhoa/google-antigravity/graphs/contributors"><img src="https://img.shields.io/github/contributors/Dokhacgiakhoa/google-antigravity?color=blue" alt="Contributors"></a> <a href="https://github.com/Dokhacgiakhoa/google-antigravity/commits/main"><img src="https://img.shields.io/github/last-commit/Dokhacgiakhoa/google-antigravity?color=blueviolet" alt="Last Commit"></a> <a href="https://github.com/Dokhacgiakhoa/google-antigravity"><img src="https://img.shields.io/github/languages/code-size/Dokhacgiakhoa/google-antigravity?color=ff69b4" alt="Code Size"></a>
 
-**Vibe thoải mái, Code thảnh thơi. Một lệnh duy nhất cân cả thế giới.**
+| **573** Skills | **38** Specialist Agents | **33** Patterns | **25** Rules | **20** Shared Libs |
+| :---: | :---: | :---: | :---: | :---: |
+| Enterprise Standard | Role-Based Personas | PDCA Cycle | Security Armor | Shared Knowledge |
 
-[Trang chủ](https://antigravity-ide-cli.vercel.app/) • [Github](https://github.com/Dokhacgiakhoa/antigravity-ide) • [Báo lỗi](https://github.com/Dokhacgiakhoa/antigravity-ide/issues)
+</div>
 
 ---
 
-### 📊 Ma trận Năng lực Hệ thống
+## 🚀 1. Quick Start (Scaffolding)
 
-| **16** Quy tắc | **573** Kỹ năng | **2977** Chiến thuật | **30** Quy trình | **17** Core Libs |
-| :---: | :---: | :---: | :---: | :---: |
-| *Quản trị* | *Công cụ lõi* | *Mẫu AI Nâng cao* | *Chuẩn hóa* | *DNA Dùng chung* |
+Sử dụng CLI để thiết lập môi trường tác chiến trong 30 giây:
 
-</div>
+```sh
+# 1. New Project (Khuyên dùng - Luôn tải bản mới nhất)
+npx antigravity-ide@latest project_name
 
-<br>
+# 2. Install trực tiếp vào thư mục hiệnại
+npx antigravity-ide@latest
+```
 
-## ⚡ Cơ Chế Cài Đặt Thông Minh (Smart Sync)
+> [!WARNING]
+> **Lưu ý quan trọng:** Không nên cài đặt Global (`npm install -g antigravity-ide`) vì sẽ gây xung đột phiên bản. Luôn dùng `npx ...@latest` để đảm bảo Project được khởi tạo với Engine mới nhất.
 
-Antigravity sử dụng chiến lược **Dual-Scope Installation** để đảm bảo sự ổn định:
+### ✨ Setup Wizard (v4.2.1)
+Trải nghiệm Premium CLI với 3 cấp độ tài nguyên Resource:
 
-1.  **Global Scope (Gốc Dự Án)**: Cài đặt `GEMINI.md` (Cấu hình định danh).
-2.  **Workspace Scope (Thư mục .agent)**: Cài đặt Rules, Skills, Workflows (Bộ não).
+1.  **🌿 ECO (Basic - 96 Skills)**:
+    - **Mục tiêu**: Gemini 1.5 Flash / Free Tier.
+    - **Capabilities**: Core Skills (Scaffolding, Patterns, Debugging).
+    - **Hiệu năng**: Nhẹ, siêu tốc, tiết kiệm token tối đa.
 
-```bash
-# MỘT LỆNH DUY NHẤT CHO TẤT CẢ
-npx antigravity-ide [ten-du-an]
-```
+2.  **🏢 PRO (Professional - 216 Skills)**:
+    - **Mục tiêu**: Gemini 1.5 Pro / Paid Account.
+    - **Capabilities**: Bổ sung DevOps, Security Audit, Cloud Architecture, TDD.
+    - **Hiệu năng**: Cân bằng hoàn hảo giữa sức mạnh và ngữ cảnh. Enterprise Standard.
 
-> [!TIP]
-> **Mới dùng npx?** Xem [Hướng dẫn Cài đặt](docs/INSTALL_NPX_GUIDE.vi.md) để bắt đầu.
+3.  **🌌 ULTRA (Enterprise - 573 Skills)**:
+    - **Mục tiêu**: Gemini 1.5 Ultra / Large Context Model (2M+ tokens).
+    - **Capabilities**: Full Fractal Knowledge. Bao gồm Vertical Skills (Fintech, Edtech), Deep Research và Multi-Agent Orchestration.
+    - **Hiệu năng**: Sức mạnh không giới hạn.
 
 ---
 
-## ✨ Điểm khác biệt (Phiên bản v4.1.30)
+## 2. Documentation System (Offline Docs)
+Bộ tài liệu chi tiết được cài sẵn trong thư mục `docs/`. Bạn có thể tra cứu Offline bất cứ lúc nào.
 
-Tại sao nên chọn AntiGravity thay vì các AI wrapper thông thường?
+### 📘 Core Guides
+- **[Quick Install Guide](./docs/INSTALL_NPX_GUIDE.vi.md)**:
+  *Các bước cài đặt nhanh và troubleshooting cho người mới.*
+- **[Master Guide](./docs/MASTER_GUIDE.vi.md)**:
+  *Triết lý thiết kế, các concept cốt lõi và kiến trúc hệ thống Antigravity.*
+- **[Operational Flow](./docs/OPERATIONAL_FLOW.vi.md)**:
+  *Standard PDCA Operational Workflow (Plan-Do-Check-Act) với AI.*
 
-| Tính năng | **AntiGravity IDE** | Wrapper AI thông thường |
-| :--- | :--- | :--- |
-| **🧠 Trí tuệ Fractal** | **573 Kỹ năng** với 2977 chiến thuật | Chỉ là các câu prompt rời rạc |
-| **🛡️ Hệ thống Watchdog** | Phát hiện treo & Tự học từ lỗi dự án | Hay bị kẹt / Lỗi im lặng |
-| **🌊 Scale Adaptive** | DNA linh hoạt cho Instant/Creative/SME | Một khuôn mẫu cho mọi dự án |
-| **🛠️ Self-Healing** | Tự sửa lỗi cấu hình qua 1 lệnh duy nhất | Phải sửa JSON thủ công |
-| **🔒 Provenance** | Build được ký số (NPM Sigstore) | Không xác thực nguồn gốc |
+### 📙 Reference Manuals
+- **[Skills Catalog](./docs/SKILLS_GUIDE.vi.md)**:
+  *Danh sách chi tiết 573 Skills, triggers và ví dụ.*
+- **[Agent Roster](./docs/AGENTS_GUIDE.vi.md)**:
+  *Profile năng lực của 42 Specialist Agents (Frontend, Backend, Security...).*
+- **[Workflow Library](./docs/WORKFLOW_GUIDE.vi.md)**:
+  *Thư viện 21 Standard Workflows (ví dụ: /plan, /create, /deploy).*
+- **[Rules & Protocols](./docs/RULES_GUIDE.vi.md)**:
+  *Rules, Security Standards và Coding Protocols.*
 
----
+### 🛠️ Support
+- **[Glossary](./docs/GLOSSARY.vi.md)**: *Định nghĩa thuật ngữ (Fractal, PDCA, MCP).*
+- **[Troubleshooting](./docs/TROUBLESHOOTING.vi.md)**: *Các lỗi phổ biến và giải pháp xử lý.*
 
-## 🎯 3 Bước để Bắt đầu
 
-1.  **Mở Terminal**: Command Prompt hoặc Powershell.
-2.  **Chạy Lệnh Vạn Năng**: `npx antigravity-ide ten-du-an`
-3.  **Trò chuyện với AI**: Bắt đầu làm việc với đội ngũ ảo của bạn.
+    > **"wake up [agent-name]"**
+    
+    *(Ví dụ: "wake up Jarvis")*
 
----
+AI sẽ tự động đọc file cấu hình `.agent/GEMINI.md` và tải toàn bộ Skills vào bộ nhớ đệm.
 
-## 📂 Cấu trúc Dự án (Visual Tree)
+---
 
-Kiến trúc chuẩn hóa, dễ dàng mở rộng và bảo trì.
+## 🧠 2. The Heart of System: Thư mục `.agent`
 
-```text
-du-an-cua-ban/
-├── .agent/              # 🧠 BỘ NÃO (Fractal Core)
-│   ├── .shared/         # ⛩️ Thư viện lõi (API/DB/Security Standards)
-│   ├── rules/           # ⚖️ Quản trị (Compliance, Context)
-│   ├── skills/          # 🛠️ Kỹ năng (573 Fractal Skills)
-│   └── workflows/       # 🚀 Quy trình (/create, /debug, /audit)
-└── GEMINI.md            # 📋 Cấu hình định danh Agent
-```
+Thư mục `.agent` chứa toàn bộ "Brain" của hệ thống:
 
-> [!NOTE]
-> **Định Nghĩa Phạm Vi (Scope)**:
-> - **Global (Toàn cầu)**: Bộ công cụ CLI (`npx antigravity-ide`) dùng để cài đặt & quản lý.
-> - **Workspace (Dự án)**: Toàn bộ Quy tắc (`.agent/rules`), Kỹ năng và Quy trình được cài đặt **Cục bộ** vào từng dự án riêng biệt. Đảm bảo trí tuệ của dự án này không bị rò rỉ sang dự án khác.
+- **Specialist Agent Personas**: Planner, Backend/Frontend Specialists, Security Auditor và Orchestrator.
+- **PDCA Workflow (Plan-Do-Check-Act)**: AI không code tùy tiện. Nó phải Plan -> Execute -> Check -> Approve.
+- **Shared Knowledge (`.shared/`)**: Chứa Project DNA như API Standards, DB Schema, Compliance Docs và các Domain Blueprints (Fintech, Edtech...).
 
 ---
 
-## 🚀 Lệnh Nâng Cao (Power Commands)
+## ⚡ 3. Slash Commands (`/`) & Updates
 
-| Lệnh | Hành động | Logic Xử Lý |
-| :--- | :--- | :--- |
-| `npx antigravity-ide .` | **Sửa Chữa / Đồng Bộ** | Quét cả Global (`GEMINI.md`) & Workspace (`.agent`). Bù file thiếu. |
-| `npx antigravity-ide validate` | **Kiểm Tra Sức Khỏe** | Xác minh tính toàn vẹn của cả 2 phạm vi. |
-| `npx antigravity-ide update` | **Nâng Cấp** | Cập nhật Core DNA nhưng tôn trọng ranh giới Scope (không ghi đè ẩu). |
+Kích hoạt các Workflows chuyên sâu ngay trong chat:
+
+- `/plan`: Project Planner & Phân rã Task.
+- `/create`: Xây dựng cấu trúc Project Foundation.
+- `/ui-ux-pro-max`: Thiết kế Premium UI/UX & Micro-interactions.
+- `/orchestrate`: Orchestrate Multi-Agent giải quyết bài toán phức tạp.
+- `/log-error`: Tự động log error kèm phân tích nguyên nhân và giải pháp.
+- `/research`: (Mới) Kích hoạt **FastCode Search** tra cứu mã nguồn siêu tốc (Native Node.js).
+- `/design-2026`: (New) Áp dụng **Frontend Trends 2026** (Liquid Glass, Bento Grid...).
+
+### System Update
+Để cập nhật Antigravity Brain lên bản mới nhất mà không mất các cấu hình custom:
+```sh
+npx antigravity-ide update
+```
 
 ---
 
-## ❓ Câu Hỏi Thường Gặp
+## 📊 Resource Matrix (Chỉ số tài nguyên)
 
-<details>
-<summary><strong>Q: Đây có phải chỉ là AI wrapper nữa không?</strong></summary>
-A: Không. Wrapper thì vô tri (stateless). Antigravity cài đặt một **Hệ Thống Ký Ức Fractal** (thư mục .agent) trực tiếp vào dự án. Nó mang lại khả năng ghi nhớ dài hạn, nhận thức ngữ cảnh và tự sửa lỗi.
-</details>
+<div align="center">
 
-<details>
-<summary><strong>Q: "Pure Install" là gì?</strong></summary>
-A: Từ v4.1.23, chúng tôi loại bỏ hoàn toàn mã thừa. Không script nội bộ, không file rác. Bạn chỉ nhận được **đúng** những gì cần thiết để vận hành đội ngũ AI.
-</details>
+| Chế độ (Mode) | Skills | Agents | Workflows | Rules | Shared Modules |
+| :--- | :---: | :---: | :---: | :---: | :---: |
+| **🌿 ECO** | 151 | 5 | 6 | 2 | 3 |
+| **🏢 PRO** | 296 | 10 | 11 | 5 | 10 |
+| **🌌 ULTRA** | 573 | 38 | 33 | 25 | 20 |
 
-<details>
-<summary><strong>Q: Tôi có thể tùy chỉnh Agent không?</strong></summary>
-A: Có. "Agent" giờ đây là các vai trò động dựa trên **Kỹ năng (Skills)**. Bạn có thể dạy họ chiêu mới bằng cách thêm file vào `.agent/skills/` hoặc sửa `GEMINI.md`. Hệ thống sẽ tự học ngay lập tức.
-</details>
+</div>
 
-<br>
+## 📂 Project Structure
+
+```text
+project-name/
+├── .agent/           # 🧠 THE BRAIN: Agent DNA, Skills & Rules
+│   ├── .shared/      # ⛩️ Master Knowledge (API, DB, Design)
+│   ├── agents/       # 🎭 Specialist Agent Personas
+│   └── skills/       # 🛠️ 550+ Combat Tools
+├── src/              # 🏗️ YOUR APPLICATION SOURCE CODE 
+├── docs/             # 📘 Offline Documentation
+├── GEMINI.md         # ⚙️ Agent Configuration (Root Context)
+├── ERRORS.md         # 🐛 Auto-generated Error Log
+└── README.md         # 📖 Project Guide
+```
 
 ---
 
-- **[Hướng dẫn Gemini](docs/GEMINI_USAGE.md)**: Cách cấu hình và sử dụng với Google Gemini.
-- **[Vận hành Master](docs/MASTER_OPERATIONS.vi.md)**: Tìm hiểu sâu về cơ chế cốt lõi.
-- **[Hướng dẫn Phát hành](docs/PUBLISHING_GUIDE.md)**: Cách đóng gói và xuất bản Agent của riêng bạn.
+## ️ Philosophy "Vietnamese Shell - English Core"
+
+- **Giao tiếp**: Tiếng Việt (Trực quan, súc tích).
+- **Kỹ thuật**: Tiếng Anh (Biến, hàm, logic - Đảm bảo hiệu suất AI cao nhất).
 
 ---
 
-<div align="center">
-  Phát triển với 💡 bởi <strong>Dokhacgiakhoa</strong><br>
-  <a href="LICENSE">MIT LICENSE</a>
-</div>
+**Antigravity IDE** - Phá bỏ mọi giới hạn, đưa dự án của bạn lên tầm cao mới. 🛰️🚀

package/action.yml

@@ -0,0 +1,32 @@
+name: 'AntiGravity IDE Setup'
+description: 'Install and configure AntiGravity IDE in your CI/CD workflow.'
+author: 'Dokhacgiakhoa'
+inputs:
+  project-name:
+    description: 'Name of the project to create'
+    required: false
+    default: 'my-antigravity-project'
+  rules:
+    description: 'Scale Config: instant, creative, or sme'
+    required: false
+    default: 'creative'
+  template:
+    description: 'Project Template: minimal, standard, full'
+    required: false
+    default: 'standard'
+  product:
+    description: 'Product Type: user_app, dev_tool, ai_agent, digital_asset'
+    required: false
+    default: 'user_app'
+  skip-prompts:
+    description: 'Skip interactive prompts (auto-confirm)'
+    required: false
+    default: 'true'
+
+runs:
+  using: 'node20'
+  main: 'dist/index.js' # We might need to bundle this first or point to cli/index.js if dependencies are handled
+
+branding:
+  icon: 'cpu'
+  color: 'purple'