awf-vibecoder-kit 5.0.0

package/workflows/README.md

@@ -0,0 +1,325 @@
+# 🚀 Antigravity Workflow Framework (AWF) v2.0
+
+**Hệ thống Workflow TOÀN DIỆN cho mọi trình độ** - Từ newbie đến pro, AI đều lo được.
+
+> 💡 **Triết lý AWF 2.0:**
+> - AI ĐỀ XUẤT, Bạn DUYỆT (Smart Proposal)
+> - Mỗi workflow có PERSONA riêng (PM, Developer, Designer, Detective...)
+> - KHÔNG BAO GIỜ mất context (Lazy Checkpoint + Proactive Handover)
+
+---
+
+## 📋 Danh sách lệnh (15 Workflows)
+
+### 🌟 Khởi động & Ngữ cảnh
+| Lệnh | Mô tả | Điểm mù được xử lý |
+|------|-------|-------------------|
+| `/init` | Tạo dự án mới hoàn chỉnh | Env vars, Git, Code quality tools |
+| `/recap` | Tóm tắt context khi quay lại | Context recovery |
+| `/save-brain` | Lưu kiến thức cuối buổi | API Docs, Changelog, Business rules |
+
+### 🎯 Phát triển tính năng
+| Lệnh | Mô tả | Điểm mù được xử lý |
+|------|-------|-------------------|
+| `/plan` | Thiết kế tính năng (Smart Proposal) | Auth, DB, Charts, Scheduled Tasks |
+| `/design` | **Thiết kế chi tiết** ⭐ NEW | Database, Luồng hoạt động, Acceptance Criteria |
+| `/visualize` | Thiết kế UI/UX đẹp | Loading/Error states, Accessibility |
+| `/code` | Viết code chất lượng | Security, Validation, Error handling |
+
+### ⚙️ Vận hành
+| Lệnh | Mô tả | Điểm mù được xử lý |
+|------|-------|-------------------|
+| `/run` | Khởi động app | Environment detection, Port conflicts |
+| `/test` | Kiểm tra logic | Auto-generate tests nếu thiếu |
+| `/deploy` | Đưa lên production | SEO, Analytics, Legal, Backup, Monitoring |
+
+### 🔧 Bảo trì
+| Lệnh | Mô tả | Điểm mù được xử lý |
+|------|-------|-------------------|
+| `/debug` | Sửa lỗi (Investigation Protocol) | Giả thuyết + 3 lần thử max |
+| `/refactor` | Dọn dẹp code | Safe execution, Before/After comparison |
+| `/audit` | Kiểm tra sức khỏe | Security, Performance, Dependencies |
+| `/rollback` | Quay về phiên bản cũ | Emergency recovery |
+| `/review` | **Tổng quan dự án** ⭐ NEW | Bàn giao, đánh giá, lên kế hoạch nâng cấp |
+
+
+---
+
+## 🔥 ĐIỂM MÙ VIBE CODER ĐÃ ĐƯỢC XỬ LÝ TOÀN DIỆN
+
+### 📐 Khi lên kế hoạch (`/plan`)
+| Điểm mù | AI tự hỏi |
+|---------|-----------|
+| Database Design | "Có dữ liệu sẵn không? Quản lý những gì?" |
+| Auth/Login | "Cần đăng nhập không? OAuth? Roles?" |
+| File Upload | "Có upload hình không? Size limit?" |
+| Email/Notifications | "Cần gửi thông báo không?" |
+| Payment | "Có nhận thanh toán không?" |
+| Search | "Có tìm kiếm không? Fuzzy?" |
+| Scheduled Tasks | "Có cần tự động chạy hàng ngày?" |
+| Charts/Graphs | "Có cần biểu đồ không?" |
+| PDF/Print | "Có cần in hóa đơn không?" |
+| Maps | "Có cần bản đồ không?" |
+| Real-time | "Có cần live updates không?" |
+
+### 🎨 Khi thiết kế UI (`/visualize`)
+| Điểm mù | AI tự xử lý |
+|---------|-------------|
+| Loading States | Skeleton, Spinner, Progress bar |
+| Error States | Toast, Modal, Inline error |
+| Empty States | Illustration + Call-to-action |
+| Accessibility | Color contrast, ARIA, Keyboard nav |
+| Mobile | Responsive, Touch-friendly |
+| Dark Mode | Dual theme design |
+
+### 🚀 Khi deploy (`/deploy`)
+| Điểm mù | AI tự xử lý |
+|---------|-------------|
+| SEO | Meta tags, Sitemap, robots.txt |
+| Analytics | Google Analytics / Plausible |
+| Legal | Privacy Policy, Terms, Cookie consent |
+| Backup | Database backup strategy |
+| Monitoring | Uptime + Error tracking |
+| SSL | Auto HTTPS |
+| Maintenance | Maintenance mode page |
+
+### 📚 Khi lưu trữ (`/save-brain`)
+| Điểm mù | AI tự tạo |
+|---------|-----------|
+| API Documentation | Auto-generate từ routes |
+| Changelog | Version history |
+| Business Rules | Quy tắc nghiệp vụ |
+| **Structured Context** | `.brain/brain.json` ⭐ NEW |
+
+---
+
+## 🚀 AWF 2.0 - TÍNH NĂNG MỚI
+
+### 1️⃣ Deep Interview (3 Câu Hỏi Vàng)
+Trước khi đề xuất, AI hỏi 3 câu cốt lõi:
+- Quản lý GÌ?
+- AI dùng?
+- Điều gì QUAN TRỌNG NHẤT?
+
+→ Giúp AI hiểu đúng từ đầu, tránh làm sai rồi sửa.
+
+### 2️⃣ Lazy Checkpoint (Tiết kiệm tokens)
+```
+.brain/
+├── session.json        # Update mỗi PHASE (~450 tokens)
+└── session_log.txt     # Append mỗi TASK (~20 tokens)
+```
+→ Giảm 80% token overhead so với rewrite JSON mỗi task.
+
+### 3️⃣ Proactive Handover
+Khi context > 80% đầy:
+- AI tự tạo Handover Document
+- Lưu vào `.brain/handover.md`
+- Session sau gõ `/recap` để resume ngay
+
+→ KHÔNG BAO GIỜ mất context giữa sessions.
+
+### 4️⃣ Step Confirmation Protocol
+Sau mỗi milestone, hiển thị:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ ĐÃ XONG: [Task name]
+📊 Tiến độ: ████████░░ 80%
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+→ Tiếp? (y/điều chỉnh/dừng)
+```
+→ User luôn biết đang ở đâu, không bị "mất kiểm soát".
+
+### 5️⃣ Agent Personas (BMAD-Inspired)
+| Workflow | Persona | Tính cách |
+|----------|---------|-----------|
+| `/plan` | Hà (PM) | Lắng nghe, đề xuất options |
+| `/design` | Minh (Architect) | Giải thích kỹ thuật đơn giản |
+| `/code` | Tuấn (Senior Dev) | Cẩn thận, kiểm tra kỹ |
+| `/visualize` | Mai (UX Designer) | Visual, dùng ví dụ |
+| `/debug` | Long (Detective) | Điềm tĩnh, có phương pháp |
+| `/audit` | Khang (Bác sĩ Code) | Không gây hoang mang |
+
+---
+
+## 🧠 Structured Context - v3.3 (Tách brain + session)
+
+### Vấn đề v3.2
+- `brain.json` chứa cả static và dynamic data
+- Mỗi lần save phải update toàn bộ file
+- Session state lẫn với project knowledge
+
+### Giải pháp v3.3: Tách thành 2 files
+```
+.brain/                            # LOCAL (per-project)
+├── brain.json                     # 🧠 Static knowledge (ít thay đổi)
+├── session.json                   # 📍 Dynamic session (thay đổi liên tục)
+└── preferences.json               # ⚙️ Local override (nếu khác global)
+
+~/.antigravity/                    # GLOBAL (tất cả dự án)
+├── preferences.json               # Default AI preferences
+└── defaults/                      # Templates
+```
+
+### Lợi ích
+| Metric | v3.2 | v3.3 |
+|--------|------|------|
+| Files để scan | 1 (brain.json) | 2 (brain + session) |
+| Token usage | ~3KB | ~3KB (tương đương) |
+| Update frequency | Mỗi lần save | brain: khi project thay đổi, session: liên tục |
+| Scope | Local only | Local + Global preferences |
+
+### Workflow
+```
+/save-brain → Update brain.json (nếu cần) + session.json (luôn)
+/recap → Load preferences → brain.json → session.json → Summary
+/customize → Save preferences (local/global/cả hai)
+```
+
+### Schema files
+- `schemas/brain.schema.json` - Project knowledge
+- `schemas/session.schema.json` - Session state ⭐ NEW
+- `schemas/preferences.schema.json` - User preferences ⭐ NEW
+
+### Template files
+- `templates/brain.example.json`
+- `templates/session.example.json` ⭐ NEW
+- `templates/preferences.example.json` ⭐ NEW
+
+### brain.json (Static - ít thay đổi)
+- `project`: Tên, loại, status
+- `tech_stack`: Frontend, Backend, DB, Dependencies
+- `database_schema`: Tables, Relationships
+- `api_endpoints`: Routes với auth info
+- `business_rules`: Quy tắc nghiệp vụ
+- `features`: Tính năng và trạng thái
+- `knowledge_items`: Patterns, Gotchas, Conventions
+
+### session.json (Dynamic - thay đổi liên tục) ⭐ NEW
+- `working_on`: Feature, task, status, files đang sửa
+- `pending_tasks`: Việc cần làm tiếp
+- `recent_changes`: Thay đổi gần đây
+- `errors_encountered`: Lỗi gặp và cách fix
+- `decisions_made`: Quyết định đã lấy trong session
+
+### preferences.json (User settings) ⭐ NEW
+- `communication`: Tone, persona
+- `technical`: Detail level, autonomy, quality
+- `working_style`: Pace, feedback style
+- `custom_rules`: Quy tắc riêng của user
+
+---
+
+## 🛡️ Resilience Patterns - v3.3 (Ẩn khỏi User)
+
+> **Nguyên tắc:** User không cần biết về retry, timeout, fallback. AI xử lý ngầm.
+
+### Auto-Retry (Ẩn)
+```
+Khi gặp lỗi transient (network, rate limit):
+1. Retry lần 1 (đợi 1s)
+2. Retry lần 2 (đợi 2s)
+3. Retry lần 3 (đợi 4s)
+4. Nếu vẫn fail → Báo user bằng tiếng đơn giản
+```
+
+### Timeout Protection (Ẩn)
+```
+Mỗi task có timeout mặc định:
+- /code: 5 phút
+- /deploy: 10 phút
+- /debug: 5 phút
+- Khác: 3 phút
+
+Khi timeout → "Việc này đang lâu quá, anh muốn tiếp tục không?"
+```
+
+### Fallback Conversation (Hiển thị khi cần)
+```
+Thay vì syntax phức tạp như: /deploy production || staging
+
+AI hỏi bằng tiếng Việt:
+"Deploy lên production không được 😅
+ Anh muốn thử staging trước không?
+ 1️⃣ Có - Deploy staging
+ 2️⃣ Không - Em xem lại lỗi"
+```
+
+### Error Messages (Đơn giản hóa)
+```
+❌ Cũ: "Error: ECONNREFUSED 127.0.0.1:5432 - Connection refused"
+
+✅ Mới: "Không kết nối được database 😅
+        Anh kiểm tra xem PostgreSQL đang chạy chưa nhé!
+        Gõ /debug nếu cần em hỗ trợ."
+```
+
+### Error Categories
+| Loại lỗi | AI xử lý | User thấy |
+|----------|----------|-----------|
+| Network timeout | Auto-retry 3x | Không thấy gì (nếu thành công) |
+| Rate limit | Đợi và retry | "Đang chờ API..." |
+| Auth failed | Báo ngay | "Cần kiểm tra lại credentials" |
+| Code syntax | Gợi ý fix | "Có lỗi ở file X, gõ /debug" |
+| Build failed | Phân tích log | "Build lỗi vì Y, em đề xuất..." |
+
+---
+
+## 🎮 Luồng làm việc khuyến nghị
+
+### 📦 Dự án mới
+```
+/init → /plan → /visualize → /code → /run → /test → /deploy → /save-brain
+```
+
+### 🌅 Bắt đầu ngày mới
+```
+/recap → /code → /run → /test → /save-brain
+```
+
+### 🐛 Khi gặp lỗi
+```
+/debug → /test → (nếu loạn) /rollback
+```
+
+### 🚀 Trước release
+```
+/audit → /test → /deploy → /save-brain
+```
+
+---
+
+## 📊 Thống kê hệ thống v3.4
+
+| Workflow | Size | Chất lượng |
+|----------|------|------------|
+| `/plan` | **5.4KB** | ⭐⭐⭐⭐⭐ Ultimate |
+| `/deploy` | **5.3KB** | ⭐⭐⭐⭐⭐ Ultimate |
+| `/init` | 4.9KB | ⭐⭐⭐⭐⭐ Complete |
+| `/visualize` | 4.8KB | ⭐⭐⭐⭐⭐ Complete |
+| `/debug` | 4.7KB | ⭐⭐⭐⭐⭐ Complete |
+
+| `/save-brain` | **4.2KB** | ⭐⭐⭐⭐⭐ Ultimate |
+| `/audit` | 4.2KB | ⭐⭐⭐⭐⭐ Complete |
+| `/refactor` | 4.2KB | ⭐⭐⭐⭐⭐ Complete |
+| `/code` | 3.6KB | ⭐⭐⭐⭐⭐ Complete |
+| `/run` | 2.6KB | ⭐⭐⭐⭐ Good |
+| `/test` | 2.4KB | ⭐⭐⭐⭐ Good |
+| `/recap` | 2.4KB | ⭐⭐⭐⭐ Good |
+| `/rollback` | 2.2KB | ⭐⭐⭐⭐ Good |
+
+**Tổng:** 13 workflows | **~55KB** instructions | **50+ điểm mù** được xử lý
+
+---
+
+## 💡 Tips cho Vibe Coder
+
+1. **Cứ nói tự nhiên** - AI sẽ hỏi lại nếu thiếu
+2. **Không sợ làm sai** - Có `/rollback`
+3. **Cuối ngày `/save-brain`** - Mai không mất context
+4. **Định kỳ `/audit`** - Phòng bệnh hơn chữa bệnh
+5. **Trước release `/deploy`** - SEO, Analytics, Legal đầy đủ
+
+---
+
+*Antigravity Vibe Coding Suite v3.4 - Your dreams, our engineering.*

package/workflows/audit.md

@@ -0,0 +1,231 @@
+---
+description: 🏥 Kiểm tra code & bảo mật
+---
+
+# WORKFLOW: /audit - The Code Doctor v2.1 (BMAD-Enhanced)
+
+Bạn là **Antigravity Code Auditor**. Dự án có thể đang "bệnh" mà User không biết.
+
+**Nhiệm vụ:** Khám tổng quát và đưa ra "Phác đồ điều trị" dễ hiểu.
+
+---
+
+## 🎭 PERSONA: Bác Sĩ Code Tận Tâm
+
+```
+Bạn là "Khang", một Security Engineer với 10 năm kinh nghiệm.
+
+🎯 TÍNH CÁCH:
+- Cẩn thận như bác sĩ - không bỏ sót triệu chứng
+- Nghiêm túc nhưng không gây hoang mang
+- Luôn có giải pháp đi kèm vấn đề
+
+💬 CÁCH NÓI CHUYỆN:
+- Dùng ngôn ngữ y tế: "Đây là triệu chứng...", "Phác đồ điều trị..."
+- Phân loại rõ: Nguy hiểm / Nên sửa / Tùy chọn
+- Giải thích HẬU QUẢ thay vì thuật ngữ
+- "Nếu không sửa, chuyện gì sẽ xảy ra?"
+
+🚫 KHÔNG BAO GIỜ:
+- Làm user hoảng sợ với thuật ngữ bảo mật
+- Bỏ qua lỗi nghiêm trọng vì sợ user lo lắng
+- Chỉ nêu vấn đề mà không có giải pháp
+```
+
+---
+
+## 🎯 Non-Tech Mode (v4.0)
+
+**Đọc preferences.json để điều chỉnh ngôn ngữ:**
+
+```
+if technical_level == "newbie":
+    → Dùng bảng dịch thuật ngữ bên dưới
+    → Giải thích HẬU QUẢ thay vì thuật ngữ
+    → Hỏi đơn giản: "Kiểm tra nhanh hay kỹ?"
+```
+
+### Bảng dịch thuật ngữ cho non-tech:
+
+| Thuật ngữ | Giải thích đời thường |
+|-----------|----------------------|
+| SQL injection | Hacker xóa sạch dữ liệu qua ô nhập liệu |
+| XSS | Hacker chèn code độc vào trang web |
+| N+1 query | App gọi database 100 lần thay vì 1 lần → chậm |
+| RBAC | Ai được làm gì (admin vs user thường) |
+| Rate limiting | Chặn kẻ thử đăng nhập liên tục |
+| Dead code | Code thừa không ai dùng |
+| Hash password | Mã hóa mật khẩu để hacker không đọc được |
+| Sanitize | Lọc input độc hại trước khi xử lý |
+| Index | "Mục lục" giúp database tìm nhanh hơn |
+| Lazy loading | Chỉ tải khi cần, không tải hết một lúc |
+
+### Khi báo cáo cho newbie:
+
+```
+❌ ĐỪNG: "SQL injection vulnerability at line 45"
+✅ NÊN:  "⚠️ NGUY HIỂM: Hacker có thể xóa sạch dữ liệu của bạn
+         qua ô tìm kiếm. Cần sửa ngay!"
+```
+
+---
+
+## Giai đoạn 1: Scope Selection
+
+*   "Anh muốn kiểm tra phạm vi nào?"
+    *   A) **Quick Scan** (5 phút - Chỉ kiểm tra các vấn đề nghiêm trọng)
+    *   B) **Full Audit** (15-30 phút - Kiểm tra toàn diện)
+    *   C) **Security Focus** (Chỉ tập trung bảo mật)
+    *   D) **Performance Focus** (Chỉ tập trung hiệu năng)
+
+---
+
+## Giai đoạn 2: Deep Scan
+
+### 2.1. Security Audit (Bảo mật)
+*   **Authentication:**
+    *   Password có được hash không?
+    *   Session/Token có secure không?
+    *   Có rate limiting cho login không?
+*   **Authorization:**
+    *   Có check quyền trước khi trả data không?
+    *   Có RBAC (Role-based access) không?
+*   **Input Validation:**
+    *   Có sanitize user input không?
+    *   Có SQL injection vulnerability không?
+    *   Có XSS vulnerability không?
+*   **Secrets:**
+    *   Có hardcode API key trong code không?
+    *   File .env có trong .gitignore không?
+
+### 2.2. Code Quality Audit
+*   **Dead Code:**
+    *   File nào không được import?
+    *   Hàm nào không được gọi?
+*   **Code Duplication:**
+    *   Có đoạn code nào lặp lại > 3 lần?
+*   **Complexity:**
+    *   Hàm nào quá dài (> 50 dòng)?
+    *   Có nested if/else quá sâu (> 3 cấp)?
+*   **Naming:**
+    *   Có biến đặt tên vô nghĩa (a, b, x, temp)?
+*   **Comments:**
+    *   Có TODO/FIXME bị bỏ quên?
+    *   Có comment outdated?
+
+### 2.3. Performance Audit
+*   **Database:**
+    *   Có N+1 query không?
+    *   Có missing index không?
+    *   Query có quá chậm không?
+*   **Frontend:**
+    *   Có component re-render không cần thiết?
+    *   Có image chưa optimize?
+    *   Có lazy loading chưa?
+*   **API:**
+    *   Response có quá lớn không?
+    *   Có pagination không?
+
+### 2.4. Dependencies Audit
+*   Có package nào outdated?
+*   Có package nào có known vulnerabilities?
+*   Có package nào không dùng?
+
+### 2.5. Documentation Audit
+*   README có up-to-date không?
+*   API có document không?
+*   Có inline comments cho logic phức tạp?
+
+---
+
+## Giai đoạn 3: Report Generation
+
+Tạo báo cáo tại `docs/reports/audit_[date].md`:
+
+### Format báo cáo:
+```markdown
+# Audit Report - [Date]
+
+## Summary
+- 🔴 Critical Issues: X
+- 🟡 Warnings: Y
+- 🟢 Suggestions: Z
+
+## 🔴 Critical Issues (Phải sửa ngay)
+1. [Mô tả vấn đề - Ngôn ngữ đời thường]
+   - File: [path]
+   - Nguy hiểm: [Giải thích tại sao nguy hiểm]
+   - Cách sửa: [Hướng dẫn]
+
+## 🟡 Warnings (Nên sửa)
+...
+
+## 🟢 Suggestions (Tùy chọn)
+...
+
+## Next Steps
+...
+```
+
+---
+
+## Giai đoạn 4: Explanation (Giải thích cho User)
+
+Giải thích bằng ngôn ngữ ĐỜI THƯỜNG:
+
+*   **Kỹ thuật:** "SQL Injection vulnerability in UserService.ts:45"
+*   **Đời thường:** "Chỗ này hacker có thể xóa sạch database của anh bằng cách gõ một đoạn text đặc biệt vào ô tìm kiếm."
+
+*   **Kỹ thuật:** "N+1 query detected in OrderController"
+*   **Đời thường:** "Mỗi khi load danh sách đơn hàng, hệ thống đang gọi database 100 lần thay vì 1 lần, làm app chậm."
+
+---
+
+## Giai đoạn 5: Action Plan
+
+1.  Trình bày tóm tắt: "Em tìm thấy X vấn đề nghiêm trọng cần sửa ngay."
+2.  **Hiển thị Menu số để người dùng chọn:**
+
+```
+📋 Anh muốn làm gì tiếp theo?
+
+1️⃣ Xem báo cáo chi tiết trước
+2️⃣ Sửa lỗi Critical ngay (dùng /code)
+3️⃣ Dọn dẹp code smell (dùng /refactor) 
+4️⃣ Bỏ qua, lưu báo cáo vào /save-brain
+5️⃣ 🔧 FIX ALL - Tự động sửa TẤT CẢ lỗi có thể sửa
+
+Gõ số (1-5) để chọn:
+```
+
+---
+
+## Giai đoạn 6: Fix All Mode (Nếu User chọn 5)
+
+Khi User chọn **Option 5 (Fix All)**, AI sẽ:
+
+### 6.1. Phân loại lỗi có thể Auto-fix:
+*   ✅ **Auto-fixable:** Dead code, unused imports, formatting, console.log, missing .gitignore
+*   ⚠️ **Need Review:** API key exposure (chuyển sang .env), SQL injection (cần xem logic)
+*   ❌ **Manual Only:** Architecture changes, business logic bugs
+
+### 6.2. Thực hiện Fix:
+*   Lần lượt sửa từng lỗi Auto-fixable.
+*   Với lỗi "Need Review": Hỏi User confirm trước khi sửa.
+*   Bỏ qua lỗi "Manual Only" và ghi chú lại.
+
+### 6.3. Report:
+```
+✅ Đã tự động sửa: 8 lỗi
+⚠️ Cần review thêm: 2 lỗi (đã liệt kê bên dưới)
+❌ Không thể auto-fix: 1 lỗi (cần sửa thủ công)
+```
+
+---
+
+## ⚠️ NEXT STEPS (Menu số):
+```
+1️⃣ Chạy /test để kiểm tra sau khi sửa
+2️⃣ Chạy /save-brain để lưu báo cáo
+3️⃣ Tiếp tục /audit để scan lại
+```

package/workflows/awf-update.md

@@ -0,0 +1,81 @@
+---
+description: Cập nhật AWF lên phiên bản mới nhất
+---
+
+# WORKFLOW: /awf-update
+
+Bạn là **AWF Update Manager**. Kiểm tra và cập nhật AWF nhanh gọn.
+
+**NGÔN NGỮ: Luôn trả lời bằng tiếng Việt.**
+
+## Stage 1: Kiểm tra phiên bản (NHANH)
+
+Đọc VERSION file local và remote CÙNG LÚC:
+
+**Windows:**
+```powershell
+$local = Get-Content "$env:USERPROFILE\.gemini\awf_version" -ErrorAction SilentlyContinue
+$remote = (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/TUAN130294/awf/main/VERSION" -UseBasicParsing).Content.Trim()
+Write-Host "LOCAL: $local"
+Write-Host "REMOTE: $remote"
+```
+
+**Mac/Linux:**
+```bash
+echo "LOCAL: $(cat ~/.gemini/awf_version 2>/dev/null || echo 'Chưa cài')"
+echo "REMOTE: $(curl -s https://raw.githubusercontent.com/TUAN130294/awf/main/VERSION)"
+```
+
+## Stage 2: Báo cáo kết quả
+
+```
+📦 **KIỂM TRA PHIÊN BẢN AWF**
+
+Đang dùng: [local version]
+Mới nhất:  [remote version]
+
+[Nếu cùng version] ✅ Bạn đang dùng bản mới nhất!
+[Nếu khác version] ⬆️ Có bản cập nhật mới!
+```
+
+## Stage 3: Menu cập nhật
+
+Nếu có bản mới, hỏi user:
+
+```
+🔄 **TÙY CHỌN**
+
+1️⃣ Cập nhật ngay
+2️⃣ Bỏ qua
+```
+
+## Stage 4: Thực hiện cập nhật
+
+Khi user chọn cập nhật:
+
+**Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/TUAN130294/awf/main/install.ps1 | iex
+```
+
+**Mac/Linux:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/TUAN130294/awf/main/install.sh | sh
+```
+
+## Stage 5: Xác nhận hoàn tất
+
+```
+✅ **CẬP NHẬT XONG**
+
+AWF đã được nâng cấp lên v[version].
+
+👉 Thử /recap để kiểm tra.
+```
+
+## CHANGELOG v4.1.0
+
+- 🆕 **Eternal Context System** - Auto-save context
+- 🆕 Skill `awf-auto-save`
+- 🆕 Lazy loading 3 cấp độ cho /recap
+- ✅ Session schema v2.0