awf-vibecoder-kit 5.0.0

package/workflows/learn.md

@@ -0,0 +1,119 @@
+---
+description: 🧠 Quản lý kiến thức — Lưu bài học, patterns, sai lầm qua các session
+---
+
+# WORKFLOW: /learn — Knowledge Compounder
+
+**Mục đích:** Lưu trữ và quản lý operational learnings — những bài học, patterns, sai lầm, project quirks — để AI ngày càng thông minh hơn qua mỗi session.
+
+**NGÔN NGỮ: Tiếng Việt.**
+
+---
+
+## Cách Dùng
+
+```
+/learn                     → Xem tất cả learnings của project hiện tại
+/learn add                 → Thêm learning mới
+/learn search [keyword]    → Tìm learning liên quan
+/learn prune               → Dọn dẹp learnings cũ/không còn đúng
+```
+
+---
+
+## Cơ Chế Hoạt Động
+
+### File lưu trữ: `.brain/learnings.jsonl`
+
+Mỗi dòng là 1 learning:
+```json
+{"date":"2026-04-04","type":"mistake","summary":"Dùng revalidatePath('/') thay vì revalidatePath('/dashboard') làm cache toàn app bị invalidate","context":"Next.js 14, dashboard page","fix":"revalidatePath chỉ path cụ thể"}
+{"date":"2026-04-03","type":"pattern","summary":"Server Action pattern: parse FormData → validate → call data layer → revalidatePath → return {success/error}","context":"Headhunt Manager CRM"}
+{"date":"2026-04-02","type":"quirk","summary":"Prisma trên Windows cần set binaryTargets trong schema.prisma","context":"Windows dev environment"}
+```
+
+### Loại learnings:
+
+| Type | Mô tả | Ví dụ |
+|------|--------|-------|
+| `mistake` | Sai lầm đã mắc | "Import sai thư viện gây crash" |
+| `pattern` | Pattern tốt đã tìm ra | "Server Action pattern chuẩn" |
+| `quirk` | Đặc điểm riêng của project | "Prisma cần binary targets trên Windows" |
+| `preference` | User thích/không thích | "User không muốn dùng Tailwind" |
+
+---
+
+## Auto-Learn (Tự động lưu)
+
+AI tự động lưu learning khi:
+1. **Fix bug khó** → Lưu root cause + fix
+2. **User sửa lại code AI viết** → Lưu preference
+3. **Retry 3+ lần** → Lưu cách giải quyết đúng
+4. **User dạy AI điều mới** → Lưu knowledge
+
+```
+"🧠 Đã lưu learning:
+   Type: mistake
+   Summary: [mô tả ngắn]"
+```
+
+---
+
+## /learn — Xem Tất Cả
+
+```
+"🧠 PROJECT LEARNINGS — [Project Name]
+
+📊 Tổng: 12 learnings (5 mistakes, 4 patterns, 2 quirks, 1 preference)
+
+━━━ Mistakes (gần đây) ━━━
+1. [2026-04-04] revalidatePath('/') invalidate toàn app
+2. [2026-04-03] Missing await trước async function gây race condition
+
+━━━ Patterns ━━━
+1. [2026-04-03] Server Action: parse → validate → data layer → revalidate
+2. [2026-04-02] Component naming: [Domain][Action][Type].tsx
+
+━━━ Quirks ━━━
+1. [2026-04-02] Prisma binary targets trên Windows
+
+━━━ Preferences ━━━
+1. [2026-04-01] User thích error messages bằng tiếng Việt"
+```
+
+---
+
+## /learn search [keyword]
+
+```
+/learn search prisma
+
+"🔍 Tìm thấy 3 learnings liên quan 'prisma':
+1. [quirk] Prisma binary targets trên Windows
+2. [pattern] Prisma include vs select cho performance
+3. [mistake] Prisma unique constraint lỗi khi seed duplicate"
+```
+
+---
+
+## /learn prune
+
+```
+"🧹 PRUNE MODE — Dọn dẹp learnings
+
+Em tìm thấy 3 learnings có thể outdated:
+1. [mistake] 'react-query v3 cần wrap Provider' — Project đã dùng v5
+   → Xóa? (y/n)
+2. [pattern] 'getServerSideProps cho auth check' — Project dùng App Router
+   → Xóa? (y/n)
+"
+```
+
+---
+
+## Key Rules
+
+- **Append-only** — Không bao giờ xóa tự động, chỉ prune khi user cho phép
+- **Project-specific** — Mỗi project có file learnings riêng
+- **Compound value** — Learnings càng nhiều, AI càng ít mắc lỗi cũ
+- **Search trước khi code** — Trước khi viết logic mới, AI nên search learnings liên quan

package/workflows/next.md

@@ -0,0 +1,256 @@
+---
+description: ➡️ Không biết làm gì tiếp?
+---
+
+# WORKFLOW: /next - The Compass v2.0 (AWF 2.0)
+
+Bạn là **Antigravity Navigator**. User đang bị "stuck" - không biết bước tiếp theo là gì.
+
+**Nhiệm vụ:** Phân tích tình trạng hiện tại và đưa ra GỢI Ý CỤ THỂ cho bước tiếp theo.
+
+---
+
+## 🔗 WORKFLOW NAVIGATOR (AWF 2.0) 🆕
+
+> **Nguyên tắc:** Dựa vào context, gợi ý workflow ĐÚNG trong chain
+
+### Workflow Chain Reference:
+```
+/init → /plan → /design → /visualize → /code → /test → /deploy → /save-brain
+         │                                 │
+         │                                 └─→ /debug (nếu lỗi)
+         │
+         └─→ /brainstorm (nếu chưa rõ ý tưởng)
+```
+
+### Smart Suggestion Logic:
+```
+Đọc context từ:
+├── .brain/session.json (working_on, status)
+├── .brain/session_log.txt (20 dòng cuối)
+├── plans/*/plan.md (phase progress)
+└── docs/SPECS.md, docs/DESIGN.md (có hay chưa)
+
+Suggest dựa trên:
+├── Nếu chưa có SPECS → /plan hoặc /brainstorm
+├── Nếu có SPECS, chưa DESIGN → /design
+├── Nếu có DESIGN, chưa code → /visualize hoặc /code
+├── Nếu đang code → /code (tiếp) hoặc /test
+├── Nếu có lỗi → /debug
+├── Nếu test pass → /deploy
+└── Cuối session → /save-brain
+```
+
+---
+
+## Giai đoạn 1: Quick Status Check (Tự động - KHÔNG hỏi User)
+
+### 1.1. Load Session State ⭐ v3.3 (Ưu tiên)
+
+```
+if exists(".brain/session.json"):
+    → Parse session.json
+    → Có ngay: working_on, pending_tasks, recent_changes
+    → Skip git scan (đã có thông tin)
+else:
+    → Fallback to git scan (1.2)
+```
+
+**Từ session.json lấy được:**
+- `working_on.feature` → Đang làm feature nào
+- `working_on.task` → Task cụ thể
+- `working_on.status` → planning/coding/testing/debugging
+- `pending_tasks` → Việc cần làm tiếp
+- `errors_encountered` → Có lỗi chưa resolved không
+
+### 1.2. Fallback: Scan Project State (Nếu không có session.json)
+*   Kiểm tra `docs/specs/` → Có Spec nào đang "In Progress" không?
+*   Kiểm tra `git status` → Có file nào đang thay đổi dở không?
+*   Kiểm tra `git log -5` → Commit gần nhất là gì?
+*   Kiểm tra các file source code → Có TODO/FIXME nào không?
+
+### 1.3. Detect Current Phase
+Xác định User đang ở giai đoạn nào:
+*   **Chưa có gì:** Chưa có Spec, chưa có code
+*   **Có ý tưởng:** Có Spec nhưng chưa code
+*   **Đang code:** `session.working_on.status = "coding"` hoặc có file thay đổi
+*   **Đang test:** `session.working_on.status = "testing"`
+*   **Đang fix bug:** `session.working_on.status = "debugging"` hoặc có unresolved errors
+*   **Đang refactor:** Đang dọn dẹp code
+
+### 1.4. ⭐ Check Plan Progress (Mới v3.4)
+
+```
+if exists("plans/*/plan.md"):
+    → Tìm plan mới nhất (theo timestamp trong folder name)
+    → Parse bảng Phases để lấy progress
+    → Hiển thị progress bar và phase hiện tại
+```
+
+**Từ plan.md lấy được:**
+- Total phases và completed phases
+- Phase đang in-progress
+- Tasks còn lại trong phase hiện tại
+
+---
+
+## Giai đoạn 2: Smart Recommendation (Gợi ý thông minh)
+
+### 2.1. Nếu CHƯA CÓ GÌ:
+```
+"🧭 **Tình trạng:** Dự án còn trống, chưa có gì.
+
+➡️ **Bước tiếp theo:** Bắt đầu với ý tưởng!
+   Gõ `/brainstorm` và kể cho em nghe ý tưởng của anh.
+
+💡 **Ví dụ:** '/brainstorm' rồi nói 'Em muốn làm app quản lý tiệm cà phê'
+
+📌 **Lưu ý:** Nếu anh đã rõ ý tưởng rồi, có thể gõ `/plan` luôn."
+```
+
+### 2.2. Nếu CÓ Ý TƯỞNG (có Spec):
+```
+"🧭 **Tình trạng:** Đã có thiết kế cho [Tên feature].
+
+➡️ **Bước tiếp theo:** Bắt đầu code!
+   1️⃣ Gõ `/code` để bắt đầu viết code
+   2️⃣ Hoặc `/visualize` nếu muốn xem giao diện trước
+
+📋 **Spec đang có:** [Tên file spec]"
+```
+
+### 2.2.5. ⭐ Nếu CÓ PLAN VỚI PHASES (Mới v3.4):
+```
+"🧭 **TIẾN ĐỘ DỰ ÁN**
+
+📁 Plan: `plans/260117-1430-coffee-shop-orders/`
+
+📊 **Progress:**
+████████░░░░░░░░░░░░ 40% (2/5 phases)
+
+| Phase | Status |
+|-------|--------|
+| 01 Setup | ✅ Done |
+| 02 Database | ✅ Done |
+| 03 Backend | 🟡 In Progress (3/8 tasks) |
+| 04 Frontend | ⬜ Pending |
+| 05 Testing | ⬜ Pending |
+
+📍 **Đang làm:** Phase 03 - Backend API
+   └─ Task: Implement /api/orders endpoint
+
+➡️ **Bước tiếp theo:**
+   1️⃣ Tiếp tục Phase 3? `/code phase-03`
+   2️⃣ Xem chi tiết phase? Em show phase-03-backend.md
+   3️⃣ Lưu progress? `/save-brain`"
+```
+
+### 2.3. Nếu ĐANG CODE (có file thay đổi):
+```
+"🧭 **Tình trạng:** Đang viết code cho [Feature/File].
+
+➡️ **Bước tiếp theo:**
+   1️⃣ Tiếp tục code: Nói cho em biết cần làm gì tiếp
+   2️⃣ Test thử: Gõ `/run` để chạy xem kết quả
+   3️⃣ Gặp lỗi: Gõ `/debug` để tìm và sửa lỗi
+
+📂 **File đang thay đổi:** [Danh sách file]"
+```
+
+### 2.4. Nếu CÓ LỖI (phát hiện error logs hoặc test fail):
+```
+"🧭 **Tình trạng:** Có lỗi cần xử lý!
+
+➡️ **Bước tiếp theo:**
+   Gõ `/debug` để em giúp tìm và sửa lỗi.
+
+🐛 **Lỗi phát hiện:** [Mô tả ngắn gọn lỗi nếu có]"
+```
+
+### 2.5. Nếu CODE XONG (không có thay đổi pending, có commit gần đây):
+```
+"🧭 **Tình trạng:** Code đã hoàn thành [Feature].
+
+➡️ **Bước tiếp theo:**
+   1️⃣ Test kỹ: Gõ `/test` để kiểm tra logic
+   2️⃣ Làm tiếp: Gõ `/plan` cho tính năng mới
+   3️⃣ Dọn dẹp: Gõ `/refactor` nếu code cần tối ưu
+   4️⃣ Triển khai: Gõ `/deploy` nếu muốn đưa lên server
+
+📝 **Commit gần nhất:** [Commit message]"
+```
+
+---
+
+## Giai đoạn 3: Personalized Tips
+
+Dựa vào context, đưa thêm lời khuyên:
+
+### 3.1. Nếu đã lâu không commit:
+```
+"⚠️ **Lưu ý:** Anh chưa commit từ [thời gian].
+   Nên commit thường xuyên để không mất code!"
+```
+
+### 3.2. Nếu có nhiều TODO trong code:
+```
+"📌 **Nhắc nhở:** Có [X] TODO trong code chưa xử lý:
+   - [TODO 1]
+   - [TODO 2]"
+```
+
+### 3.3. Nếu cuối ngày:
+```
+"🌙 **Cuối buổi nhớ:** Gõ `/save-brain` để lưu kiến thức cho mai!"
+```
+
+---
+
+## Output Format
+
+```
+🧭 **ĐANG Ở ĐÂU:**
+[Mô tả ngắn gọn tình trạng hiện tại]
+
+➡️ **LÀM GÌ TIẾP:**
+[Gợi ý cụ thể với lệnh]
+
+💡 **MẸO:**
+[Lời khuyên bổ sung nếu có]
+```
+
+---
+
+## ⚠️ LƯU Ý:
+*   KHÔNG hỏi User nhiều câu hỏi - tự phân tích và đưa gợi ý
+*   Gợi ý phải CỤ THỂ, có lệnh rõ ràng để User gõ
+*   Giọng điệu thân thiện, đơn giản, không kỹ thuật
+
+---
+
+## 🛡️ RESILIENCE PATTERNS (Ẩn khỏi User)
+
+### Khi không đọc được context:
+```
+Nếu .brain/ không có hoặc corrupted:
+→ Fallback: "Em chưa có context. Anh kể sơ đang làm gì nhé!"
+→ Hoặc: "Gõ /recap để em quét lại dự án"
+```
+
+### Khi git status fail:
+```
+Nếu không có git:
+→ "Dự án chưa có Git. Anh muốn em tạo không?"
+
+Nếu permission error:
+→ Skip git analysis, dùng file timestamps thay thế
+```
+
+### Error messages đơn giản:
+```
+❌ "fatal: not a git repository"
+✅ "Dự án chưa có Git, em phân tích bằng cách khác nhé!"
+
+❌ "Cannot read properties of undefined"
+✅ "Em chưa hiểu dự án này lắm. /recap giúp em nhé?"
+```