antigravity-ide 4.2.0 → 4.2.1

package/docs/OPERATIONAL_FLOW.md

@@ -0,0 +1,147 @@
+# Operational Flow Guide 📘
+
+> **Foreword**: Building software is a **long conversation** between the Boss (User) and the Employee (AI). This document is not theory; it provides **Sample Transcripts** of 5 real-world projects so you can copy-paste and learn how to "command" effectively.
+
+---
+
+## 🎯 Case Study 1: E-commerce Platform (Web Fullstack) 🛒
+**Difficulty**: High | **Timeline**: 2 weeks (equiv) | **Focus**: Database, API, State Management.
+
+### Phase 1: Kickoff & Foundation (10%)
+> **Boss**: `/create` (select SME, Industry F&B)
+>
+> **Boss**: `/plan`
+> **Prompt**: "I want to build a Sneaker store. Needs Homepage, Detail page, Cart, and Admin Dashboard. Analyze what Tables we need in the Database?"
+>
+> **Boss**: *Approves plan* -> "Ok, plan looks good. Create the folder structure."
+
+### Phase 2: Backend & Database (30%)
+> **Boss**: "Now design the Database Schema. Use PostgreSQL."
+> **Context**: `@database-architect`
+> **Prompt**: "Create `schema.sql`. Need `Users`, `Products` (with size, color), `Orders`, `OrderItems` tables. Add an Index to the `price` column for faster filtering."
+>
+> **Boss**: "Now write the Register/Login API."
+> **Context**: `@backend` `@security`
+> **Prompt**: "Create POST `/auth/register` API. Validate email strictly. Password must be hashed with Bcrypt. Return a JWT Token."
+>
+> **Boss**: *Tests and finds error* -> `/debug`
+> **Prompt**: "I sent a Login request but got 500. Log says: `Cannot read property 'hash' of undefined`. Fix ASAP."
+> **Context**: `@debug`
+
+### Phase 3: Frontend (40%)
+> **Boss**: "Switch to UI. Use Next.js."
+> **Context**: `@frontend` `@ui-ux-pro-max`
+> **Prompt**: "Create `ProductCard` component. Requirements: Large image, bold title, red price. On hover, the card should elevate (shadow)."
+>
+> **Boss**: "Make the Shopping Cart page."
+> **Context**: `@frontend`
+> **Prompt**: "Create `/cart` page. Use Zustand for cart state management. Show product list, quantity toggle, and subtotal."
+>
+> **Boss**: "Ugly. Fix the CSS."
+> **Context**: `@ui-ux-pro-max`
+> **Prompt**: "The 'Checkout' button looks cheap. Change it to an orange-purple gradient, rounded corners, and add a Shopping Bag icon."
+
+### Phase 4: Integration & Polish (20%)
+> **Boss**: "Connect API to Frontend."
+> **Prompt**: "On Login page, when user clicks Submit, call `/auth/login` API. If success, save token to localStorage and redirect to Home."
+>
+> **Boss**: "Check performance."
+> **Context**: `@performance`
+> **Prompt**: "Run Lighthouse audit on Home page. Optimize images and lazy load heavy components for me."
+
+---
+
+## 🎯 Case Study 2: Mobile Game "Flappy Clone" (Indie Game) 🎮
+**Difficulty**: Medium | **Focus**: Logic, Physics, Performance.
+
+### Phase 1: Core Logic
+> **Boss**: `/create` (select Mobile & Game)
+>
+> **Boss**: "Write gravity logic for the bird."
+> **Context**: `@game-development`
+> **Prompt**: "Create `Bird` class. Have an `update()` function. Every frame `y` increases (falls). When calling `flap()`, `velocity` jumps up. Tune numbers to feel like real Flappy Bird."
+
+### Phase 2: Gameplay Loop
+> **Boss**: "Make obstacles (Pipes)."
+> **Prompt**: "Create `PipeManager` class. Spawn a pipe pair (top/bottom) every 2 seconds. Pipes move right to left. If bird collides, Game Over."
+
+### Phase 3: Polish
+> **Boss**: "Add sound."
+> **Prompt**: "Play `sfx_wing.mp3` when flying. Play `sfx_hit.mp3` on death."
+>
+> **Boss**: `/debug` (Game stutters)
+> **Context**: `@performance`
+> **Prompt**: "Game lags after playing a while. I suspect too many objects are created without deletion. Check for memory leaks in `PipeManager`?"
+
+---
+
+## 🎯 Case Study 3: Digital Banking (Fintech Enterprise) 🏦
+**Difficulty**: Very Hard | **Focus**: Security, Audit, Compliance.
+
+### Phase 1: Hardening
+> **Boss**: `/create` (select Enterprise, Finance)
+>
+> **Boss**: "Design security architecture."
+> **Context**: `@security-auditor`
+> **Prompt**: "Review `server.js`. Ensure Helmet, Rate Limiting, and CORS are strictly configured. Block strange IPs from Admin API."
+
+### Phase 2: Sensitive Logic
+> **Boss**: "Write money transfer function."
+> **Context**: `@backend` `@database-architect`
+> **Prompt**: "Write `transferMoney` function. MUST use Database Transaction. Debit A and Credit B must happen simultaneously. Rollback immediately on error. Log everything to Audit table."
+
+### Phase 3: Audit
+> **Boss**: `/audit`
+> **Context**: `@compliance`
+> **Prompt**: "Scan entire code for accidental logging of sensitive info (Card numbers, Phone). Project must comply with PCI-DSS."
+
+---
+
+## 🎯 Case Study 4: Personal Blog (Personal Brand) ✍️
+**Difficulty**: Easy | **Focus**: SEO, Speed, Content.
+
+> **Boss**: `/create` (Personal)
+>
+> **Boss**: "Write Home page intro."
+> **Context**: `@seo-expert-kit`
+> **Prompt**: "Write intro content introducing me as an AI Engineer with 5 years exp. Embed keywords like 'AI Consultant', 'Machine Learning' for Google ranking."
+>
+> **Boss**: "Add Dark Mode."
+> **Context**: `@frontend`
+> **Prompt**: "Add Light/Dark toggle in top right. Save setting to local storage."
+>
+> **Boss**: `/deploy` -> "Push to Vercel for me."
+
+---
+
+## 🎯 Case Study 5: Data Processing Tool (Python AI Lab) 🐍
+**Difficulty**: Specialist | **Focus**: Python, Data, Charts.
+
+> **Boss**: `/create` (select Advanced - Python)
+> **Boss**: *Sees Python missing warning* -> "Ok, run the install command."
+>
+> **Boss**: "Write script to read Excel."
+> **Context**: `@data-engineer`
+> **Prompt**: "Use `pandas` to read `sales.xlsx`. Clean data: Remove empty rows, fill 0 for missing values."
+>
+> **Boss**: "Draw chart."
+> **Context**: `@ai-engineer`
+> **Prompt**: "Use `matplotlib` to plot line chart of monthly revenue. Export to `chart.png`."
+
+---
+
+## 📝 Summary of "Magic Spells" (Prompt Patterns)
+
+1.  **"Role - Task - Standard" Model**:
+    *   *Basic*: "Write login code." (Vague)
+    *   *Pro*: "Act as `@security`, write Login API (`Task`), require password hash and Anti-Brute Force (`Standard`)."
+
+2.  **"Evidence-based Debugging" Model**:
+    *   *Basic*: "Code is broken, fix it." (AI guesses)
+    *   *Pro*: "Call `/debug`. I got `Error: connection refused` at line 50 of `db.js`. Analyze if it's config port issue or DB not running?"
+
+3.  **"Iterative" Model**:
+    *   Lap 1: "Create basic UI first."
+    *   Lap 2: "Add CSS to make it pretty."
+    *   Lap 3: "Optimize code to be cleaner."
+    *   *(Don't force AI to be perfect in the very first prompt)*.

package/docs/OPERATIONAL_FLOW.vi.md

@@ -4,15 +4,6 @@
 
 ---
 
-## 🛡️ Cơ chế Bảo vệ & Tự học (The Watchdog v4.0.8)
-
-Dự án v4.0.8 tích hợp sẵn hệ thống giám sát cấp cao:
-- **Chống Treo & Lặp**: Agent tự ngắt các tác vụ bị kẹt và báo cáo cho User.
-- **Học Từ Sai Lầm**: Mọi lỗi (Test fail, Agent hiểu sai) đều được ghi vào `ERRORS.md` để rút kinh nghiệm cho lần sau.
-- **Kỷ Luật PDCA**: Mọi task đều đi qua chu kỳ Lập kế hoạch -> Thực thi -> Kiểm tra -> Cải tiến.
-
----
-
 ## 🎯 Case Study 1: Sàn Thương mại Điện tử (Web Fullstack) 🛒
 **Độ khó**: Cao | **Thời gian**: 2 tuần quy đổi | **Trọng tâm**: Database, API, State Management.
 
@@ -154,9 +145,3 @@ Dự án v4.0.8 tích hợp sẵn hệ thống giám sát cấp cao:
     *   Vòng 2: "Thêm CSS cho đẹp."
     *   Vòng 3: "Tối ưu code cho gọn."
     *   *(Đừng bắt AI làm hoàn hảo ngay từ lệnh đầu tiên)*.
-
-4.  **Mô hình "Bảo trì Thần tốc"**:
-    *   Khi thấy Agent chạy chệch hướng hoặc Rules bị cũ: "Chạy `npx antigravity-ide` để **Repair & Sync** toàn bộ hệ thống ngay lập tức."
-
----
-*Cẩm nang này sẽ được cập nhật liên tục theo các phiên bản mới của Antigravity IDE.*

package/docs/PLAN-upgrade-core-architecture.md

@@ -0,0 +1,71 @@
+# PLAN: Upgrade Core Architecture to Context-Aware Rules
+
+> **Goal**: Refactor `.agent/rules` from a monolithic design to a modular, context-aware structure leveraging Antigravity's advanced triggers (Glob, Model Decision).
+
+---
+
+## 1. Analysis & Strategy
+
+**Current State:**
+- Single `GEMINI.md` file doing everything.
+- Wasted context tokens (loading Backend rules when working on CSS).
+- Lack of file-specific enforcement.
+
+**Target State:**
+- **Modular**: Separate files for Security, Frontend, Backend, DevOps.
+- **Context-Aware**:
+  - `glob`: Load Frontend rules ONLY for `.tsx/.css`.
+  - `model_decision`: Load Debug rules ONLY when needed.
+  - `always_on`: Keep Security & Personality active globally.
+
+---
+
+## 2. Execution Phase (Task Breakdown)
+
+### Phase 2.1: Refactor Global Rules (`rules/`)
+
+- [ ] **Update `GEMINI.md`**
+  - **Trigger**: `always_on`
+  - **Content**: Agent Identity, Core Ethics, PDCA Cycle, Socratic Gate.
+  
+- [ ] **Create `security.md`**
+  - **Trigger**: `always_on`
+  - **Content**: OWASP Top 10, Secret Management, `rm -rf` protection.
+
+- [ ] **Create `frontend.md`**
+  - **Trigger**: `glob: "**/*.{js,jsx,ts,tsx,css,scss,html}"`
+  - **Content**: UI/UX Premium, Component patterns, State management.
+
+- [ ] **Create `backend.md`**
+  - **Trigger**: `glob: "**/*.{py,js,ts,go,rs,sql,php}"` (Exclude frontend-only paths if possible, or assume overlap)
+  - **Content**: API Standards, DB Schema 3NF, Error Handling.
+
+- [ ] **Create `debug.md`**
+  - **Trigger**: `model_decision` ("When the user needs to fix bugs, analyze errors, or troubleshoot issues.")
+  - **Content**: Root cause analysis, systematically reading files, test-first fix.
+
+### Phase 2.2: Standardize Workflows (`workflows/`)
+
+- [ ] Audit all 11 workflows.
+- [ ] Ensure valid YAML frontmatter with `description` for correct Slash Command mapping.
+
+### Phase 2.3: System Synchronization
+
+- [ ] Update `setup.js` to ensure recursive copying of the new `rules/` structure.
+- [ ] Update `README.vi.md` to explain the new "Context-Aware Rule System".
+
+---
+
+## 3. Verification Checklist
+
+1. **Security Check**: Is `security.md` loaded even when editing a simple text file? (Yes, via `always_on`).
+2. **Context Check**: Does `frontend.md` load when I open `App.tsx`?
+3. **Smart Check**: Does `debug.md` load when I say "Fix this error"?
+
+---
+
+## 4. Agent Assignments
+
+- **Architect**: `project-planner` (Created this plan)
+- **Implementer**: `orchestrator` (Will execute file creations)
+- **Validator**: `quality-inspector` (Will verify rule triggers)

package/docs/{PUBLISHING_GUIDE.md → PUBLISHING.md}

@@ -3,16 +3,13 @@
 ## ✅ Published Successfully!
 
 **Package:** `antigravity-ide`  
-**Version:** `4.0.8`  
-**Published:** 2026-02-08  
+**Version:** `4.2.1`  
+**Published:** 2026-02-16  
 **Link:** https://www.npmjs.com/package/antigravity-ide
 
 ---
 
-
-> **⚠️ QUAN TRỌNG**: Chỉ thực hiện quy trình này khi **ĐƯỢC NGƯỜI DÙNG YÊU CẦU**. Tuyệt đối không tự ý release.
-
-## 1. Pre-flight Checklist (Tự động)
+## Pre-publish Checklist
 
 All steps completed:
 
@@ -179,28 +176,3 @@ npm owner add <username> antigravity-ide
 ---
 
 **Congratulations! Your package is now live on npm! 🎉**
-
----
-
-## GitHub Packages Support
-
-This project is configured to **Dual Publish**:
-1. **npm Registry**: `antigravity-ide` (Public, Unscoped)
-2. **GitHub Packages**: `@Dokhacgiakhoa/antigravity-ide` (Scoped to repository owner)
-
-### How it works
-The `release.yml` workflow automatically renames the package to `@Dokhacgiakhoa/antigravity-ide` *only* during the GitHub Packages publishing step. This ensures the source code remains `antigravity-ide` for npm compatibility.
-
-### Installing from GitHub Packages
-To install the scoped version from GitHub:
-
-1. Create a `.npmrc` file in your project:
-   ```ini
-   @Dokhacgiakhoa:registry=https://npm.pkg.github.com
-   //npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN
-   ```
-
-2. Install:
-   ```bash
-   npm install @Dokhacgiakhoa/antigravity-ide
-   ```

package/docs/RULES_GUIDE.vi.md

@@ -1,96 +1,60 @@
-# 📜 Hướng Dẫn Sử Dụng "Luật Hệ Thống" (Rules System) v4.0.8
+# 📜 Hướng Dẫn Sử Dụng "Luật Hệ Thống" (Rules System)
 
-> **Cơ chế hoạt động**: Antigravity sử dụng cơ chế **Hybrid Language Protocol** (Song ngữ Anh-Việt) để tối ưu hóa cả khả năng hiểu của AI và sự tiện lợi cho đội ngũ phát triển.
+> **Cơ chế hoạt động**: Antigravity sử dụng cơ chế **Hybrid Trigger** (Kết hợp Tự động & Gọi tên) để đảm bảo code vừa nhanh vừa chuẩn.
 
 ---
 
-## 0. Triết lý "Mục đích kép" (Dual Audience)
-
-Các file trong thư mục `.agent/rules/` được thiết kế để phục vụ cùng lúc 2 đối tượng:
-
-1.  **🤖 AI Agent (Constraint Layer)**:
-    -   Đóng vai trò là "Rào chắn" (Guardrails).
-    -   Ví dụ: Khi Agent đọc rule `code-quality.md`, nó biết ngay lệnh cấm: *"No console.log in production"*.
-    -   Agent hiểu hoàn hảo cả Tiếng Anh (Keyword) và Tiếng Việt (Context).
-
-2.  **👨‍💻 Human Team (Standard Layer)**:
-    -   Đóng vai trò là "Cẩm nang phát triển" (Wiki).
-    -   Thành viên mới gia nhập dự án có thể đọc để nắm bắt Coding Style, Quy trình Git, Bảo mật.
-    -   Sử dụng Tiếng Việt giúp anh em dev nắm bắt nhanh hơn, tránh rào cản ngôn ngữ.
-
-3.  **🏢 Professional Protocol (Compliance Layer)**:
-    -   Mọi Rule hiện nay đều được liên kết trực tiếp vào các Phase của **Unified Protocol** (Discovery, Planning, Execution, Audit).
-    -   Agent không thể bỏ qua Rule nếu muốn pass qua giai đoạn **Audit**.
-
----
-
-## 1. Giao thức Ngôn ngữ Lai (Hybrid Language Protocol)
-
-Để đạt hiệu quả tối đa, hệ thống áp dụng quy tắc ngôn ngữ sau:
-
-| Thành phần | Ngôn ngữ | Lý do | Ví dụ |
-| :--- | :--- | :--- | :--- |
-| **Logic Cốt lõi** | 🇬🇧 **Tiếng Anh** | Chính xác cho máy, keyword chuẩn quốc tế. | `Metadata`, `Variable Name`, `Anti-Patterns` |
-| **Giải thích/Ngữ cảnh** | 🇻🇳 **Tiếng Việt** | Tự nhiên, dễ hiểu cho người Việt. | "Mục tiêu: Đảm bảo mã nguồn sạch..." |
-| **Cấu hình (Config)** | 🇬🇧 **Tiếng Anh** | Bắt buộc do cú pháp hệ thống. | `json`, `yaml`, `regex` |
-
----
-
-## 2. Phân Loại Rules
+## 1. Phân Loại Rules
 
 ### 🤖 Nhóm Tự Động (Auto-Active)
 *Luôn chạy ngầm, bạn không cần gọi.*
 
-| Rule | Chức năng | Ngôn ngữ |
+| Rule | Kích hoạt khi | Chức năng |
 | :--- | :--- | :--- |
-| **`GEMINI.md`** | **Hiến pháp lõi**: Định hình nhân dạng, tính cách và các mode vận hành (Solo/Team/Factory). | Hybrid |
-| **`security.md`** | **Bảo mật**: Chặn hardcode API Key, SQL Injection, XSS. | Hybrid |
-| **`code-quality.md`** | **Chất lượng**: Quy định về Naming, Comments, Error Handling. | Hybrid |
-| **`frontend.md`** | **Giao diện**: Chuẩn hóa UI/UX, Responsive, Performance. | Hybrid |
-| **`backend.md`** | **Hệ thống**: Chuẩn Clean Architecture, API Response, DB Schema. | Hybrid |
-| **`testing-standard.md`** | **Kiểm thử**: Quy chuẩn Pyramid, Naming, Mocking & Coverage. | Hybrid |
-| **`malware-protection`** | **An toàn**: Chống virus, link độc hại và kiểm soát package. | English |
-| **`error-logging`** | **Học tập**: Tự động ghi lại lỗi vào ERRORS.md. | Hybrid |
-| **`docs-update`** | **Tài liệu**: Checklist tự động cập nhật docs khi có tính năng mới. | Hybrid |
-| **`system-update`** | **Hệ thống**: Tự động kiểm tra và nâng cấp Antigravity IDE. | Hybrid |
-| **`runtime-watchdog`** | **An toàn**: Chống treo, vòng lặp vô hạn và lỗi Agent phản hồi chậm. | Hybrid |
+| **`security`** | **Luôn luôn** | Chặn hardcode API Key, SQL Injection, XSS. |
+| **`frontend`** | File `.js`, `.css`, `.tsx` | Chuẩn hóa UI, Spacing, Responsive. |
+| **`backend`** | File `.py`, `.go`, `.sql` | Chuẩn Clean Architecture, API Response. |
+| **`gemini`** | **Luôn luôn** | Cấu hình lõi, tính cách Agent. |
 
 ### 🛠️ Nhóm Theo Yêu Cầu (On-Demand / @Tags)
 *Chỉ chạy khi có ngữ cảnh phù hợp hoặc được bạn gọi đích danh.*
 
 | Tag Gọi | Tên Rule | Chức năng |
 | :--- | :--- | :--- |
-| **`@biz`** | `business.md` | Kiểm tra logic nghiệp vụ, tính tiền, quyền hạn. |
-| **`@legal`** | `compliance.md` | Rà soát GDPR, bảo mật dữ liệu, Logging chuẩn. |
-| **`@arch`** | `architecture-review.md` | Đánh giá khả năng chịu tải, HA, Microservices. |
-| **`@debug`** | `debug.md` | Kích hoạt quy trình 4 bước: Điều tra -> Test -> Sửa -> Báo cáo. |
+| **`@biz`** | `business` | Kiểm tra logic nghiệp vụ, tính tiền, quyền hạn. |
+| **`@legal`** | `compliance` | Rà soát GDPR, bảo mật dữ liệu, Logging chuẩn. |
+| **`@arch`** | `architecture-review` | Đánh giá khả năng chịu tải, HA, Microservices. |
+| **`@debug`** | `debug` | Kích hoạt quy trình 4 bước: Điều tra -> Test -> Sửa -> Báo cáo. |
 
 ---
 
-## 3. Cách Sử Dụng Semantic Tags (@)
+## 2. Cách Sử Dụng Semantic Tags (@)
 
 Bạn có thể dùng ký tự `@` trong lệnh chat để **ép buộc** Agent tập trung vào một khía cạnh cụ thể.
 
-**Ví dụ thực tế:**
+### Ví dụ thực tế:
+
+**1. Khi Review Logic Tính Tiền:**
+> "Agent, hãy `@biz` check lại hàm tính thuế này xem có bị lỗi làm tròn số (Float) không?"
+*(Agent sẽ lôi `rules/business.md` ra để soi kỹ vấn đề Decimal vs Float)*
 
-1.  **Khi Review Logic Tính Tiền:**
-    > "Agent, hãy `@biz` check lại hàm tính thuế này xem có bị lỗi làm tròn số (Float) không?"
-    *(Agent sẽ lôi `rules/business.md` ra để soi kỹ vấn đề Decimal vs Float)*
+**2. Khi Audit Bảo Mật Dữ Liệu:**
+> "Code này `@legal` có vi phạm quy tắc log email người dùng không?"
+*(Agent sẽ đối chiếu với `rules/compliance.md` về PII masking)*
 
-2.  **Khi Audit Bảo Mật Dữ Liệu:**
-    > "Code này `@legal` có vi phạm quy tắc log email người dùng không?"
-    *(Agent sẽ đối chiếu với `rules/compliance.md` về PII masking)*
+**3. Khi Sửa Lỗi Khó:**
+> "Hệ thống đang bị lỗi 500, `@debug` điều tra giúp tôi."
+*(Agent kích hoạt chế độ Sherlock Holmes)*
 
-3.  **Khi Sửa Lỗi Khó:**
-    > "Hệ thống đang bị lỗi 500, `@debug` điều tra giúp tôi."
-    *(Agent kích hoạt chế độ Sherlock Holmes)*
+**4. Khi Thiết Kế Hệ Thống Lớn:**
+> "Tôi muốn xây dựng module Payment, `@arch` tư vấn giải pháp chịu tải cao."
+*(Agent dùng `rules/architecture-review.md` để tư vấn Redis/Queue)*
 
 ---
 
-## 4. Tại sao cần chia ra như vậy?
+## 3. Tại sao cần chia ra như vậy?
 
-*   **Tránh Overload**: Nếu nạp **tất cả** luật cùng lúc, Agent sẽ bị "quá tải" (Cognitive Overload).
-*   **Tăng độ chính xác**: Cơ chế **@Tags** giúp bạn điều hướng sự tập trung của Agent vào đúng chỗ cần thiết nhất.
-*   **Thân thiện**: Cách viết Hybrid giúp Rule trở nên "có hồn" hơn, giống như một người mentor đang hướng dẫn team.
+*   Nếu nạp **tất cả** luật cùng lúc: Agent sẽ bị "quá tải" (Cognitive Overload), dẫn đến xử lý chậm và hay quên các chi tiết nhỏ.
+*   Cơ chế **@Tags** giúp bạn điều hướng sự tập trung của Agent vào đúng chỗ cần thiết nhất tại thời điểm đó.
 
-> **Lời khuyên**: Hãy coi `rules/` là thư viện luật pháp của dự án. Khi cần ban hành luật mới, hãy tạo file mới hoặc sửa file cũ theo chuẩn Hybrid này.
+> **Mẹo**: Hãy coi các Rule này là các "Cố vấn chuyên môn". Khi cần ai, hãy gọi tên người đó!

package/docs/SHARED_LIBRARY_GUIDE.vi.md

@@ -11,30 +11,34 @@ Khi cần, Agent chỉ việc "copy-paste" ra dùng. Nhanh và Chuẩn.
 
 ---
 
-## 2. Danh mục 17 Kho Tàng (Modules) v4.0
+## 2. Danh mục 17 Kho Tàng (Modules)
 
-### 🏢 Nhóm Cốt Lõi (Core DNA)
-*   **`design-philosophy`**: Triết lý thiết kế (Linear, Magic UI).
-*   **`dx-toolkit`**: Công cụ hỗ trợ Dev (VSCode Settings, Linting).
-*   **`metrics`**: Cấu hình giám sát (Logging, Telemetry).
-*   **`vitals-templates`**: Tiêu chuẩn hiệu năng (Lighthouse Config).
+### 🧠 Cốt Lõi & AI
+*   **`ai-master`**: Chứa các Prompt mẫu, cấu hình RAG System.
+*   **`core`**: Cấu trúc dự án mẫu (Project Structure).
 
-### 🛠️ Nhóm Kỹ Thuật (Technical Stack)
-*   **`ai-master`**: Prompt mẫu, cấu hình RAG System.
+### 🛡️ Bảo Mật & Tuân Thủ
+*   **`security-armor`**: Bộ quy tắc chống hack (OWASP), script quét lỗ hổng.
+*   **`compliance`**: Mẫu pháp lý (Privacy Policy, GDPR Checklists).
 *   **`api-standards`**: Chuẩn thiết kế API (RESTful, Error Codes).
-*   **`database-master`**: Các mẫu Schema DB (E-commerce, SaaS).
+
+### 🎨 Giao Diện & Trải Nghiệm
 *   **`design-system`**: Bộ Token màu sắc, Typography chuẩn.
-*   **`i18n-master`**: Hệ thống đa ngôn ngữ.
+*   **`ui-ux-pro-max`**: Các hiệu ứng động cao cấp (Motion Presets).
+*   **`design-philosophy`**: Triết lý thiết kế (Linear, Magic UI).
+
+### 🏗️ Hạ Tầng & Vận Hành
+*   **`infra-blueprints`**: File cấu hình Docker, Terraform, CI/CD.
+*   **`database-master`**: Các mẫu Schema DB (E-commerce, Social, SaaS).
+*   **`metrics`**: Cấu hình giám sát (Logging, Telemetry).
 *   **`resilience-patterns`**: Mẫu thiết kế chịu lỗi (Circuit Breaker).
-*   **`security-armor`**: Bộ quy tắc chống hack (OWASP).
-*   **`seo-master`**: Checklist SEO, mẫu JSON-LD.
-*   **`testing-master`**: Chiến lược kiểm thử toàn diện.
-*   **`ui-ux-pro-max`**: Hiệu ứng động cao cấp.
 
-### 🌐 Nhóm Chuyên Biệt (Vertical Blueprints)
-*   **`compliance`**: Mẫu pháp lý (GDPR, HIPAA).
-*   **`domain-blueprints`**: Kiến trúc mẫu theo từng ngành nghề.
-*   **`infra-blueprints`**: Cấu hình hạ tầng (Docker, Terraform).
+### 📈 Tăng Trưởng & Chất Lượng
+*   **`seo-master`**: Checklist SEO, mẫu JSON-LD.
+*   **`testing-master`**: Kịch bản test mẫu (E2E, Unit Test).
+*   **`vitals-templates`**: Tiêu chuẩn hiệu năng (Lighthouse Config).
+*   **`i18n-master`**: File ngôn ngữ mẫu (Đa ngôn ngữ).
+*   **`dx-toolkit`**: Công cụ hỗ trợ Dev (VSCode Settings, Linting).
 
 ---