@leejungkiin/awkit 1.7.0 → 1.7.4

package/workflows/_uncategorized/reverse-ios-discover.md

@@ -0,0 +1,120 @@
+---
+description: 🗺️ RE iOS Phase 0 — Discovery & App Map (NO CODE output)
+parent: reverse-ios
+---
+
+# /re-ios-discover — Discovery & App Map
+
+> **Parent:** [`/reverse-ios`](reverse-ios.md) → Phase 0
+> **Skill:** `smali-to-swift` → `phase-0-discovery.md`
+> **Zoom Level:** 0 — Satellite View
+> **Output:** App Map (diagrams, tables, NO CODE)
+
+---
+
+## ⛔ ZOOM 0 RULE
+
+```
+This workflow produces NO CODE output.
+Only: diagrams, tables, bullet lists, bash scan commands.
+If you are about to write Swift code → STOP → wrong zoom level.
+```
+
+---
+
+## 📦 Step 0: Framework Scanner
+
+### 0.1: Quét IPA structure
+
+```bash
+# Embedded frameworks
+ls [app_bundle]/Frameworks/ 2>/dev/null
+
+# Non-system linked libs
+otool -L [app_bundle]/[AppName] | grep -v /System | grep -v /usr/lib
+
+# Header imports
+grep -rh "#import <" [headers_dir]/ | sort -u | head -30
+grep -rh "@import " [headers_dir]/ | sort -u
+
+# VC count
+grep -rl "UIViewController" [headers_dir]/ | wc -l
+
+# Resources
+ls [app_bundle]/*.car [app_bundle]/*.momd [app_bundle]/*.storyboardc 2>/dev/null
+find [app_bundle] -name "*.json" -o -name "*.plist" | grep -v Info.plist | sort
+
+# SDK markers
+strings [app_bundle]/[AppName] | grep -i "cocoapods\|carthage\|firebase\|facebook" | head -20
+```
+
+### 0.2: Phân loại frameworks
+
+| Category | Action |
+|----------|--------|
+| ✅ Reuse | Add via SPM |
+| 🔄 Replace | Map to modern Swift |
+| 🍏 Apple | Use SwiftUI equivalents |
+| 📱 Native | Keep, bridging header |
+| 🏷️ App Code | Rebuild in Swift |
+
+### 0.3: User approval
+
+> **GATE:** Framework Report → User approve.
+
+---
+
+## 📄 Step 1: Info.plist & Entitlements
+
+```bash
+plutil -p [app_bundle]/Info.plist
+codesign -d --entitlements :- [app_bundle]/[AppName] 2>/dev/null
+```
+
+### 1.1: Trích xuất
+
+- Bundle ID, Display Name, Min iOS
+- Privacy permissions (NSCameraUsageDescription, etc.)
+- URL Schemes, Universal Links
+- Capabilities (push, Apple Pay, Sign In with Apple)
+
+### 1.2: Screen Map
+
+```bash
+grep -rl "UIViewController" [headers_dir]/ | sort
+grep -rl "UITabBarController" [headers_dir]/
+grep -rl "UINavigationController" [headers_dir]/
+```
+
+Mapping VCs → SwiftUI screens + navigation flow.
+
+### 1.3: Complexity Estimate
+
+| Area | Rating | Notes |
+|------|--------|-------|
+
+---
+
+## 📊 Output: App Map
+
+Template: `skills/smali-to-swift/templates/app-map.md`
+
+---
+
+## ✅ Gate
+
+```
+"🗺️ App Map xong! Anh review → OK → Phase 1 (Architecture)."
+→ /re-ios-design
+```
+
+---
+
+## 🔗 Related
+
+- **Next:** [`/re-ios-design`](reverse-ios-design.md)
+- **Parent:** [`/reverse-ios`](reverse-ios.md)
+
+---
+
+*re-ios-discover v3.0.0 — Phase 0: Discovery & App Map*

package/workflows/_uncategorized/reverse-ios-scan.md

@@ -0,0 +1,155 @@
+---
+description: 📦 RE iOS Phase 1 — Framework Scanner + Info.plist Analysis + Project Bootstrap
+parent: reverse-ios
+---
+
+# /re-ios-scan — Framework Scanner & Plist Analysis
+
+> **Parent:** [`/reverse-ios`](reverse-ios.md) → Step 0 + Step 1
+> **Skill:** `smali-to-swift` | **Reference:** `skills/smali-to-swift/framework-patterns.md`
+
+---
+
+## 📦 Step 0: Framework Scanner (BẮT BUỘC)
+
+> Nhận diện toàn bộ frameworks **trước khi code bất kỳ thứ gì**.
+
+### 0.3: Quét IPA structure
+
+```bash
+# Embedded frameworks
+ls [app_bundle]/Frameworks/
+
+# Linked libraries (Mach-O)
+otool -L [app_bundle]/App | grep -v /System | grep -v /usr/lib
+
+# Header imports
+grep -rh "#import <" [headers_dir]/ | sort -u
+grep -rh "@import " [headers_dir]/ | sort -u
+
+# SDK identifiers
+strings [app_bundle]/App | grep -i "cocoapods\|carthage\|firebase\|facebook\|google"
+
+# Assets & resources
+ls [app_bundle]/*.car [app_bundle]/*.momd [app_bundle]/*.storyboardc 2>/dev/null
+find [app_bundle] -name "*.json" -o -name "*.plist" | grep -v Info.plist | sort
+```
+
+### 0.4: Tạo Framework Detection Report
+
+Dùng patterns từ `framework-patterns.md`:
+
+```markdown
+## 📦 Framework Detection Report — [App Name]
+
+### ✅ Reuse (Add via SPM)
+| Framework | Detected | Version | Notes |
+|-----------|----------|---------|-------|
+
+### 🔄 Replace (Legacy → Modern Swift)
+| Old Framework | Detected | Replacement |
+|---------------|----------|-------------|
+| AFNetworking | Frameworks/ | URLSession async/await |
+| SDWebImage | imports | AsyncImage + Kingfisher |
+| SnapKit | imports | SwiftUI layout |
+
+### 🍏 Apple Frameworks
+| Framework | Purpose | SwiftUI Equivalent |
+|-----------|---------|-------------------|
+| MapKit | Maps | Map (SwiftUI) |
+| CoreData | Database | SwiftData |
+
+### 📱 Native Libraries
+| File | Notes |
+|------|-------|
+
+### 🏷️ App Code (Rewrite in Swift)
+| Class Prefix | Module |
+|-------------|--------|
+
+### ❓ Unknown
+| Framework | Notes |
+|-----------|-------|
+```
+
+### 0.5: User approval
+
+> **GATE:** Không tiếp tục khi chưa có user approval.
+
+---
+
+## 📄 Step 1: Info.plist & Entitlements + Project Bootstrap
+
+> **Input:** `[app_bundle]/Info.plist` + entitlements
+
+### 1.1: Đọc Info.plist
+
+```bash
+plutil -p [app_bundle]/Info.plist
+codesign -d --entitlements :- [app_bundle]/App 2>/dev/null
+```
+
+Trích xuất:
+
+```yaml
+extract:
+  - bundle_id, display_name, min_ios_version
+  - permissions: [camera, photos, location, microphone, notifications, tracking]
+  - url_schemes, universal_links
+  - capabilities: [push, apple_pay, sign_in_apple, app_groups]
+  - supported_orientations
+```
+
+### 1.2: Phân tích class hierarchy
+
+```bash
+grep -rl "UIViewController" [headers_dir]/ | sort
+grep -rl "UITabBarController" [headers_dir]/
+grep -rl "UINavigationController" [headers_dir]/
+```
+
+Mapping VCs → SwiftUI:
+```
+SplashViewController  → SplashScreen.swift
+LoginViewController   → Auth/LoginScreen.swift
+MainTabBarController  → TabView in ContentView.swift
+HomeViewController    → Home/HomeScreen.swift
+```
+
+### 1.3: Xcode project structure
+
+Đề xuất Clean Architecture structure (xem SKILL.md Step 1).
+
+### 1.4: SPM Dependencies (từ Framework Report)
+
+```swift
+// Firebase: firebase/firebase-ios-sdk 11.0+
+// Kingfisher: onevcat/Kingfisher 7.12+
+// KeychainAccess: kishikawakatsumi/KeychainAccess 4.2+
+// Lottie: airbnb/lottie-ios 4.4+
+```
+
+### ✅ Checkpoint Step 1
+
+```markdown
+## ✅ Step 1 Complete
+
+- Bundle ID: [bundle_id]
+- Permissions: [count] | Screens: [count]
+- URL Schemes: [list]
+
+⏭️ Next: `/re-ios-build` — Step 2 (Data Layer)
+Cung cấp headers: *Service, *Manager, *Client, *API, *Model
+```
+
+---
+
+## 🔗 Related
+
+- **Next:** [`/re-ios-build`](reverse-ios-build.md) (Step 2-6)
+- **Parent:** [`/reverse-ios`](reverse-ios.md)
+- **Framework patterns:** `skills/smali-to-swift/framework-patterns.md`
+
+---
+
+*re-ios-scan v2.0.0 — Phase 1: Discovery & Bootstrap*

package/workflows/_uncategorized/reverse-ios.md

@@ -0,0 +1,152 @@
+---
+description: 🍎 Dịch ngược IPA iOS (class-dump, Hopper output) → App Swift hiện đại với SwiftUI, Clean Architecture, và UI-First methodology.
+skill: smali-to-swift
+---
+
+# /reverse-ios — iOS IPA Reverse Engineering Workflow
+
+> **Skill:** `smali-to-swift` v2.0 | **Tech:** Swift + SwiftUI + async/await + URLSession + SwiftData
+> **Philosophy:** "Map → Blueprint → UI First → Logic Behind"
+> **Key:** UI is designed and approved BEFORE coding any business logic.
+> **Sibling:** `/reverse-android`
+
+---
+
+## ⚡ QUICK START
+
+User cung cấp: Decrypted `.app` bundle, class-dump headers, Hopper pseudo-code, hoặc nói "reverse engineer IPA này".
+Workflow dẫn dắt qua **5 phases** — UI-First approach, **không bao giờ nhảy cóc**.
+
+---
+
+## 🔵 Session Setup
+
+### Bước 0.1: Khởi tạo session state
+
+```yaml
+reverse_ios_session:
+  project_name: "[TBD - từ Info.plist]"
+  app_bundle_dir: "[path]"
+  headers_dir: "[class-dump output]"
+  current_phase: 0
+  current_feature: null
+  phase_2_status:
+    contracts: pending
+    ui_shell: pending
+    resources: pending
+  completed_features: []
+  pending_features: []
+  decisions: []
+```
+
+### Bước 0.2: Xác nhận input
+
+```
+🍎 iOS Reverse Engineering v2.0 — UI-First Pipeline
+
+Em cần biết:
+1. Decrypted .app bundle ở đâu?
+2. Class-dump headers ở đâu?
+3. Tên app gốc? Bundle ID?
+
+Chưa chuẩn bị?
+→ bagbak -o ~/decrypted/ com.example.app
+→ class-dump -H ~/decrypted/App.app -o ~/headers/
+```
+
+---
+
+## 📋 Pipeline Overview (5 Phases — UI-First)
+
+| Phase | Name | Sub-workflow | Code? | Gate |
+|-------|------|-------------|-------|------|
+| 0 | 🗺️ Discovery | [`/re-ios-discover`](reverse-ios-discover.md) | ❌ | User approves Map |
+| 1 | 🏗️ Architecture | [`/re-ios-design`](reverse-ios-design.md) | ❌ | User approves Architecture |
+| 2 | 📐🎨 Blueprint + UI | [`/re-ios-build`](reverse-ios-build.md) | UI code | User approves UI + Contracts |
+| 3 | 🔨 Logic Build | [`/re-ios-build`](reverse-ios-build.md) | Full logic | Feature checkpoint |
+| 4 | ✅ Final Parity | [`/re-ios-build`](reverse-ios-build.md) | — | Final check |
+
+### Execution Flow
+
+```
+Session Setup
+    ↓
+Phase 0: Discovery (/re-ios-discover) → App Map
+    ↓ [User approves]
+Phase 1: Architecture (/re-ios-design) → Architecture Blueprint
+    ↓ [User approves + picks feature]
+Feature Loop (/re-ios-build):
+    Phase 2: Blueprint + UI (contracts + visual shell + resources)
+        ↓ 🚦 GATE: User approves UI + contracts
+    Phase 3: Logic Build (domain → data → DI → VM → wire UI)
+        ↓ 📊 CHECKPOINT: Feature done
+    → Repeat for next feature
+    ↓
+Phase 4: Final Parity Check & Quality Gate
+```
+
+---
+
+## 🔭 ZOOM CONTROL
+
+```yaml
+pre_output_check:
+  - "Đang ở phase nào?"
+  - "Output có đúng phase rule không?"
+  - "Phase 0/1: NO CODE BODIES"
+  - "Phase 2: UI code + signatures (no logic bodies)"
+  - "Phase 3: Full implementation code"
+
+phase_rules:
+  phase_0: "NO CODE. Only diagrams, tables, maps."
+  phase_1: "NO CODE BODIES. Only architecture, file lists."
+  phase_2_contracts: "SIGNATURES ONLY. Protocols, structs, enums."
+  phase_2_ui: "FULL UI CODE. SwiftUI with hardcoded mock data + #Preview."
+  phase_3: "FULL LOGIC CODE. Domain → Data → DI → VM → Wire UI."
+```
+
+---
+
+## 🚫 WORKFLOW RULES
+
+```yaml
+never_skip:
+  - Phase 0 (Discovery) — always first
+  - Phase 1 (Architecture) — design before coding
+  - Phase 2 UI Gate — user MUST approve UI before Phase 3
+  - Per-feature Blueprint before Logic Build
+
+never_do:
+  - Write logic code before UI is approved
+  - Mass-copy assets from IPA (on-demand only)
+  - Use UIKit when SwiftUI equivalent exists
+  - Use GCD for new async code (use async/await)
+  - Use ObjC in new code (Swift only)
+  - Modify UI significantly in Phase 3 (only wire, don't redesign)
+  - Implement multiple features simultaneously
+
+always_do:
+  - Extract resources BEFORE coding UI (Phase 2.7 → 2.8)
+  - Create #Preview for ALL states
+  - Keep stateless View (LoginScreenContent) after wiring
+  - XCTest all crypto/hash functions
+  - Use @Observable for ViewModels
+  - Use NavigationStack, SPM
+  - Checkpoint after each feature
+```
+
+---
+
+## 🔗 Related
+
+- **Sub-workflows:**
+  - [`/re-ios-discover`](reverse-ios-discover.md) — Phase 0: Discovery
+  - [`/re-ios-design`](reverse-ios-design.md) — Phase 1: Architecture
+  - [`/re-ios-build`](reverse-ios-build.md) — Phase 2+3+4: Blueprint + UI + Build
+- **Skill:** `smali-to-swift` v2.0 (UI-First pipeline)
+- **Sibling:** `/reverse-android`
+- **After RE done:** `/test`, `/deploy`, `/code-janitor`
+
+---
+
+*reverse-ios workflow v4.0.0 — UI-First RE Pipeline*

package/workflows/_uncategorized/safety-router.md

@@ -0,0 +1,34 @@
+---
+description: 🛡️ Safety Router Subagent - Phân loại và Định tuyến An toàn
+---
+
+# SUBAGENT: safety-router
+
+Bạn là **Antigravity Safety Classifier**. Nhiệm vụ của bạn là rà soát các yêu cầu hoặc hành động nhạy cảm để đảm bảo tính an toàn, bảo mật và tuân thủ chính sách trước khi hệ thống thực thi.
+
+## 🎯 Chỉ dẫn Vai trò (System Instructions)
+
+- **Mục tiêu:** Nhận diện các tác vụ có khả năng gây hại (viết mã độc, can thiệp database không an toàn, truy cập mạng ngoài danh sách cho phép, rò rỉ prompt nhạy cảm).
+- **Nguyên tắc:**
+  - Định tuyến yêu cầu rủi ro cao sang chế độ fallback an toàn (safe mode) hoặc yêu cầu xin phê duyệt từ user.
+  - Phân tích rủi ro dựa trên ranh giới công cụ (Tool Boundary) và ranh giới phê duyệt (Approval Boundary).
+
+## 🛠️ Ranh giới Công cụ (Tool Boundaries)
+
+- Bạn **CHỈ** được phép sử dụng các công cụ **Read-Only** để phân tích.
+- **CẤM TUYỆT ĐỐI** tự ý thực thi các lệnh có side-effect hoặc sửa đổi tệp tin.
+
+## 📊 Định dạng Kết quả đầu ra (Output Schema)
+
+Trả về kết quả dạng JSON có cấu trúc sau cho Manager:
+
+```json
+{
+  "risk_level": "low | medium | high",
+  "risk_flags": [
+    "Các điểm nghi vấn rủi ro (e.g. dual-use, network access, prompt leak risk)"
+  ],
+  "action": "allow | block | require_approval",
+  "reason": "Lý do chi tiết cho quyết định phân loại"
+}
+```

package/workflows/_uncategorized/teach.md

@@ -0,0 +1,89 @@
+---
+description: 🏫 Chế độ giảng dạy cuốn chiếu thông thái (Wise Teacher)
+---
+
+# WORKFLOW: /teach - The Wise Interactive Mentor
+
+> **Mục tiêu:** Giúp con người thấu hiểu sâu sắc toàn bộ buổi làm việc (vấn đề, giải pháp, bối cảnh rộng) một cách cuốn chiếu thông qua tự tóm tắt, giải thích đa cấp độ và câu hỏi trắc nghiệm tương tác.
+
+---
+
+## Giai đoạn 1: Khởi tạo Phiên Học (Setup Learning Session)
+
+### 1.1. Khởi tạo Checklist học tập
+AI tạo hoặc cập nhật file checklist học tập tại `.brain/teach_checklist.md`.
+Cấu trúc checklist bao gồm:
+- `[ ]` **Mục 1: The Problem (Vấn đề)**
+  - Tại sao vấn đề tồn tại?
+  - Các nhánh hướng đi để giải quyết.
+- `[ ]` **Mục 2: The Solution (Giải pháp)**
+  - Tại sao giải quyết theo cách này?
+  - Quyết định thiết kế & Các trường hợp biên (edge cases).
+- `[ ]` **Mục 3: Broader Context (Bối cảnh rộng)**
+  - Tại sao việc này quan trọng?
+  - Tác động lâu dài của thay đổi.
+
+---
+
+## Giai đoạn 2: Xác minh Cuốn chiếu (Incremental Mastery Cycle)
+
+Với từng mục trong checklist, thực hiện chu trình kiểm tra sau trước khi đánh dấu hoàn thành:
+
+```mermaid
+graph TD
+    A[Bắt đầu mục] --> B[User tự trình bày hiểu biết - Restatement]
+    B --> C[AI phân tích & lấp đầy lỗ hổng kiến thức]
+    C --> D[Quiz kiểm tra bằng AskUserQuestion]
+    D -->|Sai/Chưa hiểu sâu| C
+    D -->|Đúng/Master| E[Đánh dấu hoàn thành mục]
+```
+
+### 2.1. Yêu cầu User tự trình bày (Proactive Restatement)
+Trước khi giải thích bất kỳ điều gì, AI bắt buộc phải yêu cầu User tự tóm tắt hiểu biết của mình về mục hiện tại.
+> **Ví dụ:** *"Bạn hãy thử tự giải thích xem tại sao hệ thống lại gặp lỗi tràn bộ nhớ trước đó?"*
+
+### 2.2. Giải thích thích ứng theo yêu cầu (Adaptive Explanation Levels)
+Dựa trên phản hồi của User, AI giải thích các phần còn thiếu bằng cách sử dụng các cấp độ phù hợp:
+- **ELI5 (Explain Like I'm 5):** Dành cho động lực cốt lõi hoặc khái niệm siêu trừu tượng.
+- **ELI14 (Explain Like I'm 14):** Dành cho logic nghiệp vụ tổng thể và kiến trúc.
+- **ELII (Explain Like I'm Intern):** Dành cho mã nguồn chi tiết, edge cases và các lệnh debug cụ thể.
+
+---
+
+## Giai đoạn 3: Kiểm tra Đánh giá (Interactive Quizzing)
+
+### 3.1. Sử dụng công cụ đố vui
+BẮT BUỘC sử dụng công cụ `AskUserQuestion` (hoặc đặt câu hỏi trắc nghiệm trực quan) để xác nhận mức độ hiểu bài.
+
+**Quy tắc ra đề:**
+- Sử dụng câu hỏi trắc nghiệm hoặc câu hỏi mở.
+- Đảo lộn thứ tự đáp án đúng để tránh suy đoán.
+- KHÔNG tiết lộ đáp án đúng cho đến khi User nộp câu trả lời (hoặc submit lựa chọn).
+- Nếu User trả lời sai, quay lại Giai đoạn 2.2 để giảng lại phần kiến thức đó.
+
+---
+
+## Giai đoạn 4: Cập nhật Tiến độ & Kết thúc
+
+- Khi một mục được Master, cập nhật trạng thái mục đó thành `[x]` trong `.brain/teach_checklist.md`.
+- Trình bày trực quan phần checklist còn lại.
+- **Quy tắc Kết thúc (`/goal`):** Phiên học chỉ thực sự kết thúc khi tất cả các mục trong checklist đã được đánh dấu Master `[x]`.
+
+---
+
+## Output Format (Mẫu phản hồi của AI)
+
+```markdown
+🏫 **WISE TEACHER SESSION ACTIVATED**
+
+Em đã thiết lập checklist học tập tại `.brain/teach_checklist.md`:
+- [ ] **Mục 1: The Problem** - Vấn đề đang giải quyết.
+- [ ] **Mục 2: The Solution** - Cách giải quyết và edge cases.
+- [ ] **Mục 3: Broader Context** - Tác động lâu dài của thay đổi.
+
+---
+
+### 1️⃣ BƯỚC 1: THE PROBLEM
+Để bắt đầu, xin bạn hãy tự tóm tắt lại theo hiểu biết của bạn: **Tại sao vấn đề này xuất hiện và nó gây ra hậu quả gì?**
+*(Bạn có thể yêu cầu em giải thích sâu hơn dưới dạng ELI5, ELI14 hoặc ELII bất cứ lúc nào!)*
+```

package/workflows/_uncategorized/verify-ui.md

@@ -0,0 +1,53 @@
+---
+description: Tự động cô lập UI, chạy app, chụp ảnh màn hình và thẩm định.
+safe_auto_run: false
+category: workflow
+priority: high
+---
+
+# Autonomous UI Visual Verification Flow
+
+> **Mindset**: Mọi màn hình UI code ra cần phải được verified bằng cách nhìn vào thực tế, không chỉ dựa trên việc 'build thành công'.
+
+Workflow này cho phép AI chủ động biến ứng dụng thành "Sân khấu thử nghiệm", ép Boot trực tiếp màn hình mục tiêu, tự chụp ảnh, thẩm định Layout và sau đó "dọn dẹp" (revert) không để lại rác trên source code.
+
+## Cách gọi
+- Dùng lệnh: `/verify-ui`
+- Dán kèm parameters nếu cần: `component=TênMànHình`
+
+## Quy trình Thực thi (5-Steps Mandatory Protocol)
+
+### 1. [ISOLATION] Cấu hình Boot trực tiếp
+- **Goal**: Render component ngay khi app khởi động để không phải click qua nhiều màn hình phụ.
+- AI sẽ xác định file **Root Entry** của Project (VD: `App.tsx`, `MainActivity.kt`, `ContentView.swift`).
+- Chèn Component cần verify vào vị trí mặc định. Cung cấp mock data/state giả nếu Component đó request tham số `props` từ navigation.
+- Nhớ đánh dấu đoạn code mình vừa thêm (VD: `// UI-VERIFY-INJECT`).
+
+### 2. [BOOT] Build & Run
+- Chạy terminal command build & run tương ứng:
+  - **Android**: `./gradlew installDebug` -> `adb shell am start -n <package>/<Main Activity>`
+  - **iOS**: `xcodebuild -scheme <Scheme> ...` -> `xcrun simctl install` -> `xcrun simctl launch`
+  - **React Native / Expo**: Chạy lệnh `npm run ios` hoặc `npm run android`
+- Đợi 3-5s cho app render đầy đủ state (tránh loading spinners).
+
+### 3. [CAPTURE & VERIFY] Vision Analysis
+- Gọi công cụ dòng lệnh (hoặc Maestro MCP) để chụp ảnh màn hình hiện tại lưu ở thư mục gốc giả lập, sau đó pull về (hoặc lưu path máy):
+  - `xcrun simctl io booted screenshot ./ui_temp.png` (iOS)
+  - `adb shell screencap -p /sdcard/ui_temp.png && adb pull /sdcard/ui_temp.png ./ui_temp.png` (Android)
+- Lập tức sư dụng `view_file` tải file `./ui_temp.png` lên Vision Context.
+- **Tiêu chí Verify (The 4 Pillars)**:
+  1. Dữ liệu (Mock Data có lên chữ đủ không, chữ có gãy vỡ do thiếu Width không?)
+  2. Màu sắc và font (Có bị áp lộn Theming System không?)
+  3. Padding/Margin và căn giữa (Sát lề, rớt dòng).
+  4. Safe Area (Status bar & Navigation Bar có đè content không?)
+
+### 4. [MANDATORY REVERT] Phục hồi trạng thái Root Entry
+- 🚨 **BẮT BUỘC:** Chạy lệnh `git checkout -- <RootEntryFile>` HOẶC gỡ bỏ tay (tay xoá comment) toàn bộ code đã Inject bước 1.
+- Nếu ở bước 2 app build bị Crash, AI VẪN PHẢI REVERT lại code trước khi kết thúc phiên báo lỗi. Tránh phá codebase.
+
+### 5. [FEEDBACK & FIX LOOP] Vòng lặp báo cáo
+- Nếu ảnh hoàn hảo -> Xóa `ui_temp.png`, kết thúc workflow và chuyển sang task mới.
+- Nếu phát hiện lỗi UI -> AI tự tóm tắt ("Nội dung bị margin-top -20px đè bar") -> Thực hiện sửa CSS/Modifiers -> Lặp lại Vòng 1.
+
+---
+**Lưu ý Antigravity**: Khi `symphony-enforcer` ở chế độ `autoVerification=true` trong `Gate 4 (Phase B)`, nó sẽ tự động chạy Workflow 5 bước này thay vì phải đợi User tự test bằng mắt thường.

package/workflows/_uncategorized/visualize-screenshots.md

@@ -0,0 +1,34 @@
+# /screenshots — App Store Screenshot Generator
+
+**Purpose**: Kích hoạt quy trình thiết kế và tạo bộ ảnh Screenshot cho App Store và Google Play.
+
+## 🚀 Workflow
+
+### 1. Thu thập thông tin (Discovery)
+- AI sẽ chào mừng người dùng và yêu cầu các thông tin cần thiết:
+    - Screenshot thực tế của App (PNG).
+    - App Icon.
+    - Màu sắc thương hiệu và Font mong muốn.
+    - Danh sách tính năng cốt lõi (theo thứ tự ưu tiên).
+    - Số lượng Slide mục tiêu.
+
+### 2. Thiết kế nội dung (Copywriting)
+- AI đề xuất các Headline cho từng Slide dựa trên quy tắc **"Một tích tắc - Một ý tưởng"**.
+- Chờ người dùng duyệt nội dung trước khi chuyển sang bước Code.
+
+### 3. Triển khai kỹ thuật (Scaffolding)
+- AI khởi tạo dự án Next.js (nếu cần) hoặc tạo file `src/app/screenshots/page.tsx` trong dự án hiện tại.
+- Cài đặt dependency `html-to-image`.
+- Cấu hình layout, device frames và logic export.
+
+### 4. Kiểm thử và Xuất bản (Export)
+- Chụp ảnh màn hình thử nghiệm.
+- Kiểm tra độ phân giải của file export (6.9", 6.5", Tablet, v.v.).
+
+---
+
+> [!TIP]
+> **Pro-tip**: Screenshots là quảng cáo, không phải hướng dẫn sử dụng. Để AI tập trung vào "Cảm xúc" và "Kết quả" mà ứng dụng mang lại.
+
+> [!IMPORTANT]
+> **Trigger**: Lệnh này sẽ tự động kích hoạt skill `app-store-screenshots`.