awf-vibecoder-kit 5.0.0

package/docs/glossary.md

@@ -0,0 +1,181 @@
+# 📚 Thuật Ngữ — Giải Thích Đời Thường
+
+> Gặp từ lạ? Tra ở đây. Giải thích bằng ngôn ngữ hàng ngày.
+
+---
+
+## A
+
+**API (Application Programming Interface)**
+> "Cửa" để app nói chuyện với server. Giống như khi bạn gọi món ở quán → bồi bàn (API) mang order vào bếp (server) rồi mang đồ ăn ra cho bạn.
+
+**Architecture (Kiến trúc)**
+> Cách các phần của app kết nối với nhau. Giống bản vẽ nhà — phòng nào nối phòng nào, cửa ở đâu.
+
+**Auth / Authentication**
+> Hệ thống "Bạn là ai?" — đăng nhập, đăng ký, quên mật khẩu.
+
+**Authorization**
+> Hệ thống "Bạn được làm gì?" — admin được xóa, nhân viên chỉ được xem.
+
+---
+
+## B
+
+**Backend**
+> Phần "hậu trường" mà user không thấy. Server, database, logic xử lý. Giống bếp của nhà hàng.
+
+**Branch (Git)**
+> "Bản sao" của code để bạn sửa mà không ảnh hưởng bản gốc. Giống photocopy bài — sửa bản photo, bản gốc vẫn nguyên.
+
+**Build**
+> Biến code thành app chạy được. Giống nấu cơm — gạo (code) → cơm (app).
+
+**Bug**
+> Lỗi trong code. App làm sai vì code viết sai.
+
+---
+
+## C
+
+**CLI (Command Line Interface)**
+> Giao diện dùng text thay vì click chuột. Gõ lệnh → máy tính làm.
+
+**Component**
+> "Mảnh ghép" của giao diện. Nút bấm là 1 component, form là 1 component, card là 1 component.
+
+**CRUD**
+> 4 thao tác cơ bản: **C**reate (Tạo), **R**ead (Xem), **U**pdate (Sửa), **D**elete (Xóa).
+
+**CSS**
+> "Son phấn" cho website. Quyết định màu sắc, font chữ, khoảng cách, layout.
+
+---
+
+## D
+
+**Database (Cơ sở dữ liệu)**
+> "Kho" lưu trữ thông tin. Giống Excel khổng lồ — mỗi sheet là 1 table, mỗi row là 1 record.
+
+**Deploy**
+> Đưa app từ máy bạn lên mạng cho mọi người dùng. Giống mở cửa hàng sau khi decor xong.
+
+**Dependency**
+> Thư viện/package mà code của bạn dùng. Giống nguyên liệu nấu ăn — bạn cần bột, đường, trứng...
+
+---
+
+## E-F
+
+**Endpoint**
+> Một "cửa" cụ thể của API. VD: `/api/users` là cửa để lấy danh sách user.
+
+**Frontend**
+> Phần user nhìn thấy và tương tác. Giống mặt tiền nhà hàng — menu, bàn ghế, trang trí.
+
+**Framework**
+> "Bộ khung" giúp code nhanh hơn. Next.js, React, Vue... giống khung nhà prefab — dựng nhanh hơn xây từ gạch.
+
+---
+
+## G-H
+
+**Git**
+> Hệ thống lưu lịch sử code. Mỗi lần commit = 1 điểm save game. Sai? Load lại.
+
+**Hosting**
+> Thuê "đất" trên mạng để đặt app. Vercel, Railway, AWS... giống thuê chỗ để mở shop.
+
+---
+
+## I-L
+
+**Import**
+> Mượn code từ file/thư viện khác. Giống mượn đồ: `import { hammer } from 'toolbox'`.
+
+**Lint / Linting**
+> Kiểm tra code có "sạch sẽ" không — lỗi chính tả, style không thống nhất...
+
+---
+
+## M-N
+
+**Middleware**
+> "Bảo vệ" đứng giữa request và xử lý. VD: check đăng nhập trước khi cho vào dashboard.
+
+**Migration**
+> Thay đổi cấu trúc database một cách có kiểm soát. Giống sửa bản vẽ nhà — thêm phòng, đổi cửa.
+
+**MVP (Minimum Viable Product)**
+> Phiên bản nhỏ nhất chạy được. Đủ để test ý tưởng, chưa cần hoàn hảo.
+
+---
+
+## O-P
+
+**Package**
+> Thư viện code người khác đã viết, bạn dùng lại. Giống mua mì gói thay vì tự kéo mì.
+
+**PR (Pull Request)**
+> Yêu cầu "nhập" code mới vào code chính. Giống nộp bài — reviewer duyệt rồi mới chấp nhận.
+
+**Production**
+> Môi trường "thật" — app đang chạy trên mạng, user đang dùng. Khác "dev" (trên máy bạn).
+
+---
+
+## R-S
+
+**Refactor**
+> Sửa code cho sạch hơn mà KHÔNG thay đổi tính năng. Giống dọn nhà — cùng đồ đạc nhưng gọn hơn.
+
+**Responsive**
+> Website tự điều chỉnh theo kích thước màn hình — đẹp trên cả máy tính lẫn điện thoại.
+
+**Schema**
+> "Bản vẽ" cấu trúc database. Quyết định lưu gì, ở đâu, liên kết thế nào.
+
+**Server**
+> Máy tính chạy 24/7 trên mạng, xử lý yêu cầu từ app. Giống bếp nhà hàng — nhận order, nấu, trả món.
+
+**Sprint**
+> 1 chu kỳ làm việc (thường 1-2 tuần). Lên kế hoạch → Code → Test → Ship.
+
+---
+
+## T-V
+
+**Test**
+> "Bài kiểm tra" cho code. Viết trước "nếu nhập X thì phải ra Y" → chạy xem đúng không.
+
+**Token**
+> "Thẻ ra vào" dạng digital. Sau khi đăng nhập → nhận token → dùng token để chứng minh "tôi đã đăng nhập".
+
+**TypeScript**
+> Phiên bản nâng cấp của JavaScript — thêm "type" để bắt lỗi sớm hơn.
+
+**UI (User Interface)**
+> Giao diện — mọi thứ user nhìn thấy và tương tác.
+
+**UX (User Experience)**
+> Trải nghiệm người dùng — app có dễ dùng không? Có thấy thoải mái không?
+
+**Vibecoding**
+> Bạn mô tả ý tưởng bằng lời → AI viết code. Bạn là "sếp", AI là "dev".
+
+---
+
+## Thuật Ngữ AWF
+
+| Thuật ngữ | Nghĩa |
+|-----------|-------|
+| **Workflow** | Quy trình từng bước (VD: `/brainstorm` là 1 workflow) |
+| **Skill** | Kiến thức chuyên môn AI tự dùng |
+| **Agent** | "Nhân vật" AI đóng vai (frontend specialist, debugger...) |
+| **Phase** | Giai đoạn trong plan (phase-01, phase-02...) |
+| **Sprint Flow** | Quy trình: Idea → Plan → Code → Review → Ship |
+| **Design Brief** | Tóm tắt ý tưởng sau brainstorm |
+| **Context** | Thông tin AI nhớ về project (lưu trong .brain/) |
+| **Freeze** | Khóa phạm vi sửa file |
+| **Canary** | Kiểm tra sức khỏe app sau deploy |
+| **Learning** | Bài học AI lưu qua sessions |

package/docs/quick-start.md

@@ -0,0 +1,96 @@
+# ⚡ Quick Start — Bắt Đầu Trong 5 Phút
+
+> Không cần biết code. Không cần setup. Chỉ cần mở Antigravity và gõ lệnh.
+
+---
+
+## Vibecoding Là Gì?
+
+**Vibecoding** = Bạn mô tả ý tưởng bằng lời → AI viết code cho bạn.
+
+Hãy tưởng tượng bạn là **ông chủ** thuê 1 đội dev:
+- Bạn nói: "Tôi muốn app quản lý chi tiêu"
+- "Đội dev" (AI) hỏi lại vài câu, lên kế hoạch, rồi code, test, fix bug
+- Bạn chỉ cần duyệt và nói "OK" hoặc "Sửa chỗ này"
+
+**AWF** là bộ "quy trình làm việc" giúp bạn làm ông chủ hiệu quả hơn — biết ra lệnh đúng lúc, kiểm tra đúng chỗ.
+
+---
+
+## 3 Bước Đầu Tiên
+
+### Bước 1: Tạo project mới
+
+```
+Gõ: /init
+```
+
+AI sẽ hỏi:
+- "Tên dự án là gì?" → Trả lời: `my-spending-app`
+- "Mô tả ngắn?" → Trả lời: `App quản lý chi tiêu cá nhân`
+- "Tạo ở đâu?" → Trả lời: `Thư mục hiện tại`
+
+**Xong!** AI tạo workspace cho bạn. Chưa có code gì — chỉ có folder trống.
+
+---
+
+### Bước 2: Khám phá ý tưởng
+
+```
+Gõ: /brainstorm
+```
+
+AI sẽ hỏi bạn 5 câu:
+1. **Tại sao lúc này?** — "Tháng nào cũng hết tiền"
+2. **Ai gặp vấn đề?** — "Mình"
+3. **Đang giải quyết bằng cách nào?** — "Ghi vào giấy, hay quên"
+4. **Không làm thì sao?** — "Tiếp tục hết tiền"
+5. **Phiên bản nhỏ nhất?** — "Chỉ cần nhập chi tiêu + xem tổng"
+
+Sau đó AI sẽ:
+- **Đặt lại vấn đề:** "Anh không cần app quản lý, anh cần app NHẬN BIẾT tiêu vặt"
+- **Challenge giả định:** "Anh có chắc cần biểu đồ không? Hay chỉ cần con số?"
+- **Đưa 3 cách:** Quick Win (1 ngày) / Balanced (3 ngày) / Full (1 tuần)
+- Bạn chọn → AI tạo Design Brief tự động
+
+---
+
+### Bước 3: Code!
+
+```
+Gõ: /plan          → AI lên kế hoạch, chia thành 5-6 phases
+Gõ: /code phase-01  → AI bắt đầu code phase 1
+```
+
+AI sẽ:
+- Tự code → Tự test → Nếu fail → Tự fix → Test lại (tối đa 3 lần)
+- Báo progress: "✅ Task 3/5 xong. Tiếp task 4?"
+- Khi xong phase: "🎉 Phase 01 hoàn tất! Tiếp phase 02?"
+
+---
+
+## Sau Đó Thì Sao?
+
+```
+/review     → Kiểm tra code (AI tự tìm bug, tự fix)
+/test       → Chạy test
+/deploy     → Đưa app lên mạng
+/canary     → Kiểm tra app sau deploy
+/save-brain → Lưu context (để lần sau mở lại AI nhớ)
+```
+
+---
+
+## Mẹo Cho Người Mới
+
+| Mẹo | Tại sao |
+|-----|---------|
+| 🧠 Luôn `/brainstorm` trước | 5 phút brainstorm tiết kiệm 5 ngày code sai |
+| 👀 Luôn `/review` trước `/deploy` | Bắt bug trước khi user gặp |
+| 💾 `/save-brain` cuối buổi | Để AI nhớ context khi bạn quay lại |
+| 🔢 Trả lời bằng số (1, 2, 3...) | Menu số = nhanh nhất |
+| ❓ Không biết gõ gì? | Gõ `/help` hoặc `/next` |
+
+---
+
+## Tiếp Theo: [Danh sách 16 lệnh đầy đủ →](commands.md)

package/docs/scenarios.md

@@ -0,0 +1,293 @@
+# 🎯 Kịch Bản Thực Tế — Từ A Đến Z
+
+> 8 kịch bản phổ biến nhất. Copy theo từng bước.
+
+---
+
+## 📋 Danh Sách Kịch Bản
+
+| # | Kịch bản | Độ khó | Thời gian |
+|---|---------|--------|-----------|
+| 1 | [Xây app từ con số 0](#1) | ⭐ Dễ | 1-3 ngày |
+| 2 | [Thêm feature cho project có sẵn](#2) | ⭐ Dễ | 1-2 giờ |
+| 3 | [Fix bug](#3) | ⭐ Dễ | 15 phút |
+| 4 | [Mở lại project sau 1 tuần](#4) | ⭐ Dễ | 5 phút |
+| 5 | [Chuẩn bị deploy production](#5) | ⭐⭐ Trung bình | 30 phút |
+| 6 | [Refactor code lộn xộn](#6) | ⭐⭐ Trung bình | 1-2 giờ |
+| 7 | [Làm landing page đẹp](#7) | ⭐ Dễ | 2-4 giờ |
+| 8 | [Vibecoding session dài (full day)](#8) | ⭐⭐⭐ Nâng cao | Cả ngày |
+
+---
+
+<a id="1"></a>
+## 1️⃣ Xây App Từ Con Số 0
+
+**Tình huống:** Bạn có ý tưởng app CRM quản lý khách hàng cho freelancer.
+
+```
+Session 1 (Sáng — Lên ý tưởng):
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+/init
+→ Tên: my-freelance-crm
+→ Mô tả: CRM cho freelancer quản lý khách hàng
+
+/brainstorm
+→ AI hỏi 5 câu forcing
+→ Phát hiện: "Anh cần app theo dõi DỰ ÁN + THANH TOÁN, không chỉ khách hàng"
+→ Chọn: Option B (Balanced — 3 ngày)
+
+/plan
+→ AI tạo 6 phases, 45 tasks
+→ Duyệt: OK
+
+
+Session 2 (Chiều — Code):
+━━━━━━━━━━━━━━━━━━━━━━━━━
+
+/code phase-01
+→ Setup Next.js + Prisma + Tailwind
+→ ✅ Phase 01 done
+
+/code phase-02
+→ Database schema + seed data
+→ ✅ Phase 02 done
+
+/save-brain
+→ Lưu context cuối ngày
+
+
+Session 3 (Hôm sau):
+━━━━━━━━━━━━━━━━━━━
+
+/recap
+→ AI nhớ: "Đang ở phase 03, đã xong setup + database"
+
+/code phase-03
+/code phase-04
+/code phase-05
+
+/review
+→ Auto-fix 8 issues, hỏi 2 issues → approve
+
+/test
+→ 24/24 tests passed
+
+/deploy
+→ Deploy lên Vercel
+
+/canary https://my-crm.vercel.app
+→ ✅ All healthy
+
+/save-brain
+```
+
+---
+
+<a id="2"></a>
+## 2️⃣ Thêm Feature Cho Project Có Sẵn
+
+**Tình huống:** Project CRM đang chạy, muốn thêm dark mode.
+
+```
+/recap
+→ AI nhớ context project
+
+/brainstorm thêm dark mode
+→ AI: "Dark mode đơn giản, không cần brainstorm sâu.
+   Em sẽ thêm CSS variables + toggle. OK?"
+→ OK
+
+/code thêm dark mode toggle
+→ AI code: CSS variables, toggle component, localStorage persist
+→ Auto-test: ✅ Pass
+
+/review
+→ Auto-fix 1 issue (missing aria-label trên toggle)
+→ ✅ Ready to ship
+
+/deploy
+→ ✅ Deployed
+
+/save-brain
+```
+
+**Tổng thời gian:** ~30 phút
+
+---
+
+<a id="3"></a>
+## 3️⃣ Fix Bug
+
+**Tình huống:** User report "Login không hoạt động trên Safari"
+
+```
+/debug login không hoạt động trên Safari
+→ AI phân tích:
+   Giả thuyết 1: Cookie SameSite policy ← Đúng!
+   Root cause: Safari strict SameSite=Lax mặc định
+   Fix: Set cookie options explicit
+
+/freeze src/lib/auth.ts
+→ Lock scope (chỉ sửa auth-related files)
+
+→ AI fix code
+→ Auto-test: ✅ Pass
+
+/unfreeze
+
+/review
+→ ✅ Clean
+
+/deploy
+→ ✅ Hotfix deployed
+
+/canary
+→ ✅ Login working on all browsers
+```
+
+**Tổng thời gian:** ~15 phút
+
+---
+
+<a id="4"></a>
+## 4️⃣ Mở Lại Project Sau 1 Tuần
+
+**Tình huống:** Nghỉ 1 tuần, quên hết context.
+
+```
+/recap
+→ "📖 Anh đang làm project my-freelance-crm:
+   ✅ Phase 1-4 done (setup, db, backend, frontend)
+   🟡 Phase 5 dở: Integration — task 3/6
+   ⚠️ Có 1 test bị skip: invoice-calc.test.ts
+   
+   Tiếp: /code phase-05 để tiếp tục integration"
+
+/learn
+→ Xem learnings: "Prisma cần reload schema sau migrate"
+
+/code phase-05
+→ Tiếp từ task 3...
+```
+
+---
+
+<a id="5"></a>
+## 5️⃣ Chuẩn Bị Deploy Production
+
+**Tình huống:** App đã code xong, cần kiểm tra kỹ trước khi public.
+
+```
+/review
+→ Scan toàn bộ code
+→ Auto-fix 12 issues
+→ "⚠️ 2 API routes thiếu auth check"
+→ Fix → ✅
+
+/audit
+→ Security scan: OWASP checklist
+→ "🔴 1 critical: SQL injection trong search endpoint"
+→ Fix parameterized query → ✅
+
+/test
+→ Run all tests → 42/42 passed
+→ Coverage: 78%
+
+/deploy check
+→ Pre-flight: TypeScript ✅, ESLint ✅, Tests ✅, Security ✅
+
+/deploy production
+→ ✅ Deployed!
+
+/canary https://myapp.com
+→ ✅ All healthy
+
+/save-brain
+```
+
+---
+
+<a id="6"></a>
+## 6️⃣ Refactor Code Lộn Xộn
+
+**Tình huống:** Code chạy nhưng lộn xộn, file 500+ dòng, logic trùng lặp.
+
+```
+/refactor src/components/Dashboard.tsx
+→ AI phân tích:
+   - File 520 dòng → nên tách thành 5 components
+   - 3 đoạn logic trùng lặp → extract thành utils
+   - 12 magic numbers → extract thành constants
+
+→ AI sửa tất cả
+→ Auto-test: ✅ Behavior không thay đổi
+
+/review
+→ ✅ Cleaner, shorter, maintainable
+```
+
+---
+
+<a id="7"></a>
+## 7️⃣ Làm Landing Page Đẹp
+
+**Tình huống:** Cần landing page cho product mới.
+
+```
+/init
+→ my-product-landing
+
+/plan landing page cho SaaS product quản lý dự án
+→ Plan: 3 phases (Setup, Content + Design, Deploy)
+
+/visualize
+→ AI tạo mockup UI
+
+/code phase-01
+→ Setup Next.js + styling
+
+/code phase-02
+→ Hero section, features, pricing, testimonials, CTA
+
+/review
+→ ✅ SEO checked, responsive checked
+
+/deploy
+→ ✅ Live!
+```
+
+---
+
+<a id="8"></a>
+## 8️⃣ Vibecoding Session Full Day
+
+**Tình huống:** Có nguyên 1 ngày, muốn ship maximum.
+
+```
+9:00 - /recap → Nhớ lại context
+9:05 - /code all-phases → Auto-code tất cả phases
+
+   [AI tự code phase 01 → test → next]
+   [AI tự code phase 02 → test → next]
+   [AI tự code phase 03 → test → fail → fix → test → pass → next]
+   ...
+   [Nếu fail 3 lần → hỏi bạn]
+
+12:00 - Nghỉ trưa → /save-brain
+
+13:00 - /recap → Tiếp tục
+13:05 - /code all-phases (từ phase dở)
+   [Tiếp tục auto-code...]
+
+16:00 - Code xong tất cả phases
+16:05 - /review → Auto-fix + scan
+16:15 - /test → ✅ All pass
+16:20 - /deploy → Ship!
+16:25 - /canary → ✅ Healthy
+16:30 - /save-brain → Xong ngày!
+```
+
+---
+
+## Tiếp Theo: [Thuật ngữ giải thích đời thường →](glossary.md)

package/docs/skills.md

@@ -0,0 +1,147 @@
+# 🧩 Skills — Siêu Năng Lực Ẩn Của AI
+
+> Skills = Kiến thức chuyên môn mà AI tự kích hoạt khi cần.
+> Bạn KHÔNG cần gõ lệnh gì. AI tự biết khi nào dùng skill nào.
+
+---
+
+## Skill Hoạt Động Như Thế Nào?
+
+Hãy tưởng tượng bạn thuê 1 nhân viên "biết tuốt":
+- Khi bạn hỏi về database → Anh ta tự chuyển sang "chế độ DBA"
+- Khi bạn hỏi về UI → Anh ta tự chuyển sang "chế độ Designer"
+- Khi có lỗi bảo mật → Anh ta tự để ý và cảnh báo
+
+**Bạn không cần nói "hãy dùng skill X".** Nó tự kích hoạt. Nhưng nếu muốn tìm hiểu, đây là danh sách:
+
+---
+
+## 📂 Skills Theo Nhóm
+
+### 🤖 Auto Skills (Chạy tự động, bạn không cần biết)
+
+| Skill | Tự kích hoạt khi | Làm gì |
+|-------|------------------|--------|
+| `awf-session-restore` | Mỗi đầu session | Khôi phục context — AI nhớ lại bạn đang ở đâu |
+| `awf-auto-save` | Cuối workflow / quyết định quan trọng | Tự lưu context để không mất data |
+| `awf-adaptive-language` | Đầu session | Điều chỉnh thuật ngữ theo trình độ bạn |
+| `awf-error-translator` | Khi có lỗi | Dịch lỗi kỹ thuật → tiếng thường |
+| `awf-onboarding` | Lần đầu dùng AWF | Hướng dẫn bước đầu |
+| `awf-context-help` | Khi bạn gõ `/help` | Trợ giúp theo context hiện tại |
+
+**Ví dụ:**
+```
+Lỗi gốc:   "TypeError: Cannot read property 'map' of undefined"
+Sau dịch:   "😅 Có lỗi trong code — dữ liệu trả về trống. Em đang fix..."
+```
+
+---
+
+### 🧠 Code Intelligence (GitNexus — Knowledge Graph)
+
+> Đây là bộ siêu năng lực giúp AI **hiểu cấu trúc code** của dự án, không chỉ đọc từng file.
+
+| Skill | Làm gì | Ví dụ |
+|-------|--------|-------|
+| `gnx-intelligence-layer` | Auto-enrich mọi code edit bằng graph context | Trước khi sửa function, tự check ai đang gọi nó |
+| `gnx-impact-guard` | Phân tích blast radius trước khi sửa code | "⚠️ Sửa function này ảnh hưởng 12 file khác!" |
+| `gnx-code-navigator` | Explore code architecture | "Ai gọi function X? X phụ thuộc vào gì?" |
+| `gnx-safe-refactor` | Rename/move an toàn đa file | Rename function → tự update tất cả references |
+| `gnx-index-keeper` | Quản lý index freshness | Tự nhắc re-index khi codebase thay đổi nhiều |
+
+**Ví dụ thực tế:**
+```
+Bạn: "Sửa function createUser trong auth.ts"
+AI (nhờ gnx-impact-guard):
+  "⚠️ createUser đang được gọi bởi:
+   - signup-form.tsx (UI)
+   - import-users.ts (script)
+   - user.test.ts (test)
+   Sửa createUser có thể ảnh hưởng cả 3 file. Tiếp tục?"
+```
+
+---
+
+### 🎨 Frontend Skills
+
+| Skill | Khi nào dùng | Làm gì |
+|-------|-------------|--------|
+| `frontend-design` | Thiết kế UI | Thinking về colors, typography, layout |
+| `nextjs-react-expert` | Code React/Next.js | Performance optimization, Server Components |
+| `tailwind-patterns` | Dùng Tailwind CSS | CSS-first config, container queries |
+| `web-design-guidelines` | Review UI | Check accessibility, UX best practices |
+| `seo-fundamentals` | SEO | Meta tags, Core Web Vitals |
+
+---
+
+### 🔧 Backend Skills
+
+| Skill | Khi nào dùng | Làm gì |
+|-------|-------------|--------|
+| `api-patterns` | Thiết kế API | REST vs GraphQL, pagination, versioning |
+| `database-design` | Thiết kế DB | Schema, indexing, ORM |
+| `nodejs-best-practices` | Code Node.js | Async patterns, security |
+
+---
+
+### 🔒 Security Skills
+
+| Skill | Khi nào dùng | Làm gì |
+|-------|-------------|--------|
+| `vulnerability-scanner` | `/audit` | OWASP 2025, supply chain security |
+| `red-team-tactics` | Security deep dive | MITRE ATT&CK, attack phase analysis |
+
+---
+
+### 🧪 Testing Skills
+
+| Skill | Khi nào dùng | Làm gì |
+|-------|-------------|--------|
+| `testing-patterns` | `/test` | Unit, integration, mocking |
+| `tdd-workflow` | Test-driven development | RED-GREEN-REFACTOR cycle |
+| `webapp-testing` | E2E testing | Playwright, deep audit |
+| `systematic-debugging` | `/debug` | 4-phase debugging methodology |
+
+---
+
+### 🏗️ Architecture & DevOps Skills
+
+| Skill | Khi nào dùng | Làm gì |
+|-------|-------------|--------|
+| `architecture` | Quyết định kiến trúc | Requirements analysis, ADR documentation |
+| `deployment-procedures` | `/deploy` | Safe deployment, rollback strategies |
+| `server-management` | Quản lý server | PM2, monitoring, scaling |
+| `performance-profiling` | Optimization | Measure → analyze → optimize |
+
+---
+
+### 🎮 Specialized Skills
+
+| Skill | Khi nào dùng | Làm gì |
+|-------|-------------|--------|
+| `game-development` | Làm game | Unity, Godot, 2D/3D |
+| `mobile-design` | Mobile app | Touch interaction, platform conventions |
+| `rust-pro` | Code Rust | Tokio, axum, type system |
+| `python-patterns` | Code Python | Async, type hints, project structure |
+| `mcp-builder` | Build MCP server | Tool design, resource patterns |
+
+---
+
+### 📝 Process Skills
+
+| Skill | Khi nào dùng | Làm gì |
+|-------|-------------|--------|
+| `brainstorming` | `/brainstorm` | Socratic questioning protocol |
+| `plan-writing` | `/plan` | Structured task planning |
+| `clean-code` | Mọi lúc | Code concise, self-documenting |
+| `intelligent-routing` | Mọi lúc | Auto-chọn specialist phù hợp |
+
+---
+
+## Tôi Có Thể Tắt/Bật Skill Không?
+
+**Không cần.** Skills tự hoạt động. Nếu bạn thấy AI dùng skill không phù hợp, nói "đừng làm X" là đủ.
+
+---
+
+## Tiếp Theo: [Kịch bản thực tế A→Z →](scenarios.md)