@leejungkiin/awkit 1.0.0

package/workflows/mobile/structure-clean-architect.md

@@ -0,0 +1,271 @@
+---
+description: Khởi tạo nhanh cấu trúc Clean Architecture cho các tính năng Swift, Kotlin hoặc Expo.
+safe_auto_run: true
+---
+
+# /structure-clean-architect - Mobile Feature Scaffolder
+
+> 💡 **Tip:** For complete feature design from scratch (architecture → specs → UI → implementation), use `/feature-design-pipeline` master workflow.
+
+Generates complete file structure for a new feature based on `.project-identity` and platform.
+
+---
+
+## Phase 1: Input Parsing
+
+**Trigger**: User says "Create feature [FeatureName]"
+
+1. **Extract feature name** (e.g., "ProfileSettings", "Checkout")
+2. **Read `.project-identity`** for:
+   - Platform (iOS/Android/Expo)
+   - Architecture (MVVM/TCA/MVI)
+   - Language (Swift/Kotlin/TypeScript)
+
+---
+
+## Phase 2: iOS (Swift/SwiftUI) Scaffold
+
+### MVVM Architecture
+// turbo
+Create directory structure:
+```
+Features/[FeatureName]/
+├── Views/
+│   └── [FeatureName]View.swift
+├── ViewModels/
+│   └── [FeatureName]ViewModel.swift
+├── Models/
+│   └── [FeatureName]Model.swift
+├── Services/
+│   └── [FeatureName]Service.swift
+└── Tests/
+    └── [FeatureName]ViewModelTests.swift
+```
+
+### File Templates
+
+**[FeatureName]View.swift**
+```swift
+import SwiftUI
+
+struct [FeatureName]View: View {
+    @StateObject private var viewModel = [FeatureName]ViewModel()
+    
+    var body: some View {
+        Text("Hello, [FeatureName]!")
+    }
+}
+
+#Preview {
+    [FeatureName]View()
+}
+```
+
+**[FeatureName]ViewModel.swift**
+```swift
+import Foundation
+import Combine
+
+@MainActor
+final class [FeatureName]ViewModel: ObservableObject {
+    enum State {
+        case idle
+        case loading
+        case loaded([FeatureName]Model)
+        case error(Error)
+    }
+    
+    @Published private(set) var state: State = .idle
+    
+    private let service: [FeatureName]Service
+    
+    init(service: [FeatureName]Service = [FeatureName]Service()) {
+        self.service = service
+    }
+    
+    func load() async {
+        state = .loading
+        // TODO: Implement loading logic
+    }
+}
+```
+
+**[FeatureName]Model.swift**
+```swift
+import Foundation
+
+struct [FeatureName]Model: Codable, Identifiable {
+    let id: String
+    // TODO: Add properties
+}
+```
+
+---
+
+## Phase 3: Android (Kotlin/Compose) Scaffold
+
+### MVVM Architecture
+// turbo
+Create directory structure:
+```
+features/[featurename]/
+├── ui/
+│   └── [FeatureName]Screen.kt
+├── viewmodel/
+│   └── [FeatureName]ViewModel.kt
+├── model/
+│   └── [FeatureName].kt
+├── repository/
+│   └── [FeatureName]Repository.kt
+└── di/
+    └── [FeatureName]Module.kt
+```
+
+### File Templates
+
+**[FeatureName]Screen.kt**
+```kotlin
+package com.app.features.[featurename].ui
+
+import androidx.compose.runtime.*
+import androidx.compose.material3.*
+import androidx.hilt.navigation.compose.hiltViewModel
+
+@Composable
+fun [FeatureName]Screen(
+    viewModel: [FeatureName]ViewModel = hiltViewModel()
+) {
+    val uiState by viewModel.uiState.collectAsStateWithLifecycle()
+    
+    [FeatureName]Content(uiState = uiState)
+}
+
+@Composable
+private fun [FeatureName]Content(uiState: [FeatureName]UiState) {
+    Text("Hello, [FeatureName]!")
+}
+```
+
+**[FeatureName]ViewModel.kt**
+```kotlin
+package com.app.features.[featurename].viewmodel
+
+import androidx.lifecycle.ViewModel
+import dagger.hilt.android.lifecycle.HiltViewModel
+import kotlinx.coroutines.flow.*
+import javax.inject.Inject
+
+@HiltViewModel
+class [FeatureName]ViewModel @Inject constructor(
+    private val repository: [FeatureName]Repository
+) : ViewModel() {
+    
+    private val _uiState = MutableStateFlow<[FeatureName]UiState>([FeatureName]UiState.Loading)
+    val uiState: StateFlow<[FeatureName]UiState> = _uiState.asStateFlow()
+}
+
+sealed interface [FeatureName]UiState {
+    data object Loading : [FeatureName]UiState
+    data class Success(val data: [FeatureName]) : [FeatureName]UiState
+    data class Error(val message: String) : [FeatureName]UiState
+}
+```
+
+---
+
+## Phase 4: Expo (TypeScript) Scaffold
+
+// turbo
+Create directory structure:
+```
+app/[featurename]/
+├── index.tsx
+├── [id].tsx (if detail needed)
+components/[featurename]/
+├── [FeatureName]Card.tsx
+├── [FeatureName]List.tsx
+hooks/
+├── use[FeatureName].ts
+services/
+├── [featurename]Service.ts
+types/
+├── [featurename].ts
+```
+
+### File Templates
+
+**app/[featurename]/index.tsx**
+```typescript
+import { View, Text } from 'react-native';
+import { use[FeatureName] } from '@/hooks/use[FeatureName]';
+
+export default function [FeatureName]Screen() {
+  const { data, isLoading, error } = use[FeatureName]();
+  
+  if (isLoading) return <Text>Loading...</Text>;
+  if (error) return <Text>Error: {error.message}</Text>;
+  
+  return (
+    <View>
+      <Text>Hello, [FeatureName]!</Text>
+    </View>
+  );
+}
+```
+
+**hooks/use[FeatureName].ts**
+```typescript
+import { useQuery } from '@tanstack/react-query';
+import { [featurename]Service } from '@/services/[featurename]Service';
+
+export function use[FeatureName]() {
+  return useQuery({
+    queryKey: ['[featurename]'],
+    queryFn: [featurename]Service.getAll,
+  });
+}
+```
+
+---
+
+## Phase 5: Registration
+
+### iOS
+// turbo
+- Add to Navigation/Router if using coordinator pattern
+- Register in DI container if applicable
+
+### Android
+// turbo
+- Add navigation route to NavGraph
+- Register Hilt module if using DI
+
+### Expo
+// turbo
+- Route auto-registered via file-based routing
+
+---
+
+## Phase 6: Summary
+
+Return checklist:
+- ✅ Created files: [list]
+- 📝 TODOs to implement:
+  - [ ] Add model properties
+  - [ ] Implement service/repository
+  - [ ] Connect to API
+  - [ ] Add UI elements
+
+**Optional**: Create feature specs?
+- `docs/specs/[feature]/requirements.md`
+- `docs/specs/[feature]/design.md`
+- `docs/specs/[feature]/design.md`
+
+Use `/feature-completion` to generate specs if needed.
+
+---
+
+## ⚠️ NEXT STEPS:
+- Add UI → `/ui-review`
+- Implement logic → `/feature-completion`
+- Run app → `/run`

package/workflows/mobile/turbo-mobile-build.md

@@ -0,0 +1,190 @@
+---
+description: Tự động hóa build dự án mobile và khắc phục lỗi môi trường phổ biến.
+safe_auto_run: true
+---
+
+# /turbo-mobile-build - The Build Doctor
+
+Automates the build process for mobile apps. Attempts to build, detects errors, applies known fixes, and rebuilds.
+
+---
+
+## Phase 1: Platform Detection & Clean
+// turbo
+
+1. **Detect platform:**
+   - `*.xcworkspace` → iOS (prefer workspace over project)
+   - `*.xcodeproj` → iOS
+   - `build.gradle.kts` → Android
+   - `app.json` with expo → Expo
+
+2. **Clean build artifacts:**
+
+### iOS
+```bash
+# Clean DerivedData
+rm -rf ~/Library/Developer/Xcode/DerivedData/[ProjectName]*
+
+# Clean build folder
+xcodebuild clean -workspace *.xcworkspace -scheme [Scheme]
+```
+
+### Android
+```bash
+./gradlew clean
+```
+
+### Expo
+```bash
+npx expo start -c  # Clear cache
+rm -rf node_modules/.cache
+```
+
+---
+
+## Phase 2: Dependency Resolution
+// turbo
+
+### iOS - CocoaPods
+```bash
+# Check Podfile.lock vs Pods
+pod install --repo-update
+
+# If still failing
+rm -rf Pods Podfile.lock
+pod install
+```
+
+### iOS - SPM (Swift Package Manager)
+```bash
+# Resolve packages
+xcodebuild -resolvePackageDependencies
+```
+
+### Android - Gradle
+```bash
+# Refresh dependencies
+./gradlew --refresh-dependencies
+
+# If cache issues
+rm -rf ~/.gradle/caches
+./gradlew build
+```
+
+### Expo
+```bash
+rm -rf node_modules
+npm install
+```
+
+---
+
+## Phase 3: Build Execution
+// turbo
+
+### iOS
+```bash
+xcodebuild build \
+  -workspace *.xcworkspace \
+  -scheme [Scheme] \
+  -destination 'generic/platform=iOS Simulator' \
+  -configuration Debug \
+  CODE_SIGNING_ALLOWED=NO
+```
+
+### Android
+```bash
+./gradlew assembleDebug
+```
+
+### Expo
+```bash
+npx expo export --platform ios
+npx expo export --platform android
+# Or for native build
+eas build --platform ios --profile development
+eas build --platform android --profile development
+```
+
+---
+
+## Phase 4: Error Analysis & Auto-Fix Loop
+
+### iOS Common Errors
+
+| Error Pattern | Auto-Fix |
+| :--- | :--- |
+| `No such module 'X'` | `pod install --repo-update` |
+| `Command PhaseScriptExecution failed` | Check build phases, re-run |
+| `Signing requires a development team` | Set `CODE_SIGNING_ALLOWED=NO` for simulator |
+| `Multiple commands produce` | Clean DerivedData |
+| `Package resolution failed` | `xcodebuild -resolvePackageDependencies` |
+| `Framework not found` | Check Podfile, reinstall pods |
+
+### Android Common Errors
+
+| Error Pattern | Auto-Fix |
+| :--- | :--- |
+| `Gradle daemon stopped` | `./gradlew --stop && ./gradlew build` |
+| `SDK location not found` | Set ANDROID_HOME in local.properties |
+| `Dependency resolution failed` | `./gradlew --refresh-dependencies` |
+| `Kotlin version mismatch` | Sync Kotlin versions in build.gradle |
+| `AAPT2 error` | Clean and rebuild |
+
+### Expo Common Errors
+
+| Error Pattern | Auto-Fix |
+| :--- | :--- |
+| `Metro bundler crashed` | `npx expo start -c` |
+| `Native module not linked` | `npx expo prebuild --clean` |
+| `EAS build failed` | Check eas.json, credentials |
+
+---
+
+## Phase 5: Report
+// turbo
+
+### Success Report
+```
+✅ BUILD SUCCESSFUL
+
+Platform: [iOS/Android/Expo]
+Scheme: [Scheme Name]
+Duration: [X] seconds
+Output: [path to .app/.apk]
+
+Actions Taken:
+- Cleaned DerivedData
+- Installed CocoaPods
+- Built successfully
+
+Next: /run to launch, or /deploy to publish
+```
+
+### Failure Report
+```
+❌ BUILD FAILED
+
+Platform: [iOS/Android/Expo]
+Error Type: [Compilation/Linking/Signing]
+
+Error Details:
+[First 10 lines of error]
+
+Attempted Fixes:
+- [Fix 1] - ❌ Did not resolve
+- [Fix 2] - ❌ Did not resolve
+
+Remaining Issues:
+- [Issue 1] - Likely code error in [File]
+- [Issue 2] - Missing dependency
+
+Recommendation: Use /debug to investigate code errors
+```
+
+---
+
+## ⚠️ NEXT STEPS:
+- Build passed → `/run` to launch
+- Build failed (env issue) → Retry with suggested fix
+- Build failed (code issue) → `/debug`