anchi-kit 2.0.2 → 2.0.3

package/.cursor/UX_GUIDELINES.md

@@ -0,0 +1,126 @@
+# 💬 UX Guidelines for anchi-kit
+
+> Hướng dẫn tương tác với user để AI thân thiện và dễ sử dụng hơn.
+
+---
+
+## 1. Welcome Messages
+
+Mỗi command nên bắt đầu với greeting ngắn gọn:
+
+```markdown
+👋 /[command] đang chạy!
+[Mô tả ngắn về command sẽ làm gì]
+```
+
+**Ví dụ:**
+```markdown
+👋 /plan đang chạy!
+Tôi sẽ tạo kế hoạch chi tiết cho feature của bạn.
+```
+
+---
+
+## 2. Progress Indicators
+
+Khi thực hiện nhiều bước, show progress:
+
+```markdown
+📊 Đang thực hiện...
+
+[1/4] 🔍 Phân tích yêu cầu...
+[2/4] 📚 Đọc codebase liên quan...
+[3/4] 📝 Tạo kế hoạch...
+[4/4] ✅ Hoàn tất!
+```
+
+---
+
+## 3. Interactive Confirmations
+
+Thay vì `[Y/n]`, dùng format rõ ràng:
+
+```markdown
+📋 **Tóm tắt thay đổi:**
+• Tạo: `user.service.ts`
+• Sửa: `api/users/route.ts`
+• Thêm: 2 types
+
+👉 **Tiếp tục?**
+- Gõ `ok` hoặc `y` để thực hiện
+- Gõ feedback để tôi điều chỉnh
+```
+
+---
+
+## 4. Friendly Error Messages
+
+```markdown
+❌ **Lỗi:** [Mô tả ngắn]
+
+💡 **Gợi ý:**
+• [Cách fix 1]
+• [Cách fix 2]
+
+📌 **Thử lại:** [Command gợi ý]
+```
+
+---
+
+## 5. Quick Actions Menu
+
+Sau mỗi command, suggest next steps:
+
+```markdown
+✅ **Xong!**
+
+📌 **Tiếp theo:**
+• `/cook "Phase 1"` - Bắt đầu implement
+• `/review` - Review trước khi làm
+• Feedback - Để tôi điều chỉnh
+```
+
+---
+
+## 6. Session Summary Cards
+
+Cuối session quan trọng, show summary:
+
+```markdown
+┌─────────────────────────────────────┐
+│ 📊 SUMMARY                          │
+├─────────────────────────────────────┤
+│ ✅ Created: X files                 │
+│ 📝 Modified: Y files                │
+│ 🧪 Tests: Passed                    │
+├─────────────────────────────────────┤
+│ 📌 Next: /cook "Phase 2"            │
+└─────────────────────────────────────┘
+```
+
+---
+
+## Tone Guidelines
+
+| ❌ Tránh | ✅ Nên dùng |
+|---------|------------|
+| Formal, dài dòng | Ngắn gọn, thân thiện |
+| Technical jargon | Giải thích đơn giản |
+| Y/n | ok/feedback |
+| Error occurred | ❌ Lỗi: [chi tiết] |
+
+---
+
+## Emoji Usage
+
+| Emoji | Ý nghĩa |
+|-------|---------|
+| 👋 | Welcome |
+| 📊 | Progress/Summary |
+| ✅ | Success/Done |
+| ❌ | Error |
+| 💡 | Tip/Suggestion |
+| 📌 | Next steps |
+| ⚠️ | Warning |
+| 🔍 | Analyzing |
+| 📝 | Writing/Creating |

package/.cursor/commands/cook.md

@@ -97,4 +97,47 @@ Analyze `.cursor/skills/*` and activate only what's needed:
 - **Don't over-engineer**: Simple solutions preferred
 - **Ask once**: Batch related questions together
 - **Skip liberally**: Not every task needs every stage
-- **User approval**: Always get approval before destructive changes
+- **User approval**: Always get approval before destructive changes
+
+---
+
+## UX Guidelines (REQUIRED)
+
+**Read `.cursor/UX_GUIDELINES.md` for interaction patterns.**
+
+### Welcome
+```
+👋 /cook đang chạy!
+[Mô tả ngắn task sẽ làm]
+```
+
+### Progress (cho multi-step)
+```
+📊 Đang thực hiện...
+
+[1/4] 🔍 Research...
+[2/4] 📝 Plan...
+[3/4] 💻 Implement...
+[4/4] 🧪 Test...
+```
+
+### Summary Card (cuối session)
+```
+┌─────────────────────────────────────┐
+│ 📊 SUMMARY                          │
+├─────────────────────────────────────┤
+│ ✅ Created: X files                 │
+│ 📝 Modified: Y files                │
+│ 🧪 Tests: Passed                    │
+├─────────────────────────────────────┤
+│ 📌 Next: /cook "Phase 2"            │
+└─────────────────────────────────────┘
+```
+
+### Quick Actions
+```
+📌 **Tiếp theo:**
+• `/review` - Review code
+• `/test` - Run tests
+• `/cook "Next phase"` - Tiếp tục
+```

package/.cursor/commands/fix.md

@@ -91,4 +91,37 @@ User disagrees with routing?
 
 - `detailed-description` = Enhanced prompt with context
 - Skip pre-requisites for obvious quick fixes
-- Trust user's judgment on complexity
+- Trust user's judgment on complexity
+
+---
+
+## UX Guidelines (REQUIRED)
+
+**Read `.cursor/UX_GUIDELINES.md` for interaction patterns.**
+
+### Welcome
+```
+👋 /fix đang chạy!
+Tôi sẽ giúp bạn debug và fix issue này.
+```
+
+### Friendly Error Messages
+```
+❌ **Lỗi:** [Mô tả ngắn gọn]
+
+💡 **Gợi ý:**
+• [Cách fix 1]
+• [Cách fix 2]
+
+📌 **Thử:** [Command suggestion]
+```
+
+### Quick Actions (cuối)
+```
+✅ Issue đã fix!
+
+📌 **Tiếp theo:**
+• `/test` - Verify fix
+• `/review` - Review changes
+• `/cook` - Continue with next task
+```

package/.cursor/commands/plan.md

@@ -70,3 +70,41 @@ Before delegating to plan subcommands, check for existing active plan:
 - You MAY skip pre-requisites reading if task is obvious and simple
 - You MAY ask user which planning mode they prefer
 - You MAY combine insights from previous conversations
+
+---
+
+## UX Guidelines (REQUIRED)
+
+**Read `.cursor/UX_GUIDELINES.md` for interaction patterns.**
+
+### Welcome
+```
+👋 /plan đang chạy!
+Tôi sẽ tạo kế hoạch chi tiết cho feature của bạn.
+```
+
+### Progress
+```
+[1/3] 🔍 Phân tích yêu cầu...
+[2/3] 📚 Đọc codebase liên quan...
+[3/3] 📝 Tạo kế hoạch...
+```
+
+### Confirmation (thay vì Y/n)
+```
+📋 **Tóm tắt kế hoạch:**
+• [Bước 1]
+• [Bước 2]
+
+👉 Gõ `ok` để tiếp tục, hoặc feedback để điều chỉnh
+```
+
+### Quick Actions (cuối command)
+```
+✅ Plan đã tạo!
+
+📌 **Tiếp theo:**
+• `/cook "Phase 1"` - Implement
+• `/review` - Review trước
+• Feedback - Để tôi điều chỉnh
+```

package/.cursor/commands/start.md

@@ -4,16 +4,20 @@ description: ⚡⚡⚡⚡ Bắt đầu sử dụng anchi-kit - Entry point cho m
 
 # INSTRUCTION: Follow this workflow exactly
 
-**IMMEDIATELY ask the user:**
+**Read `.cursor/UX_GUIDELINES.md` first for interaction patterns.**
+
+**IMMEDIATELY show welcome and ask:**
 
 ```
-🚀 Chào mừng đến với anchi-kit!
+👋 Chào mừng đến với anchi-kit!
 
-Dự án này là:
-1️⃣ **Dự án có sẵn** - Đã có code, muốn tích hợp anchi-kit
-2️⃣ **Dự án mới** - Bắt đầu từ đầu
+Tôi sẽ giúp bạn setup dự án. Chỉ cần trả lời 1 câu hỏi:
 
-Chọn (1 hoặc 2):
+📂 Dự án của bạn là:
+  1️⃣ Dự án có sẵn - Đã có code
+  2️⃣ Dự án mới - Bắt đầu từ đầu
+
+👉 Gõ 1 hoặc 2:
 ```
 
 **Wait for user response before doing anything else.**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anchi-kit",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "Cursor AI toolkit - Install into any existing project. Includes commands, agents, skills, and architecture presets.",
   "main": "src/cli.js",
   "bin": {