@leejungkiin/awkit 1.0.0

package/skills/auto-save/SKILL.md

@@ -0,0 +1,223 @@
+---
+name: awf-auto-save
+description: >-
+  Eternal Context System - Auto-save session to prevent context loss.
+  Triggers: workflow end, user leaving, decisions, periodic checkpoint.
+  Warns when context is getting full.
+version: 1.0.0
+---
+
+# AWF Auto-Save (Eternal Context)
+
+Tu dong luu session de khong bao gio mat context.
+
+## Trigger Conditions
+
+### 1. Workflow End (Automatic)
+Sau khi hoan thanh bat ky workflow nao:
+- `/plan` → Save decisions, specs
+- `/code` → Save progress, files changed
+- `/debug` → Save errors resolved
+- `/test` → Save test results
+- `/deploy` → Save deployment info
+
+### 2. User Leaving Detection
+Pattern matching trong tin nhan user:
+```
+patterns:
+  - "bye", "tam biet", "tam nghi"
+  - "toi di", "di an com", "nghi thoi"
+  - "het gio", "mai lam tiep", "save"
+  - "dong app", "tat may"
+```
+
+### 3. Decision Made Detection
+Khi user dua ra quyet dinh:
+```
+patterns:
+  - "chon phuong an", "dung cai nay"
+  - "ok", "dong y", "lam vay"
+  - "quyet dinh la", "se dung"
+```
+
+### 4. Periodic Checkpoint
+Moi 15 tin nhan → Background save
+
+### 5. Context Warning (80% estimate)
+```
+token_estimate = message_count * 150 + code_blocks * 300
+if token_estimate > 100000:  # 80% of 128K
+    trigger_emergency_save()
+    show_warning()
+```
+
+## Execution Logic
+
+### Step 1: Detect Trigger
+
+```
+on_message(user_input):
+    increment message_count
+
+    if matches_leaving_pattern(user_input):
+        trigger = "user_leaving"
+    elif matches_decision_pattern(user_input):
+        trigger = "decision_made"
+    elif message_count % 15 == 0:
+        trigger = "periodic"
+    elif estimate_tokens() > 100000:
+        trigger = "emergency"
+    else:
+        return  # No save needed
+
+    execute_save(trigger)
+```
+
+### Step 2: Generate Summary
+
+```
+summary = {
+    project: brain.project.name,
+    current_feature: session.working_on.feature,
+    current_task: session.working_on.task,
+    status: session.working_on.status,
+    progress_percent: calculate_progress(),
+    last_action: get_last_action(),
+    next_step: suggest_next_step()
+}
+```
+
+### Step 3: Save to Session
+
+```
+session.summary = summary
+session.message_count = current_count
+session.context_checkpoints.append({
+    timestamp: now(),
+    trigger: trigger_type,
+    summary: compress_summary(summary),
+    message_count: current_count
+})
+save_to_file(".brain/session.json")
+```
+
+### Step 4: Notify User (if enabled)
+
+```
+if trigger == "user_leaving":
+    show: "💾 Thay ban chuan bi di, da auto-save session."
+
+if trigger == "workflow_end":
+    show: "💾 Da luu tien do. Ban co the dong app an toan."
+
+if trigger == "emergency":
+    show: "⚠️ Context sap day. Da save backup. Nen bat dau session moi."
+
+if trigger == "periodic" or "decision_made":
+    # Silent save - no notification
+```
+
+## Token Estimation Heuristic
+
+```
+function estimate_tokens():
+    base = message_count * 150
+    code_blocks = count_code_blocks() * 300
+    error_dumps = count_errors() * 200
+
+    return base + code_blocks + error_dumps
+
+function get_warning_level():
+    tokens = estimate_tokens()
+    if tokens > 115000: return "critical"  # 90%
+    if tokens > 100000: return "warning"   # 80%
+    if tokens > 80000: return "info"       # 60%
+    return "safe"
+```
+
+## Snapshot Management
+
+### Save Snapshot (7 days retention)
+```
+on_workflow_end():
+    snapshot = {
+        timestamp: now(),
+        session: session.json,
+        brain_summary: extract_brain_summary()
+    }
+    save_to(".brain/snapshots/{date}_{time}.json")
+
+    # Cleanup old snapshots
+    delete_snapshots_older_than(7_days)
+```
+
+### Restore from Snapshot
+```
+if session.json corrupted:
+    latest_snapshot = get_latest_snapshot()
+    restore_from(latest_snapshot)
+    show: "Da khoi phuc tu backup gan nhat."
+```
+
+## User Messages
+
+```yaml
+workflow_end:
+  vi: "💾 Da luu tien do. Ban co the dong app an toan."
+  en: "💾 Progress saved. You can safely close the app."
+
+user_leaving:
+  vi: "💾 Thay ban chuan bi di, da auto-save session."
+  en: "💾 Detected you're leaving, session auto-saved."
+
+context_warning:
+  vi: "⚠️ Context sap day. Da save backup. Nen go /save-brain roi bat dau session moi."
+  en: "⚠️ Context nearly full. Backup saved. Consider starting new session."
+
+emergency_save:
+  vi: "⚠️ Da luu khan cap. Go /recap trong session moi de tiep tuc."
+  en: "⚠️ Emergency save complete. Use /recap in new session to continue."
+```
+
+## Integration with Workflows
+
+Moi workflow PHAI goi auto-save khi ket thuc:
+
+```markdown
+# Cuoi moi workflow.md:
+
+## Post-Workflow: Auto-Save
+
+Sau khi hoan thanh workflow:
+1. Cap nhat session.summary
+2. Append vao context_checkpoints
+3. Hien thong bao: "💾 Da luu tien do."
+```
+
+## Config Options
+
+```json
+{
+  "auto_save_config": {
+    "enabled": true,
+    "notify_on_save": true,
+    "checkpoint_interval": 15,
+    "warn_threshold": 80,
+    "snapshot_retention_days": 7
+  }
+}
+```
+
+## Error Handling
+
+```
+if save_fails:
+    retry 3 times with exponential backoff
+    if still fails:
+        show: "⚠️ Khong the luu session. Kiem tra quyen ghi file."
+        log error to console
+
+if disk_full:
+    delete oldest snapshots
+    retry save
+```

package/skills/awf-adaptive-language/SKILL.md

@@ -0,0 +1,189 @@
+---
+name: awf-adaptive-language
+description: >-
+  Adjust terminology based on user technical level. Keywords: language,
+  terminology, jargon, level, beginner, newbie, simple, explain.
+  Reads technical_level from preferences.json and sets communication context.
+version: 1.0.0
+---
+
+# AWF Adaptive Language
+
+Tự động điều chỉnh ngôn ngữ kỹ thuật theo trình độ user.
+
+## Trigger Conditions
+
+**Pre-hook for ALL workflows** - Activates at session start.
+
+**Check preferences:**
+```
+if exists(".brain/preferences.json"):
+    → Read technical_level
+else if exists("~/.antigravity/preferences.json"):
+    → Read global technical_level
+else:
+    → Default: "basic"
+```
+
+## Personality Modes (from /customize)
+
+**Also read `personality` from preferences.json:**
+
+### Mentor Mode (`mentor`)
+```
+Khi làm bất kỳ task nào:
+1. Giải thích TẠI SAO làm vậy
+2. Giải thích thuật ngữ mới gặp
+3. Đôi khi hỏi ngược: "Anh nghĩ tại sao phải làm vậy?"
+4. Sau khi xong: "Anh học được gì từ bước này?"
+```
+
+### Strict Coach Mode (`strict_coach`)
+```
+Khi làm bất kỳ task nào:
+1. Đòi hỏi cao về chất lượng
+2. Chỉ ra cách làm tốt hơn
+3. Giải thích best practices
+4. Không chấp nhận code xấu: "Cách này không tối ưu vì..."
+```
+
+### Default (không có personality setting)
+→ Dùng style "Trợ lý thông minh" - hữu ích, đưa lựa chọn
+
+---
+
+## Technical Levels
+
+### Level: `newbie`
+**Target:** Không biết code, chỉ có ý tưởng
+
+| Term | Translation |
+|------|-------------|
+| database | kho lưu trữ thông tin |
+| API | cổng giao tiếp giữa các phần mềm |
+| deploy | đưa lên mạng cho người khác dùng |
+| commit | lưu lại thay đổi |
+| branch | bản nháp của dự án |
+| error | lỗi cần sửa |
+| debug | tìm và sửa lỗi |
+| test | kiểm tra xem có chạy đúng không |
+| server | máy tính chạy ứng dụng |
+| frontend | giao diện người dùng thấy |
+| backend | phần xử lý ẩn phía sau |
+
+**Communication style:**
+- Giải thích MỌI khái niệm kỹ thuật
+- Dùng ví dụ đời thường
+- Tránh từ viết tắt
+- Bước nhỏ, từng bước một
+
+### Level: `basic`
+**Target:** Biết dùng máy tính, đọc được code cơ bản
+
+| Term | Usage |
+|------|-------|
+| database | database (cơ sở dữ liệu) |
+| API | API (giao diện lập trình) |
+| deploy | deploy (triển khai) |
+| commit | commit (lưu thay đổi vào git) |
+
+**Communication style:**
+- Giải thích từ kỹ thuật lần đầu
+- Sau đó dùng bình thường
+- Gợi ý tra cứu thêm nếu cần
+- Nhóm nhiều bước nhỏ lại
+
+### Level: `technical`
+**Target:** Developers, có kinh nghiệm code
+
+**Communication style:**
+- Dùng thuật ngữ chuẩn
+- Không cần giải thích
+- Tập trung vào implementation
+- Có thể dùng viết tắt (PR, CI/CD, etc.)
+
+## Execution Logic
+
+### Step 1: Load Preferences
+
+```
+preferences = null
+
+# Try local first
+if exists(".brain/preferences.json"):
+    preferences = parse(".brain/preferences.json")
+
+# Fallback to global
+if !preferences && exists("~/.antigravity/preferences.json"):
+    preferences = parse("~/.antigravity/preferences.json")
+
+# Extract level
+level = preferences?.technical?.technical_level || "basic"
+```
+
+### Step 2: Set Context
+
+```
+Set internal context for session:
+- terminology_level = level
+- Apply translation rules based on level
+```
+
+### Step 3: Silent Operation
+
+This skill operates SILENTLY:
+- KHÔNG show indicator
+- KHÔNG notify user
+- Just sets context for subsequent responses
+
+## Integration with Workflows
+
+All AWF workflows should respect the set terminology level:
+
+```
+When outputting technical terms:
+if level == "newbie":
+    → Use translated terms from table
+    → Add explanations
+elif level == "basic":
+    → Use term (explanation) format first time
+    → Plain term after that
+else:
+    → Use standard technical terms
+```
+
+## Performance
+
+- Load time: < 100ms
+- Single file read
+- Cached for session duration
+
+## Error Handling
+
+```
+If preferences.json corrupted:
+→ Use default level: "basic"
+→ NO error message to user
+
+If technical_level invalid:
+→ Map to closest: "newbie"/"basic"/"technical"
+→ Log warning internally
+```
+
+## Example Behavior
+
+**User level: newbie**
+```
+User: /deploy
+
+Output: "Sẵn sàng đưa ứng dụng lên mạng (deploy) cho người khác dùng.
+Em sẽ kiểm tra xem mọi thứ đã sẵn sàng chưa..."
+```
+
+**User level: technical**
+```
+User: /deploy
+
+Output: "Initiating deployment pipeline.
+Running pre-deploy checks..."
+```

package/skills/awf-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