@leejungkiin/awkit 1.0.3 → 1.0.5

package/workflows/mobile/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/mobile/reverse-ios.md

@@ -1,12 +1,13 @@
 ---
-description: 🍎 Dịch ngược IPA iOS (class-dump, Hopper output) → App Swift hiện đại với SwiftUI, Clean Architecture, và Framework Scanner tự động.
+description: 🍎 Dịch ngược IPA iOS (class-dump, Hopper output) → App Swift hiện đại với SwiftUI, Clean Architecture. Progressive Disclosure: Map → Blueprint → Build.
 skill: smali-to-swift
 ---
 
 # /reverse-ios — iOS IPA Reverse Engineering Workflow
 
-> **Skill:** `smali-to-swift` | **Tech:** Swift + SwiftUI + async/await + URLSession + SwiftData
-> **Philosophy:** "Read ObjC headers to understand WHAT & WHY → Write Swift for HOW"
+> **Skill:** `smali-to-swift` v2.0 | **Tech:** Swift + SwiftUI + async/await + URLSession + SwiftData
+> **Philosophy:** "Treat decompiled code as a MAP, not a TODO list"
+> **Approach:** Map → Blueprint → Build (progressive disclosure)
 > **Sibling:** `/reverse-android`
 
 ---
@@ -14,7 +15,7 @@ skill: smali-to-swift
 ## ⚡ 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 từng bước — **không bao giờ nhảy cóc**.
+Workflow dẫn dắt qua **4 phases** — mỗi phase có zoom level riêng, **không bao giờ nhảy cóc**.
 
 ---
 
@@ -27,18 +28,20 @@ reverse_ios_session:
   project_name: "[TBD - từ Info.plist]"
   app_bundle_dir: "[path]"
   headers_dir: "[class-dump output]"
-  current_step: 0
-  framework_report_done: false
-  plist_analyzed: false
-  completed_screens: []
-  pending_screens: []
+  current_phase: 0
+  current_zoom: 0
+  current_feature: null
+  app_map_done: false
+  architecture_done: false
+  completed_features: []
+  pending_features: []
   decisions: []
 ```
 
 ### Bước 0.2: Xác nhận input
 
 ```
-🍎 iOS Reverse Engineering bắt đầu!
+🍎 iOS Reverse Engineering v2.0 — Map → Blueprint → Build
 
 Em cần biết:
 1. Decrypted .app bundle ở đâu?
@@ -52,25 +55,47 @@ Chưa chuẩn bị?
 
 ---
 
-## 📋 Pipeline Overview (7 Steps)
+## 📋 Pipeline Overview (4 Phases)
 
-| Step | Phase | Sub-workflow | Gate |
-|------|-------|-------------|------|
-| 0 | 📦 Framework Scanner | [`/re-ios-scan`](reverse-ios-scan.md) | User approve report |
-| 1 | 📄 Info.plist & Bootstrap | [`/re-ios-scan`](reverse-ios-scan.md) | Checkpoint |
-| 2 | 💾 Data Layer | [`/re-ios-build`](reverse-ios-build.md) | Checkpoint |
-| 3 | 🧮 Core Logic & Utils | [`/re-ios-build`](reverse-ios-build.md) | Checkpoint |
-| 4 | 🎨 UI & ViewModel | [`/re-ios-build`](reverse-ios-build.md) | Per-screen loop |
-| 5 | 📦 SDK Integration | [`/re-ios-build`](reverse-ios-build.md) | Checkpoint |
-| 6 | ✅ Parity Check | [`/re-ios-build`](reverse-ios-build.md) | Final QA |
+| Phase | Name | Sub-workflow | Zoom | Code? | Gate |
+|-------|------|-------------|------|-------|------|
+| 0 | 🗺️ Discovery | [`/re-ios-discover`](reverse-ios-discover.md) | Satellite | ❌ | User approves Map |
+| 1 | 🏗️ Architecture | [`/re-ios-design`](reverse-ios-design.md) | District | ❌ | User approves Architecture |
+| 2 | 📐 Blueprint | [`/re-ios-build`](reverse-ios-build.md) | Block | Signatures | Per-feature approval |
+| 3 | 🔨 Implementation | [`/re-ios-build`](reverse-ios-build.md) | Ground | Full | Per-feature checkpoint |
 
 ### Execution Flow
 
 ```
-Session Setup → Step 0+1 (/re-ios-scan) → Step 2-6 (/re-ios-build)
+Session Setup
+    ↓
+Phase 0: Discovery (/re-ios-discover) → App Map
+    ↓ [User approves]
+Phase 1: Architecture (/re-ios-design) → Architecture Blueprint
+    ↓ [User approves + picks feature]
+Phase 2+3 Loop (/re-ios-build):
+    → Blueprint Feature X → Build Feature X → Checkpoint
+    → Blueprint Feature Y → Build Feature Y → Checkpoint
+    ↓
+Final: Parity Check & Quality Gate
 ```
 
-**Chạy tuần tự:** Xong `/re-ios-scan` → chuyển sang `/re-ios-build`.
+---
+
+## 🔭 ZOOM CONTROL
+
+```yaml
+pre_output_check:
+  - "Đang ở zoom level nào?"
+  - "Output có đúng zoom level không?"
+  - "Có function body trong Phase 0/1 không? → REMOVE"
+
+zoom_rules:
+  zoom_0: "NO CODE. Only diagrams, tables, maps."
+  zoom_1: "NO CODE BODIES. Only architecture, file lists."
+  zoom_2: "SIGNATURES ONLY. Protocols, structs, enums."
+  zoom_3: "FULL CODE. Implementation for ONE feature."
+```
 
 ---
 
@@ -78,37 +103,38 @@ Session Setup → Step 0+1 (/re-ios-scan) → Step 2-6 (/re-ios-build)
 
 ```yaml
 never_skip:
-  - Step 0 (Framework Scanner) — always first
-  - User approval of Framework Report
-  - Checkpoint after each step
+  - Phase 0 (Discovery) — always first
+  - Phase 1 (Architecture) — design before code
+  - Per-feature Blueprint before Implementation
 
 never_do:
+  - Write code in Phase 0 or Phase 1
   - Mass-copy assets from IPA
   - Use UIKit when SwiftUI equivalent exists
   - Use GCD for new async code (use async/await)
-  - Use ObjC in new code (Swift only, except bridging headers)
-  - Skip crypto parity testing
+  - Use ObjC in new code (Swift only)
+  - Implement multiple features simultaneously
 
 always_do:
-  - Document decisions in session state
-  - Present Framework Report before coding
+  - Start with App Map
+  - Create Blueprint before each feature
   - XCTest all crypto/hash functions
-  - Use @Observable for ViewModels (iOS 17+)
-  - Use NavigationStack for navigation
-  - Use SPM for all dependencies
+  - Use @Observable for ViewModels
+  - Use NavigationStack, SPM
 ```
 
 ---
 
 ## 🔗 Related
 
-- **Sub-workflows:** [`/re-ios-scan`](reverse-ios-scan.md) · [`/re-ios-build`](reverse-ios-build.md)
-- **Skill:** `smali-to-swift` (core knowledge & rules)
-- **Framework DB:** `skills/smali-to-swift/framework-patterns.md`
-- **ObjC Guide:** `skills/smali-to-swift/objc-reading-guide.md`
-- **Sibling:** `/reverse-android` (Android counterpart)
+- **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: Blueprint + Build
+- **Skill:** `smali-to-swift` v2.0
+- **Sibling:** `/reverse-android`
 - **After RE done:** `/test`, `/deploy`, `/code-janitor`
 
 ---
 
-*reverse-ios workflow v2.0.0 — Modular RE Pipeline*
+*reverse-ios workflow v3.0.0 — Progressive Disclosure RE Pipeline*

package/workflows/mobile/reverse-android-scan.md

@@ -1,158 +0,0 @@
----
-description: 📦 RE Android Phase 1 — Library Scanner + Manifest Analysis + Project Bootstrap
-parent: reverse-android
----
-
-# /re-android-scan — Library Scanner & Manifest Analysis
-
-> **Parent:** [`/reverse-android`](reverse-android.md) → Step 0 + Step 1
-> **Skill:** `smali-to-kotlin` | **Reference:** `skills/smali-to-kotlin/library-patterns.md`
-
----
-
-## 📦 Step 0: Library Scanner (BẮT BUỘC)
-
-> Nhận diện toàn bộ thư viện **trước khi code bất kỳ thứ gì**.
-
-### 0.3: Quét Smali directories
-
-```bash
-# Top-level packages
-find [apktool_dir]/smali -maxdepth 3 -type d | sed 's|[apktool_dir]/smali/||' | sort
-
-# Multi-dex
-find [apktool_dir] -name "smali*" -maxdepth 1 -type d
-find [apktool_dir]/smali_classes2 -maxdepth 3 -type d 2>/dev/null | sort
-
-# Native libraries & Assets
-find [apktool_dir]/lib -name "*.so" 2>/dev/null
-ls [apktool_dir]/assets/ 2>/dev/null
-```
-
-### 0.4: Tạo Library Detection Report
-
-Dùng patterns từ `library-patterns.md`, phân loại:
-
-```markdown
-## 📦 Library Detection Report — [App Name]
-
-### ✅ Reuse (build.gradle)
-| Library | Package Detected | Version | Notes |
-|---------|-----------------|---------|-------|
-| Retrofit | com/squareup/retrofit2 | 2.9.0 | Keep |
-| OkHttp | com/squareup/okhttp3 | 4.12.0 | Keep |
-
-### 🔄 Replace (Legacy → Modern)
-| Old Library | Detected | Replacement |
-|-------------|----------|-------------|
-| Volley | com/android/volley | Retrofit + OkHttp |
-| AsyncTask | android.os.AsyncTask | Coroutines |
-
-### 🔵 Firebase/Google SDKs
-| SDK | Detected | Action |
-|-----|----------|--------|
-
-### 📱 Native (.so) — Giữ nguyên
-| File | Architecture | Notes |
-|------|-------------|-------|
-
-### 🏷️ App Code (Rebuild in Kotlin)
-| Package | Module |
-|---------|--------|
-
-### ❓ Unknown (Cần điều tra)
-| Package | Path | Possible |
-|---------|------|----------|
-```
-
-### 0.5: User approval
-
-> **GATE:** Không tiếp tục Step 1 khi chưa có user approval report.
-
----
-
-## 📄 Step 1: AndroidManifest Analysis & Project Bootstrap
-
-> **Input:** `[apktool_dir]/AndroidManifest.xml`
-
-### 1.1: Phân tích Manifest
-
-Trích xuất:
-
-```yaml
-extract:
-  - application_id, package_name
-  - min_sdk, target_sdk
-  - permissions: [network, storage, camera, location, other]
-  - entry_points: [application_class, splash_activity, main_activity]
-  - components: [activities, services, receivers, providers]
-  - deep_links, features
-```
-
-### 1.2: Đề xuất project structure
-
-Mapping activities → Compose screens (xem SKILL.md Step 1):
-
-```
-SplashActivity → presentation/screens/splash/SplashScreen.kt
-MainActivity   → presentation/screens/main/MainScreen.kt
-LoginActivity  → presentation/screens/auth/LoginScreen.kt
-```
-
-### 1.3: Tạo `build.gradle.kts` skeleton
-
-```kotlin
-plugins {
-    alias(libs.plugins.android.application)
-    alias(libs.plugins.kotlin.android)
-    alias(libs.plugins.kotlin.compose)
-    alias(libs.plugins.hilt.android)
-    alias(libs.plugins.ksp)
-    alias(libs.plugins.kotlin.serialization)
-}
-
-android {
-    namespace = "[package_name]"
-    compileSdk = [target_sdk]
-    defaultConfig {
-        applicationId = "[application_id]"
-        minSdk = [min_sdk]
-        targetSdk = [target_sdk]
-    }
-    buildFeatures { compose = true; buildConfig = true }
-}
-
-dependencies {
-    // Compose BOM + Material3 + Navigation
-    // Coroutines + Hilt DI
-    // Network: Retrofit + OkHttp (từ Library Report)
-    // Local: Room + DataStore
-    // Image: Coil + Logging: Timber
-    // [Thêm libs từ "Reuse" section]
-}
-```
-
-### ✅ Checkpoint Step 1
-
-```markdown
-## ✅ Step 1 Complete
-
-- Package: [package_name]
-- Entry points: [list]
-- Screens to rebuild: [list]
-
-⏭️ Next: `/re-android-build` — Step 2 (Data Layer)
-Cung cấp Smali: smali/[package]/network/, model/, data/
-```
-
----
-
-## 🔗 Related
-
-- **Next:** [`/re-android-build`](reverse-android-build.md) (Step 2-6)
-- **Parent:** [`/reverse-android`](reverse-android.md)
-- **Library patterns:** `skills/smali-to-kotlin/library-patterns.md`
-
----
-
-*re-android-scan v2.0.0 — Phase 1: Discovery & Bootstrap*

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

@@ -1,155 +0,0 @@
----
-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*