antigravity-ide 4.2.1 → 4.3.3

package/README.md

@@ -1,108 +1,141 @@
 <div align="center">
-  <img src="antigravity-ide-logo.svg" alt="AntiGravity IDE Logo" width="120">
 
-  # AntiGravity IDE
-  ### Activate Senior Engineer Mindset for AI
+# 🛰️ AntiGravity IDE
+### *Advanced Edition • v4.3.3 Meta-Engine*
 
-  [English](./README.md) | [Tiếng Việt](./README.vi.md)
+<!-- 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>
 
-  > **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.
+<!-- 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>&nbsp;&nbsp;
+  <img src="https://img.shields.io/badge/Files-10.9k-blueviolet" alt="Total Files" />&nbsp;&nbsp;
+  <img src="https://img.shields.io/badge/Lines_of_Code-669k-ff69b4" alt="Lines of Code" />
+</p>
 
-<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>
+<br>
 
-| **573** Skills | **38** Specialist Agents | **33** Patterns | **25** Rules | **20** Shared Libs |
+**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 | **30** Flows | **10.9k** Files | **669k** Lines |
 | :---: | :---: | :---: | :---: | :---: |
-| Enterprise Patterns | Role-Based Personas | PDCA Cycle | Security Armor | Shared Knowledge |
+| *Governance* | *Operational* | *Standardized* | *Workspace* | *Codebase* |
 
 </div>
 
----
+<br>
+
+## ⚡ Smart Installation (npx)
 
-## 🚀 1. Quick Start
+Antigravity uses a **Dual-Scope Strategy** to ensure absolute stability:
 
-Scaffold your AI-ready environment in 30 seconds:
+1.  **Global Scope (Project Root)**: Installs `GEMINI.md` (Configuration).
+2.  **Workspace Scope (`.agent/`)**: Installs Rules, Skills, and Workflows (The Brain).
 
-```sh
-npx antigravity-ide@latest
+```bash
+# ONE COMMAND TO RULE THEM ALL
+npx antigravity-ide [project-name]
 ```
 
-### ✨ Setup Wizard (v4.2.1)
-Interactive CLI configuration with 3 defined tiers to match your computational resources:
+> [!TIP]
+> **New to npx?** Check our [NPX Installation Guide](docs/INSTALL_NPX_GUIDE.md) for a step-by-step setup.
 
-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.
+---
+
+## ✨ The Premium Edge (v4.3.3)
+
+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 |
+
+---
 
-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.
+## 🎯 3 Steps to Your First App
 
-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.
+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.
 
 ---
 
-## 2. Documentation & Guides (Included in `docs/`)
-Comprehensive documentation is installed locally with every project. You don't need internet access to master the tool.
+## 📂 Visual Brain Structure
 
-### 📘 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.*
+A fracture-free, standardized architecture for scalable AI development.
 
-### 📙 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.*
+```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
+```
 
-### 🛠️ Support
-- **[Glossary](./docs/GLOSSARY.md)**: *Definitions of terms (Fractal, PDCA, MCP).*
-- **[Troubleshooting](./docs/TROUBLESHOOTING.md)**: *Common issues and solutions.*
+> [!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.
+
+---
 
+## 🚀 Power Commands
+
+| Command | Action | Logic |
+| :--- | :--- | :--- |
+| `npx antigravity-ide manager` | **Manager View** | Launches Realtime Swarm Dashboard (Agent-First Mode). |
+| `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. |
 
 ---
 
-## 📊 Resource Matrix
+## ❓ Frequent Questions
 
-<div align="center">
+<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>
 
-| 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: 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>
+<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>
 
-## 📂 Project Structure
+<br>
 
-```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
-```
+---
+
+- **[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.
 
 ---
 
-**Antigravity IDE** - Breaking the laws of gravity to elevate your projects. 🛰️🚀
+<div align="center">
+  Developed with 💡 by <strong>Dokhacgiakhoa</strong><br>
+  <a href="LICENSE">MIT LICENSE</a>
+</div>

package/README.vi.md

@@ -1,158 +1,141 @@
 <div align="center">
-  <img src="antigravity-ide-logo.svg" alt="AntiGravity IDE Logo" width="120">
 
-  # AntiGravity IDE
-  ### Activate Senior Engineer Mindset for AI
+# 🛰️ AntiGravity IDE
+### *Phiên bản Nâng cao • v4.3.3 Meta-Engine*
 
-  [English](./README.md) | [Tiếng Việt](./README.vi.md)
+<!-- 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>
 
-  > **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.
+<!-- 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>&nbsp;&nbsp;
+  <img src="https://img.shields.io/badge/Tệp-10.9k-blueviolet" alt="Total Files" />&nbsp;&nbsp;
+  <img src="https://img.shields.io/badge/Dòng_Code-669k-ff69b4" alt="Lines of Code" />
+</p>
 
-<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>
+<br>
 
-| **573** Skills | **38** Specialist Agents | **33** Patterns | **25** Rules | **20** Shared Libs |
-| :---: | :---: | :---: | :---: | :---: |
-| Enterprise Standard | Role-Based Personas | PDCA Cycle | Security Armor | Shared Knowledge |
+**Vibe thoải mái, Code thảnh thơi. Một lệnh duy nhất cân cả thế giới.**
 
-</div>
+[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)
 
 ---
 
-## 🚀 1. Quick Start (Scaffolding)
+### 📊 Ma trận Năng lực Hệ thống
 
-Sử dụng CLI để thiết lập môi trường tác chiến trong 30 giây:
+| **16** Quy tắc | **573** Kỹ năng | **30** Quy trình | **10.9k** Tệp | **669k** Dòng |
+| :---: | :---: | :---: | :---: | :---: |
+| *Quản trị* | *Công cụ lõi* | *Chuẩn hóa* | *Không gian* | *Mã nguồn* |
 
-```sh
-# 1. New Project (Khuyên dùng - Luôn tải bản mới nhất)
-npx antigravity-ide@latest project_name
+</div>
 
-# 2. Install trực tiếp vào thư mục hiệnại
-npx antigravity-ide@latest
-```
+<br>
 
-> [!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.
+## ⚡ Cơ Chế Cài Đặt Thông Minh (Smart Sync)
 
-### ✨ Setup Wizard (v4.2.1)
-Trải nghiệm Premium CLI với 3 cấp độ tài nguyên Resource:
+Antigravity sử dụng chiến lược **Dual-Scope Installation** để đảm bảo sự ổn định:
 
-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.
+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).
 
-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.
+```bash
+# MỘT LỆNH DUY NHẤT CHO TẤT CẢ
+npx antigravity-ide [ten-du-an]
+```
 
-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.
+> [!TIP]
+> **Mới dùng npx?** Xem [Hướng dẫn Cài đặt](docs/INSTALL_NPX_GUIDE.vi.md) để bắt đầu.
 
 ---
 
-## 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.
+## ✨ Điểm khác biệt (Phiên bản v4.3.3)
 
-### 📘 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ại sao nên chọn AntiGravity thay vì các AI wrapper thông thường?
 
-### 📙 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ý.*
+| 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 |
 
+---
 
-    > **"wake up [agent-name]"**
-    
-    *(Ví dụ: "wake up Jarvis")*
+## 🎯 3 Bước để Bắt đầu
 
-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.
+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.
 
 ---
 
-## 🧠 2. The Heart of System: Thư mục `.agent`
-
-Thư mục `.agent` chứa toàn bộ "Brain" của hệ thống:
+## 📂 Cấu trúc Dự án (Visual Tree)
 
-- **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...).
+Kiến trúc chuẩn hóa, dễ dàng mở rộng và bảo trì.
 
----
+```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
+```
 
-## ⚡ 3. Slash Commands (`/`) & Updates
+> [!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.
 
-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...).
+## 🚀 Lệnh Nâng Cao (Power Commands)
 
-### 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
-```
+| Lệnh | Hành động | Logic Xử Lý |
+| :--- | :--- | :--- |
+| `npx antigravity-ide manager` | **Manager View** | Mở bảng điều khiển Swarm thời gian thực (Agent-First Mode). |
+| `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). |
 
 ---
 
-## 📊 Resource Matrix (Chỉ số tài nguyên)
+## ❓ Câu Hỏi Thường Gặp
 
-<div align="center">
+<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>
 
-| 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: "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>
 
-</div>
+<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>
 
-## 📂 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
-```
+<br>
 
 ---
 
-## ️ 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).
+- **[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.
 
 ---
 
-**Antigravity IDE** - Phá bỏ mọi giới hạn, đưa dự án của bạn lên tầm cao mới. 🛰️🚀
+<div align="center">
+  Phát triển với 💡 bởi <strong>Dokhacgiakhoa</strong><br>
+  <a href="LICENSE">MIT LICENSE</a>
+</div>