awf-vibecoder-kit 5.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,159 @@
+# ⚡ AWF Vibecoder Kit v5
+
+> Biến AI thành đội dev ảo. Bộ công cụ vibecoding cho [Antigravity IDE](https://antigravity.dev).
+
+**Vibecoding** = Bạn nói ý tưởng → AI viết code. Bạn làm "sếp", AI làm "nhân viên".
+
+AWF (Antigravity Workflow Framework) giúp bạn "sếp" tốt hơn — ra lệnh đúng, kiểm tra đúng, ship nhanh.
+
+---
+
+## ✨ Highlights
+
+🎯 **16 lệnh chính** — Sprint flow: Idea → Plan → Code → Review → Ship
+🧠 **~50 skills ẩn** — AI tự kích hoạt kiến thức chuyên môn khi cần
+🇻🇳 **Vietnamese-first** — Viết cho người Việt, thuật ngữ dễ hiểu
+📱 **Mọi trình độ** — Từ non-tech đến senior dev đều dùng được
+🔧 **Fix-first review** — AI tự fix lỗi rõ ràng, chỉ hỏi khi cần judgment
+📚 **Docs đầy đủ** — 5 file hướng dẫn từ Quick Start đến Glossary
+
+---
+
+## 🚀 Cài Đặt — 30 Giây
+
+### Cách 1: npm (Khuyến nghị)
+
+```bash
+npm install -g awf-vibecoder-kit
+```
+
+Tự động copy workflows + docs + skills vào `~/.gemini/antigravity/`.
+
+### Cách 2: Git Clone
+
+```bash
+git clone https://github.com/mh/awf-vibecoder-kit.git
+cd awf-vibecoder-kit
+node bin/setup.js
+```
+
+### Cách 3: Manual
+
+Copy thủ công 3 folder vào `~/.gemini/antigravity/`:
+- `workflows/` → `global_workflows/`
+- `docs/` → `docs/`
+- `skills/` → `skills/`
+
+---
+
+## 📖 Quick Start
+
+1. Mở Antigravity
+2. Gõ `/vibecoder-guide` để đọc hướng dẫn
+3. Gõ `/init` để tạo project mới
+4. Gõ `/brainstorm` để khám phá ý tưởng
+5. Ship! 🚀
+
+---
+
+## 🗺️ Sprint Flow
+
+```
+/init → /brainstorm → /plan → /design → /code → /review → /test → /deploy → /canary
+  ↑                                                                              ↓
+  └────────────────────── /recap (mở lại project) ←──────── /save-brain (cuối buổi)
+```
+
+---
+
+## 📋 16 Lệnh Chính
+
+| Lệnh | Mô tả | Khi nào dùng |
+|-------|--------|-------------|
+| `/init` | ✨ Tạo dự án mới | Bắt đầu project |
+| `/brainstorm` | 💡 Khám phá ý tưởng (5 forcing questions) | Chưa rõ muốn làm gì |
+| `/plan` | 📋 Lên kế hoạch chi tiết | Đã biết muốn gì |
+| `/design` | 🎨 Thiết kế DB, API, luồng | Trước khi code |
+| `/visualize` | 🖼️ Thiết kế UI mockup | Muốn xem UI trước |
+| `/code` | 💻 Viết code (auto-test loop) | Bắt đầu code |
+| `/review` | 👀 Code review + auto-fix | Sau code, trước deploy |
+| `/test` | 🧪 Chạy test suite | Kiểm tra code |
+| `/deploy` | 🚀 Deploy lên mạng | App sẵn sàng |
+| `/canary` | 🐤 Check sức khỏe sau deploy | Vừa deploy xong |
+| `/debug` | 🐛 Tìm và sửa lỗi | App bị lỗi |
+| `/audit` | 🔒 Kiểm tra bảo mật | Trước khi public |
+| `/freeze` | 🔒 Lock edit scope | Debug tập trung |
+| `/learn` | 📚 Quản lý kiến thức | Xem bài học qua sessions |
+| `/recap` | 📖 Nhớ lại context | Mở lại project |
+| `/save-brain` | 🧠 Lưu context | Cuối buổi |
+
+---
+
+## 📂 Cấu Trúc Package
+
+```
+awf-vibecoder-kit/
+├── bin/
+│   ├── setup.js          # Install script
+│   └── uninstall.js      # Uninstall guide
+├── workflows/            # 16+ workflow .md files
+│   ├── brainstorm.md     # 5 forcing questions + reframe
+│   ├── review.md         # Fix-first code review
+│   ├── freeze.md         # Edit scope lock
+│   ├── canary.md         # Post-deploy monitoring
+│   ├── learn.md          # Compound learnings
+│   ├── code.md           # Phase-based coding
+│   ├── plan.md           # Multi-perspective planning
+│   └── ...
+├── docs/                 # User guide (Vietnamese)
+│   ├── README.md         # Table of contents
+│   ├── quick-start.md    # 5-minute beginner guide
+│   ├── commands.md       # 16 commands detailed
+│   ├── skills.md         # ~50 skills explained
+│   ├── scenarios.md      # 8 real-world scenarios
+│   └── glossary.md       # Tech terms → plain Vietnamese
+├── skills/               # Auto-activated AI skills
+│   ├── awf-session-restore/
+│   ├── awf-auto-save/
+│   └── ...
+├── package.json
+├── LICENSE
+└── README.md             # ← You are here
+```
+
+---
+
+## 🆚 Lấy Cảm Hứng Từ
+
+AWF v5 lấy ý tưởng hay nhất từ **[GStack](https://github.com/garrytan/gstack)** (Garry Tan, CEO Y Combinator) và kết hợp với thế mạnh riêng:
+
+| Feature | GStack | AWF v5 |
+|---------|--------|--------|
+| Sprint flow | ✅ | ✅ |
+| Fix-first review | ✅ | ✅ |
+| Post-deploy canary | ✅ | ✅ |
+| Edit scope lock | ✅ | ✅ |
+| Memory/learnings | ✅ | ✅ |
+| Real browser testing | ✅ | ❌ |
+| Vietnamese UX | ❌ | ✅ |
+| Phase-based coding | ❌ | ✅ |
+| Non-tech friendly | ❌ | ✅ |
+| Knowledge graph (GitNexus) | ❌ | ✅ |
+| Multi-agent orchestration | ❌ | ✅ |
+
+---
+
+## 📝 License
+
+MIT — Free forever. Go build something.
+
+---
+
+## 🧑‍💻 Contributing
+
+1. Fork repo
+2. Tạo branch: `git checkout -b improve/brainstorm`
+3. Sửa workflow `.md` files
+4. PR + mô tả changes
+
+Workflows là Markdown files — không cần biết code cũng contribute được!

package/bin/setup.js

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+
+/**
+ * AWF Vibecoder Kit — Setup Script
+ * 
+ * Copies workflows, docs, and skills to ~/.gemini/antigravity/
+ * Safe: backs up existing files before overwriting.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// ═══════════════════════════════════════
+// Config
+// ═══════════════════════════════════════
+
+const HOME = os.homedir();
+const TARGET_BASE = path.join(HOME, '.gemini', 'antigravity');
+const SOURCE_BASE = path.join(__dirname, '..');
+const isAuto = process.argv.includes('--auto');
+const isForce = process.argv.includes('--force');
+
+const DIRS_TO_COPY = [
+    { src: 'workflows', dest: 'global_workflows', merge: true },
+    { src: 'docs', dest: 'docs', merge: true },
+    { src: 'skills', dest: 'skills', merge: true },
+];
+
+// ═══════════════════════════════════════
+// Helpers
+// ═══════════════════════════════════════
+
+const COLORS = {
+    green: (t) => `\x1b[32m${t}\x1b[0m`,
+    yellow: (t) => `\x1b[33m${t}\x1b[0m`,
+    red: (t) => `\x1b[31m${t}\x1b[0m`,
+    cyan: (t) => `\x1b[36m${t}\x1b[0m`,
+    bold: (t) => `\x1b[1m${t}\x1b[0m`,
+    dim: (t) => `\x1b[2m${t}\x1b[0m`,
+};
+
+function log(icon, msg) {
+    console.log(`  ${icon} ${msg}`);
+}
+
+function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+
+function copyFileSync(src, dest) {
+    const destDir = path.dirname(dest);
+    ensureDir(destDir);
+    fs.copyFileSync(src, dest);
+}
+
+function copyDirMerge(srcDir, destDir) {
+    if (!fs.existsSync(srcDir)) return 0;
+    ensureDir(destDir);
+    let count = 0;
+
+    const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(srcDir, entry.name);
+        const destPath = path.join(destDir, entry.name);
+
+        if (entry.isDirectory()) {
+            count += copyDirMerge(srcPath, destPath);
+        } else {
+            copyFileSync(srcPath, destPath);
+            count++;
+        }
+    }
+    return count;
+}
+
+function backupExisting(dir) {
+    if (!fs.existsSync(dir)) return;
+    const backupDir = dir + '.backup-' + Date.now();
+    fs.cpSync(dir, backupDir, { recursive: true });
+    return backupDir;
+}
+
+// ═══════════════════════════════════════
+// Main
+// ═══════════════════════════════════════
+
+function main() {
+    console.log('');
+    console.log(COLORS.bold('  ⚡ AWF Vibecoder Kit v5.0 — Setup'));
+    console.log(COLORS.dim('  ─────────────────────────────────────'));
+    console.log('');
+
+    // Check target exists
+    ensureDir(TARGET_BASE);
+    log('📁', `Target: ${COLORS.cyan(TARGET_BASE)}`);
+    console.log('');
+
+    let totalFiles = 0;
+
+    for (const { src, dest, merge } of DIRS_TO_COPY) {
+        const srcDir = path.join(SOURCE_BASE, src);
+        const destDir = path.join(TARGET_BASE, dest);
+
+        if (!fs.existsSync(srcDir)) {
+            log('⏭️', COLORS.dim(`Skip: ${src}/ (not found in package)`));
+            continue;
+        }
+
+        // Count source files
+        const srcFiles = fs.readdirSync(srcDir, { recursive: true });
+
+        if (merge) {
+            const count = copyDirMerge(srcDir, destDir);
+            log('✅', `${COLORS.green(src + '/')} → ${dest}/ (${count} files)`);
+            totalFiles += count;
+        }
+    }
+
+    console.log('');
+    console.log(COLORS.dim('  ─────────────────────────────────────'));
+    log('🎉', COLORS.bold(COLORS.green(`Done! ${totalFiles} files installed.`)));
+    console.log('');
+
+    console.log('  📖 Quick Start:');
+    console.log('     1. Open Antigravity');
+    console.log('     2. Type /vibecoder-guide');
+    console.log('     3. Start vibecoding!');
+    console.log('');
+    console.log('  🗺️ Sprint Flow:');
+    console.log('     /init → /brainstorm → /plan → /code → /review → /deploy');
+    console.log('');
+    console.log('  📚 Docs: ~/.gemini/antigravity/docs/');
+    console.log('');
+}
+
+try {
+    main();
+} catch (err) {
+    console.error(COLORS.red(`\n  ❌ Setup failed: ${err.message}\n`));
+    process.exit(1);
+}

package/bin/uninstall.js

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+
+/**
+ * AWF Vibecoder Kit — Uninstall Script
+ * Lists files that were installed (does not delete — user decides).
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const HOME = os.homedir();
+const TARGET_BASE = path.join(HOME, '.gemini', 'antigravity');
+
+console.log('');
+console.log('  ⚠️  AWF Vibecoder Kit — Uninstall');
+console.log('  ─────────────────────────────────────');
+console.log('');
+console.log('  AWF files are installed at:');
+console.log(`  📁 ${TARGET_BASE}`);
+console.log('');
+console.log('  To uninstall, manually delete these folders:');
+console.log('     - global_workflows/  (AWF workflow files)');
+console.log('     - docs/              (AWF documentation)');
+console.log('     - skills/            (AWF auto-skills)');
+console.log('');
+console.log('  ⚠️  This will NOT delete your project data or .brain/ files.');
+console.log('');

package/docs/README.md

@@ -0,0 +1,37 @@
+# 📖 AWF v5 — Tài Liệu Hướng Dẫn
+
+> **AWF** (Antigravity Workflow Framework) — Bộ công cụ biến AI thành đội ngũ phát triển phần mềm ảo.
+> Bạn chỉ cần nói ý tưởng, AI lo phần còn lại.
+
+---
+
+## 📂 Mục Lục Tài Liệu
+
+| # | File | Nội dung | Dành cho ai |
+|---|------|---------|-------------|
+| 1 | [quick-start.md](quick-start.md) | Bắt đầu trong 5 phút | Tất cả |
+| 2 | [commands.md](commands.md) | 16 lệnh chi tiết + ví dụ | Tất cả |
+| 3 | [skills.md](skills.md) | ~50 skills ẩn — AI tự kích hoạt | Người muốn hiểu sâu |
+| 4 | [scenarios.md](scenarios.md) | 8 kịch bản thực tế A→Z | Tất cả |
+| 5 | [glossary.md](glossary.md) | Thuật ngữ giải thích đời thường | Người mới |
+
+---
+
+## 🎯 Đọc Gì Trước?
+
+**Nếu mới bắt đầu:** Đọc `quick-start.md` → `commands.md` → `scenarios.md`
+
+**Nếu đã dùng AWF:** Đọc `commands.md` (phần "Mới ở v5") → `skills.md`
+
+**Nếu muốn tra cứu nhanh:** Mở `commands.md` → tìm lệnh cần dùng
+
+---
+
+## 🔗 Sprint Flow
+
+```
+/init → /brainstorm → /plan → /design → /code → /review → /test → /deploy → /canary
+  ↑                                                                              ↓
+  └────────────────────── /recap ←──────────────────────────────── /save-brain ←─┘
+                    (quay lại khi mở project)                  (cuối buổi làm việc)
+```

package/docs/commands.md

@@ -0,0 +1,306 @@
+# 📋 Danh Sách Lệnh — 16 Lệnh Chính Của AWF v5
+
+> Mỗi lệnh bắt đầu bằng `/`. Gõ trong chat Antigravity.
+
+---
+
+## 🗺️ Bản Đồ: Dùng Lệnh Nào Khi Nào?
+
+```
+Muốn bắt đầu project mới?
+  └→ /init
+
+Có ý tưởng mơ hồ?
+  └→ /brainstorm
+
+Đã biết muốn làm gì?
+  └→ /plan → /design → /code
+
+Code xong, muốn kiểm tra?
+  └→ /review → /test
+
+Muốn đưa app lên mạng?
+  └→ /deploy → /canary
+
+Cuối buổi làm việc?
+  └→ /save-brain
+
+Mở lại project sau 1 thời gian?
+  └→ /recap
+
+Gặp lỗi?
+  └→ /debug
+
+Không biết làm gì tiếp?
+  └→ /next hoặc /help
+```
+
+---
+
+## 📖 Chi Tiết Từng Lệnh
+
+---
+
+### ✨ `/init` — Tạo Dự Án Mới
+
+**Khi nào:** Bắt đầu 1 project hoàn toàn mới.
+
+**AI sẽ hỏi:** Tên project, mô tả ngắn, tạo ở đâu.
+
+**Output:** Folder project với `.brain/` (bộ nhớ AI) + `docs/` + `README.md`
+
+**KHÔNG làm gì thêm** — chưa install package, chưa tạo code. Mọi thứ để các lệnh sau lo.
+
+```
+Ví dụ:
+/init
+→ "Tên dự án?" → my-crm
+→ "Mô tả?" → CRM quản lý khách hàng
+→ ✅ Đã tạo workspace!
+```
+
+---
+
+### 💡 `/brainstorm` — Khám Phá Ý Tưởng 🆕 v5
+
+**Khi nào:** Có ý tưởng mơ hồ, cần AI giúp làm rõ trước khi code.
+
+**Cách hoạt động:**
+1. AI hỏi **5 câu bắt buộc** (tại sao? ai dùng? đã có gì? không làm thì sao? nhỏ nhất là gì?)
+2. AI **đặt lại vấn đề** — đôi khi vấn đề thật khác hoàn toàn feature request
+3. AI **challenge giả định** — phản biện để bạn suy nghĩ kỹ hơn
+4. AI đưa **3 giải pháp** (Quick Win / Balanced / Full Vision)
+5. Bạn chọn → AI tạo **Design Brief** tự động
+
+**Tại sao quan trọng:** 5 phút brainstorm tiết kiệm 5 ngày code sai hướng.
+
+```
+Ví dụ:
+/brainstorm app quản lý nhân sự
+→ AI hỏi 5 câu → phát hiện: "Anh không cần app quản lý nhân sự.
+   Anh cần app RECRUITMENT — theo dõi ứng viên qua từng vòng."
+→ Đưa 3 giải pháp → Bạn chọn Balanced
+→ ✅ Design Brief đã lưu tại .brain/design-brief.md
+```
+
+---
+
+### 📋 `/plan` — Lên Kế Hoạch Chi Tiết
+
+**Khi nào:** Đã biết muốn làm gì, cần kế hoạch cụ thể.
+
+**Cách hoạt động:**
+1. AI hỏi 3 câu nhanh (quản lý gì? / ai dùng? / quan trọng nhất?)
+2. AI đề xuất kiến trúc (tự chọn tech stack)
+3. Bạn duyệt: OK / Chỉnh sửa / Từ đầu
+4. AI tạo plan chi tiết → chia phases → list tasks mỗi phase
+
+**Output:** Folder `plans/` với `plan.md` + `phase-01.md`, `phase-02.md`...
+
+```
+Ví dụ:
+/plan
+→ Plan: 6 phases, 56 tasks
+→ Phase 01: Setup (5 tasks)
+→ Phase 02: Database (8 tasks)
+→ ...
+→ "Bắt đầu Phase 1? Gõ /code phase-01"
+```
+
+---
+
+### 🎨 `/design` — Thiết Kế Kỹ Thuật
+
+**Khi nào:** Sau `/plan`, trước `/code`. Thiết kế database, API, luồng hoạt động.
+
+**Output:** File `docs/DESIGN.md` với sơ đồ database, danh sách màn hình, user journey, test criteria.
+
+**Giải thích đời thường:** Nếu `/plan` là "biết LÀM GÌ", thì `/design` là "biết LÀM NHƯ THẾ NÀO".
+
+---
+
+### 🖼️ `/visualize` — Thiết Kế Giao Diện (UI)
+
+**Khi nào:** Muốn xem UI trước khi code. Tạo mockup.
+
+**Output:** Hình ảnh mockup của các màn hình app.
+
+---
+
+### 💻 `/code` — Viết Code
+
+**Khi nào:** Đã có plan, bắt đầu code.
+
+**Cách dùng:**
+| Lệnh | Ý nghĩa |
+|-------|---------|
+| `/code phase-01` | Code phase 1 trong plan |
+| `/code phase-02` | Code phase 2 |
+| `/code all-phases` | Code tất cả phases liên tục |
+| `/code thêm dark mode` | Code feature cụ thể (không cần plan) |
+
+**Tính năng đặc biệt:**
+- **Auto Test Loop:** Code → test → fail → tự fix → test lại (max 3 lần)
+- **Quality Level:** Hỏi bạn muốn MVP (nhanh) / Production (chuẩn) / Enterprise (scale)
+- **Auto Checkpoint:** Tự lưu progress sau mỗi task
+
+---
+
+### 👀 `/review` — Kiểm Tra Code 🆕 v5
+
+**Khi nào:** Sau khi code xong, TRƯỚC khi deploy. **Đừng bao giờ skip bước này.**
+
+**Cách hoạt động:**
+1. AI scan tất cả code đã thay đổi
+2. **Tự fix** lỗi rõ ràng (imports, console.log, unused vars...)
+3. **Hỏi bạn** lỗi cần judgment (race conditions, logic bugs)
+4. Chạy checklist: Security / Error Handling / Performance
+5. Đưa **verdict**: READY TO SHIP hoặc NEEDS WORK
+
+**Trước v5:** `/review` chỉ là báo cáo tổng quan project.
+**Từ v5:** `/review` tìm bug thật, fix thật, đánh giá production-readiness.
+
+---
+
+### 🧪 `/test` — Chạy Test
+
+**Khi nào:** Kiểm tra code chạy đúng.
+
+| Lệnh | Ý nghĩa |
+|-------|---------|
+| `/test` | Chạy tất cả test |
+| `/test src/auth.ts` | Tạo test cho file cụ thể |
+| `/test coverage` | Xem test coverage |
+
+---
+
+### 🚀 `/deploy` — Đưa App Lên Mạng
+
+**Khi nào:** App đã sẵn sàng, muốn public.
+
+**Cách hoạt động:**
+1. Chạy pre-flight checks (TypeScript, ESLint, tests, security)
+2. Build app
+3. Deploy lên platform (Vercel, Railway, Fly.io, Docker...)
+4. Health check
+
+| Lệnh | Ý nghĩa |
+|-------|---------|
+| `/deploy` | Deploy wizard |
+| `/deploy check` | Chỉ kiểm tra, chưa deploy |
+| `/deploy preview` | Deploy bản preview/staging |
+| `/deploy production` | Deploy bản chính thức |
+| `/deploy rollback` | Quay lại phiên bản trước |
+
+---
+
+### 🐤 `/canary` — Kiểm Tra Sau Deploy 🆕 v5
+
+**Khi nào:** Vừa deploy xong, muốn chắc app chạy ổn.
+
+**Kiểm tra:** Homepage load, API health, console errors, Core Web Vitals.
+
+```
+Ví dụ:
+/canary https://myapp.com
+→ Homepage: ✅ 200 OK (1.2s)
+→ API Health: ✅ OK
+→ Console Errors: ✅ None
+→ Performance: ⚠️ LCP 3.2s (cần cải thiện)
+→ 💚 Overall: HEALTHY
+```
+
+---
+
+### 🐛 `/debug` — Tìm Và Sửa Lỗi
+
+**Khi nào:** App bị lỗi, cần tìm nguyên nhân.
+
+**Cách hoạt động:**
+1. Thu thập thông tin lỗi
+2. Đặt giả thuyết (3 nguyên nhân có thể)
+3. Kiểm tra từng giả thuyết
+4. Fix + giải thích root cause
+5. Gợi ý cách phòng ngừa
+
+```
+Ví dụ:
+/debug login không hoạt động
+→ Giả thuyết 1: Token hết hạn ← Đúng!
+→ Fix: Thêm refresh token logic
+→ Prevention: Test token expiry trong test suite
+```
+
+---
+
+### 🔒 `/freeze` — Khóa Phạm Vi Sửa File 🆕 v5
+
+**Khi nào:** Đang debug, sợ AI "tiện tay" sửa file không liên quan.
+
+```
+/freeze src/lib/auth.ts       → Chỉ cho sửa file auth.ts
+/freeze src/components/       → Chỉ cho sửa trong components/
+/unfreeze                     → Mở khóa
+```
+
+**Tự động:** Khi gõ `/debug file.ts`, AI tự freeze scope vào folder chứa file đó.
+
+---
+
+### 🔒 `/audit` — Kiểm Tra Bảo Mật
+
+**Khi nào:** Trước khi public app. Kiểm tra SQL injection, XSS, auth bypass...
+
+---
+
+### 📖 `/recap` — Nhớ Lại Đang Làm Gì
+
+**Khi nào:** Mở lại project sau 1 thời gian (1 ngày, 1 tuần, 1 tháng).
+
+AI đọc `.brain/` → nhớ lại bạn đang ở phase nào, làm gì dở, cần làm gì tiếp.
+
+---
+
+### 🧠 `/save-brain` — Lưu Context
+
+**Khi nào:** Cuối mỗi buổi làm việc. Để AI nhớ context cho session sau.
+
+**Nếu quên:** Session sau AI sẽ không biết bạn đã làm gì → phải giải thích lại.
+
+---
+
+### 📚 `/learn` — Quản Lý Kiến Thức 🆕 v5
+
+**Khi nào:** Xem/thêm bài học AI đã học qua các session.
+
+```
+/learn                     → Xem tất cả learnings
+/learn search prisma       → Tìm learning liên quan Prisma
+/learn prune               → Dọn dẹp learnings cũ
+```
+
+**Auto-learn:** AI tự lưu khi fix bug khó, khi bạn sửa code AI viết, khi retry 3+ lần.
+
+---
+
+### 🔧 `/refactor` — Dọn Dẹp Code
+
+**Khi nào:** Code chạy rồi nhưng lộn xộn, cần restructure.
+
+---
+
+### ➡️ `/next` — Gợi Ý Bước Tiếp Theo
+
+**Khi nào:** Không biết gõ gì tiếp.
+
+AI đọc context → gợi ý lệnh phù hợp nhất lúc này.
+
+---
+
+### ❓ `/help` — Trợ Giúp
+
+**Khi nào:** Cần hỏi về AWF, lệnh nào làm gì.
+
+---
+
+## Tiếp Theo: [Skills ẩn — AI tự kích hoạt →](skills.md)