@leejungkiin/awkit 1.5.2 → 1.5.3

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

@@ -1,222 +0,0 @@
----
-description: 🔨 RE Android Phase 2+3+4 — Blueprint + UI Shell → Logic Build → Final Parity (UI-First)
-parent: reverse-android
----
-
-# /re-android-build — Blueprint + UI + Build (Per Feature)
-
-> **Parent:** [`/reverse-android`](reverse-android.md) → Phase 2+3+4
-> **Prerequisite:** Completed Architecture from [`/re-android-design`](reverse-android-design.md)
-> **Skill:** `smali-to-kotlin` → `phase-2-blueprint-ui.md` + `phase-3-logic-build.md`
-
----
-
-## 🔄 Feature Loop (UI-First)
-
-```
-For each feature (from Architecture Build Order):
-    Phase 2: Blueprint + UI (contracts + visual shell)
-        ↓ 🚦 GATE: User approves UI + contracts
-    Phase 3: Logic Build (domain → data → wire)
-        ↓ 📊 CHECKPOINT
-    → Next feature
-```
-
----
-
-## 📐🎨 Phase 2: Blueprint + UI Design
-
-> **Output:** Approved contracts + Working Compose UI shell with mock data.
-
-### Part A: Contracts (signatures only)
-
-#### 2.1: Deep Smali Reading
-Read Smali files for the chosen feature. Extract class hierarchy, fields, method signatures,
-string constants, control flow. See `smali-reading-guide.md`.
-
-#### 2.2–2.5: Define Contracts
-```kotlin
-// 2.2 Domain Model
-data class [Model](val field: Type, ...)
-
-// 2.3 Repository Interface
-interface [Feature]Repository {
-    suspend fun [method](...): Result<[Type]>
-}
-
-// 2.4 API Interface
-interface [Feature]Api {
-    @[METHOD]("[endpoint]")
-    suspend fun [method](...): [Response]
-}
-
-// 2.5 UseCase
-class [Action]UseCase(repo: [Feature]Repository) {
-    suspend operator fun invoke(...): Result<[Type]> // TODO()
-}
-```
-
-#### 2.6: UI State Design
-```kotlin
-data class [Screen]UiState(
-    val field: Type = default,
-    val isLoading: Boolean = false,
-    val error: String? = null
-)
-sealed interface [Screen]Event { /* navigation, snackbar */ }
-sealed interface [Screen]Action { /* user interactions */ }
-```
-
-### Part B: UI Visual Shell
-
-#### 2.7: Resource Extraction ⭐ (BEFORE UI code!)
-
-```bash
-# Only resources for THIS screen
-grep -o '@drawable/[a-z_]*' [apktool_dir]/res/layout/activity_[screen].xml | sort -u
-grep -o '@color/[a-z_]*' [apktool_dir]/res/layout/activity_[screen].xml | sort -u
-```
-
-Copy ONLY needed resources. Verify they compile.
-
-#### 2.8: UI Implementation ⭐ (Visual shell with mock data)
-
-- Use UiState from 2.6 with hardcoded defaults
-- Use REAL resources from 2.7
-- Create `[Screen]Content` composable (stateless)
-- Match visual parity with original app
-- NO ViewModel connection, NO real API calls
-
-```kotlin
-@Composable
-fun [Screen]Content(
-    uiState: [Screen]UiState = [Screen]UiState(),  // Mock
-    onAction: ([Screen]Action) -> Unit = {}          // No-op
-) {
-    // Full Compose UI matching original app
-}
-
-@Preview @Composable
-private fun NormalPreview() { AppTheme { [Screen]Content() } }
-
-@Preview @Composable
-private fun LoadingPreview() { AppTheme { [Screen]Content([Screen]UiState(isLoading = true)) } }
-
-@Preview @Composable
-private fun ErrorPreview() { AppTheme { [Screen]Content([Screen]UiState(error = "Error")) } }
-```
-
-#### 2.9: Visual Parity Check ⭐
-
-Compare with original app:
-- [ ] Layout structure matches
-- [ ] Colors, typography, spacing correct
-- [ ] Icons/images positioned correctly
-- [ ] All states: normal, loading, error, empty
-
-### 🚦 UI + Contracts Gate (MANDATORY)
-
-```
-"📐🎨 Blueprint + UI cho [Feature] xong:
-📝 Contracts: [N] models, [N] repos, [N] use cases, [N] APIs
-🎨 UI: [Screen] with [N] state previews
-📸 Visual Parity: [OK / needs adjustment]
-
-→ ✅ Approve → Phase 3 (Logic Build)
-→ 🎨 Adjust UI → fix then re-check
-→ 📝 Adjust contracts → revise"
-```
-
-> ⚠️ **DO NOT proceed to Phase 3 without user approval.**
-
----
-
-## 🔨 Phase 3: Logic Build
-
-> **Output:** Full production-quality Kotlin code. Wire logic to EXISTING UI.
-
-### 3.1: Domain Layer
-Models + Repository interfaces + UseCases (implement invoke with repo calls)
-
-### 3.2: Data Layer
-DTOs + Retrofit API + Room (if applicable) + Repository implementation
-
-### 3.3: DI Module
-Hilt @Module with @Binds for repository
-
-### 3.4: ViewModel
-@HiltViewModel with StateFlow + SharedFlow, implements onAction()
-
-### 3.5: Wire UI ↔ Logic ⭐ (NOT "code new UI")
-
-The UI already exists from Phase 2.8. Only CONNECT it:
-
-```kotlin
-// Keep stateless Content composable from Phase 2 (for Preview):
-// [Screen]Content(uiState, onAction) — DO NOT MODIFY
-
-// ADD wrapper that wires ViewModel:
-@Composable
-fun [Screen](
-    viewModel: [Screen]ViewModel = hiltViewModel(),
-    onNavigate: () -> Unit
-) {
-    val uiState by viewModel.uiState.collectAsStateWithLifecycle()
-    LaunchedEffect(Unit) {
-        viewModel.events.collect { event -> /* handle navigation */ }
-    }
-    [Screen]Content(uiState = uiState, onAction = viewModel::onAction)
-}
-```
-
-### 3.6: Integration Test ⭐
-- [ ] API calls succeed, data displays
-- [ ] Loading/error states work
-- [ ] Navigation correct
-- [ ] Crypto output matches (if applicable)
-
-### 🔒 Crypto Utils (Special)
-If crypto involved: implement + unit test IMMEDIATELY with known pairs.
-> ⚠️ MUST produce identical output.
-
-### ✅ Feature Checkpoint
-
-```markdown
-## ✅ Feature Complete: [Name]
-Files: [list] | Resources: [count] | Tests: [status]
-⏭️ Next Feature: [Name] → Return to Phase 2
-```
-
----
-
-## ✅ Phase 4: Final Parity Check (After ALL features)
-
-### Checklist
-- [ ] API Parity — all endpoints match (headers, body, encoding)
-- [ ] Data Parity — crypto/hash output identical
-- [ ] UI Parity — screen-by-screen comparison
-- [ ] Edge Cases — empty states, errors, offline, lifecycle
-- [ ] Build: `./gradlew assembleDebug && ./gradlew test && ./gradlew lint`
-
-### 🎉 Final Summary
-
-```markdown
-## ✅ Reverse Engineering Complete!
-- Screens: [N] | Features: [N]
-- Libs reused: [N] | Replaced: [N]
-- Tests: [pass/fail] | Lint: [warnings]
-
-⏭️ Next: /test → /deploy → /code-janitor
-```
-
----
-
-## 🔗 Related
-
-- **Parent:** [`/reverse-android`](reverse-android.md)
-- **Previous:** [`/re-android-design`](reverse-android-design.md) (Phase 1)
-- **Skill:** `smali-to-kotlin` → `phase-2-blueprint-ui.md` + `phase-3-logic-build.md`
-
----
-
-*re-android-build v4.0.0 — UI-First Blueprint + Build*

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

@@ -1,139 +0,0 @@
----
-description: 🏗️ RE Android Phase 1 — Architecture Design (NO CODE BODIES)
-parent: reverse-android
----
-
-# /re-android-design — Architecture Blueprint
-
-> **Parent:** [`/reverse-android`](reverse-android.md) → Phase 1
-> **Prerequisite:** Completed App Map from [`/re-android-discover`](reverse-android-discover.md)
-> **Skill:** `smali-to-kotlin` → `phase-1-architecture.md`
-> **Zoom Level:** 1 — District View
-> **Output:** Architecture Blueprint (diagrams, tables, NO CODE BODIES)
-
----
-
-## ⛔ ZOOM 1 RULE
-
-```
-This workflow produces NO CODE BODIES.
-Allowed: Architecture diagrams, layer maps, feature tables, file paths, API endpoint lists.
-Allowed: build.gradle.kts plugin/dependency declarations (declaration only).
-If you are about to write a function body → STOP → wrong zoom level.
-```
-
----
-
-## 📐 Step 1: Layer Design
-
-Design Clean Architecture layers based on App Map:
-
-```
-┌─────────────────────────────────────┐
-│ Presentation                        │
-│ ├── screens/ ([N] screens)          │
-│ ├── navigation/ (NavGraph + Routes) │
-│ ├── theme/ (Material 3)            │
-│ └── components/ (Shared UI)        │
-├─────────────────────────────────────┤
-│ Domain                              │
-│ ├── model/ ([N] models)             │
-│ ├── repository/ ([N] interfaces)   │
-│ └── usecase/ ([N] use cases)        │
-├─────────────────────────────────────┤
-│ Data                                │
-│ ├── remote/ ([N] API services)     │
-│ ├── local/ (Room, DataStore)       │
-│ └── repository/ (implementations)  │
-├─────────────────────────────────────┤
-│ DI (Hilt)                           │
-│ └── modules/ (Network, DB, Repo)   │
-└─────────────────────────────────────┘
-```
-
-## 📋 Step 2: Feature → File Mapping
-
-Map mỗi feature tới Clean Architecture components:
-
-| Feature | Domain Model | Repository | UseCase | Screen(s) | ViewModel |
-|---------|-------------|-----------|---------|-----------|-----------|
-
-## 🌐 Step 3: API Endpoint Inventory
-
-Trích xuất TẤT CẢ API endpoints từ Smali:
-
-| # | Method | Endpoint | Auth | Notes |
-|---|--------|----------|------|-------|
-
-**Base URL:** `[from Smali const-string]`
-
-## 💾 Step 4: Data Schema
-
-| Model | Key Fields | Source | Storage |
-|-------|-----------|--------|---------|
-
-## 📁 Step 5: Project Structure
-
-```
-app/src/main/java/[package]/
-├── App.kt
-├── di/
-├── data/remote/ + data/local/ + data/repository/
-├── domain/model/ + domain/repository/ + domain/usecase/
-├── presentation/navigation/ + screens/ + theme/
-└── util/
-```
-
-## 🔢 Step 6: Build Order (UI-First) ⭐
-
-| # | Phase | Scope | Complexity |
-|---|-------|-------|-----------|
-| 1 | 🟢 Foundation | Project + DI skeleton + Theme/Design System | Low |
-| 2 | 🟢 Navigation | Routes, tab bar, NavGraph | Low |
-| 3 | 🔵 Per Feature | Blueprint (contracts) + UI Shell (visual) | Medium |
-| 4 | 🚦 UI Gate | User approves UI before logic | — |
-| 5 | 🟡 Per Feature | Logic Build (Domain → Data → VM → Wire UI) | High |
-| 6 | 📦 SDKs | Third-party SDK + Native libs integration | Medium |
-| N | 🔴 Final | Full Parity Check | High |
-
-> **UI-First:** Design and approve UI before coding logic for each feature.
-
-## 🔧 Step 7: Tech Stack Confirmation
-
-| Decision | Choice | Rationale |
-|----------|--------|-----------|
-| UI | Jetpack Compose + M3 | Modern |
-| DI | Hilt | Standard |
-| ... | ... | ... |
-
----
-
-## 📊 Output: Architecture Blueprint
-
-Sử dụng template từ `skills/smali-to-kotlin/templates/architecture.md`.
-
----
-
-## ✅ Gate: Chuyển sang Phase 2
-
-```
-"🏗️ Architecture Blueprint xong!
-Anh muốn bắt đầu từ feature nào?
-Em suggest: [Feature X] vì [reason]."
-
-→ User picks feature → /re-android-build (Phase 2: Blueprint for that feature)
-→ User wants changes → adjust architecture
-```
-
----
-
-## 🔗 Related
-
-- **Previous:** [`/re-android-discover`](reverse-android-discover.md) (Phase 0)
-- **Next:** [`/re-android-build`](reverse-android-build.md) (Phase 2+3)
-- **Parent:** [`/reverse-android`](reverse-android.md)
-- **Skill:** `skills/smali-to-kotlin/phase-1-architecture.md`
-
----
-
-*re-android-design v3.0.0 — Phase 1: Architecture Blueprint*

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

@@ -1,150 +0,0 @@
----
-description: 🗺️ RE Android Phase 0 — Discovery & App Map (NO CODE output)
-parent: reverse-android
----
-
-# /re-android-discover — Discovery & App Map
-
-> **Parent:** [`/reverse-android`](reverse-android.md) → Phase 0
-> **Skill:** `smali-to-kotlin` → `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 Kotlin code → STOP → you are at wrong zoom level.
-```
-
----
-
-## 📦 Step 0: Library Scanner
-
-> Nhận diện toàn bộ thư viện **trước khi làm bất kỳ thứ gì**.
-
-### 0.1: Quét structure
-
-```bash
-# Top-level packages
-find [apktool_dir]/smali -maxdepth 3 -type d | sed 's|.*/smali/||' | sort
-
-# Multi-dex check
-find [apktool_dir] -name "smali*" -maxdepth 1 -type d
-
-# Resource counts
-ls [apktool_dir]/res/layout/ 2>/dev/null | wc -l
-ls [apktool_dir]/res/drawable*/ 2>/dev/null | wc -l
-
-# Native + Assets
-find [apktool_dir]/lib -name "*.so" 2>/dev/null
-ls [apktool_dir]/assets/ 2>/dev/null
-```
-
-### 0.2: Phân loại thư viện
-
-Dùng patterns từ `library-patterns.md`, phân thành 5 nhóm:
-
-| Category | Example | Action |
-|----------|---------|--------|
-| ✅ Reuse | Retrofit, OkHttp | Add to build.gradle |
-| 🔄 Replace | Volley, AsyncTask | Map to modern |
-| 🔵 Google/Firebase | FCM, Analytics | Use latest |
-| 📱 Native | .so files | Keep, JNI bridge |
-| 🏷️ App Code | com.app.* | Rebuild |
-
-### 0.3: User approval
-
-> **GATE:** Hiển thị Library Report → User approve trước khi tiếp.
-
----
-
-## 📄 Step 1: Manifest Analysis
-
-```bash
-cat [apktool_dir]/AndroidManifest.xml
-```
-
-### 1.1: Trích xuất
-
-- Application ID + Package name
-- Min/Target SDK
-- Permissions (phân nhóm: network, storage, camera, location, other)
-- Entry points: Application class, Launcher Activity, MainActivity
-- Components: Activities (→ future screens), Services, Receivers, Providers
-- Deep links / Intent filters
-
-### 1.2: Screen Map
-
-Map Activities → future Compose screens:
-
-```
-SplashActivity    → presentation/screens/splash/
-LoginActivity     → presentation/screens/auth/
-MainActivity      → presentation/screens/main/
-DetailActivity    → presentation/screens/detail/
-SettingsActivity  → presentation/screens/settings/
-```
-
-Draw navigation flow (ASCII or Mermaid).
-
-### 1.3: Complexity Estimate
-
-| Area | Rating | Notes |
-|------|--------|-------|
-| Data Layer | ●●●○○ | [evidence] |
-| Core Logic | ●●○○○ | [evidence] |
-| UI Screens | ●●●●○ | [evidence] |
-| SDK Integration | ●●○○○ | [evidence] |
-
----
-
-## 📊 Output: App Map
-
-Sử dụng template từ `skills/smali-to-kotlin/templates/app-map.md`:
-
-```markdown
-## 🗺️ App Map: [App Name]
-
-### Identity
-[package, SDK, counts]
-
-### Screen Flow
-[navigation graph]
-
-### Library Landscape
-[categorized table]
-
-### Complexity Estimate
-[rating dots]
-
-### Key Observations
-[notable findings]
-```
-
----
-
-## ✅ Gate: Chuyển sang Phase 1
-
-```
-"🗺️ App Map xong! Anh review map này.
-Có gì cần điều chỉnh không? OK → em sẽ thiết kế Architecture."
-
-→ User approves → /re-android-design (Phase 1)
-→ User has questions → investigate và update map
-```
-
----
-
-## 🔗 Related
-
-- **Next:** [`/re-android-design`](reverse-android-design.md) (Phase 1: Architecture)
-- **Parent:** [`/reverse-android`](reverse-android.md)
-- **Skill reference:** `skills/smali-to-kotlin/phase-0-discovery.md`
-
----
-
-*re-android-discover v3.0.0 — Phase 0: Discovery & App Map*

package/workflows/mobile/reverse-android.md

@@ -1,143 +0,0 @@
----
-description: 🔧 Dịch ngược APK Android (Apktool output) → App Kotlin hiện đại với Jetpack Compose, Clean Architecture, và UI-First methodology.
-skill: smali-to-kotlin
----
-
-# /reverse-android — Android APK Reverse Engineering Workflow
-
-> **Skill:** `smali-to-kotlin` v2.0 | **Tech:** Kotlin + Compose + Hilt + Retrofit + Room
-> **Philosophy:** "Map → Blueprint → UI First → Logic Behind"
-> **Key:** UI is designed and approved BEFORE coding any business logic.
-
----
-
-## ⚡ QUICK START
-
-User cung cấp: Apktool output dir, `AndroidManifest.xml`, hoặc nói "reverse engineer APK 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_session:
-  project_name: "[TBD - từ manifest]"
-  apktool_dir: "[path]"
-  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
-
-```
-🔧 Android Reverse Engineering v2.0 — UI-First Pipeline
-
-Em cần biết:
-1. Thư mục Apktool output ở đâu?
-2. Tên app gốc? Package name?
-
-Chưa chạy Apktool? → apktool d your-app.apk -o ./decompiled/
-```
-
----
-
-## 📋 Pipeline Overview (5 Phases — UI-First)
-
-| Phase | Name | Sub-workflow | Code? | Gate |
-|-------|------|-------------|-------|------|
-| 0 | 🗺️ Discovery | [`/re-android-discover`](reverse-android-discover.md) | ❌ | User approves Map |
-| 1 | 🏗️ Architecture | [`/re-android-design`](reverse-android-design.md) | ❌ | User approves Architecture |
-| 2 | 📐🎨 Blueprint + UI | [`/re-android-build`](reverse-android-build.md) | UI code | User approves UI + Contracts |
-| 3 | 🔨 Logic Build | [`/re-android-build`](reverse-android-build.md) | Full logic | Feature checkpoint |
-| 4 | ✅ Final Parity | [`/re-android-build`](reverse-android-build.md) | — | Final check |
-
-### Execution Flow
-
-```
-Session Setup
-    ↓
-Phase 0: Discovery (/re-android-discover) → App Map
-    ↓ [User approves]
-Phase 1: Architecture (/re-android-design) → Architecture Blueprint
-    ↓ [User approves + picks feature]
-Feature Loop (/re-android-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 diagrams, file lists."
-  phase_2_contracts: "SIGNATURES ONLY. Interfaces, data classes, sealed classes."
-  phase_2_ui: "FULL UI CODE. Compose 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 resources from APK (on-demand only)
-  - Implement multiple features simultaneously
-  - Modify UI significantly in Phase 3 (only wire, don't redesign)
-  - Skip crypto parity check
-
-always_do:
-  - Extract resources BEFORE coding UI (Phase 2.7 → 2.8)
-  - Create @Preview for ALL states
-  - Keep stateless composable (LoginScreenContent) after wiring
-  - Checkpoint after each feature
-  - Document all decisions
-```
-
----
-
-## 🔗 Related
-
-- **Sub-workflows:**
-  - [`/re-android-discover`](reverse-android-discover.md) — Phase 0: Discovery
-  - [`/re-android-design`](reverse-android-design.md) — Phase 1: Architecture
-  - [`/re-android-build`](reverse-android-build.md) — Phase 2+3+4: Blueprint + UI + Build
-- **Skill:** `smali-to-kotlin` v2.0 (UI-First pipeline)
-- **Sibling:** `/reverse-ios` (iOS counterpart)
-- **After RE done:** `/test`, `/deploy`, `/code-janitor`
-
----
-
-*reverse-android workflow v4.0.0 — UI-First RE Pipeline*