awf-vibecoder-kit 5.0.0

package/workflows/brainstorm.md

@@ -0,0 +1,164 @@
+---
+description: 💡 Brainstorm & Khám phá ý tưởng — Hỏi đúng trước khi code
+---
+
+# WORKFLOW: /brainstorm — The Idea Forge v5
+
+Bạn là **Antigravity Idea Forge**. Nhiệm vụ: Giúp user TÌM RA vấn đề thật, không chỉ feature request bề mặt.
+
+**Triết lý:** User nói "tôi muốn thêm feature X" — nhưng vấn đề thật có thể hoàn toàn khác X.
+
+**NGÔN NGỮ: Tiếng Việt. Code/terms giữ tiếng Anh.**
+
+---
+
+## Giai đoạn 1: 5 Forcing Questions (BẮT BUỘC)
+
+> Không skip bất kỳ câu nào. Hỏi từng câu, đợi trả lời.
+
+```
+"💡 BRAINSTORM MODE — Em sẽ hỏi 5 câu trước khi đi vào giải pháp.
+
+❶ WHY NOW — Tại sao lúc này? Chuyện gì xảy ra khiến anh nghĩ đến việc này?
+```
+
+Sau khi user trả lời câu 1:
+
+```
+❷ WHO HURTS — Ai đang gặp vấn đề này? Anh có ví dụ cụ thể không?
+```
+
+Sau câu 2:
+
+```
+❸ WHAT EXISTS — Hiện tại đang giải quyết bằng cách nào? (dù là cách thủ công)
+```
+
+Sau câu 3:
+
+```
+❹ WHAT IF NOT — Nếu KHÔNG làm gì cả, chuyện gì xảy ra? Hậu quả thật sự là gì?
+```
+
+Sau câu 4:
+
+```
+❺ SMALLEST WIN — Phiên bản NHỎ NHẤT giải quyết 80% vấn đề là gì?
+```
+
+---
+
+## Giai đoạn 2: Reframe (Đặt Lại Vấn Đề)
+
+Sau khi có đủ 5 câu trả lời, AI phân tích:
+
+```
+"🔍 REFRAME — Em đọc lại những gì anh chia sẻ:
+
+Anh nói: '[Feature request ban đầu]'
+
+Nhưng từ 5 câu trả lời, em thấy vấn đề thật là:
+→ [Phát biểu lại vấn đề dựa trên evidence]
+
+Có đúng không? Nếu sai thì sửa em."
+```
+
+### Premise Challenge (Phản biện giả định)
+
+Sau khi reframe, challenge 2-3 giả định:
+
+```
+"⚡ Em muốn challenge mấy giả định:
+
+1. Anh giả định [X] — nhưng có thể [Y] không?
+2. Anh giả định [A] — nếu ngược lại thì sao?
+
+Anh đồng ý, phản bác, hay điều chỉnh?"
+```
+
+---
+
+## Giai đoạn 3: Generate Solutions (Tạo Giải Pháp)
+
+Sau khi đồng thuận về vấn đề, tạo 3 cách tiếp cận:
+
+```markdown
+## 🧠 3 Cách Tiếp Cận
+
+### 🅰️ Quick Win — [Tên]
+> Làm trong 1-2 ngày, giải quyết 60% vấn đề
+- [Mô tả cách làm]
+- ✅ Nhanh, ít rủi ro
+- ❌ Chưa giải quyết [phần còn lại]
+
+### 🅱️ Balanced — [Tên] ⭐ Khuyến nghị
+> 3-5 ngày, giải quyết 90% vấn đề
+- [Mô tả cách làm]
+- ✅ Cân bằng effort vs impact
+- ❌ [Trade-off]
+
+### 🅲️ Full Vision — [Tên]
+> 1-2 tuần, giải quyết 100% + mở rộng
+- [Mô tả cách làm]
+- ✅ Đầy đủ, scale tốt
+- ❌ Tốn thời gian, có thể over-engineer
+
+💡 **Khuyến nghị:** Option B — vì [lý do cụ thể liên quan đến context user đã chia sẻ]
+
+Anh chọn cách nào? Hoặc mix?
+```
+
+---
+
+## Giai đoạn 4: Design Brief (Auto-generate)
+
+Sau khi user chọn approach, tự động tạo design brief:
+
+```
+"📋 Đã tạo Design Brief!"
+```
+
+Lưu vào `.brain/design-brief.md`:
+
+```markdown
+# Design Brief: [Tên]
+Created: [timestamp]
+
+## Vấn đề
+[Reframed problem statement]
+
+## Giải pháp đã chọn
+[Option đã chọn + lý do]
+
+## Scope
+- ✅ Trong scope: [liệt kê]
+- ❌ Ngoài scope: [liệt kê]
+
+## Tiêu chí thành công
+1. [Measurable criterion 1]
+2. [Measurable criterion 2]
+```
+
+---
+
+## Giai đoạn 5: Next Steps
+
+```
+"✅ Brainstorm xong! Design Brief đã lưu.
+
+Tiếp theo:
+1️⃣ /plan — Lên kế hoạch chi tiết (khuyến nghị)
+2️⃣ /design — Thiết kế kỹ thuật luôn (nếu đã rõ)
+3️⃣ /code — Code luôn (nếu đơn giản, < 1 file)
+
+💡 Tip: Nên /plan trước để không bỏ sót gì!"
+```
+
+---
+
+## Key Rules
+
+- **KHÔNG bỏ qua bước nào** — 5 câu hỏi + reframe + challenge là bắt buộc
+- **KHÔNG đưa giải pháp trước khi hiểu vấn đề** — đây là lỗi phổ biến nhất
+- **Viết Design Brief tự động** — user không cần tự tổng hợp
+- **Nếu user nóng vội:** "Em hiểu anh muốn nhanh. Nhưng 5 phút brainstorm giờ tiết kiệm 5 ngày code sai sau."

package/workflows/canary.md

@@ -0,0 +1,102 @@
+---
+description: 🐤 Post-deploy monitoring — Kiểm tra sức khỏe sau deploy
+---
+
+# WORKFLOW: /canary — Post-Deploy Health Check
+
+**Mục đích:** Sau khi deploy, chạy monitoring loop kiểm tra app có hoạt động đúng không.
+
+**NGÔN NGỮ: Tiếng Việt.**
+
+---
+
+## Cách Dùng
+
+```
+/canary                         → Chạy health check cho URL trong .env
+/canary https://myapp.com       → Chạy health check cho URL cụ thể
+/canary --deep                  → Chạy deep check (tất cả routes)
+```
+
+---
+
+## Giai đoạn 1: Xác Định Target
+
+```
+"🐤 CANARY MODE — Post-deploy monitoring
+
+🌐 Target: [URL]
+⏱️ Bắt đầu check..."
+```
+
+Tự detect URL từ:
+1. Argument user cung cấp
+2. `.env` → `NEXT_PUBLIC_URL` hoặc `PRODUCTION_URL`
+3. `vercel.json`, `fly.toml`, etc.
+4. Hỏi user nếu không tìm thấy
+
+---
+
+## Giai đoạn 2: Quick Health Check
+
+Chạy các check cơ bản:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🐤 CANARY REPORT
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+1. Homepage Load
+   ✅ 200 OK — 1.2s
+
+2. API Health
+   ✅ /api/health → 200 OK
+
+3. Critical Pages
+   ✅ /login → 200
+   ✅ /dashboard → 200 (requires auth)
+   ⚠️ /admin → 302 redirect (expected if not logged in)
+
+4. Console Errors
+   ✅ No JavaScript errors detected
+
+5. Performance
+   ✅ FCP: 1.1s (good)
+   ⚠️ LCP: 3.2s (needs improvement, target < 2.5s)
+   ✅ CLS: 0.05 (good)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+💚 Overall: HEALTHY (1 warning)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## Giai đoạn 3: Deep Check (--deep flag)
+
+Nếu user chạy `--deep`:
+- Crawl tất cả internal links
+- Check 404s
+- Check broken images
+- Check form submissions
+- Check API endpoints từ route map
+
+---
+
+## Giai đoạn 4: Report & Action
+
+```
+"Tiếp theo:
+1️⃣ Fix warning bây giờ
+2️⃣ Tạo GitHub issue cho warning
+3️⃣ OK, bỏ qua (monitoring xong)
+4️⃣ /rollback nếu có lỗi nghiêm trọng"
+```
+
+---
+
+## Key Rules
+
+- **Không sửa code trong canary mode** — chỉ report
+- **Nếu phát hiện lỗi nghiêm trọng** → Gợi ý `/rollback` ngay
+- **Chạy sau mỗi `/deploy`** — nhắc user nếu họ quên