@leejungkiin/awkit 1.0.1 → 1.0.3

package/workflows/expert/planExpert.md

@@ -42,13 +42,34 @@ description: 📝 Thiết kế tính năng (Expert Mode - Zero Questions)
   - Medium: 6 phases (+ Database + Integration)
   - Complex: 8+ phases (+ Auth + Deploy + Monitoring)
 
-### 4. Sync to Beads
+### 4. Sync to Beads (Hierarchical — v6.5)
 ```bash
+# Step 1: Create epic (1 per plan)
+EPIC_ID=$(bd create "<Feature Name>" -t epic -p 1 \
+  --description "<feature summary>" \
+  --acceptance "<high-level acceptance>" \
+  --design "<architecture approach>" \
+  --json | jq -r '.id')
+
+# Step 2: Create phase tasks as children of epic
 for each phase:
-  bd create "Phase X: [Name]" --priority [0-2]
-  
-for each task in phase:
-  bd create "[Task Name]" --parent [Phase ID]
+  PHASE_ID=$(bd create "Phase X: [Name]" \
+    --parent $EPIC_ID -p 1 \
+    --description "<phase summary>" \
+    --json | jq -r '.id')
+
+  # Step 3: Create subtasks as children of phase
+  for each task in phase:
+    bd create "[Task Name]" \
+      --parent $PHASE_ID -p 2 \
+      --acceptance "<definition of done>" \
+      --json
+
+# Step 4: Set inter-phase dependencies
+bd dep add $PHASE2_ID $PHASE1_ID  # Sequential phases
+
+# Step 5: Save to brain/active_plans.json
+# → { "current": { "epic_id": $EPIC_ID, "feature": "...", "phases": [...] } }
 ```
 
 ### 5. Report
@@ -59,16 +80,17 @@ for each task in phase:
 📋 Spec: docs/specs/shopping-cart_spec.md
 
 📊 **Structure:**
-- 6 Phases
-- 42 Tasks
+- 🏔️ 1 Epic
+- 📦 6 Phases (sequential dependencies)
+- 📝 42 Subtasks (with acceptance criteria)
 - Estimated: 3-4 sessions
 
-📿 **Beads:**
-- Created 6 phase tasks
-- Created 42 sub-tasks
-- Ready to start: bd list
+📿 **Beads (Hierarchical):**
+- Epic: bd-xxxx
+- Tree: bd list --parent bd-xxxx --tree
+- Ready: bd ready --parent bd-xxxx
 
-➡️ **Next:** /codeExpert phase-01
+➡️ **Next:** /codeExpert (auto-picks first ready subtask)
 ```
 
 ---
@@ -107,6 +129,7 @@ Options:
 
 ## Integration
 
-- **Brain:** Auto-save to `brain/active_plans.json`
-- **Beads:** Auto-create tasks with dependencies
+- **Brain:** Auto-save epic mapping to `brain/active_plans.json` (with epic_id + phase IDs)
+- **Beads:** Auto-create epic → phase → subtask hierarchy with dependencies
+- **Skill:** Uses `plan_to_beads()` from `beads-manager` skill v6.5
 - **Git:** Auto-commit plan files (optional)

package/workflows/lifecycle/plan.md

@@ -46,8 +46,10 @@ description: 📝 Thiết kế tính năng (Dual-Mode v5.0)
 ### Phase 3: Plan Generation
 1.  **Action:** Tạo folder structure và file markdown (như v2).
 2.  **Sync Beads:** (Nếu user đồng ý ở Phase 1)
-    -   Loop qua từng Phase -> `bd create "Phase X: [Name]"`
-    -   Loop qua từng Step trong Phase -> `bd dep add [Child] [Parent]`
+    -   `bd create -t epic` → Create root epic
+    -   Loop qua từng Phase → `bd create --parent <epic-id>`
+    -   Loop qua từng Step → `bd create --parent <phase-id> --acceptance "..."`
+    -   `bd dep add` cho inter-phase dependencies
 
 ### Phase 4: Handoff
 1.  **Report:** Hiển thị chi tiết Plan và Link Beads.
@@ -63,15 +65,17 @@ description: 📝 Thiết kế tính năng (Dual-Mode v5.0)
 
 ## 🧠 Brain & Beads Integration Details
 
-### 1. Auto-Sync Logic
-Khi tạo file `phase-01-setup.md`, hệ thống sẽ:
-1.  Parse các dòng `- [ ] Task Name`.
-2.  Chạy `bd create "Task Name"`.
-3.  Ghi lại Bead ID vào cuối dòng trong file MD: `- [ ] Task Name <!-- bead:123 -->`.
+### 1. Auto-Sync Logic (Hierarchical — v6.5)
+Khi tạo plan, hệ thống sẽ:
+1.  `bd create "<Feature>" -t epic --json` → Create root epic
+2.  For each phase: `bd create "Phase X" --parent <epic-id> --json`
+3.  For each task: `bd create "Task" --parent <phase-id> --acceptance "..." --json`
+4.  `bd dep add <phase-N+1> <phase-N>` → Sequential phase dependencies
+5.  Ghi epic mapping → `brain/active_plans.json`
 
 ### 2. Context Retention
--   Lưu đường dẫn Plan vào `brain/active_plans.json`.
--   Khi User gõ `/next`, hệ thống đọc file này để biết đang làm Feature nào.
+-   Lưu `epic_id` + phase IDs vào `brain/active_plans.json`.
+-   Khi User gõ `/next`, hệ thống dùng `bd ready --parent <epic-id>` để suggest task.
 
 ---
 

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

@@ -0,0 +1,232 @@
+---
+description: 🏗️ RE Android Phase 2 — Data Layer, Utils, UI, SDK Integration & Parity Check
+parent: reverse-android
+---
+
+# /re-android-build — Build & Verify
+
+> **Parent:** [`/reverse-android`](reverse-android.md) → Step 2-6
+> **Prerequisite:** Hoàn thành [`/re-android-scan`](reverse-android-scan.md)
+> **Skill:** `smali-to-kotlin` | **Smali Guide:** `skills/smali-to-kotlin/smali-reading-guide.md`
+
+---
+
+## 💾 Step 2: Data Layer Reconstruction
+
+> **Input:** Smali files cho network, models, database logic
+
+### 2.1: Network Layer → Retrofit interfaces
+
+```kotlin
+interface UserApi {
+    @GET("users/{id}")
+    suspend fun getUser(@Path("id") id: String): UserDto
+
+    @POST("auth/login")
+    suspend fun login(@Body request: LoginRequest): TokenDto
+}
+```
+
+### 2.2: DTOs (Kotlin Serialization)
+
+```kotlin
+@Serializable
+data class UserDto(
+    @SerialName("user_id") val userId: String,
+    @SerialName("full_name") val fullName: String,
+    @SerialName("email") val email: String,
+)
+```
+
+### 2.3: Room Database (nếu có local DB)
+
+- Entity với `@Entity` + `@PrimaryKey`
+- DAO với `@Dao` + `Flow<>` return types
+- `OnConflictStrategy.REPLACE` cho upsert
+
+### 2.4: Repository Pattern
+
+- Domain: `interface UserRepository` (Flows + Results)
+- Data: `UserRepositoryImpl @Inject constructor(api, dao)` — offline-first
+
+### ✅ Checkpoint Step 2
+
+---
+
+## 🧮 Step 3: Core Logic & Utils
+
+> **CRITICAL:** Output phải match 100% với app gốc
+
+### 3.1: Nhận diện từ Smali
+
+```
+javax/crypto/Cipher       → AES/DES encryption
+java/security/MessageDigest → MD5/SHA hashing
+android/util/Base64        → Base64 encoding
+Custom XOR/shift loops     → Custom obfuscation
+```
+
+### 3.2: Kotlin objects
+
+```kotlin
+object CryptoUtils {
+    fun hashMd5(input: String): String {
+        val md = MessageDigest.getInstance("MD5")
+        return md.digest(input.toByteArray())
+            .joinToString("") { "%02x".format(it) }
+    }
+    fun encryptAes(data: String, key: String): String { /* from Smali */ }
+}
+```
+
+### 3.3: Unit Test verification (BẮT BUỘC cho crypto)
+
+```kotlin
+class CryptoUtilsTest {
+    @Test
+    fun `md5 hash matches original`() {
+        assertEquals("expected_hash", CryptoUtils.hashMd5("test_input"))
+    }
+}
+```
+
+### ✅ Checkpoint Step 3
+
+---
+
+## 🎨 Step 4: UI & ViewModel (Per Screen — Loop)
+
+> **Input:** `res/layout/*.xml` + Activity/Fragment Smali
+> **Lặp lại** cho MỌI màn hình từ Step 1
+
+### 4.0: Thứ tự ưu tiên
+
+1. SplashScreen → 2. Auth → 3. Home → 4. Detail → 5. Settings/Profile
+
+### 4.1: Resource Extraction (On-Demand only)
+
+Chỉ copy resources cho màn hình hiện tại: drawables, strings, colors, dimens, fonts.
+
+### 4.2: XML Layout → Compose
+
+Pattern cho mỗi screen:
+
+```kotlin
+@Composable
+fun [Screen]Screen(
+    viewModel: [Screen]ViewModel = hiltViewModel(),
+    onNavigateTo[Next]: () -> Unit
+) {
+    val uiState by viewModel.uiState.collectAsStateWithLifecycle()
+    // LaunchedEffect for events
+    // Scaffold with content
+}
+```
+
+### 4.3: ViewModel Pattern
+
+```kotlin
+@HiltViewModel
+class [Screen]ViewModel @Inject constructor(
+    private val useCase: [Feature]UseCase
+) : ViewModel() {
+    private val _uiState = MutableStateFlow([Screen]UiState())
+    val uiState = _uiState.asStateFlow()
+    
+    private val _events = MutableSharedFlow<[Screen]Event>()
+    val events = _events.asSharedFlow()
+}
+
+data class [Screen]UiState(val isLoading: Boolean = false, val error: String? = null)
+sealed interface [Screen]Event { /* navigation, snackbar */ }
+```
+
+### ✅ Checkpoint Step 4 (Per Screen)
+
+> **Loop:** Quay lại 4.0 cho screen tiếp. Hết screen → Step 5.
+
+---
+
+## 📦 Step 5: SDK & Native Library Integration
+
+> **Input:** Library Report từ Step 0
+
+### 5.1: Native Libraries (.so) → JNI Bridge
+
+```kotlin
+class NativeBridge {
+    companion object { init { System.loadLibrary("name") } }
+    external fun nativeMethod(param: String): ByteArray
+}
+```
+
+### 5.2: Application class
+
+```kotlin
+@HiltAndroidApp
+class App : Application() {
+    override fun onCreate() { super.onCreate(); setupTimber(); setupFirebase() }
+}
+```
+
+### 5.3: Hilt DI Modules
+
+- `NetworkModule`: OkHttpClient + Retrofit + Interceptors
+- `DatabaseModule`: Room database + DAOs
+- `RepositoryModule`: Bind implementations
+
+### ✅ Checkpoint Step 5
+
+---
+
+## ✅ Step 6: Parity Check & Quality Gate
+
+### 6.1: Edge Case checklist (từ Smali branches)
+
+```markdown
+- [ ] Login empty/invalid input
+- [ ] Network timeout/offline
+- [ ] Empty list states
+- [ ] Null server responses
+- [ ] App lifecycle (bg/fg)
+```
+
+### 6.2: API Parity
+
+- [ ] Base URL, headers, body format matches
+- [ ] Response parsing correct
+- [ ] Error handling matches
+
+### 6.3: Data Parity
+
+- [ ] Encryption/hash output matches
+- [ ] Date formatting matches
+- [ ] Local storage works correctly
+
+### 6.4: Build & Test
+
+```bash
+./gradlew assembleDebug && ./gradlew test && ./gradlew lint
+```
+
+### 🎉 Final Summary
+
+```markdown
+## Complete!
+- Screens: [count] | Libs reused: [count] | Replaced: [count]
+- Tests: [pass/fail] | Lint: [pass/warnings]
+
+⏭️ Next: /test → /deploy → /code-janitor
+```
+
+---
+
+## 🔗 Related
+
+- **Parent:** [`/reverse-android`](reverse-android.md)
+- **Previous:** [`/re-android-scan`](reverse-android-scan.md) (Step 0-1)
+- **Smali Guide:** `skills/smali-to-kotlin/smali-reading-guide.md`
+
+---
+
+*re-android-build v2.0.0 — Phase 2: Build & Verify*

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

@@ -0,0 +1,158 @@
+---
+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-android.md

@@ -0,0 +1,106 @@
+---
+description: 🔧 Dịch ngược APK Android (Apktool output) → App Kotlin hiện đại với Jetpack Compose, Clean Architecture, và Library Scanner tự động.
+skill: smali-to-kotlin
+---
+
+# /reverse-android — Android APK Reverse Engineering Workflow
+
+> **Skill:** `smali-to-kotlin` | **Tech:** Kotlin + Compose + Hilt + Retrofit + Room
+> **Philosophy:** "Read Smali to understand WHAT & WHY → Write Kotlin for HOW"
+
+---
+
+## ⚡ 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 từng bước — **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_step: 0
+  library_report_done: false
+  manifest_analyzed: false
+  completed_screens: []
+  pending_screens: []
+  decisions: []
+```
+
+### Bước 0.2: Xác nhận input
+
+```
+🔧 Android Reverse Engineering bắt đầu!
+
+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 (7 Steps)
+
+| Step | Phase | Sub-workflow | Gate |
+|------|-------|-------------|------|
+| 0 | 📦 Library Scanner | [`/re-android-scan`](reverse-android-scan.md) | User approve report |
+| 1 | 📄 Manifest & Bootstrap | [`/re-android-scan`](reverse-android-scan.md) | Checkpoint |
+| 2 | 💾 Data Layer | [`/re-android-build`](reverse-android-build.md) | Checkpoint |
+| 3 | 🧮 Core Logic & Utils | [`/re-android-build`](reverse-android-build.md) | Checkpoint |
+| 4 | 🎨 UI & ViewModel | [`/re-android-build`](reverse-android-build.md) | Per-screen loop |
+| 5 | 📦 SDK Integration | [`/re-android-build`](reverse-android-build.md) | Checkpoint |
+| 6 | ✅ Parity Check | [`/re-android-build`](reverse-android-build.md) | Final QA |
+
+### Execution Flow
+
+```
+Session Setup → Step 0+1 (/re-android-scan) → Step 2-6 (/re-android-build)
+```
+
+**Chạy tuần tự:** Xong `/re-android-scan` → chuyển sang `/re-android-build`.
+
+---
+
+## 🚫 WORKFLOW RULES
+
+```yaml
+never_skip:
+  - Step 0 (Library Scanner) — always first
+  - User approval of Library Report — gate before Step 1
+  - Checkpoint after each step — no silent progress
+
+never_do:
+  - Mass-copy resources from APK (on-demand only)
+  - Use deprecated libraries without replacement plan
+  - Skip parity check for encryption utils
+  - Proceed to next step without user confirmation
+
+always_do:
+  - Document decisions in session state
+  - Present Library Report before any coding
+  - Unit test all crypto/hash functions
+  - Update session state after each screen in Step 4
+```
+
+---
+
+## 🔗 Related
+
+- **Sub-workflows:** [`/re-android-scan`](reverse-android-scan.md) · [`/re-android-build`](reverse-android-build.md)
+- **Skill:** `smali-to-kotlin` (core knowledge & rules)
+- **Library DB:** `skills/smali-to-kotlin/library-patterns.md`
+- **Smali Guide:** `skills/smali-to-kotlin/smali-reading-guide.md`
+- **Sibling:** `/reverse-ios` (iOS counterpart)
+- **After RE done:** `/test`, `/deploy`, `/code-janitor`
+
+---
+
+*reverse-android workflow v2.0.0 — Modular RE Pipeline*