@leejungkiin/awkit 1.7.0 → 1.7.4

package/workflows/ads/smali-ads-native.md

@@ -0,0 +1,382 @@
+---
+description: 📰 Tích hợp Native Ads vào APK mod - Tận dụng library có sẵn
+---
+
+# Smali Native Ads Integration
+
+> **🎯 Mục tiêu**: Tích hợp Native Ads bằng cách tận dụng ads library có sẵn trong APK.
+
+---
+
+## 🔍 Phase 1: Discovery - Tìm Native Ads Library
+
+### 1.1. Scan Pattern-based Search
+
+**Pattern 1: Tìm theo keyword**
+```bash
+# Tìm file chứa "Native"
+find smali* -name "*Native*.smali" | grep -i ad
+
+# Tìm theo nội dung
+find smali* -name "*.smali" | xargs grep -l "NativeAd\|native.*ad"
+```
+
+**Pattern 2: Tìm theo View components**
+```bash
+# Native Ad thường có View custom
+find smali* -name "*AdView*.smali"
+find smali* -name "*NativeView*.smali"
+
+# Hoặc trong layout
+grep -r "NativeAd" res/layout/
+```
+
+**Pattern 3: Google AdMob Native**
+```bash
+# Native Ad từ AdMob SDK
+find smali* -path "*/gms/ads/nativead/*" -type f
+```
+
+### 1.2. Identify Components
+
+**Common structures:**
+- `NativeAd.smali` - Core ad object
+- `NativeAdView.smali` - Container view
+- `NativeAdOptions.smali` - Configuration
+- `MediaView.smali` - Media content view
+- Custom wrappers: `*NativeAdHelper*.smali`
+
+**Document findings:**
+```
+[Native Ads Discovery]
+
+Library Location: smali_classes*/{path}/
+Core Classes:
+- NativeAd: {ClassName}.smali
+- AdView: {ViewClassName}.smali
+- Loader: {LoaderClassName}.smali
+
+View Components:
+- Layout: res/layout/{native_ad_layout}.xml
+- Binding: {package}/databinding/{Binding}.smali (nếu có)
+
+Current Usage:
+- Used in: {Activity/Fragment}.smali
+- Inflated in: {methodName}()
+```
+
+---
+
+## 📦 Phase 2: Understanding Native Ad Structure
+
+### 2.1. Ad Assets Components
+
+**Standard Native Ad có các thành phần:**
+
+| Asset | Purpose | View Type |
+|-------|---------|-----------|
+| **Headline** | Tiêu đề chính | TextView |
+| **Body** | Mô tả | TextView |
+| **Icon** | Logo/Icon | ImageView |
+| **Media** | Ảnh/Video lớn | MediaView |
+| **Call to Action** | Button hành động | Button |
+| **Advertiser** | Tên advertiser | TextView |
+| **Star Rating** | Đánh giá | RatingBar |
+| **Price** | Giá (nếu có) | TextView |
+| **Store** | Store name | TextView |
+
+### 2.2. Analyze Existing Layout
+
+**Tìm layout XML:**
+```bash
+# Tìm layout có Native Ad
+grep -r "NativeAdView\|native.*ad" res/layout/
+
+# Hoặc tìm theo ID
+grep -r "@id/ad_" res/layout/
+```
+
+**Structure thường gặp:**
+```xml
+<com.google.android.gms.ads.nativead.NativeAdView>
+    <ImageView android:id="@+id/ad_app_icon" />
+    <TextView android:id="@+id/ad_headline" />
+    <TextView android:id="@+id/ad_body" />
+    <com.google.android.gms.ads.nativead.MediaView 
+        android:id="@+id/ad_media" />
+    <Button android:id="@+id/ad_call_to_action" />
+</com.google.android.gms.ads.nativead.NativeAdView>
+```
+
+### 2.3. API Pattern Recognition
+
+**Sử dụng jadx để xem pattern:**
+```java
+// Example pattern
+AdLoader adLoader = new AdLoader.Builder(context, "AD_UNIT_ID")
+    .forNativeAd(new NativeAd.OnNativeAdLoadedListener() {
+        @Override
+        public void onNativeAdLoaded(NativeAd nativeAd) {
+            // Populate views
+        }
+    })
+    .build();
+    
+adLoader.loadAd(new AdRequest.Builder().build());
+```
+
+---
+
+## 🔧 Phase 3: Integration Strategy
+
+### 3.1. Determine Placement
+
+**Từ `/smali-ads-flow`:**
+- **Onboarding Activity** - Between slides
+- **Other screens** (optional) - List items, feed, etc.
+
+**Layout Strategy:**
+
+**Option A: Inline placement**
+```xml
+<ScrollView>
+    <LinearLayout>
+        <!-- Content -->
+        <TextView .../>
+        
+        <!-- Native Ad Container -->
+        <include layout="@layout/native_ad_layout" />
+        
+        <!-- More content -->
+    </LinearLayout>
+</ScrollView>
+```
+
+**Option B: Overlay placement**
+```xml
+<FrameLayout>
+    <!-- Main content -->
+    <ViewPager .../>
+    
+    <!-- Ad overlay -->
+    <include 
+        layout="@layout/native_ad_layout"
+        android:layout_gravity="bottom" />
+</FrameLayout>
+```
+
+### 3.2. Loading Pattern
+
+**Lifecycle integration:**
+```
+onCreate/onViewCreated:
+  → Initialize AdLoader
+  → Load ad
+
+onNativeAdLoaded:
+  → Populate NativeAdView
+  → Show ad container
+  → Track impression
+
+onDestroy:
+  → Destroy ad
+  → Cleanup resources
+```
+
+### 3.3. View Population
+
+**Generic pattern trong Smali:**
+```
+1. Get ad assets (headline, body, icon, etc.)
+2. Set to corresponding views
+3. Register NativeAdView
+4. Track loaded state
+```
+
+**Implementation**: Xem existing usage trong APK để copy pattern
+
+---
+
+## 🎨 Phase 4: UI Implementation
+
+### 4.1. Layout Creation/Reuse
+
+**Option 1: Reuse existing layout**
+```bash
+# Tìm layout có sẵn
+find res/layout -name "*native*.xml"
+find res/layout -name "*ad*.xml"
+
+# Copy và modify cho use case mới
+cp res/layout/existing_native_ad.xml res/layout/onboarding_native_ad.xml
+```
+
+**Option 2: Create new layout**
+- Design theo style app
+- Include all required ad components
+- Match NativeAdView structure
+
+### 4.2. Styling Considerations
+
+**Tuân thủ AdMob policy:**
+- Phải có "Ad" badge/label
+- Không được misleading
+- CTA button phải rõ ràng
+- Không che khuất nội dung bắt buộc
+
+**Implementation:**
+```xml
+<!-- Ad badge -->
+<TextView
+    android:text="Ad"
+    android:background="@color/ad_badge_bg"
+    .../>
+```
+
+---
+
+## 🔌 Phase 5: Code Injection
+
+### 5.1. Hook Points
+
+**Trong OnboardingActivity:**
+```
+Location: OnboardingActivity.smali
+Method: onCreate() hoặc setupUI()
+
+Actions:
+1. Initialize AdLoader
+2. Load native ad
+3. Setup callback handlers
+```
+
+### 5.2. Injection Pattern
+
+**Generic template:**
+```smali
+# In onCreate or initialization method
+
+# Create AdLoader
+new-instance v0, Lcom/google/android/gms/ads/AdLoader$Builder;
+const-string v1, "{AD_UNIT_ID}"
+invoke-direct {v0, p0, v1}, ...; <init>(...)
+
+# Set native ad listener
+# ... (copy pattern from existing usage)
+
+# Build and load
+invoke-virtual {v0}, ...; build()
+move-result-object v1
+invoke-virtual {v1, ...}, ...; loadAd(...)
+```
+
+### 5.3. Callback Implementation
+
+**Pattern:**
+```smali
+.method private onNativeAdLoaded(Lcom/.../NativeAd;)V
+    # 1. Get ad container view
+    # 2. Populate assets to views
+    # 3. Register ad view
+    # 4. Make container visible
+.end method
+
+.method private onAdFailedToLoad()V
+    # Fallback: hide ad container
+    # Continue without ad
+.end method
+```
+
+---
+
+## ✅ Phase 6: Testing & Validation
+
+### 6.1. Functional Tests
+
+| Test | Expected | Verification |
+|------|----------|--------------|
+| **Load Success** | Ad loads, views populated | Visual check |
+| **All Assets** | Headline, body, media, CTA shown | Check each element |
+| **Click Works** | Clicking opens advertiser page | Test CTA |
+| **Fallback** | No ad = hidden container | Test with no network |
+| **No Memory Leak** | Destroy properly | Monitor memory |
+
+### 6.2. UI/UX Tests
+
+- [ ] Ad không che khuất content quan trọng
+- [ ] "Ad" badge visible
+- [ ] Layout responsive với different screen sizes
+- [ ] Không conflict với app UI
+- [ ] Smooth scroll/transition
+
+### 6.3. Debug Commands
+
+```bash
+# Monitor native ad events
+adb logcat | grep -E "NativeAd|AdLoader|MediaView"
+
+# Test with test ad ID
+# ca-app-pub-3940256099942544/2247696110 (Android Test Native)
+
+# Check view hierarchy
+adb shell uiautomator dump
+adb pull /sdcard/window_dump.xml
+```
+
+---
+
+## 📋 Implementation Checklist
+
+### Discovery
+- [ ] Tìm được native ad library/wrapper
+- [ ] Xác định NativeAd và NativeAdView classes
+- [ ] Tìm được existing layout
+- [ ] Document API usage pattern
+
+### Layout
+- [ ] Có layout cho native ad
+- [ ] Include tất cả required components
+- [ ] Add "Ad" badge
+- [ ] Styling match app design
+
+### Integration
+- [ ] Hook vào OnboardingActivity
+- [ ] Inject AdLoader initialization
+- [ ] Implement onNativeAdLoaded callback
+- [ ] Populate view assets
+
+### Testing
+- [ ] Load ad successfully
+- [ ] All assets display correctly
+- [ ] Click tracking works
+- [ ] Fallback when no ad
+- [ ] No memory leaks
+
+---
+
+## 🔗 Related Resources
+
+### Workflows
+- `/smali-ads-flow` - Main ads flow
+- `/smali-ads-interstitial` - Interstitial ads
+- `/smali-ads-config` - Remote config
+
+### References
+- [AdMob Native Ads Guide](https://developers.google.com/admob/android/native)
+- [Native Ads Policies](https://support.google.com/admob/answer/6329638)
+- [Test Ads](https://developers.google.com/admob/android/test-ads)
+
+---
+
+## 💡 Tips & Best Practices
+
+1. **Reuse existing implementation**: Copy pattern từ native ad có sẵn trong app
+2. **Respect policies**: Luôn có "Ad" badge, không misleading
+3. **Test thoroughly**: Native ad có nhiều assets, test kỹ
+4. **Handle missing assets**: Một số ad không có đủ assets (rating, price)
+5. **Cleanup properly**: Destroy ad trong onDestroy để tránh memory leak
+6. **Responsive design**: Test với nhiều screen sizes
+
+---
+
+**⚠️ Quan trọng**: Native Ads phải tuân thủ strict policies về disclosure và presentation!

package/workflows/context/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/gitnexus.md

@@ -18,17 +18,17 @@ node --version
 
 2. Index project:
 ```bash
-npx -y gitnexus@latest analyze
+pnpm dlx gitnexus analyze  # (Hoặc: npx -y gitnexus@latest analyze)
 ```
 
 3. Verify index:
 ```bash
-npx gitnexus status
+pnpm dlx gitnexus status   # (Hoặc: npx gitnexus status)
 ```
 
 4. (Optional) Generate embeddings cho semantic search tốt hơn:
 ```bash
-npx gitnexus analyze --embeddings
+pnpm dlx gitnexus analyze --embeddings  # (Hoặc: npx gitnexus analyze --embeddings)
 ```
 
 ---
@@ -38,12 +38,12 @@ npx gitnexus analyze --embeddings
 // turbo
 1. Xem trạng thái index:
 ```bash
-npx gitnexus status
+pnpm dlx gitnexus status   # (Hoặc: npx gitnexus status)
 ```
 
 2. Nếu stale → suggest re-index:
 ```bash
-npx gitnexus analyze
+pnpm dlx gitnexus analyze  # (Hoặc: npx gitnexus analyze)
 ```
 
 ---
@@ -96,7 +96,7 @@ READ gitnexus://repo/{name}/processes
 // turbo
 1. Liệt kê tất cả repos:
 ```bash
-npx gitnexus list
+pnpm dlx gitnexus list  # (Hoặc: npx gitnexus list)
 ```
 
 ---
@@ -105,12 +105,12 @@ npx gitnexus list
 
 1. Xóa index project hiện tại:
 ```bash
-npx gitnexus clean
+pnpm dlx gitnexus clean  # (Hoặc: npx gitnexus clean)
 ```
 
 2. Xóa tất cả indexes (cẩn thận!):
 ```bash
-npx gitnexus clean --all --force
+pnpm dlx gitnexus clean --all --force  # (Hoặc: npx gitnexus clean --all --force)
 ```
 
 ---

package/workflows/lifecycle/brainstorm.md

@@ -114,6 +114,41 @@ Sau khi hiểu, tóm tắt:
 
 ---
 
+## Giai đoạn 1.5: Phân tích Thiết kế Hành vi (Mô hình Hooked)
+
+> [!NOTE]
+> Để tạo ra một sản phẩm hình thành thói quen lâu dài, chúng ta cần rà soát qua 4 bước của Mô hình Hooked trong sách *Dẫn dắt người dùng*.
+
+Trong bước này, AI PHẢI tự phân tích trong `<thought>` và đưa ra 1-2 câu hỏi phản biện sâu sắc cho người dùng về một trong các thành tố sau:
+
+### 1. Kích hoạt (Trigger)
+*   **Kích hoạt bên trong (Internal Trigger):** Người dùng đang có cảm xúc tiêu cực nào (lo lắng, chán nản, cô đơn, FOMO) ngay trước khi họ muốn dùng app?
+    *   *Câu hỏi gợi ý:* "Khi người dùng cảm thấy [cảm xúc tiêu cực], họ sẽ tìm đến app của anh như thế nào? Đâu là khoảnh khắc 'ngòi nổ' thúc đẩy họ?"
+*   **Kích hoạt bên ngoài (External Trigger):** Cái gì sẽ lôi kéo họ vào app lần đầu hoặc quay lại?
+    *   *Câu hỏi gợi ý:* "Chúng ta sẽ dùng thông báo push, email hay tác nhân môi trường nào để kích hoạt hành động của họ mà không gây phiền toái?"
+
+### 2. Hành động (Action)
+*   **Tối giản hành động:** Hành vi đơn giản nhất người dùng thực hiện để nhận phần thưởng là gì?
+*   **Fogg Behavior Model ($B = MAP$):**
+    *   *Motivation:* Người dùng muốn tìm kiếm điều gì (Niềm vui, Hy vọng, Sự chấp nhận)?
+    *   *Ability:* Làm sao để giảm ma sát (thời gian, tiền bạc, sức lực, tư duy nhận thức)?
+    *   *Câu hỏi gợi ý:* "Hành động đơn giản nhất mà người dùng cần làm để nhận được giá trị đầu tiên là gì? Có bước nào chúng ta có thể loại bỏ hoặc tối giản hóa nữa không?"
+
+### 3. Phần thưởng biến thiên (Variable Reward)
+*   **Tính bất ngờ:** Phần thưởng nào giải quyết được vấn đề của họ nhưng vẫn giữ được sự tò mò và không biết lần sau có gì thú vị hơn?
+*   **3 nhóm phần thưởng:**
+    *   *Reward of the Tribe (Bộ lạc):* Sự công nhận, tương tác xã hội.
+    *   *Reward of the Hunt (Săn mồi):* Thông tin mới, ưu đãi, tài nguyên.
+    *   *Reward of the Self (Bản thân):* Cảm giác hoàn thành, làm chủ kỹ năng.
+    *   *Câu hỏi gợi ý:* "Phần thưởng nào sẽ giúp người dùng thỏa mãn ngay lập tức nhưng vẫn kích thích sự tò mò để họ muốn quay lại khám phá thêm?"
+
+### 4. Sự đầu tư (Investment)
+*   **Tích lũy giá trị (Stored Value):** Người dùng gửi gắm dữ liệu, thời gian, tiền bạc hay danh tiếng gì vào hệ thống?
+*   **Nạp đạn trigger tiếp theo:** Sự đầu tư này có tự động tạo ra kích hoạt tiếp theo không?
+    *   *Câu hỏi gợi ý:* "Sau khi nhận phần thưởng, người dùng sẽ 'đầu tư' lại gì (ví dụ: tùy chỉnh profile, lưu trữ lịch sử, kết nối bạn bè) để app có giá trị hơn với họ trong tương lai?"
+
+---
+
 ## Giai đoạn 2: Research Thị Trường (Nếu User Cần)
 
 ### 2.1. Hỏi về nhu cầu research
@@ -266,6 +301,14 @@ Tạo file `docs/BRIEF.md`:
 ## 2. GIẢI PHÁP ĐỀ XUẤT
 [App sẽ giải quyết vấn đề như thế nào]
 
+## 2.5. THIẾT KẾ HÀNH VI (MÔ HÌNH HOOKED)
+- **Kích hoạt (Trigger):**
+  - *Internal (Bên trong):* [Cảm xúc tiêu cực/nhu cầu kích hoạt sử dụng]
+  - *External (Bên ngoài):* [Tác nhân bên ngoài đưa người dùng trở lại]
+- **Hành động (Action):** [Hành vi đơn giản nhất người dùng thực hiện để nhận phần thưởng & tối giản hóa ma sát]
+- **Phần thưởng biến thiên (Variable Reward):** [Phần thưởng tạo sự thỏa mãn và tò mò (Bộ lạc, Săn mồi, Bản thân)]
+- **Sự đầu tư (Investment):** [Người dùng đầu tư gì để tích lũy giá trị và kích hoạt trigger tiếp theo]
+
 ## 3. ĐỐI TƯỢNG SỬ DỤNG
 - **Primary:** [Ai dùng chính]
 - **Secondary:** [Ai dùng phụ]

package/workflows/lifecycle/code.md

@@ -132,6 +132,11 @@ User gõ: /code (không có gì)
 ### 0.3. Lưu Current Plan vào Session
 
 Khi bắt đầu code theo phase:
+
+### 0.4. Tự động hóa Cô lập Ngữ cảnh (Subagent Research)
+Trước khi phân tích codebase hoặc tìm kiếm nhiều file:
+- BẮT BUỘC gọi subagent `research` (built-in) để thực hiện quét.
+- Chỉ lấy kết quả tóm tắt dạng JSON cấu trúc gửi về qua tin nhắn để tránh dồn log tìm kiếm vào chat chính (chống Context Rot).
 ```json
 // .brain/session.json
 {

package/workflows/lifecycle/init.md

@@ -21,16 +21,34 @@ description: ✨ Khởi tạo dự án chuẩn Antigravity (v5.0 - Spec-First +
 
 ---
 
-## ⚡ Giai đoạn 1: Context Awareness & Smart Adoption
+## ⚡ Giai đoạn 1: Context Awareness & Smart Adoption (SAEE Engine)
 
 **Kịch bản A: Thư mục trống (New Project)**
 *   Chạy quy trình phỏng vấn **Vision Capture**.
 *   Hỏi: "Anh muốn dùng template có sẵn không?" (Clean Arch, Boilerplate).
 
-**Kịch bản B: Thư mục có Code (Adoption Mode)**
-*   AI quét cấu trúc hiện tại.
-*   Tự động điền `.project-identity`.
-*   Đề xuất chuẩn hóa theo Antigravity Workflow.
+**Kịch bản B: Thư mục có Code (Adoption Mode - SAEE Activation)**
+AI thực hiện quét phân tích codebase tự động theo 5 bước:
+
+1.  **Smart Stack Analyzer**:
+    *   AI chủ động đọc cấu trúc thư mục và xem nội dung các file cấu hình quan trọng như `package.json`, `Podfile`, `build.gradle`, `Package.swift`, `requirements.txt` bằng `view_file` (KHÔNG grep blind).
+    *   Nhận diện ngôn ngữ, framework (React, Next.js, Expo, UIKit, FastAPI...), DB và package manager.
+
+2.  **Ecosystem Recommender (MCP & Skills)**:
+    *   Đối chiếu với bảng mapping tại [setup-mapping.json](file:///Users/trungkientn/Dev/NodeJS/main-awf/templates/setup-mapping.json) để đề xuất:
+        *   **MCP Servers phù hợp** (ví dụ: `playwright`, `maestro`, `firebase-mcp-server`, `ios-simulator`).
+        *   **Adaptive Skills cần kích hoạt** (ví dụ: `expo-build-optimizer`, `firebase-firestore`, `swiftui-pro`).
+    *   Hỏi ý kiến người dùng: *"Tìm thấy stack [Stack]. Bật MCP [MCP] và Skills [Skills] này nhé anh?"*
+
+3.  **Automated Hook System (AHS)**:
+    *   Đề xuất kích hoạt các hook tự động như `autoCommit: true`, `build_preflight: "awkit build"` trước khi push.
+    *   Điền trực tiếp các cấu hình được duyệt vào `.project-identity` của dự án mới.
+
+4.  **Tailored Workflows**:
+    *   Đề xuất nạp thêm các custom workflows đặc thù (ví dụ: `/aso-audit` cho Mobile, `/api-test` cho Backend).
+
+5.  **Tạo File `.project-identity`**:
+    *   Tự động tổng hợp toàn bộ kết quả phân tích và lựa chọn của người dùng vào file `.project-identity`.
 
 ---