awf-vibecoder-kit 5.0.0

package/skills/awf-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/awf-onboarding/SKILL.md

@@ -0,0 +1,248 @@
+---
+name: awf-onboarding
+description: >-
+  First-time user onboarding experience. Keywords: new, first, start, begin,
+  welcome, tutorial, guide, learn, help me.
+  Activates on first /init or when .brain/preferences.json doesn't exist.
+version: 1.0.0
+---
+
+# AWF Onboarding
+
+Hướng dẫn người dùng mới làm quen với AWF.
+
+## Trigger Conditions
+
+**Activates when:**
+- User chạy `/init` lần đầu (không có `.brain/` folder)
+- User chạy `/help` và chưa có preferences
+- User nói "mới dùng", "hướng dẫn", "không biết bắt đầu"
+
+**Check:**
+```
+if NOT exists(".brain/preferences.json") AND NOT exists("~/.antigravity/preferences.json"):
+     Activate onboarding
+else:
+     Skip (returning user)
+```
+
+## Execution Logic
+
+### Step 1: Welcome Message
+
+```
+👋 **CHÀO MỪNG ĐẾN VỚI AWF!**
+
+Em là trợ lý AI, sẽ giúp anh biến ý tưởng thành app thật.
+
+🎯 AWF có thể giúp anh:
+   • Tạo app/website từ con số 0
+   • Không cần biết code (em làm giùm!)
+   • Nhớ mọi thứ giữa các lần làm việc
+
+⏱️ Cho em 2 phút để hướng dẫn nhanh nhé?
+
+1️⃣ Có, hướng dẫn em đi
+2️⃣ Không cần, bắt đầu luôn
+```
+
+### Step 2: Quick Assessment (nếu chọn 1)
+
+```
+📊 **EM CẦN HIỂU ANH MỘT CHÚT:**
+
+Anh đã từng làm app/website chưa?
+
+1️⃣ Chưa bao giờ (newbie)
+   → Em sẽ giải thích mọi thứ đơn giản
+
+2️⃣ Có biết chút chút (basic)
+   → Em giải thích khi cần
+
+3️⃣ Dân IT rồi (technical)
+   → Em nói chuyện như đồng nghiệp
+```
+
+### Step 3: 5 Commands Tour
+
+```
+🗺️ **5 LỆNH QUAN TRỌNG NHẤT:**
+
+┌─────────────────────────────────────────┐
+│ 1️⃣ /brainstorm                          │
+│    "Tôi có ý tưởng nhưng chưa rõ"       │
+│    → AI giúp làm rõ ý tưởng             │
+├─────────────────────────────────────────┤
+│ 2️⃣ /plan                                │
+│    "Tôi biết muốn làm gì rồi"           │
+│    → AI lên kế hoạch chi tiết           │
+├─────────────────────────────────────────┤
+│ 3️⃣ /code                                │
+│    "Bắt đầu viết code đi"               │
+│    → AI code theo kế hoạch              │
+├─────────────────────────────────────────┤
+│ 4️⃣ /run                                 │
+│    "Chạy thử xem nào"                   │
+│    → Khởi động app để xem kết quả       │
+├─────────────────────────────────────────┤
+│ 5️⃣ /debug                               │
+│    "Có lỗi rồi, sửa giùm"               │
+│    → AI tìm và sửa lỗi                  │
+└─────────────────────────────────────────┘
+
+💡 Mẹo: Không cần nhớ hết! Gõ /next bất cứ lúc nào
+   để em gợi ý nên làm gì tiếp.
+```
+
+### Step 4: Quick Start Options
+
+```
+🚀 **BẮT ĐẦU THÔI!**
+
+Anh muốn làm gì?
+
+1️⃣ Tôi có ý tưởng app rồi → /plan
+2️⃣ Chưa rõ, muốn bàn trước → /brainstorm
+3️⃣ Hướng dẫn chi tiết hơn → /help
+4️⃣ Tùy chỉnh cách AI nói chuyện → /customize
+```
+
+### Step 5: Initialize .brain/ Folder
+
+**Tạo folder structure:**
+```
+.brain/
+├── preferences.json
+├── session.json
+├── session_log.txt
+└── brain.json
+```
+
+**preferences.json:**
+```json
+{
+  "communication": {
+    "tone": "friendly",
+    "personality": "assistant"
+  },
+  "technical": {
+    "technical_level": "[user_choice]",
+    "detail_level": "simple",
+    "autonomy_level": "ask_often"
+  },
+  "onboarding_completed": true,
+  "onboarding_date": "[timestamp]"
+}
+```
+
+**session.json:**
+```json
+{
+  "updated_at": "[timestamp]",
+  "working_on": {
+    "feature": null,
+    "task": null,
+    "status": "idle"
+  },
+  "pending_tasks": [],
+  "errors_encountered": [],
+  "decisions_made": [
+    {
+      "decision": "Technical level set to [level]",
+      "reason": "User selection during onboarding"
+    }
+  ],
+  "skipped_tests": []
+}
+```
+
+**session_log.txt:**
+```
+[YYYY-MM-DD HH:MM] ONBOARDING COMPLETE
+[YYYY-MM-DD HH:MM] Technical level: [level]
+[YYYY-MM-DD HH:MM] Ready for first project
+```
+
+**brain.json:**
+```json
+{
+  "meta": {
+    "schema_version": "1.0.0",
+    "awf_version": "4.0.2",
+    "created_at": "[timestamp]"
+  },
+  "project": {
+    "name": null,
+    "type": null,
+    "status": "not_started"
+  },
+  "updated_at": "[timestamp]"
+}
+```
+
+### Step 6: Save & Complete
+
+```
+✅ **HOÀN TẤT SETUP!**
+
+Em đã tạo:
+📁 .brain/
+   ├── preferences.json  (cài đặt của anh)
+   ├── session.json      (theo dõi tiến độ)
+   ├── session_log.txt   (nhật ký)
+   └── brain.json        (kiến thức dự án)
+
+💾 Mọi thứ sẽ được tự động lưu từ giờ!
+
+────────────────────────
+
+Giờ anh muốn làm gì?
+
+1️⃣ Tạo dự án đầu tiên → /init
+2️⃣ Bàn ý tưởng trước → /brainstorm
+3️⃣ Xem hướng dẫn chi tiết → /help
+```
+
+## Returning User Detection
+
+```
+if exists("preferences.json") AND preferences.onboarding_completed == true:
+
+     Nếu > 7 ngày không dùng:
+          "👋 Chào mừng anh quay lại! Gõ /recap để em nhắc lại đang làm gì nhé."
+
+     Nếu < 7 ngày:
+          Skip welcome, vào thẳng workflow
+```
+
+## Error Handling
+
+```
+If cannot create .brain/ folder:
+    Try create in current directory
+    If still fail:
+        Warning: "⚠️ Em không tạo được folder lưu trữ, nhưng vẫn làm việc được!"
+        Continue in-memory mode
+
+If user skips all steps:
+    Use defaults: technical_level = "basic"
+    Mark onboarding_completed = true
+```
+
+## Integration
+
+**Với /init:**
+```
+/init được gọi
+    ↓
+Check .brain/ folder
+    ↓
+├── Không có → Chạy onboarding TRƯỚC
+└── Có rồi → Chạy /init bình thường
+```
+
+## Performance
+
+- Total time: < 2 minutes
+- No external API calls
+- Minimal file I/O

package/skills/awf-session-restore/SKILL.md

@@ -0,0 +1,234 @@
+---
+name: awf-session-restore
+description: >-
+  Lazy-loading context restore with 3 levels. Fast startup with minimal tokens.
+  Keywords: context, memory, session, restore, recap, remember, resume, continue.
+version: 2.0.0
+---
+
+# AWF Session Restore (Lazy Loading)
+
+Khoi phuc context voi 3 cap do de tiet kiem token.
+
+## Load Levels
+
+| Level | Tokens | Khi nao | Gi duoc load |
+|-------|--------|---------|--------------|
+| 1 | ~200 | Luon luon | summary, current task, blockers |
+| 2 | ~800 | /recap full | + decisions, pending tasks, recent files |
+| 3 | ~2000 | /recap deep | + full history, all errors, conversation |
+
+## Trigger Conditions
+
+### Auto-Trigger (Level 1 only)
+- Bat dau session moi
+- Truoc moi AWF workflow
+
+### Manual Trigger
+- `/recap` → Level 1 (nhanh)
+- `/recap full` → Level 1 + 2
+- `/recap deep` → Level 1 + 2 + 3
+- `/recap [topic]` → Smart search
+
+## Execution Logic
+
+### Level 1: Instant Load (Always)
+
+```
+load_level_1():
+    summary = session.summary
+
+    show:
+    """
+    👋 Chao mung tro lai!
+
+    📍 Project: {summary.project}
+    📍 Dang lam: {summary.current_feature}
+       └─ Task: {summary.current_task}
+       └─ Status: {summary.status} ({summary.progress_percent}%)
+
+    ⏭️ Buoc tiep: {summary.next_step}
+    🕐 Last saved: {format_time(updated_at)}
+    """
+
+    # Token cost: ~200
+```
+
+### Level 2: On-Demand (When Requested)
+
+```
+load_level_2():
+    load_level_1()
+
+    decisions = session.decisions_made[-5:]  # Last 5
+    pending = session.pending_tasks[:5]       # Next 5
+    files = session.working_on.files
+
+    show:
+    """
+    ─────────────────────────────
+    📋 Quyet dinh gan day:
+    {format_decisions(decisions)}
+
+    📝 Viec can lam:
+    {format_pending(pending)}
+
+    📁 Files dang sua:
+    {format_files(files)}
+    """
+
+    # Token cost: ~800 total
+```
+
+### Level 3: Deep Dive (Explicit Request)
+
+```
+load_level_3():
+    load_level_2()
+
+    errors = session.errors_encountered
+    checkpoints = session.context_checkpoints
+    changes = session.recent_changes
+
+    show:
+    """
+    ─────────────────────────────
+    🐛 Lich su loi:
+    {format_errors(errors)}
+
+    💾 Checkpoints:
+    {format_checkpoints(checkpoints)}
+
+    📜 Thay doi gan day:
+    {format_changes(changes)}
+    """
+
+    # Token cost: ~2000 total
+```
+
+### Smart Search: /recap [topic]
+
+```
+recap_topic(topic):
+    # Search in all tiers
+    results = search_session(topic)
+    results += search_brain(topic)
+
+    show:
+    """
+    🔍 Tim kiem: "{topic}"
+
+    {format_search_results(results)}
+    """
+
+    # Only load relevant context
+```
+
+## Auto-Inject (System Prompt)
+
+Khi bat dau session, inject Level 1 vao system prompt:
+
+```markdown
+## Session Context (Auto-loaded)
+
+- Project: {project}
+- Feature: {current_feature}
+- Task: {current_task}
+- Status: {status} ({progress}%)
+- Blockers: {blockers_count}
+
+[Conversation continues below...]
+```
+
+## Token Budget
+
+```
+Total context: 128K tokens
+├── System prompt: 10K (fixed)
+├── Conversation: 100K (dynamic)
+├── Session load: 8K max
+│   ├── Level 1: 200 (always)
+│   ├── Level 2: 600 (on-demand)
+│   └── Level 3: 1200 (explicit)
+└── Buffer: 10K (safety)
+```
+
+## Output Format
+
+### /recap (Level 1)
+```
+👋 Chao mung tro lai!
+
+📍 Project: ThaoCoffe
+📍 Dang lam: User Authentication
+   └─ Task: Login form validation
+   └─ Status: coding (65%)
+
+⏭️ Buoc tiep: Add password validation
+🕐 Last saved: 2 gio truoc
+
+💡 Go /recap full de xem chi tiet.
+```
+
+### /recap full (Level 1+2)
+```
+[Level 1 output]
+─────────────────────────────
+📋 Quyet dinh gan day:
+  • Dung NextAuth (don gian hon)
+  • Validation bang Zod
+  • Session-based auth
+
+📝 Viec can lam:
+  1. [HIGH] Add password validation
+  2. [MED] Implement remember me
+  3. [LOW] Add forgot password
+
+📁 Files dang sua:
+  • src/app/login/page.tsx
+  • src/lib/auth.ts
+```
+
+### /recap deep (All levels)
+```
+[Level 1+2 output]
+─────────────────────────────
+🐛 Lich su loi:
+  • CORS error → Fixed: added middleware
+  • Type error → Fixed: added null check
+
+💾 Checkpoints (7 ngay):
+  • 2024-01-15 14:30 - workflow_end
+  • 2024-01-16 09:00 - user_leaving
+
+📜 Thay doi gan day:
+  • [feature] Added login form
+  • [bugfix] Fixed CORS issue
+```
+
+## Error Handling
+
+```
+if session.json not found:
+    show: "Chua co session. Bat dau moi nhe!"
+    skip restore
+
+if session.json corrupted:
+    try: restore from latest snapshot
+    if success:
+        show: "Da khoi phuc tu backup."
+    else:
+        show: "Session bi loi. Bat dau fresh!"
+        create new session
+
+if summary missing:
+    generate summary from available data
+    save to session.json
+```
+
+## Performance
+
+- Level 1 load: < 100ms
+- Level 2 load: < 300ms
+- Level 3 load: < 500ms
+- Search: < 1s