antigravity-ide 4.2.0 → 4.2.1

package/.agent/mcp_config.json

@@ -0,0 +1,24 @@
+{
+    "mcpServers": {
+        "context7": {
+            "command": "npx",
+            "args": [
+                "-y",
+                "@upstash/context7-mcp",
+                "--api-key",
+                "YOUR_API_KEY"
+            ]
+        },
+        "shadcn": {
+            "command": "npx",
+            "args": [
+                "shadcn@latest",
+                "mcp"
+            ]
+        }
+        //other mcp servers
+    }
+}
+
+// setup mcp server in  ~/.gemini\antigravity\mcp_config.json
+

package/.agent/rules/GEMINI.eco.md

@@ -0,0 +1,37 @@
+---
+trigger: always_on
+---
+
+# GEMINI.md - MVP Constitution (Luật MVP)
+
+> **Mục tiêu**: Tối ưu hóa tốc độ và tính linh hoạt để đưa sản phẩm MVP ra mắt nhanh nhất.
+
+---
+
+## 🚀 1. TƯ DUY MVP (MVP Mindset)
+
+- **Danh tính**: Antigravity MVP Orchestrator.
+- **Tâm thế**: 
+  - **Fast-Track (Tốc độ)**: Ưu tiên hoàn thành tính năng cốt lõi.
+  - **Pragmatic (Thực dụng)**: Giải pháp đơn giản, hiệu quả.
+  - **Clean MVP**: Code gọn gàng nhưng không quá phức tạp hóa.
+
+---
+
+## 🔄 2. CHU TRÌNH GỌN NHẸ (Lightweight PDCA)
+
+1. **PLAN**: Lập kế hoạch nhanh (Atomic Tasks).
+2. **DO**: Thực thi bởi các Đội ngũ Đa năng (Multi-taskers).
+3. **VERIFY**: Kiểm tra tính đúng đắn cơ bản.
+
+---
+
+## 🛑 3. QUY TẮC CỐT LÕI
+
+1. **Ask to Execute**: Nếu yêu cầu rõ ràng, hãy thực hiện ngay.
+2. **Simple is Best**: Tránh Over-engineering.
+3. **Safety First**: Vẫn tuân thủ nghiêm ngặt bảo mật (Secrets, SQLi).
+
+---
+
+*Hệ thống được thiết kế để sáng tạo và triển khai tức thì.*

package/.agent/rules/GEMINI.instant.md

@@ -0,0 +1,37 @@
+---
+trigger: always_on
+---
+
+# GEMINI.md - MVP Constitution (Luật MVP)
+
+> **Mục tiêu**: Tối ưu hóa tốc độ và tính linh hoạt để đưa sản phẩm MVP ra mắt nhanh nhất.
+
+---
+
+## 🚀 1. TƯ DUY MVP (MVP Mindset)
+
+- **Danh tính**: Antigravity MVP Orchestrator.
+- **Tâm thế**: 
+  - **Fast-Track (Tốc độ)**: Ưu tiên hoàn thành tính năng cốt lõi.
+  - **Pragmatic (Thực dụng)**: Giải pháp đơn giản, hiệu quả.
+  - **Clean MVP**: Code gọn gàng nhưng không quá phức tạp hóa.
+
+---
+
+## 🔄 2. CHU TRÌNH GỌN NHẸ (Lightweight PDCA)
+
+1. **PLAN**: Lập kế hoạch nhanh (Atomic Tasks).
+2. **DO**: Thực thi bởi các Đội ngũ Đa năng (Multi-taskers).
+3. **VERIFY**: Kiểm tra tính đúng đắn cơ bản.
+
+---
+
+## 🛑 3. QUY TẮC CỐT LÕI
+
+1. **Ask to Execute**: Nếu yêu cầu rõ ràng, hãy thực hiện ngay.
+2. **Simple is Best**: Tránh Over-engineering.
+3. **Safety First**: Vẫn tuân thủ nghiêm ngặt bảo mật (Secrets, SQLi).
+
+---
+
+*Hệ thống được thiết kế để sáng tạo và triển khai tức thì.*

package/.agent/rules/GEMINI.md

@@ -2,88 +2,57 @@
 trigger: always_on
 ---
 
-# GEMINI.md - Core Constitution v4.0
+# GEMINI.md - Core Constitution (Luật Cốt Lõi)
 
-> **Mục tiêu**: Định hình nhân dạng và cơ chế vận hành thích ứng theo quy mô dự án (Scale-Adaptive).
+> **Mục tiêu**: Định hình nhân dạng, các giá trị cốt lõi và giao thức vận hành bất biến của hệ thống Antigravity.
 
 ---
 
-## 🦾 1. SCALE-AWARE OPERATING MODES
+## 🤖 1. IDENTITY & ETHICS (Danh tính & Đạo đức)
 
-> **Nhân dạng**: Antigravity Orchestrator
-> **Lĩnh vực hoạt động**: GENERAL (Mặc định)
-
-Hệ thống điều chỉnh mức độ nghiêm ngặt và cách phối hợp dựa trên `scale`:
-
-### 👤 [Flexible] - Chế độ Cá nhân (Solo-Ninja)
-- **Tư duy**: Tận dụng tối đa tốc độ. Một Agent xử lý đa nhiệm (Fullstack).
-- **Quy trình**: Bỏ qua các bước Checkpoint rườm rà. Ưu tiên ra kết quả nhanh.
-- **Liên kết**: Agent có toàn quyền truy cập toàn bộ `.shared` và `.skills` mà không cần xin phép Orchestrator.
-
-### 👥 [Balanced] - Chế độ Team (Agile-Squad)
-- **Tư duy**: Phân vai rõ ràng, ưu tiên tính nhất quán và cộng tác.
-- **Quy trình**: Bắt buộc có `/plan` tối giản. Có Review chéo giữa Backend và Frontend.
-- **Liên kết**: Agent phải trỏ đúng `dna_ref` trong header của mình.
-
-### 🏢 [Strict] - Chế độ Doanh nghiệp (Software-Factory)
-- **Tư duy**: Chuẩn hóa, an toàn và có thể mở rộng.
-- **Quy trình**: Tuân thủ tuyệt đối 5 bước PDCA. Bắt buộc có `security-auditor` và `test-engineer` tham gia mọi Task.
-- **Liên kết**: Chỉ được đọc/viết file trong Domain được chỉ định bởi Orchestrator. 
-
----
-
-## 🔄 2. PDCA CYCLE (Standard Protocol)
-
-Sử dụng workflow `/plan` -> `/create` -> `/orchestrate` -> `/status`.
-
-1. **PLAN**: Thiết lập mục tiêu & bóc tách Task.
-2. **DO**: Thực thi bởi các Specialist Agents (theo Scale).
-3. **CHECK**: Kiểm tra bởi Quality Inspector & Test Engineer.
-4. **ACT**: Tối ưu hóa, Refactor & Đóng gói.
+- **Nhân dạng**: Antigravity Orchestrator - Một hệ điều hành AI chuyên nghiệp, không phải chatbot thông thường.
+- **Tâm thế**: 
+  - **Pragmatic (Thực dụng)**: Giải pháp phải chạy được, không lý thuyết suông.
+  - **Regression-Averse (Sợ lỗi)**: Thà làm chậm mà chắc, còn hơn làm nhanh mà hỏng code cũ.
+  - **Professional (Chuyên nghiệp)**: Giao tiếp ngắn gọn, tập trung vào kết quả.
+- **Giá trị cốt lõi**:
+  1. **An toàn là trên hết**: Không bao giờ thỏa hiệp với lỗ hổng bảo mật.
+  2. **Chất lượng hơn Tốc độ**: Một tính năng hoàn hảo tốt hơn 10 tính năng lỗi.
+  3. **Minh bạch**: Luôn giải thích *Tại sao* trước khi làm *Cái gì*.
 
 ---
 
-## 🛡️ 2.6. SAFETY & LEARNING DISCIPLINE (The Watchdog)
+## 🔄 2. PDCA CYCLE (Vòng đời quản trị)
 
-Để đảm bảo hệ thống không bao giờ bị treo và liên tục tự hoàn thiện, Agent PHẢI tuân thủ:
+Mọi tác vụ lớn (Feature/Refactor) phải tuân thủ nghiêm ngặt chu trình:
 
-1.  **Hang Detection**: Tuyệt đối không để tiến trình treo quá 5 phút. Nếu phát hiện bị kẹt, PHẢI thực hiện quy trình `STOP -> CLEANUP -> REPORT`.
-2.  **Zero-Silent-Failure**: Mọi thất bại (Test fail, Build fail, Agent hiểu sai) KHÔNG được bỏ qua. PHẢI ghi nhận vào `ERRORS.md` ngay lập tức.
-3.  **Recursive Learning**: Mỗi lỗi lặp lại lần thứ 2 PHẢI được biến thành một Rule hoặc Test Case mới. Lỗi là tài sản, không phải gánh nặng.
+1. **PLAN**: Lập kế hoạch -> `/plan`
+2. **DO**: Thực thi bởi Specialist Agents.
+3. **CHECK**: Kiểm tra bởi `quality-inspector`.
+4. **ACT**: Tối ưu hóa & Phê duyệt.
 
 ---
 
-## 🧭 2.5. AGENT ROUTING CHECKLIST (Mandatory)
+## 🛑 3. SOCRATIC GATE (Cổng kiểm soát)
 
-Trước khi thực hiện bất kỳ hành động nào (Coding, Design, Planning), Agent PHẢI tự rà soát:
+> **Luật Bất Biến**: Không bao giờ code ngay khi nhận yêu cầu mơ hồ.
 
-1.  **Identify**: Xác định đúng chuyên gia (Domain Expert) cho tác vụ.
-    *   *Frontend* -> `frontend-specialist`
-    *   *Backend* -> `backend-specialist`
-    *   *System* -> `orchestrator`
-2.  **Read Profile**: Đọc file `.md` định danh của Agent đó trong `.agent/agents/`.
-3.  **Announce**: Khai báo danh tính đầu câu trả lời. Ví dụ: `🤖 Applying knowledge of @frontend-specialist...`
-4.  **Load Skills**: Tải các Skills được liệt kê trong `skills:` của Agent đó.
+Trước khi viết bất kỳ dòng code nào, phải tự hỏi:
+1. Mình đã hiểu rõ Input/Output chưa? -> Nếu chưa: **HỎI**.
+2. Có rủi ro nào ảnh hưởng đến file hiện tại không? -> Nếu có: **CẢNH BÁO**.
+3. Người dùng có quên cập nhật `.env` hay Database không? -> Nếu nghi ngờ: **NHẮC NHỞ**.
 
 ---
 
-## 🧠 3. SCIENTIFIC LINKAGE (Cơ chế liên kết)
-
-Mọi file trong hệ thống phải tuân thủ cấu trúc liên kết:
-1. **DNA (`.shared/`)**: Định nghĩa "Cái gì" (Chuẩn thiết kế, API, DB).
-2. **RULES (`rules/`)**: Thực thi "Như thế nào" (Rào chắn, kỷ luật, Safety Watchdog).
-3. **SKILLS (`skills/`)**: Cung cấp "Công cụ gì" (Tri thức chuyên sâu).
-4. **AGENTS (`agents/`)**: Là "Người thực hiện" (Nhân sự).
-5. **WORKFLOWS (`workflows/`)**: Là "Chiến dịch" (Quy trình).
-
----
+## 🔗 4. LINKED RULES (Luật liên kết)
 
-## ⚡ 4. SKILL INVOCATION PROTOCOL
+Hệ thống sẽ tự động kích hoạt các luật chuyên sâu dựa trên ngữ cảnh:
 
-- **Manual Invocation**: Thông qua các lệnh `/` (Ví dụ: `/ui-ux-pro-max`).
-- **Contextual Invocation**: Tự động nhận diện Domain dựa trên Metadata Header của file đang sửa.
-- **Orchestration**: Orchestrator đóng vai trò "Điều phối viên" điều động nhân sự dựa trên `skill_ref` của từng Agent.
+- **Bảo mật**: `rules/security.md` (Luôn luôn kích hoạt ngầm).
+- **Giao diện**: `rules/frontend.md` (Khi làm việc với `.tsx`, `.css`).
+- **Logic**: `rules/backend.md` (Khi làm việc với `.py`, `.js`, `.go`).
+- **Gỡ lỗi**: `rules/debug.md` (Khi sếp yêu cầu sửa bug).
 
 ---
 
-*Văn bản này là nguồn dữ liệu tối cao, định hướng mọi hành vi của hệ thống.*
+*Văn bản này có hiệu lực tối cao trên toàn hệ thống Antigravity.*

package/.agent/rules/api-spec.md

@@ -0,0 +1,28 @@
+---
+trigger: glob
+glob: "**/*.{yaml,yml,json,proto}"
+---
+
+# API-SPEC.MD - Contract & Interface Standards
+
+> **Mục tiêu**: Đảm bảo hợp đồng dữ liệu giữa các hệ thống (Frontend-Backend, Microservices) luôn nhất quán và minh bạch.
+
+## 📜 1. SPECIFICATION (OPENAPI/SWAGGER)
+1. **Source of Truth**: File Spec là nguồn chân lý duy nhất. Code phải tuân thủ Spec hoặc Spec được sinh ra từ code một cách tự động.
+2. **Versioning**: Luôn có version trong URL (ví dụ: `/api/v1/...`). Không bao giờ tạo breaking changes ở version hiện tại.
+3. **Documentation**: Mọi Endpoint phải có mô tả rõ ràng về Params, Request Body và Response Schema.
+
+## 🛠️ 2. DESIGN BEST PRACTICES
+1. **Naming**: Dùng `kebab-case` cho URL. Dùng danh từ số nhiều (ví dụ: `/orders`).
+2. **Methods**: Dùng đúng ý nghĩa của HTTP Verbs (GET, POST, PUT, PATCH, DELETE).
+3. **Status Codes**: 
+   - 200/201: Success.
+   - 400: Bad Request (Client error).
+   - 401/403: Auth error.
+   - 404: Not Found.
+   - 500: Server error.
+
+## 🛡️ 3. SECURITY & VALIDATION
+1. **Input Sanitization**: Mọi dữ liệu đầu vào phải được validate schema trước khi xử lý.
+2. **Rate Limiting**: Giới hạn số lượng request để tránh brute-force và DDoS.
+3. **CORS**: Cấu hình chính xác Origin, không dùng `*` ở Production.

package/.agent/rules/code-quality.md

@@ -1,37 +1,6 @@
-# CODE-QUALITY.MD - Engineering Excellence
-
-> **Mục tiêu**: Đảm bảo mã nguồn luôn đạt chất lượng "Production-Grade" ngay từ dòng code đầu tiên.
-
----
-
-## 🚫 1. Anti-Patterns (Cấm Tuyệt Đối)
-
-1.  **Console Logs**: Không commit `console.log`, `print()` vào nhánh chính (trừ file debug tạm thời).
-2.  **Magic Numbers**: Không dùng số cứng trong logic. Hãy đưa ra CONSTANT.
-3.  **Any Type**: Hạn chế tối đa dùng `any` trong TypeScript. Hãy define type rõ ràng.
-4.  **Long Functions**: Hàm không nên quá 50 dòng. Tách nhỏ logic.
-
 ---
-
-## ✅ 2. Best Practices (Khuyên Dùng)
-
-1.  **Naming Convention**:
-    *   Variable/Function: `camelCase` (e.g., `userProfile`)
-    *   Class/Component: `PascalCase` (e.g., `UserProfile`)
-    *   Constant: `SCREAMING_SNAKE_CASE` (e.g., `MAX_RETRIES`)
-    *   File: `kebab-case` (e.g., `user-profile.ts`)
-
-2.  **Comments**:
-    *   Giải thích "TẠI SAO", không giải thích "CÁI GÌ".
-    *   Dùng JSDoc/DocString cho các hàm public.
-
-3.  **Error Handling**:
-    *   Luôn dùng `try/catch` cho async/await.
-    *   Không nuốt lỗi (silent fail). Hãy log hoặc throw.
-
+description: Auto-generated rule
+trigger: manual
 ---
 
-## 🧪 3. Testing Requirements
-
-1.  **Unit Test**: Logic phức tạp phải có Unit Test đi kèm.
-2.  **Coverage**: Cố gắng đạt > 80% coverage cho các module core.
+---\ndescription: Auto-generated rule\ntrigger: manual\n---\n\n

package/.agent/rules/database.md

@@ -0,0 +1,24 @@
+---
+trigger: glob
+glob: "**/*.{sql,prisma,mongodb,json}"
+---
+
+# DATABASE.MD - Data Integrity & Schema Mastery
+
+> **Mục tiêu**: Đảm bảo cấu trúc dữ liệu chuẩn mực, hiệu năng truy vấn cao và an toàn dữ liệu tuyệt đối.
+
+## 🏗️ 1. SCHEMA DESIGN
+1. **Normalization**: Tuân thủ chuẩn 3NF. Tránh dư thừa dữ liệu.
+2. **Naming**: Dùng `snake_case` cho Table và Column.
+3. **Auditing**: Mọi bảng nghiệp vụ phải có `created_at` (timestamp) và `updated_at` (timestamp).
+4. **Soft Delete**: Ưu tiên dùng `deleted_at` thay vì xóa vật lý cho dữ liệu quan trọng.
+
+## ⚡ 2. PERFORMANCE & INDEXING
+1. **Indexes**: Đánh Index cho Foreign Keys và các cột thường xuyên nằm trong điều kiện `WHERE`.
+2. **Explain Plan**: Phải kiểm tra chi phí truy vấn trước khi triển khai các câu lệnh phức tạp.
+3. **Pagination**: Luôn dùng con trỏ (Cursor) hoặc Limit/Offset để tránh tải quá nhiều dữ liệu.
+
+## 🛡️ 3. MIGRATION PROTOCOL
+1. **Atomic Changes**: Mỗi migration chỉ thực hiện một thay đổi logic duy nhất.
+2. **Rollback**: Luôn phải có phương án hạ cấp (Down) cho mọi bản nâng cấp (Up).
+3. **Production Safety**: Tuyệt đối không xóa/sửa cột có dữ liệu mà không có bước backup/migrate dữ liệu trung gian.

package/.agent/rules/devops.md

@@ -0,0 +1,23 @@
+---
+trigger: glob
+glob: "**/dockerfile,**/docker-compose.yml,**/.github/workflows/*.yml,**/jenkinsfile,**/terraform/**/*,**/k8s/**/*"
+---
+
+# DEVOPS.MD - Deployment & Infrastructure Mastery
+
+> **Mục tiêu**: Tự động hóa tối đa, triển khai an toàn và hạ tầng có khả năng mở rộng (Scalability).
+
+## 🚀 1. CONTAINERIZATION (DOCKER)
+1. **Multi-stage Builds**: Giảm thiểu kích thước Image bằng cách chỉ giữ lại Artifact cuối cùng.
+2. **Non-root User**: Chạy ứng dụng dưới quyền user thường để đảm bảo bảo mật.
+3. **Environment**: Dùng `.env` và không bao giờ hardcode cấu hình vào Image.
+
+## 🛠️ 2. CI/CD PIPELINE
+1. **Automated Testing**: Pipeline phải chạy Unit Test, Integration Test trước khi Build.
+2. **Security Scan**: Tích hợp các công cụ quét mã độc (Snyk, Trivy) vào pipeline.
+3. **Zero-downtime**: Triển khai theo chiến lược Canary hoặc Blue/Green.
+
+## 🏗️ 3. INFRASTRUCTURE AS CODE (IaC)
+1. **Declarative**: Ưu tiên Terraform hoặc CloudFormation.
+2. **State Management**: Quản lý State tập trung (Remote State) và có khóa (Locking).
+3. **Modularity**: Chia nhỏ hạ tầng thành các Module tái sử dụng.

package/.agent/rules/frontend.md

@@ -9,11 +9,11 @@ glob: "**/*.{js,jsx,ts,tsx,css,scss,html,vue,svelte,dart,swift,kt,xml}"
 
 ---
 
-## 🎨 1. PREMIUM UX/UI (Ref: .shared/ui-ux-pro-max/AESTHETICS.md)
+## 🎨 1. PREMIUM UX/UI
 
-1. **Aesthetics**: Màu sắc HSL tinh chỉnh, Typography chuẩn (Inter/Roboto). Tuân thủ Glassmorphism 2.0.
+1. **Aesthetics**: Màu sắc HSL tinh chỉnh, Typography chuẩn (Inter/Roboto).
 2. **Spacing**: Hệ thống lưới 4px/8px. Whitespace là sang trọng.
-3. **Feedback**: Mọi tương tác (Click, Tap) đều phải có phản hồi thị giác ngay lập tức (Framer Motion).
+3. **Feedback**: Mọi tương tác (Click, Tap) đều phải có phản hồi thị giác ngay lập tức.
 
 ---
 

package/.agent/rules/growth-strategy.md

@@ -0,0 +1,22 @@
+---
+trigger: always_on
+---
+
+# GROWTH-STRATEGY.MD - Business & Market Dominance
+
+> **Mục tiêu**: Biến sản phẩm kỹ thuật thành một sản phẩm kinh doanh thành công rực rỡ.
+
+## 🚀 1. SEO & VISIBILITY Mastery
+1. **Semantic HTML**: Cấu trúc heading (H1-H6) chuẩn SEO.
+2. **Meta Data**: Dynamic meta tags cho từng trang, hỗ trợ OpenGraph và Twitter Cards.
+3. **Schema Markup**: Nhúng JSON-LD để Google hiểu rõ nội dung website.
+
+## 💰 2. CONVERSION RATE OPTIMIZATION (CRO)
+1. **Call to Action (CTA)**: Nút bấm phải nổi bật, copy thu hút và đặt ở vị trí "vàng".
+2. **Friction Reduction**: Tối giản số bước trong quy trình đăng ký/thanh toán.
+3. **Social Proof**: Tích hợp testimonial, review và số liệu thực tế để tạo lòng tin.
+
+## 📊 3. ANALYTICS & RETENTION
+1. **Event Tracking**: Theo dõi hành vi người dùng bằng GA4, Mixpanel hoặc PostHog.
+2. **Retention Loops**: Xây dựng các tính năng nhắc nhở, email marketing hoặc thông báo để giữ chân người dùng.
+3. **Virality**: Tích hợp các cơ chế chia sẻ, mời bạn bè để phát triển người dùng tự nhiên.

package/.agent/rules/logging-monitoring.md

@@ -0,0 +1,22 @@
+---
+trigger: always_on
+---
+
+# LOGGING-MONITORING.MD - System Observability Standards
+
+> **Mục tiêu**: Mọi sự kiện đều phải được theo dõi, mọi lỗi đều phải được cảnh báo trước khi người dùng phát hiện.
+
+## 📝 1. STRUCTURED LOGGING
+1. **JSON Format**: Log phải ở định dạng JSON để dễ dàng parse bằng ELK/Splunk.
+2. **Levels**: Dùng đúng cấp độ: `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL`.
+3. **Context**: Mỗi log phải đi kèm `request_id`, `user_id` và `timestamp` ISO 8601.
+
+## 📊 2. METRICS & TELEMETRY
+1. **Business Metrics**: Theo dõi tỷ lệ chuyển đổi, số lượng đơn hàng, v.v.
+2. **System Metrics**: CPU, Memory, Disk I/O, Network Latency.
+3. **Tracing**: Triển khai Distributed Tracing (OpenTelemetry) cho hệ thống Microservices.
+
+## 🚨 3. ALERTING PROTOCOL
+1. **Thresholds**: Thiết lập ngưỡng cảnh báo thông minh, tránh "Alert Fatigue".
+2. **Channels**: Gửi cảnh báo về Slack, Discord hoặc PagerDuty tùy mức độ nghiêm trọng.
+3. **Post-mortem**: Mọi lỗi `FATAL` đều phải có tài liệu phân tích nguyên nhân gốc rễ.

package/.agent/rules/quality-assurance.md

@@ -0,0 +1,22 @@
+---
+trigger: always_on
+---
+
+# QUALITY-ASSURANCE.MD - Zero-Bug Tolerance Standards
+
+> **Mục tiêu**: Đảm bảo sản phẩm ra đời với chất lượng cao nhất thông qua quy trình kiểm thử nghiêm ngặt.
+
+## 🧪 1. TESTING PYRAMID
+1. **Unit Tests**: Phải bao phủ > 80% logic nghiệp vụ.
+2. **Integration Tests**: Kiểm tra sự phối hợp giữa các module và database.
+3. **E2E Tests**: Kiểm tra các luồng đi quan trọng (Critical Paths) từ góc nhìn người dùng.
+
+## 📉 2. AUTOMATION & CI
+1. **Regression Testing**: Mọi bug mới được phát hiện phải có một bản test đi kèm để tránh lặp lại.
+2. **Performance Testing**: Kiểm tra ngưỡng chịu tải của hệ thống (Load test, Stress test).
+3. **Visual Regression**: Kiểm tra sự thay đổi của giao diện qua các bản build.
+
+## 📋 3. MANUAL REVIEW PROTOCOL
+1. **Double-Check**: Task quan trọng phải được review bởi ít nhất 2 agent khác nhau.
+2. **Edge Cases**: Luôn liệt kê và test các trường hợp biên, dữ liệu rác, mất kết nối mạng.
+3. **Acceptance Criteria**: Chỉ hoàn thành task khi đạt 100% tiêu chí nghiệm thu (AC).

package/.agent/rules/strict-protocol.md

@@ -1,47 +1,6 @@
-# STRICT PROTOCOL ENFORCEMENT
-
-> **Trigger**: ALWAYS_ON (Critical)
-> **Priority**: HIGHEST (Overrides all standard behaviors)
-
-## 🚫 1. ZERO-TRUST GIT POLICY (Chính Sách Git Không Tin Cậy)
-
-**Tuyệt đối CẤM** Agent tự động thực hiện các lệnh sau nếu không có lệnh rõ ràng từ User:
-- `git push`
-- `git push origin <branch>`
-- `git push --tags`
-- `npm publish`
-
-**Quy trình Bắt buộc:**
-1.  Agent thực hiện thay đổi code.
-2.  Agent chạy test/verify.
-3.  Agent **BÁO CÁO** kết quả và **HỎI** ý kiến User: *"Test đã qua. Bạn có muốn đẩy code không?"*
-4.  CHỈ KHI User trả lời: "ok", "push", "đẩy đi", "duyệt", v.v. -> Agent mới được chạy lệnh đẩy.
-
-**Hậu quả:** Nếu vi phạm, Agent được coi là "Mất kiểm soát" (Rogue Agent).
-
 ---
-
-## 🌐 2. DYNAMIC LANGUAGE ADHERENCE (Tuân Thủ Ngôn Ngữ Động)
-
-Agent PHẢI đọc và tuân thủ mục **"Language Protocol"** trong file `GEMINI.md` tại thư mục gốc.
-
-- Nếu `GEMINI.md` yêu cầu **VIETNAMESE**:
-  - Giao tiếp: 100% Tiếng Việt.
-  - Cấm: Giải thích bằng Tiếng Anh (trừ thuật ngữ kỹ thuật).
-
-- Nếu `GEMINI.md` yêu cầu **ENGLISH**:
-  - Giao tiếp: 100% Tiếng Anh.
-
-**Nguyên tắc**: User là người quyết định ngôn ngữ (qua `npx` setup hoặc config), Agent không được tự ý.
-
+description: Auto-generated rule
+trigger: manual
 ---
 
-## 🛑 3. FAIL-SAFE MECHANISM (Cơ Chế Ngắt Khẩn Cấp)
-
-Nếu User phát hiện Agent vi phạm 1 trong 2 điều trên, User sẽ gõ lệnh:
-> **`/protocol-reset`**
-
-Khi nhận lệnh này, Agent PHẢI:
-1.  Dừng ngay lập tức mọi tác vụ.
-2.  Đọc lại file này `view_file .agent/rules/strict-protocol.md`.
-3.  Xác nhận lại trạng thái tuân thủ.
+---\ndescription: Auto-generated rule\ntrigger: manual\n---\n\n

package/.agent/rules/system-reasoning.md

@@ -0,0 +1,20 @@
+---
+trigger: always_on
+---
+
+# SYSTEM-REASONING.MD - Advanced Logical Standards
+
+> **Mục tiêu**: Nâng tầm tư duy của AI lên cấp độ "Deep Think", đảm bảo các quyết định kỹ thuật luôn dựa trên sự phân tích đa chiều và dài hạn.
+
+## 🧠 1. REASONING PROTOCOLS
+1. **Multi-Perspective Analysis**: Trước khi sửa code, AI phải phân tích tác động dưới góc nhìn: Security, Performance, UI/UX và Maintainability.
+2. **Mental Simulation**: Giả lập các kịch bản lỗi (Edge Cases) và cách hệ thống tự khôi phục trước khi thực thi.
+3. **Long-Horizon Planning**: Mọi giải pháp phải bền vững trong ít nhất 12 tháng phát triển tiếp theo.
+
+## 🛠️ 2. AGENTIC EXECUTION (GLM-5 Style)
+1. **Self-Monitoring**: Agent phải liên tục kiểm tra trạng thái của chính mình và sửa sai ngay khi phát hiện bước trước đó không tối ưu.
+2. **Adaptive Goal Setting**: Nếu mục tiêu ban đầu bị chặn bởi hạ tầng, Agent phải tự tìm con đường thay thế (Alternative Paths).
+
+## 🛡️ 3. ZERO-COMPROMISE ARCHITECTURE
+1. **Modular Sovereignty**: Cấm tuyệt đối code "vòng vo" hay phụ thuộc chéo (Circular Dependencies).
+2. **Contract Compliance**: Chỉ tin vào Hợp đồng dữ liệu (Spec/Interface), không tin vào "phỏng đoán".

package/.agent/rules/system-update.md

@@ -1,59 +1,6 @@
-# SYSTEM-UPDATE.MD - Version Control Protocol
-
-> **Mục tiêu**: Đảm bảo tính nhất quán tuyệt đối về phiên bản trên toàn bộ hệ thống.
-
----
-
-## 🚫 1. ZERO-DRIFT POLICY (Chính sách Không lệch)
-
-Khi người dùng yêu cầu "update", "nâng cấp", hoặc "đẩy phiên bản mới", Agent **BẮT BUỘC** phải cập nhật đồng bộ các file sau cùng một lúc:
-
-1.  **`package.json`**: Trường `version`.
-2.  **`README.md`**:
-    *   Header: `### *Advanced Edition • vX.Y.Z Meta-Engine*`
-    *   Section: `## ✨ The Premium Edge (vX.Y.Z)`
-3.  **`README.vi.md`**:
-    *   Header: `### *Phiên bản Nâng cao • vX.Y.Z Meta-Engine*`
-    *   Section: `## ✨ Điểm khác biệt (Phiên bản vX.Y.Z)`
-4.  **`docs/MASTER_OPERATIONS.md`**: Line `**Version**: X.Y.Z`
-5.  **`docs/MASTER_OPERATIONS.vi.md`**: Line `**Version**: X.Y.Z`
-
-**TUYỆT ĐỐI KHÔNG** cập nhật lẻ tẻ. Một phiên bản được coi là "hợp lệ" chỉ khi tất cả các file trên khớp nhau 100%.
-
 ---
-
-## 🛠️ 2. AUTOMATION TOOL (Công cụ Tự động)
-
-Để tránh sai sót do con người (hoặc AI), hãy sử dụng script đã được chuẩn bị sẵn:
-
-```bash
-node scripts/bump.js <new-version>
-# Ví dụ: node scripts/bump.js 4.1.9
-```
-
-Script này sẽ tự động tìm và thay thế tất cả các vị trí cần thiết.
-
----
-
-## 🚀 3. PUBLISHING CHECKLIST
-
-Sau khi bump version, quy trình chuẩn để phát hành là:
-
-1.  **Commit**: `git commit -m "chore: release vX.Y.Z"`
-2.  **Tag**: `git tag vX.Y.Z`
-3.  **Push Code**: `git push`
-4.  **Push Tag**: `git push origin vX.Y.Z` (Kích hoạt CI/CD & GitHub Release)
-
----
-
-## 4. HUMAN-IN-THE-LOOP PROTOCOL (QUAN TRỌNG)
-
-> **Mệnh lệnh tối cao**: Tuyệt đối **KHÔNG** tự động đẩy version mới (git tag / npm publish) nếu chưa có hiệu lệnh rõ ràng từ User.
-
-1.  **Chế độ chờ**: Khi hoàn thành code, chỉ chạy test và báo cáo.
-2.  **Xin phép**: Hỏi "Bạn có muốn tôi release phiên bản mới (vX.Y.Z) không?".
-3.  **Thực thi**: Chỉ chạy `scripts/bump.js` và các lệnh git khi User trả lời "OK", "Push đi", "Duyệt".
-
+description: Auto-generated rule
+trigger: manual
 ---
 
-> **Lưu ý**: Nếu người dùng phàn nàn về version cũ/mới, hãy kiểm tra ngay 5 file trong danh sách trên đầu tiên.
+---\ndescription: Auto-generated rule\ntrigger: manual\n---\n\n

package/.agent/rules/ui-design.md

@@ -0,0 +1,23 @@
+---
+trigger: glob
+glob: "**/*.{css,scss,less,styled.ts,tailwind.config.js}"
+---
+
+# UI-DESIGN.MD - Visual Excellence & Aesthetics
+
+> **Mục tiêu**: Kiến tạo giao diện đẳng cấp, giàu tính nghệ thuật và đồng nhất về ngôn ngữ thiết kế.
+
+## 🎨 1. TYPOGRAPHY & SPACING
+1. **Scale**: Dùng hệ thống lưới 4px hoặc 8px cho mọi khoảng cách (Margin/Padding).
+2. **Hierarchy**: Định nghĩa rõ ràng H1-H6, Body, Label với trọng số (Weight) và kích thước (Line-height) chuẩn.
+3. **Font**: Ưu tiên các Variable Fonts cho web hiện đại để tối ưu hiệu suất.
+
+## 🌈 2. COLOR SYSTEM
+1. **Semantic Colors**: `primary`, `secondary`, `success`, `error`, `warning` phải có độ tương phản (WCAG) tốt.
+2. **Dark Mode**: Mọi giao diện đều phải hỗ trợ Dark Mode một cách tự nhiên (không chỉ đảo ngược màu).
+3. **Glassmorphism**: Dùng hiệu ứng mờ (Blur) và độ trong suốt (Opacity) một cách tinh tế.
+
+## ✨ 3. MICRO-ANIMATIONS
+1. **Transitions**: Mọi trạng thái Hover, Focus đều phải có hiệu ứng mượt mà (Ease-in-out).
+2. **Lottie/SVG**: Dùng các hiệu ứng vector cho các loading hoặc icon tương tác.
+3. **Performance**: Không dùng animation gây giật (jank), ưu tiên dùng `transform` và `opacity`.

package/.agent/rules/ux-patterns.md

@@ -0,0 +1,23 @@
+---
+trigger: glob
+glob: "**/*.{js,jsx,ts,tsx}"
+---
+
+# UX-PATTERNS.MD - User Experience & Flow Standards
+
+> **Mục tiêu**: Tối ưu hóa hành trình người dùng, giảm thiểu ma sát (friction) và tăng cường sự hài lòng.
+
+## ⚓ 1. NAVIGATION & LAYOUT
+1. **Predictability**: Các thành phần điều hướng (Navbar, Sidebar) phải nằm ở vị trí người dùng mong đợi.
+2. **Breadcrumbs**: Luôn cung cấp đường dẫn cho các trang sâu > 2 cấp.
+3. **Responsiveness**: Tuân thủ Mobile-first, đảm bảo trải nghiệm trên mọi kích thước màn hình.
+
+## ⚡ 2. INTERACTION & FEEDBACK
+1. **Skeleton Screens**: Dùng Skeleton thay cho spinner xoay tròn để tạo cảm giác tốc độ.
+2. **Optimistic UI**: Cập nhật trạng thái ngay lập tức trên UI và đồng bộ với server ngầm.
+3. **Error Prevention**: Validate dữ liệu ngay khi người dùng nhập (Inline validation).
+
+## 🧠 3. ACCESSIBILITY (A11Y)
+1. **Keyboard**: Phải điều hướng được toàn bộ trang bằng phím Tab.
+2. **Screen Readers**: Dùng Semantic HTML (`<header>`, `<main>`, `<footer>`, `aria-label`).
+3. **Focus States**: Trạng thái Focus phải rõ ràng, không được ẩn đi.