@leejungkiin/awkit 1.0.0

package/skills/context-help/SKILL.md

@@ -0,0 +1,180 @@
+---
+name: awf-context-help
+description: >-
+  Context-aware help based on current workflow state. Keywords: help, what,
+  how, confused, stuck, lost, guide, tutorial, explain.
+  Activates on /help or when user asks questions.
+version: 1.0.0
+---
+
+# AWF Context Help
+
+Trợ giúp thông minh dựa trên context hiện tại.
+
+## Trigger Conditions
+
+**Activates when:**
+- User runs `/help`
+- User types "?", "giúp", "help", "làm sao"
+- User seems confused (repeated errors, long pause)
+
+## Execution Logic
+
+### Step 1: Read Context
+
+```
+context = {}
+
+if exists(".brain/session.json"):
+    context.workflow = session.working_on.feature
+    context.task = session.working_on.task
+    context.status = session.working_on.status
+    context.pending = session.pending_tasks
+
+if exists(".brain/brain.json"):
+    context.project = brain.project.name
+    context.tech = brain.tech_stack
+```
+
+### Step 2: Detect State
+
+| State | Detection | Response |
+|-------|-----------|----------|
+| `no_project` | No .brain/ folder | Show onboarding |
+| `planning` | workflow contains "plan" | Planning help |
+| `coding` | workflow contains "code" | Coding help |
+| `debugging` | workflow contains "debug" | Debug help |
+| `deploying` | workflow contains "deploy" | Deploy help |
+| `stuck` | status = "blocked" or pending > 5 | Stuck help |
+| `idle` | No active workflow | General help |
+
+### Step 3: Show Contextual Help
+
+## Help Templates
+
+### No Project State
+```
+🆕 Chưa có dự án
+
+Bạn có thể:
+1. /brainstorm - Bàn ý tưởng trước
+2. /init - Tạo dự án mới
+3. Mô tả ý tưởng cho em nghe
+
+Em sẽ hướng dẫn từng bước!
+```
+
+### Planning State
+```
+📋 Đang lập kế hoạch: {context.workflow}
+
+Bạn có thể:
+1. Tiếp tục plan hiện tại
+2. /code - Bắt đầu code phase đầu tiên
+3. Hỏi em về cách thiết kế
+
+💡 Mẹo: Plan tốt = Code nhanh hơn!
+```
+
+### Coding State
+```
+💻 Đang code: {context.task}
+   Status: {context.status}
+
+Bạn có thể:
+1. Tiếp tục code
+2. /test - Kiểm tra code vừa viết
+3. /debug - Nếu gặp lỗi
+4. /save-brain - Lưu tiến độ
+
+💡 Pending tasks: {context.pending.length}
+```
+
+### Debugging State
+```
+🔧 Đang debug: {context.task}
+
+Bạn có thể:
+1. Mô tả lỗi chi tiết hơn
+2. Paste error message
+3. /code - Quay lại code sau khi fix
+
+💡 Mẹo: Copy paste lỗi giúp em hiểu nhanh hơn!
+```
+
+### Deploying State
+```
+🚀 Đang deploy: {context.workflow}
+
+Bạn có thể:
+1. Tiếp tục deploy process
+2. /rollback - Quay về bản trước nếu lỗi
+3. Kiểm tra logs sau deploy
+
+⚠️ Nhớ test kỹ trước khi deploy production!
+```
+
+### Stuck State
+```
+😅 Có vẻ bạn đang bị kẹt
+
+Thử những cách này:
+1. /recap - Xem lại đang làm gì
+2. /debug - Nếu có lỗi
+3. Nghỉ 5 phút rồi quay lại
+4. Hỏi em cụ thể vấn đề
+
+💡 {context.pending.length} tasks đang chờ.
+   Có thể tạm skip task khó, làm cái khác trước?
+```
+
+### Idle/General State
+```
+👋 Em có thể giúp gì?
+
+Lệnh phổ biến:
+┌─────────────────────────────────────┐
+│ /next       │ Gợi ý việc tiếp theo  │
+│ /recap      │ Nhớ lại context       │
+│ /brainstorm │ Bàn ý tưởng mới       │
+│ /plan       │ Lập kế hoạch          │
+│ /code       │ Viết code             │
+└─────────────────────────────────────┘
+
+Hoặc hỏi em bất cứ điều gì!
+```
+
+## Adaptive Language
+
+Help responses adapt to `technical_level`:
+
+**newbie:**
+- Dùng tiếng Việt thuần
+- Giải thích mọi khái niệm
+- Bước nhỏ, chi tiết
+
+**basic:**
+- Mix Việt-Anh
+- Giải thích term lần đầu
+- Bước vừa phải
+
+**technical:**
+- Dùng thuật ngữ chuẩn
+- Không cần giải thích
+- Tập trung action
+
+## Fallback
+
+If context unreadable:
+```
+👋 Em ở đây giúp bạn!
+
+Gõ /next để em gợi ý việc cần làm,
+hoặc mô tả vấn đề cho em nghe.
+```
+
+## Performance
+
+- Context read: < 200ms
+- Response generation: Instant
+- No external API calls

package/skills/error-translator/SKILL.md

@@ -0,0 +1,153 @@
+---
+name: awf-error-translator
+description: >-
+  Translate technical errors to human-friendly language. Keywords: error,
+  translate, explain, help, fix, fail, broken, crash, bug.
+  Activates on /debug, /code, /test when errors detected.
+version: 1.0.0
+---
+
+# AWF Error Translator
+
+Dịch lỗi kỹ thuật sang ngôn ngữ đời thường cho non-tech users.
+
+## Trigger Conditions
+
+**Post-hook for:** `/debug`, `/code`, `/test`
+
+**When:** Error message detected in output
+
+## Execution Logic
+
+### Step 1: Detect Error
+
+```
+if output contains error patterns:
+    → Activate translation
+else:
+    → Skip (no error)
+```
+
+### Step 2: Match & Translate
+
+Match error against database, return human message + action.
+
+### Step 3: Display
+
+```
+❌ Lỗi: [human message]
+💡 Gợi ý: [action]
+```
+
+## Error Translation Database
+
+### Database Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `ECONNREFUSED` | Database chưa chạy | Khởi động PostgreSQL/MySQL |
+| `ETIMEDOUT` | Database phản hồi chậm quá | Kiểm tra kết nối mạng |
+| `ER_ACCESS_DENIED` | Sai mật khẩu database | Kiểm tra file .env |
+| `relation .* does not exist` | Bảng chưa tồn tại | Chạy migration: `/run migrate` |
+| `duplicate key` | Dữ liệu bị trùng | Kiểm tra unique constraint |
+
+### JavaScript/TypeScript Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `TypeError: Cannot read` | Đang đọc biến chưa có giá trị | Kiểm tra null/undefined |
+| `ReferenceError` | Dùng biến chưa khai báo | Kiểm tra tên biến |
+| `SyntaxError` | Code viết sai cú pháp | Kiểm tra dấu ngoặc, chấm phẩy |
+| `Maximum call stack` | Vòng lặp vô hạn | Kiểm tra điều kiện dừng |
+| `Cannot find module` | Thiếu package | Chạy `npm install` |
+
+### Network Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `fetch failed` | Không kết nối được server | Kiểm tra URL và internet |
+| `CORS` | Website chặn request | Cấu hình CORS trên server |
+| `ERR_CERT` | Chứng chỉ SSL lỗi | Dùng HTTP thay HTTPS (dev only) |
+| `timeout` | Request quá lâu | Tăng timeout hoặc kiểm tra server |
+| `ENOTFOUND` | Domain không tồn tại | Kiểm tra lại URL |
+
+### Package Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `npm ERR!` | Cài package bị lỗi | Xóa node_modules, cài lại |
+| `peer dep` | Phiên bản không tương thích | Cập nhật package.json |
+| `EACCES` | Không có quyền truy cập | Chạy với sudo hoặc sửa quyền |
+| `ENOSPC` | Hết dung lượng ổ đĩa | Dọn dẹp disk |
+| `gyp ERR!` | Lỗi build native module | Cài build tools |
+
+### Test Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `Expected .* but received` | Test thất bại - kết quả sai | Sửa code hoặc update test |
+| `Timeout` | Test chạy quá lâu | Tăng timeout hoặc optimize |
+| `before each hook` | Setup test bị lỗi | Kiểm tra beforeEach |
+| `snapshot` | UI thay đổi | Update snapshot nếu đúng |
+| `coverage` | Thiếu test coverage | Viết thêm test |
+
+### Build Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `tsc.*error` | Lỗi TypeScript | Sửa type errors |
+| `ESLint` | Code không đúng style | Chạy lint fix |
+| `Build failed` | Build thất bại | Đọc log chi tiết |
+| `Out of memory` | Hết RAM | Tăng memory limit |
+| `FATAL ERROR` | Lỗi nghiêm trọng | Restart và thử lại |
+
+### Git Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `conflict` | Code bị xung đột | Merge conflict manually |
+| `rejected` | Push bị từ chối | Pull trước khi push |
+| `detached HEAD` | Không ở branch nào | Checkout về branch |
+| `not a git repo` | Chưa init git | Chạy `git init` |
+
+### Deploy Errors
+
+| Pattern | Human Message | Action |
+|---------|---------------|--------|
+| `502 Bad Gateway` | Server không phản hồi | Restart server |
+| `503 Service` | Server quá tải | Scale up resources |
+| `permission denied` | Không có quyền deploy | Kiểm tra credentials |
+| `quota exceeded` | Hết quota | Nâng cấp plan |
+
+## Output Format
+
+```
+🔍 Translating error...
+
+❌ Lỗi: [human_message]
+   └─ Gốc: [original_error_snippet]
+
+💡 Gợi ý: [action]
+   └─ Hoặc chạy: /debug để tìm hiểu thêm
+
+────────────────────────────────
+```
+
+## Fallback
+
+If no pattern matches:
+```
+❌ Lỗi: Có vấn đề xảy ra
+💡 Gợi ý: Chạy /debug để em phân tích chi tiết
+```
+
+## Performance
+
+- Translation: < 100ms
+- Pattern matching: Simple regex
+- No external API calls
+
+## Security
+
+- Sanitize error messages (remove credentials, paths)
+- Never expose sensitive info in translations

package/skills/ios-engineer/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: ios-engineer
+description: Expert iOS Development specialist. Handles Xcode, Swift, SwiftUI, Dependency Management (SPM/CocoaPods), and iOS-specific SDK integrations.
+author: Antigravity Team
+version: 2.0.0
+---
+
+# iOS Engineer Skill
+
+This skill transforms the agent into an Expert iOS Engineer. It provides standardized guidelines for Architecture, Code Quality, UI/UX, and Troubleshooting.
+
+## 1. 🏗️ Architecture & Design Patterns
+
+### 1.1. Default Architecture: MVVM (Model-View-ViewModel)
+- **View (SwiftUI):** Pure UI. No business logic. Binds to ViewModel.
+- **ViewModel (`ObservableObject`):** Handles state, business logic, and prepares data for View.
+- **Model:** Data structures (Structs).
+- **Service/Repository Layer:** Handles API calls, Database, and data fetching. **Dependency Injection** is preferred.
+
+### 1.2. Code Style & Conventions
+- **SwiftLint:** Adhere to standard SwiftLint rules.
+- **Naming:** CamelCase for variables/functions, PascalCase for types.
+- **Access Control:** Default to `private` or `private(set)` for properties unless external access is needed.
+- **Extensions:** Use extensions to organize code and conform to protocols.
+
+## 2. 📱 UI/UX Engineering (SwiftUI)
+
+### 2.1. Componentization
+- Break down complex views into smaller, reusable `View` components.
+- Use `@ViewBuilder` for flexible layouts.
+- Avoid massive `body` properties (> 50 lines is a warning sign).
+
+### 2.2. State Management
+- `@State`: Local view state only.
+- `@ObservedObject`: For external data sources (careful with lifecycle).
+- `@StateObject`: For ViewModel ownership (lifecycle managed by View).
+- `@EnvironmentObject`: For global dependencies (Auth, Settings).
+
+### 2.3. Performance
+- Use `LazyVStack` / `LazyHStack` for lists.
+- Avoid expensive computations in `body`.
+- Use `.drawingGroup()` for complex rendering only when necessary.
+
+## 3. 🛠️ Project Management & Dependencies
+
+### 3.1. Dependency Verification Protocol (CRITICAL)
+Before running any dependency command, **IDENTIFY** the manager:
+1. **Check `Podfile`**: `ls Podfile` -> Use CocoaPods (`pod install`).
+2. **Check `Cartfile`**: `ls Cartfile` -> Use Carthage.
+3. **Default (No config file)**: Assume **Swift Package Manager (SPM)** inside `.xcodeproj`.
+   - **Action**: Use `xcodebuild -resolvePackageDependencies`.
+   - **Forbidden**: DO NOT run `pod init` unless verifying migration with User.
+
+### 3.2. Signing & Entitlements
+- **Entitlements:** Always read `.entitlements` before adding capabilities.
+- **Certificates:** Respect local signing settings (Development/Distribution).
+
+## 4. 🧪 Testing Strategy
+
+### 4.1. Unit Testing
+- Focus on **ViewModels** and **Services**.
+- Mock external dependencies (Network, Database).
+- Naming: `test_Mechanism_Condition_Expectation`.
+
+### 4.2. UI Testing
+- Use **Maestro** (via `maestro` tool) for end-to-end flows.
+- Use Xcode UI Tests for native component integration.
+
+## 5. 🚑 Troubleshooting Protocols
+
+### 5.1. SDK & Compiler Issues
+- **"Unavailable in Swift"**: Often version mismatch or header issue (e.g., Firebase).
+  - **Action**: Check SDK version. **Do not** trial-and-error syntax changes.
+  - **Fallback**: Comment out breaking code, notify user, and provide solution steps.
+
+### 5.2. Build Failures
+- **Clean Build**: `xcodebuild clean` is the first step.
+- **DerivedData**: Suggest clearing if phantom errors persist.
+
+### 5.3. Build Verification
+
+**Note:** `grep error` returns nothing when build succeeds. Check exit code or use `tee` to capture output first, then analyze conditionally.
+
+## 6. 📂 Project Structure Standard
+
+```
+App/
+├── App.swift
+├── Assets.xcassets
+├── Core/
+│   ├── Domain/ (Models, Entities)
+│   ├── Data/ (Repositories, API Services)
+│   └── Utilities/ (Extensions, Helpers)
+├── Presentation/
+│   ├── Common/ (Reusable Components, Styles)
+│   ├── Modules/ (Feature A, Feature B...)
+│   │   ├── Views/
+│   │   └── ViewModels/
+│   └── Navigation/
+└── Resources/ (Localization, Fonts, Configs)
+```