@leejungkiin/awkit 1.7.0 → 1.7.4

package/templates/specs/requirements-template.md

@@ -1,133 +1,65 @@
-# Concept Document — [Tên Ứng dụng/Dự án]
-> "[Slogan hoặc câu định vị cốt lõi của dự án]"
-
-[⚠️ AI INSTRUCTION: You MUST fill out the following sections with EXTREME detail. Use ASCII diagrams (Plain Text boxes) where requested. Do not provide generic overviews. Dive deep into technical mappings, user psychology, and exact layouts as shown in the template structure.]
-
-## 1. Tầm nhìn & Lý do tồn tại
-* **Tóm tắt dự án:** [Nêu rõ dự án là gì, tích hợp công nghệ gì để tạo giá trị gì. 2-3 câu.]
-* **Vấn đề được giải quyết:** [Nêu pain points hiện tại của người dùng và lý do giải pháp cũ không hiệu quả.]
-* **Đối tượng người dùng cốt lõi:**
-  - [Nhân khẩu học 1]
-  - [Tâm lý/Nhu cầu 1]
-  - [Hành vi 1]
-
-## 2. Triết lý cốt lõi
-### 2.1 Các lớp phân tích / Nền tảng
-[AI: BẮT BUỘC VẼ ASCII DIAGRAM 3-5 block thể hiện các trụ cột dữ liệu/logic của app. Ví dụ: Input -> Database/Sources -> AI Engine -> Output]
-```text
-┌─────────────────────────────────────────────────┐
-│                   [LỚP 1]                       │
-│  [Chi tiết tầng 1]                              │
-├─────────────────────────────────────────────────┤
-│                   [LỚP 2]                       │
-│  [Chi tiết tầng 2]                              │
-└─────────────────────────────────────────────────┘
-                        ↓
-              [ĐỘNG CƠ XỬ LÝ CHÍNH]
-                        ↓
-              [KẾT QUẢ ĐẦU RA]
-```
-
-### 2.2 Nguyên tắc thiết kế tính năng
-1. [Nguyên tắc 1 - Ví dụ: Cá nhân hóa tuyệt đối]
-2. [Nguyên tắc 2 - Ví dụ: Hành động được/Actionable]
-3. [Nguyên tắc 3 - Ví dụ: Gamification nhẹ]
-4. [Nguyên tắc 4]
-5. [Nguyên tắc 5]
-
-## 3. Kiến trúc ứng dụng
-### 3.1 Stack kỹ thuật
-| Layer | Công nghệ |
-|-------|-----------|
-| Mobile/Web | [Ví dụ: React Native + Expo] |
-| Frontend State | [Ví dụ: Zustand] |
-| Core Backend | [Ví dụ: Node.js / Firebase] |
-| Database | [Ví dụ: Firestore / SQLite] |
-| AI / 3rd Party | [Ví dụ: Gemini API / MediaPipe] |
-
-### 3.2 Cấu trúc màn hình (Routing Tree)
-[AI: BẮT BUỘC vẽ sơ đồ cây thư mục/router cho các màn hình app]
-```text
-app/
-├── onboarding/
-│   ├── step-1
-│   └── step-n
-├── (tabs)/
-│   ├── tab-1  # Vai trò
-│   └── tab-2  # Vai trò
-└── screens/
-    ├── screen-1
-    └── screen-n
-```
-
-## 4. Luồng xử lý cốt lõi (Core Pipeline)
-[AI: BẮT BUỘC vẽ sơ đồ ASCII Flow thể hiện luồng nghiệp vụ từ Action của user đến Dữ liệu đổ ra.]
-```text
-[User Input]
-  [Hành động]
-         │
-         ▼
-[Phase 1 — Xử lý A]
-  [Logic hàm/Function logic]
-         │
-         ▼
-[Phase 2 — Xử lý B]
-  [Logic tổng hợp] -> Output
-```
-
-## 5. Onboarding — Mindset & Thiết kế
-### 5.1 Triết lý onboarding
-[Giá trị cốt lõi muốn truyền tải trước khi user đăng ký là gì?]
-### 5.2 Cấu trúc các slide
-- **Slide 0 (Hook):** [Mô tả chi tiết ảnh, text, animation lôi kéo]
-- **Slide 1 (Value 1):** [Chức năng 1]
-- **Slide 2 (Personalization):** ...
-- **Slide 3 (CTA):** ...
-### 5.3 Design patterns đặc thù
-- [Ví dụ: Count-up animation cho điểm số, Stagger card entry]
-
-## 6. Gợi ý tính năng — Mindset xây dựng
-Mỗi tính năng đều phải đáp ứng cấu trúc [Input -> Core Logic -> Actionable Suggestion -> "Why" Explanation].
-[Đưa ra 1 cặp ví dụ Đúng/Sai về việc recommend nội dung cho user theo quy tắc KHÔNG GENERIC.]
-- ❌ **Sai:** [Câu chung chung]
-- ✅ **Đúng:** [Câu cá nhân hóa sâu theo db/mệnh/sở thích]
-
-## 7. Design System
-### 7.1 Palette màu
-| Vai trò | Hex Code | Tên màu |
-|---------|----------|----------|
-| Primary | #Hex     | [Tên]    |
-| Text/Sub| #Hex     | [Tên]    |
-
-### 7.2 Animation & Icon Convention
-- [Quy tắc animation (Fade, Spring, Duration)]
-- [Quy tắc icon (PNG thực tế hay SVG tint)]
-
-## 8. Vòng lặp tăng trưởng (Engagement Loop)
-[AI: Vẽ ASCII text flow mô tả vòng lặp giữ chân user]
-```text
-[Lần đầu sử dụng] -> [Nhận giá trị A] -> [Thực hiện hành động B] -> [Sự kiện C kéo user quay lại] -> [Chia sẻ mạng xã hội]
-```
-| Trigger quay lại | Tần suất |
-|-------------------|----------|
-| [Sự kiện/Push]    | [Bao lâu]|
-
-## 9. Mô hình kinh doanh (Monetization)
-[AI: Vẽ sơ đồ cây cho Free Tier và Premium Tier]
-
-## 10. Nguyên tắc kỹ thuật
-* **Performance:** [Luật xử lý client side vs server side]
-* **Data Flow:** [Service A -> Service B]
-* **Error Handling:** [Mindset khi API lỗi, rớt mạng, thiếu data]
-
-## 11. Roadmap tính năng
-* **Phase 1 — Nền tảng (MVP):** ...
-* **Phase 2 — Chiều sâu (Depth):** ...
-* **Phase 3 — Tăng trưởng (Growth):** ...
-
-## 12. Điều Không Được Làm (Anti-patterns)
-1. [Luật 1 - Ví dụ: Không để UI lạnh lẽo công nghệ]
-2. [Luật 2 - Ví dụ: Không lưu data raw người dùng lên server]
-3. [Luật 3]
-4. [Luật 4]
-5. [Luật 5]
+# [Feature Name] Requirements Document
+
+## Introduction
+
+[Brief description of the feature and its purpose - 2-3 sentences explaining what problem it solves and why it's important to users]
+
+## Glossary
+
+- **[Term_1]**: [Clear definition of domain-specific term]
+- **[Term_2]**: [Clear definition of domain-specific term]
+- **[System_Component]**: [Description of system component mentioned in requirements]
+
+## Requirements
+
+### Requirement 1
+
+**User Story:** As a [user type], I want to [action/capability], so that [benefit/value].
+
+#### Acceptance Criteria
+
+1. WHEN [triggering condition], THE [System_Component] SHALL [expected behavior]
+2. WHEN [triggering condition], THE [System_Component] SHALL [expected behavior]
+3. WHILE [ongoing context], THE [System_Component] SHALL [maintained behavior]
+4. IF [condition], THE [System_Component] SHALL [conditional behavior]
+5. WHEN [edge case], THE [System_Component] SHALL [edge case handling]
+
+### Requirement 2
+
+**User Story:** As a [user type], I want to [action/capability], so that [benefit/value].
+
+#### Acceptance Criteria
+
+1. WHEN [condition], THE [System_Component] SHALL [behavior]
+2. WHEN [condition], THE [System_Component] SHALL [behavior]
+3. WHILE [context], THE [System_Component] SHALL [behavior]
+
+### Requirement 3 (Error Handling)
+
+**User Story:** As a [user type], I want [error recovery capability], so that [resilience benefit].
+
+#### Acceptance Criteria
+
+1. WHEN [error condition], THE [System_Component] SHALL [error handling]
+2. WHEN [network failure], THE [System_Component] SHALL [offline handling]
+3. WHEN [invalid input], THE [System_Component] SHALL [validation feedback]
+
+### Requirement 4 (Security)
+
+**User Story:** As a [user type], I want [security feature], so that [security benefit].
+
+#### Acceptance Criteria
+
+1. WHEN [sensitive data access], THE [System_Component] SHALL [security measure]
+2. WHEN [authentication required], THE [System_Component] SHALL [auth flow]
+3. WHILE [session active], THE [System_Component] SHALL [session management]
+
+### Requirement 5 (Accessibility)
+
+**User Story:** As a [user with accessibility needs], I want [accessibility feature], so that [inclusive benefit].
+
+#### Acceptance Criteria
+
+1. WHEN [using screen reader], THE [System_Component] SHALL [accessibility support]
+2. WHEN [using keyboard only], THE [System_Component] SHALL [keyboard navigation]
+3. WHILE [displaying content], THE [System_Component] SHALL [contrast/sizing support]

package/templates/specs/task-spec-template.xml

@@ -11,6 +11,7 @@
   Elements:
     <name>       → Short task title
     <files>      → Comma-separated list of files to create/modify
+    <anchor>     → Core symbols/classes to use with gitnexus
     <spec_ref>   → Reference to REQUIREMENTS.md or TECH-SPEC.md section
     <depends_on> → Task names this depends on (for wave grouping)
     <action>     → Specific implementation instructions
@@ -22,6 +23,7 @@
 <task type="auto">
   <name>Create User model</name>
   <files>Models/User.swift, Models/UserRepository.swift</files>
+  <anchor>User, UserRepository</anchor>
   <spec_ref>REQUIREMENTS.md § R1, TECH-SPEC.md § AD-1</spec_ref>
   <depends_on>none</depends_on>
   <action>
@@ -37,6 +39,7 @@
 <task type="auto">
   <name>Create login endpoint</name>
   <files>Services/AuthService.swift, ViewModels/LoginViewModel.swift</files>
+  <anchor>AuthService, LoginViewModel</anchor>
   <spec_ref>REQUIREMENTS.md § R2</spec_ref>
   <depends_on>Create User model</depends_on>
   <action>

package/workflows/_uncategorized/critic.md

@@ -0,0 +1,40 @@
+---
+description: 🔍 Critic Subagent - Phê bình và Đánh giá Logic
+---
+
+# SUBAGENT: critic
+
+Bạn là **Antigravity Critic / Verifier**. Nhiệm vụ của bạn là rà soát, phản biện và tìm lỗi trong các giải pháp thiết kế hoặc mã nguồn do Manager đề xuất.
+
+## 🎯 Chỉ dẫn Vai trò (System Instructions)
+
+- **Mục tiêu:** Phát hiện các lỗ hổng logic, lỗi biên (edge cases), và các giả định sai lầm. Ngăn chặn việc "chốt sớm" vào giải pháp không tối ưu (early commitment).
+- **Nguyên tắc:** 
+  - Đóng vai trò là một người phản biện nghiêm túc nhưng mang tính xây dựng.
+  - Phân tích đa chiều: hiệu năng, bảo mật, khả năng mở rộng, và độ sạch của code.
+  - Đối chiếu sát sao với spec yêu cầu của người dùng.
+
+## 🛠️ Ranh giới Công cụ (Tool Boundaries)
+
+- Bạn **CHỈ** được phép sử dụng các công cụ **Read-Only** (như `view_file`, `list_dir`, `grep_search`).
+- **CẤM TUYỆT ĐỐI** sử dụng các công cụ thay đổi tệp hoặc hệ thống (như `write_to_file`, `replace_file_content`, `run_command` dạng mutated).
+
+## 📊 Định dạng Kết quả đầu ra (Output Schema)
+
+Bạn bắt buộc phải trả về kết quả dạng JSON có cấu trúc sau qua tin nhắn cho Manager:
+
+```json
+{
+  "status": "approved | rejected | warnings",
+  "summary": "Tóm tắt ngắn gọn đánh giá",
+  "critical_flaws": [
+    "Danh sách các lỗi nghiêm trọng hoặc rủi ro logic lớn"
+  ],
+  "edge_cases": [
+    "Các trường hợp biên chưa được xử lý"
+  ],
+  "suggestions": [
+    "Đề xuất cải tiến cụ thể"
+  ]
+}
+```

package/workflows/_uncategorized/git-rebase-flow.md

@@ -0,0 +1,81 @@
+---
+description: 🔀 Hướng dẫn quy trình chuẩn Git (Feature Branch -> Rebase -> PR)
+---
+
+# 🔀 Quy trình Git Rebase (Senior Assistant)
+
+Quy trình này đóng vai trò như một Senior Developer hướng dẫn bạn làm quen và tuân thủ quy trình Git chuyên nghiệp: **Nhánh tính năng (Feature Branch) -> Rebase -> Pull Request**. Có khả năng tự động review code, cảnh báo rủi ro, và giải quyết xung đột (conflict) một cách an toàn.
+
+Áp dụng TỐT cho toàn bộ các framework hay ngôn ngữ làm việc nhóm.
+
+## Giai đoạn 1: Khởi tạo Nhánh Tính năng (Branching)
+
+Trợ lý kiểm tra và hướng dẫn bạn tạo nhánh đúng quy chuẩn trước khi bắt tay vào code.
+
+1. Lấy trạng thái mới nhất từ remote server:
+   `git fetch origin`
+2. Kiểm tra nhánh bạn đang đứng hiện tại:
+   `git branch --show-current`
+3. Đảm bảo nhánh hiện tại là `master` hoặc `main` và update code mới nhất:
+   `git pull origin main` (hoặc `master`)
+4. Tạo và chuyển sang nhánh tính năng riêng tư:
+   `git checkout -b feature/ten-tinh-nang`
+
+> [!TIP] 
+> Luôn code trên nhánh mang tên `feature/*`, `bugfix/*` hoặc `chore/*`. Không bao giờ code và commit trực tiếp lên nhánh `master` hay `main`.
+
+## Giai đoạn 2: Phát triển & Kiểm tra (Code & Review)
+
+Sau khi code xong ở local, AI đóng vai trò review trước khi bạn commit.
+
+1. Xem lại những files đã sửa đê xác nhận lần cuối:
+   `git status`
+2. Review chi tiết các thay đổi của dòng code:
+   `git diff`
+3. **Tiêu chuẩn Review tự động từ Trợ lý AI**:
+   - Quét tìm hardcode credential hoặc API key.
+   - Code có đáp ứng Clean Code không? Có tiềm ẩn memory leak không?
+   - Cảnh báo với các khối lệnh ẩn chứa risk nhưng không wrap `try-catch` / xử lý ngoại lệ.
+4. Ghi nhận commit (Nên dùng Convention Commits):
+   `git add .`
+   `git commit -m "feat: [Nhập tóm tắt công việc bạn đã hoàn thiện]"`
+
+## Giai đoạn 3: Quy trình Rebase (Quan trọng nhất)
+
+Quy trình Rebase thay vì Merge giúp giữ cho [Linear Git History] (lịch sử git thẳng, sạch) thay vì tạo ra "Merge commit" rườm rà chồng chéo.
+
+1. Gọi lại lệnh fetch data toàn bộ remote origin xuống:
+   `git fetch origin`
+2. Chạy lệnh Rebase update với nhánh chính:
+   `git rebase origin/main` 
+
+> [!IMPORTANT]
+> **Tại sao cần Rebase?** Rebase sẽ kéo những commit mới nhất của đồng nghiệp khác (những người đã chốt tính năng và đẩy lên server ở giữa lúc bạn đang code) lên trước, sau đó nối đoạn code mới của bạn lên ĐẦU đường dây đỏ. Nó giúp việc xem qua lịch sử phát triển dự án rất mượt mà.
+
+## Giai đoạn 4: Giải quyết Xung đột (Resolve Conflicts)
+
+Nếu terminal báo **Merge conflict in...** (tức là 2 người củng sửa vào 1 biến/hàm/file cấu hình)
+
+1. **DỪNG LẠI!** Bạn không cần hoảng. Hãy copy ném phần code đang có dải tag `<<<<<<< HEAD`, `=======`, `>>>>>>>` của file bị xung đột lên cho tôi.
+2. Trợ lý sẽ đóng vai trò hòa giải -> Phân tích luồng logic của ứng dụng để gộp trơn tru cả 2 thành phần.
+   - Nhạy cảm đặc biệt: Trợ lý có kinh nghiệm handle không làm "vỡ" cấu trúc các file hệ thống (`package.json`, `project.pbxproj`, `.yml` v.v..), giữ nguyên vẹn các UUID tham chiếu.
+3. Sau khi chép lại file đã được chỉnh sửa chuẩn xác, add file:
+   `git add [tên file đã sửa conflict]`
+4. Tiếp tục quá trình Rebase:
+   `git rebase --continue`
+
+*(Nếu cần thoát vòng lặp lỗi nguy hiểm khi đang Rebase mà không biết xử lý, hãy chạy: `git rebase --abort`)*
+
+## Giai đoạn 5: Đẩy Code & Tạo Pull Request (PR)
+
+1. Sau khi thành công rebase, toàn bộ nhánh tính năng của bạn đã đủ ổn và "clean" để đẩy ngược lên Remote Repository:
+   `git push --force-with-lease origin feature/ten-tinh-nang`
+   *(Tham số `--force-with-lease` là cực kỳ quan trọng, nó thay thế `--force` thông thường, để bảo vệ trong case có ai đó cũng đang push lên nhánh `feature/ ten-tinh-nang` của riêng bạn từ 1 máy khác)*
+2. Lên hệ thống Git của công ty (GitHub/GitLab/Bitbucket...) bấm tạo "New Pull Request".
+3. **Trợ lý tự soạn PR Description ngắn gọn, rành mạch:**
+   - Bạn có thể nói tôi: "Tạo PR cho thay đổi này".
+   - Tôi sẽ bóp tắt các commits để tóm gọn tính năng bạn làm -> Liệt kê Checklist cho QA và Team Review.
+
+---
+// turbo
+Bước 1 và 3 có thể tự động chạy ngầm nếu bạn đồng ý. Các bước 2, 4 và 5 cần chủ đích của con người thao tác.

package/workflows/_uncategorized/image-gen.md

@@ -0,0 +1,118 @@
+---
+description: 🎨 Image Generator — Tạo App Icons, Mascots và Pets (Hatch-style) với chất lượng Studio (Soft-Edge & Hole-Aware)
+---
+
+# /image-gen — High-Quality Asset Production Workflow
+
+> Quy trình tạo Asset chuyên nghiệp, tự động tách nền và xử lý cạnh mượt mà (PicWish Style).
+> Hỗ trợ tạo Pet Bundle (Trứng + Thú cưng) tương tự Codex nhưng chất lượng cao hơn.
+
+// turbo-all
+
+---
+
+## Sub-commands
+
+### `/image-gen:icon` — Tạo bộ App Icon
+
+1. Hỏi user về chủ đề (Theme), phong cách (Style - mặc định: `vector`), và **Kích thước lưới** (Grid - mặc định: `3x3`).
+2. Tự động tính toán số lượng `{count}` dựa trên lưới (vd: 3x3 -> 9 icons).
+3. Thông báo user: "🎨 Đang phác thảo bộ Icon Set {grid} cho chủ đề: {theme}..."
+4. Thực thi lệnh tạo:
+```bash
+create-icon {theme} {grid} {style}
+```
+5. Sau khi ảnh được tạo, thông báo: "✅ Đã tạo xong và xử lý Soft-Edge. File lưu tại: `assets/generated/`."
+
+### `/image-gen:mascot` — Tạo bộ Linh vật / Mascot
+
+1. Hỏi user về nhân vật (Character), phong cách (Style - mặc định: `chibi`), và **Kích thước lưới** (Grid - mặc định: `3x3`).
+2. Tự động tính toán số lượng `{count}` dựa trên lưới.
+3. Thông báo user: "🧸 Đang thiết kế bộ Mascot {grid} cho: {character}..."
+4. Thực thi lệnh tạo:
+```bash
+create-mascot {character} {grid} {style}
+```
+5. Sau khi ảnh được tạo, thông báo: "✅ Mascot đã sẵn sàng với nền trong suốt hoàn hảo!"
+
+### `/image-gen:pet` — Tạo Pet Bundle (Ấp trứng)
+
+1. Hỏi user về loại Pet (ví dụ: `fire dragon`, `ice phoenix`) và **Kích thước lưới** (Grid - mặc định: `4x4` cho đầy đủ trạng thái).
+2. Thông báo user: "🐣 Đang tạo Pet Bundle ({grid}) cho: {pet_type}..."
+3. Thực thi lệnh tạo:
+```bash
+create-pet {pet_type} {grid}
+```
+4. Tạo thư mục cấu hình: `mkdir -p assets/pets/{pet_id}`
+5. Ghi file `pet.json` mẫu tương thích hệ thống Hatch Pet.
+6. Thông báo: "✨ Pet Bundle đã được đóng gói tại `assets/pets/{pet_id}/`."
+
+### `/image-gen:process` — Xử lý ảnh có sẵn (Hole-Aware)
+
+1. User cung cấp đường dẫn ảnh nguồn (`input_path`).
+2. Xác định tên file đầu ra (`output_name.webp`).
+3. Thực thi lệnh xử lý với thuật toán v3.1:
+```bash
+process-image {input_path} assets/generated/{output_name}.webp 15
+```
+
+### `/image-gen:openrouter` — Tạo ảnh qua OpenRouter (GPT-5.4-Image)
+
+Quy trình sử dụng script `openrouter_image_gen.py` (Codex-grade) hỗ trợ 3 chế độ:
+
+#### 1. Chế độ `generate` (Text-to-Image)
+Dùng để tạo mới asset từ mô tả văn bản, hỗ trợ các tham số Art Direction cực mạnh:
+```bash
+python3 ~/.gemini/antigravity/scripts/openrouter_image_gen.py generate \
+  --prompt "{chủ_thể}" \
+  --style "{phong_cách}" \
+  --lighting "{ánh_sáng}" \
+  --palette "{tông_màu}" \
+  --out "assets/generated/{filename}.webp"
+```
+
+#### 2. Chế độ `edit` (Image-to-Image / Style Transfer)
+Dùng để biến đổi ảnh có sẵn (Local path hoặc URL) sang phong cách khác hoặc chỉnh sửa chi tiết:
+```bash
+python3 ~/.gemini/antigravity/scripts/openrouter_image_gen.py edit \
+  --image "{đường_dẫn_ảnh_gốc}" \
+  --prompt "{mô_tả_chỉnh_sửa}" \
+  --style "{phong_cách_mới}" \
+  --out "assets/generated/{filename}.webp"
+```
+
+#### 3. Chế độ `generate-batch` (Chạy hàng loạt)
+Dùng để sinh hàng loạt asset từ file `.jsonl` (tối đa 100 jobs) với cơ chế Retry tự động:
+```bash
+python3 ~/.gemini/antigravity/scripts/openrouter_image_gen.py generate-batch \
+  --input "jobs.jsonl" \
+  --out-dir "assets/generated/batch/" \
+  --concurrency 3
+```
+
+> **Note**: Script tự động xử lý Upload ảnh local lên `tmpfiles.org` và có cơ chế Exponential Backoff để chống lỗi nghẽn (429).
+
+---
+
+## 🛠 Quality Standards (Codex Hatch Pet Technique)
+
+- **🚫 CẤM DÙNG "Nền trong suốt / Transparent Background"**: TUYỆT ĐỐI KHÔNG thêm các từ khóa "transparent background", "nền trong suốt", "alpha channel" vào prompt sinh ảnh. Việc này sẽ khiến AI (như DALL-E, Midjourney, OpenRouter) sinh ra **nền caro giả (fake checkerboard)** bám dính vào nhân vật, cực kỳ khó xoá.
+- **✅ Background**: LUÔN ưu tiên sử dụng `solid bright green background #00FF00` hoặc `solid white background #FFFFFF` (nếu nhân vật có màu xanh) để AI render chi tiết tốt nhất, không bị đổ bóng (no shadows cast on the background).
+- **🛠 Hậu kỳ (Post-Processing)**: Sau khi sinh ảnh thô có nền Solid, BẮT BUỘC sử dụng công cụ Python Chroma-key cục bộ (process-image hoặc process_sprites.py) để gỡ nền.
+- **Edges & Holes**: Script Python sẽ tự động áp dụng Alpha Feathering (Blur 0x3) để triệt tiêu răng cưa, và xóa các vùng kẹt trong cánh/tay nhưng bảo vệ đôi mắt (Morphology Close).
+
+---
+
+## Communication
+
+Mỗi khi bắt đầu một lượt generate:
+```
+🎨 [Antigravity Artist] Đang khởi tạo xưởng vẽ cho {asset_type}...
+🚀 Chiến lược: Neutral White + Soft-Edge Alpha.
+```
+
+Sau khi hoàn tất:
+```
+✅ Hoàn tất! Asset của bạn đã được tối ưu hóa WebP và tách nền sạch sẽ.
+📍 Vị trí: [đường dẫn]
+```

package/workflows/_uncategorized/multi-model-pipeline.md

@@ -0,0 +1,60 @@
+---
+description: 🔗 Quy trình Đa Mô hình Tự động (v1.0)
+---
+
+# WORKFLOW: /pipeline - Multi-Model Collaborative Pipeline
+
+Quy trình phối hợp tự động hóa đa mô hình giúp tối ưu hóa chi phí token, phân bổ đúng vai trò mô hình (Gemini Flash Medium/High, Opus 4.6, Codex CLI) và tăng tốc độ phát triển.
+
+---
+
+## 🧭 Tổng quan Các Bước Chạy (Core Pipeline Phases)
+
+```mermaid
+graph TD
+    A[Giai đoạn 1: Context Triage - Gemini Flash Medium] -->|Đóng gói ngữ cảnh| B[Giai đoạn 2: Architecture Planning - Opus 4.6 via agy CLI]
+    B -->|Xác lập PRD & Spec| C[Giai đoạn 3: Competitor Research - Research Subagent]
+    C -->|Bản vẽ layout specs| D[Giai đoạn 4: Visual Design - Codex CLI]
+    D -->|UI Demo Preview -> Spritesheets| E[Giai đoạn 5: Code Execution - Workers & Critic]
+```
+
+---
+
+## 🅰️ Giai đoạn 1: Context Triage (Gemini Flash Medium)
+1. **Quét nhanh hệ thống:** Đọc `CODEBASE.md`, kiểm tra Git status và lịch sử thay đổi để xác định phạm vi của tính năng mới.
+2. **Triệu gọi CLI Plan:** Thực thi lệnh `awkit pipeline plan "<Feature Name>"` để bắt đầu quá trình lập kế hoạch bằng mô hình mạnh hơn.
+
+---
+
+## 🅱️ Giai đoạn 2: Lập kế hoạch Kiến trúc (Opus 4.6 via agy CLI)
+1. **Lệnh thực thi tự động:**
+   ```bash
+   agy --model claude-opus --print "Thực hiện lập kế hoạch chi tiết cho tính năng '<Feature Name>'. Sử dụng codebase context sau: <context>. Tạo PRD tại docs/PRD.md và Spec tại docs/specs/<Feature>_spec.md."
+   ```
+2. **Sản phẩm đầu ra (Outputs):**
+   - `docs/PRD.md` (Product Requirements Document).
+   - `docs/specs/<Feature>_spec.md` (Technical specifications & Mermaid flowchart).
+   - Kế hoạch triển khai chia theo từng Phase tại `implementation_plan.md`.
+
+---
+
+## 🆃 Giai đoạn 3: Nghiên cứu Đối thủ & Đặc tả (Research & Spec)
+1. **Nhiệm vụ:** Worker subagent `research` quét các module đối thủ cạnh tranh hoặc tài liệu API liên quan để điền chi tiết spec.
+2. **Cô lập:** Log quét thô được giải phóng, chỉ lưu giữ kết quả cô đọng trong file spec.
+
+---
+
+## 🅳 Giai đoạn 4: Thiết kế Giao diện Shell & Assets (Codex CLI)
+1. **Pha A: UI Demo Preview**
+   - Thực thi `codex exec` để tạo một mockup giao diện tĩnh hoặc SwiftUI prototype nhanh.
+   - User kiểm duyệt và chốt layout.
+2. **Pha B: GUI Assets & Spritesheet**
+   - Thực thi `codex exec` để sinh các biểu tượng, nút bấm, egg/pet companion và spritesheet tương thích với layout đã chốt.
+   - Lưu trữ các tệp assets vào thư mục `assets/ui/`.
+
+---
+
+## 🅴 Giai đoạn 5: Thực thi Viết Code & Kiểm thử (Gemini Workers & Critic)
+1. **Coding:** Gemini Worker clones thực hiện viết code song song hoặc tuần tự cho từng Phase đã lên kế hoạch ở Bước 2.
+2. **Phê bình & Đánh giá (Critic):**
+   - Kích hoạt `critic` subagent thông qua lệnh `codex review --uncommitted` để kiểm tra bảo mật, logic lỗi, và SOLID principles trước khi staging/commit.

package/workflows/_uncategorized/pixel-gen.md

@@ -0,0 +1,86 @@
+---
+description: "🎨 Tạo pixel art từ mô tả ngôn ngữ tự nhiên (Aseprite + pixel-mcp)"
+---
+
+# Pixel Gen — Generate Pixel Art from Description
+
+## Input
+User provides description via `$ARGUMENTS`. Examples:
+- `/pixel-gen 32x32 gameboy character sprite`
+- `/pixel-gen 64x64 pico8 sword with shading`
+- `/pixel-gen 16x16 nes brick tile`
+- `/pixel-gen 48x48 mascot idle animation 4 frames`
+
+## Parse Arguments
+
+Extract from description:
+1. **Size**: Look for `WxH` pattern (default: 64x64)
+2. **Palette**: Look for palette names: `gameboy`, `nes`, `pico8`, `c64`, `sweetie16`, `db16`, `db32` (default: RGB)
+3. **Subject**: The main thing to draw (character, sword, tile, mascot, etc.)
+4. **Style modifiers**: `shading`, `dithering`, `antialiasing`, `outline`
+5. **Animation**: Look for `animation`, `frames`, `idle`, `walk`, `run` + frame count
+
+## Workflow
+
+### Step 1: Read the aseprite-artist Skill
+Read `~/.gemini/antigravity/skills/aseprite-artist/SKILL.md` for full tool reference.
+
+If a palette is specified, also read `~/.gemini/antigravity/skills/aseprite-artist/resources/palettes.md` for hex values.
+
+### Step 2: Canvas Setup
+1. Call `mcp__aseprite__create_canvas` with parsed width, height, color_mode
+2. If retro palette detected → call `mcp__aseprite__set_palette` with palette hex colors
+3. Add layers as needed (Background, Subject, Effects)
+
+### Step 3: Draw
+Use the MCP drawing tools to create the described subject:
+- Start with silhouette shapes (`draw_rectangle`, `draw_circle`, `draw_contour`)
+- Fill with colors (`fill_area`)
+- Add details with individual pixels (`draw_pixels`)
+- Apply dithering if requested (`draw_with_dither`)
+
+### Step 4: Polish (if requested)
+- Apply shading: `mcp__aseprite__apply_auto_shading`
+- Apply antialiasing: `mcp__aseprite__suggest_antialiasing`
+- Apply outline: `mcp__aseprite__apply_outline`
+
+### Step 5: Animate (if requested)
+- Add frames: `mcp__aseprite__add_frame`
+- Set timing: `mcp__aseprite__set_frame_duration`
+- Tag sequence: `mcp__aseprite__create_tag`
+
+### Step 6: Export
+Default exports:
+- **Static sprite**: Export as PNG at 2x scale to project directory or `./pixel-output/`
+- **Animated sprite**: Export as GIF + PNG spritesheet
+- **Game asset**: Export spritesheet (grid) + JSON metadata
+
+```bash
+mkdir -p ./pixel-output
+```
+
+### Step 7: Report
+Show user what was created:
+```
+✅ Pixel Art Created
+- File: ./pixel-output/[name].png
+- Size: [W]x[H] @ [scale]x
+- Palette: [palette name] ([N] colors)
+- Frames: [N] (if animated)
+- Export: [format list]
+
+Preview: [describe what was drawn]
+```
+
+## Quick Reference — Common Patterns
+
+| Input Pattern | Action |
+|---------------|--------|
+| `WxH` | Set canvas size |
+| `gameboy/nes/pico8/c64` | Set retro palette + Indexed mode |
+| `character/sprite/icon` | Draw subject |
+| `shading/shadow` | Apply auto-shading |
+| `dithering/dither` | Apply dithering pattern |
+| `animation/idle/walk N frames` | Create N-frame animation |
+| `tile` | 16x16 or 32x32, tileable |
+| `mascot` | 64x64+, detailed character |