anchi-kit 2.2.0 → 2.3.0

package/README.md

@@ -1,134 +1,363 @@
 # anchi-kit
 
-Template toàn diện cho việc phát triển webapp với **Cursor AI**.
+**Cursor AI Toolkit** - Bộ công cụ hoàn chỉnh hỗ trợ làm việc với Cursor AI cho cá nhân và team.
 
-> ⚡ **Bắt đầu:** `/start` - Entry point cho mọi dự án
+> 🚀 **Version 2.2.0** | 70+ commands | 6 profiles | 3 presets
 
 ---
 
-## 🎯 3 Architecture Presets
+## 📖 Mục Lục
 
-| Preset | Khi dùng | Command |
-|--------|----------|---------|
-| 🚀 **Rapid** | Demo, MVP, hackathon (< 2 tuần) | `/use-preset rapid` |
-| 🏢 **Professional** | Sản phẩm thương mại (1-6 tháng) | `/use-preset professional` |
-| 🏛️ **Enterprise** | Dự án lớn, DDD (> 6 tháng) | `/use-preset enterprise` |
+- [Ứng Dụng](#-ứng-dụng)
+- [Lợi Ích](#-lợi-ích)
+- [Cài Đặt](#-cài-đặt)
+- [Pipeline Cá Nhân](#-pipeline-cho-cá-nhân)
+- [Pipeline Team](#-pipeline-cho-team)
+- [Commands](#-tất-cả-commands)
+- [Presets](#️-architecture-presets)
+- [Configuration](#-configuration)
 
-```
-🚀 Rapid ──────► 🏢 Professional ──────► 🏛️ Enterprise
- (SQLite)         (PostgreSQL)           (DDD + Events)
- (Flat)           (Modules)              (Full DDD)
-```
+---
+
+## 🎯 Ứng Dụng
+
+### Ai nên dùng?
+
+| Đối tượng | Ứng dụng | Lợi ích |
+|-----------|----------|---------|
+| **Cá nhân** | Side project, freelance | Coding nhanh x3, AI review |
+| **Startup** | MVP, prototype | Ship trong 1-2 tuần |
+| **Team nhỏ** | 2-10 người | Workflow chuẩn, code consistent |
+| **Enterprise** | Dự án lớn | DDD patterns, maintainable |
+
+### Phù hợp với dự án nào?
+
+- ✅ Web app (Next.js, React, Vue)
+- ✅ API backend (Node.js, Express)
+- ✅ Full-stack application
+- ✅ SaaS products
+- ✅ E-commerce
+- ✅ Dashboard & Admin panel
+
+---
+
+## ✨ Lợi Ích
+
+### Cho Cá Nhân
+
+| Lợi ích | Chi tiết |
+|---------|----------|
+| ⚡ **Tốc độ x3** | AI tự động plan, implement, test - bạn chỉ review |
+| 🧠 **Context thông minh** | AI hiểu codebase qua docs và skills |
+| 🔄 **Auto mode** | `/plan:auto` và `/cook:auto` giảm 80% input |
+| 📝 **Documentation** | Tự động update docs khi code thay đổi |
+| 🐛 **Debug nhanh** | AI phân tích logs, suggest fix |
+| 🎨 **Code quality** | Auto review, suggest improvements |
+
+### Cho Team
 
-**Các preset tương thích - dễ dàng upgrade khi cần!**
+| Lợi ích | Chi tiết |
+|---------|----------|
+| 📋 **Workflow chuẩn** | Tất cả dùng chung quy trình, commands |
+| 🔍 **Code review x2** | AI review trước, human review sau |
+| 🚀 **Onboarding 1 ngày** | Member mới productive ngay |
+| 📊 **Consistency** | Code style, naming, patterns nhất quán |
+| 🤝 **Collaboration** | Plan approval, PR templates |
+| 📈 **Scalable** | Migrate từ rapid → professional → enterprise |
 
 ---
 
-## 🚀 Quick Start
+## 🚀 Cài Đặt
 
-### Phương thức 1: Smart Install (Khuyến nghị)
+### Yêu Cầu
+- Node.js 18+
+- Git
+- Cursor IDE
 
+### Cài Đặt Smart (Khuyến nghị)
 ```bash
-cd your-existing-project
+cd your-project
 npx anchi-kit init
 ```
 
-> 💡 **v2.0**: Chọn role profile + tech auto-detect + skill packs
-
-**Profiles có sẵn:**
-| Profile | Mô tả |
-|---------|-------|
-| Minimal | Core commands (5 files) |
-| Developer | Daily coding |
-| UI/UX | Frontend & design |
-| Full Stack | Everything |
-
-### Phương thức 2: Cài Nhanh
+Wizard sẽ hỏi:
+1. Chọn profile (Developer, UI/UX, Lead, etc.)
+2. Auto-detect tech stack
+3. Suggest skill packs phù hợp
 
+### Cài Đặt Nhanh
 ```bash
-npx anchi-kit install    # Tất cả files
+npx anchi-kit install    # Cài tất cả
 npx anchi-kit uninstall  # Gỡ cài đặt
 ```
 
-### Phương thức 3: Tạo Dự Án Mới
+### Kiểm Tra Setup
+```bash
+npx anchi-kit doctor
+```
+
+Output:
+```
+🩺 anchi-kit Doctor
+═══════════════════════════════════════════════════════════════
+
+  ✅ .cursor folder
+  ✅ Commands (74 files)
+  ✅ Agents (12 files)
+  ✅ .cursorrules
+  ✅ Config file
+
+✅ All checks passed! anchi-kit is healthy.
+```
 
+---
+
+## 👤 Pipeline Cho Cá Nhân
+
+### Bước 1: Setup (1 lần)
 ```bash
-git clone https://github.com/ANCHI-STE/anchi-webkit-dev.git my-project
-cd my-project && cursor .
+npx anchi-kit init
+→ Chọn: Developer hoặc Full Stack profile
+→ Mở project trong Cursor
 ```
 
-### Bước tiếp theo
+### Bước 2: Khởi Động
+```
+Mở Chat Panel (Ctrl+L)
+Gõ: /start
+
+AI hỏi:
+  1️⃣ Dự án có sẵn - AI scan codebase
+  2️⃣ Dự án mới - Chọn preset
+```
 
-Mở **Chat Panel** (`Ctrl+L`) và chạy:
+### Bước 3: Workflow Hàng Ngày
 
 ```
-/start
+📋 STANDARD WORKFLOW
+
+┌─────────────────────────────────────────────────────────────┐
+│  /plan "Feature"    →  AI tạo kế hoạch chi tiết             │
+│         ↓                                                   │
+│  Review plan        →  OK hoặc feedback để điều chỉnh       │
+│         ↓                                                   │
+│  /cook "Phase 1"    →  AI implement code                    │
+│         ↓                                                   │
+│  /test              →  AI viết và chạy tests                │
+│         ↓                                                   │
+│  /review            →  AI review code                       │
+│         ↓                                                   │
+│  git commit & push  →  Done! 🎉                             │
+└─────────────────────────────────────────────────────────────┘
 ```
 
-AI sẽ hỏi:
-- **"1" (Dự án có sẵn)** → Auto scan → Fill docs
-- **"2" (Dự án mới)** → Chọn preset → Setup
+### Bước 4: Auto Mode (Nhanh hơn)
 
 ```
-/plan "First feature"
-/cook "Phase 1"
+📋 AUTO-PILOT WORKFLOW
+
+/plan:auto "Add user authentication"
+   ↓
+AI tự động:
+  [1/4] 🔍 Analyzing...
+  [2/4] 📝 Creating plan...
+  [3/4] ✅ Auto-approved (simple task)
+  [4/4] 🚀 Starting implementation...
+   ↓
+/cook:auto "Continue"
+   ↓
+AI implement liên tục, chỉ hỏi khi:
+  - Gặp error
+  - Tests fail
+  - Cần clarification
 ```
 
+### Tips Cá Nhân
+
+| Situation | Command |
+|-----------|---------|
+| Feature mới | `/plan` → `/cook` |
+| Fix bug nhanh | `/fix:fast` |
+| Không biết bắt đầu | `/scout` → `/suggest` |
+| Tìm hiểu code | `/context "topic"` |
+
 ---
 
-## ⚡ Commands Hay Dùng
+## 👥 Pipeline Cho Team
 
-| Command | Mô tả |
-|---------|-------|
-| `/start` | **🔥 Entry point** - Bắt đầu mọi dự án |
-| `/use-preset [name]` | Chọn architecture (rapid/professional/enterprise) |
-| `/plan "..."` | Lập kế hoạch feature |
-| `/plan:auto "..."` | Auto-pilot planning |
-| `/cook "..."` | Implement theo plan |
-| `/cook:auto "..."` | Auto-pilot implementation |
-| `/scout "..."` | Tìm hiểu codebase |
-| `/fix "..."` | Sửa bug |
-| `/generate:page` | **NEW** Tạo page boilerplate |
-| `/generate:api` | **NEW** Tạo API route |
-| `/generate:component` | **NEW** Tạo component |
-| `/context` | **NEW** Xem AI context |
-| `/suggest` | **NEW** AI gợi ý action |
-
----
-
-## 📂 Cấu Trúc Template
-
-```
-anchi-kit/
-│
-├── src/                         # CLI source code
-│   └── cli.js                   # npx anchi-kit install
-│
-├── scripts/                     # Setup & install scripts
-│   ├── install.ps1              # Windows install
-│   ├── install.sh               # macOS/Linux install
-│   └── setup-*.ps1/.sh          # Preset setup scripts
-│
-├── presets/                     # 3 Architecture Presets
-│   ├── rapid-mvp/               # 🚀 Quick development
-│   ├── professional/            # 🏢 Scalable production
-│   ├── enterprise/              # 🏛️ Full DDD
-│   └── MIGRATION_GUIDE.md       # Hướng dẫn migrate
-│
-├── .cursor/                     # Cursor AI config
-│   ├── agents/                  # AI agents
-│   ├── commands/                # Slash commands
-│   └── skills/                  # Knowledge modules
-│
-├── docs/                        # Documentation templates
-├── .cursorrules                 # Current preset rules
-├── CURSOR.md                    # AI instructions
-└── README.md                    # File này
-```
-
----
-
-## 🎯 Preset Comparison
+### Bước 1: Lead Setup
+
+```bash
+# Lead cài đặt đầu tiên
+npx anchi-kit init
+→ Chọn: Lead profile
+→ Config team.yaml
+→ Push to repo
+```
+
+### Bước 2: Config Team
+
+```yaml
+# .cursor/team.yaml
+team:
+  name: "My Team"
+  project: "E-commerce Platform"
+
+members:
+  - name: Duong
+    role: lead
+    github: "@duong"
+  - name: Nam
+    role: frontend
+  - name: Linh
+    role: backend
+
+roles:
+  lead:
+    profile: fullstack
+    can_approve: true
+  frontend:
+    profile: ui_ux
+  backend:
+    profile: developer
+
+workflows:
+  feature:
+    require_plan: true
+    require_review: true
+    approvers: [lead]
+  hotfix:
+    require_plan: false
+    require_review: false
+```
+
+### Bước 3: Members Setup
+
+```bash
+# Mỗi member clone và cài đặt
+git clone [repo]
+cd project
+npx anchi-kit init
+→ Chọn profile theo role của mình
+```
+
+### Bước 4: Team Workflow
+
+```
+📋 TEAM WORKFLOW
+
+┌─────────────────────────────────────────────────────────────┐
+│  DEVELOPER                          LEAD                    │
+├─────────────────────────────────────────────────────────────┤
+│  /plan "Feature"                                            │
+│         ↓                                                   │
+│  Gửi plan (Slack/PR)   ─────────→   Review plan            │
+│         ↓                                   ↓               │
+│  Chờ approve           ←─────────   ✅ Approve              │
+│         ↓                                                   │
+│  /cook "Phase 1"                                            │
+│         ↓                                                   │
+│  /review                                                    │
+│         ↓                                                   │
+│  Create PR             ─────────→   Review PR              │
+│         ↓                                   ↓               │
+│  Done! 🎉              ←─────────   ✅ Merge               │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Workflow Templates
+
+| Template | Dùng khi | Steps |
+|----------|----------|-------|
+| `feature.yaml` | Feature mới | plan → approve → cook → review → PR |
+| `hotfix.yaml` | Fix gấp | fix:fast → test → commit |
+| `release.yaml` | Release | summary → changelog → test → tag |
+
+---
+
+## ⚡ Tất Cả Commands
+
+### 🎯 Core Commands
+
+| Command | Mô tả | Khi dùng |
+|---------|-------|----------|
+| `/start` | Entry point | Bắt đầu dự án |
+| `/use-preset [name]` | Chọn preset | Setup architecture |
+| `/summary` | Tổng hợp project info | Update docs |
+
+### 📋 Planning Commands
+
+| Command | Mô tả | Khi dùng |
+|---------|-------|----------|
+| `/plan "..."` | Lập kế hoạch chi tiết | Feature mới |
+| `/plan:fast` | Plan nhanh | Task đơn giản |
+| `/plan:auto` | Auto-pilot planning | Muốn nhanh |
+| `/plan:hard` | Plan siêu chi tiết | Task phức tạp |
+| `/brainstorm "..."` | Brainstorm ideas | Explore options |
+
+### 💻 Coding Commands
+
+| Command | Mô tả | Khi dùng |
+|---------|-------|----------|
+| `/cook "..."` | Implement theo plan | Standard workflow |
+| `/cook:auto` | Auto-pilot implement | Muốn nhanh |
+| `/code` | Quick code | Thay đổi nhỏ |
+| `/debug` | Debug issue | Có bug phức tạp |
+
+### 🛠️ Fixing Commands
+
+| Command | Mô tả | Khi dùng |
+|---------|-------|----------|
+| `/fix "..."` | Phân tích và sửa bug | Bug thường |
+| `/fix:fast` | Sửa nhanh | Bug đơn giản |
+| `/fix:types` | Sửa TypeScript errors | TS errors |
+| `/fix:ui` | Sửa UI/CSS | UI broken |
+| `/fix:test` | Sửa test failures | Tests fail |
+
+### 🔍 Exploration Commands
+
+| Command | Mô tả | Khi dùng |
+|---------|-------|----------|
+| `/scout "..."` | Tìm hiểu codebase | Code mới |
+| `/context` | Xem AI context | Debug AI |
+| `/context "topic"` | Find related files | Tìm files |
+| `/suggest` | AI gợi ý action | Không biết làm gì |
+
+### 📝 Generation Commands
+
+| Command | Mô tả | Khi dùng |
+|---------|-------|----------|
+| `/generate:page` | Tạo page | New page |
+| `/generate:api` | Tạo API route | New endpoint |
+| `/generate:component` | Tạo component | New component |
+
+### 🎨 Design Commands
+
+| Command | Mô tả | Khi dùng |
+|---------|-------|----------|
+| `/design-ui "..."` | Thiết kế UI | Design trước code |
+| `/design-domain "..."` | Thiết kế domain | DDD |
+
+### ✅ Quality Commands
+
+| Command | Mô tả | Khi dùng |
+|---------|-------|----------|
+| `/review` | Code review | Trước commit |
+| `/test` | Viết tests | After implement |
+| `/docs:update` | Update docs | After changes |
+
+### 📊 Git Commands
+
+| Command | Mô tả | Khi dùng |
+|---------|-------|----------|
+| `/git:cm` | Smart commit message | Commit |
+| `/git:pr` | Tạo PR description | Create PR |
+
+---
+
+## 🏗️ Architecture Presets
+
+### So Sánh
 
 | Feature | 🚀 Rapid | 🏢 Professional | 🏛️ Enterprise |
 |---------|----------|-----------------|----------------|
@@ -140,63 +369,134 @@ anchi-kit/
 | **Team Size** | 1-2 | 3-10 | 10+ |
 | **Timeline** | < 2 tuần | 1-6 tháng | > 6 tháng |
 
----
+### Chọn Preset
 
-## 🔄 Migration
+```bash
+/use-preset rapid         # Demo, MVP, hackathon
+/use-preset professional  # Sản phẩm thương mại
+/use-preset enterprise    # Dự án lớn, DDD
+```
 
-Khi cần upgrade:
+### Migrate
 
+```bash
+/migrate-to professional  # Upgrade từ rapid
+/migrate-to enterprise    # Upgrade từ professional
 ```
-# Professional → Enterprise
-/migrate-to enterprise
-```
-
-Xem chi tiết: [MIGRATION_GUIDE.md](./presets/MIGRATION_GUIDE.md)
 
 ---
 
-## 📖 Tài Liệu
+## ⚙️ Configuration
 
-| File | Mô tả |
-|------|-------|
-| [BEGINNER_GUIDE_VI.md](./BEGINNER_GUIDE_VI.md) | Hướng dẫn người mới |
-| [CONTRIBUTING.md](./CONTRIBUTING.md) | Hướng dẫn đóng góp |
-| [docs/WORKFLOW.md](./docs/WORKFLOW.md) | **🔥 Pipeline + Git workflow** |
-| [docs/FAQ.md](./docs/FAQ.md) | Câu hỏi thường gặp |
-| [CURSOR.md](./CURSOR.md) | AI instructions |
-| [CHANGELOG.md](./CHANGELOG.md) | Version history |
-| [presets/](./presets/) | Architecture presets |
-| [.cursor/skills/SKILLS_INDEX.md](./.cursor/skills/SKILLS_INDEX.md) | Skill mapping |
+### anchi-kit.config.yaml
+
+```yaml
+# .cursor/anchi-kit.config.yaml
+version: "2.2"
+profile: developer
+
+model_preference:
+  default: auto        # Tự chọn model
+  complex: opus        # Task phức tạp
+  economy: haiku       # Task đơn giản
+
+features:
+  auto_commit: false   # Tự commit sau /cook
+  progress_indicators: true
+  summary_cards: true
+  quick_actions: true
+
+team:
+  role: frontend       # Role của bạn trong team
+  notifications: true
+
+hooks:
+  enabled: false       # Git hooks
+  pre_commit: [review:fast]
+  post_merge: [docs:update]
+```
+
+### Git Hooks
 
-### Setup Scripts
+```bash
+# Cài đặt hooks
+./scripts/install-hooks.ps1   # Windows
+./scripts/install-hooks.sh    # macOS/Linux
+```
 
-| OS | Scripts |
-|----|---------|
-| Windows | `scripts/setup-*.ps1` |
-| macOS/Linux | `scripts/setup-*.sh` |
+Hooks sẽ remind:
+- Pre-commit: `/review:fast`
+- Post-merge: `/docs:update`
 
 ---
 
-## 📋 Workflow Chuẩn
+## 📁 Cấu Trúc Files
 
 ```
-1. /use-preset [name]    → Chọn architecture
-2. Điền docs/            → Mô tả dự án
-3. /plan "feature"       → Lập kế hoạch
-4. /cook "phase"         → Code
-5. /review & /test       → Quality
-6. git commit & push     → Deploy
+.cursor/
+├── commands/              # 70+ slash commands
+│   ├── plan.md, cook.md, fix.md, ...
+│   └── generate/          # Generation commands
+├── agents/                # 12 AI agents
+│   ├── planner.md
+│   ├── fullstack-developer.md
+│   └── ...
+├── skills/                # Knowledge modules
+│   ├── frontend-development/
+│   ├── backend-patterns/
+│   └── ...
+├── anchi-kit.config.yaml  # User config
+├── team.yaml              # Team config
+├── hooks.yaml             # Git hooks config
+└── workflows/             # Workflow templates
+    ├── feature.yaml
+    ├── hotfix.yaml
+    └── release.yaml
 ```
 
 ---
 
+## 🛠️ CLI Commands
+
+| Command | Mô tả |
+|---------|-------|
+| `npx anchi-kit init` | Smart Install (chọn profile) |
+| `npx anchi-kit install` | Cài tất cả files |
+| `npx anchi-kit update` | Kiểm tra cập nhật |
+| `npx anchi-kit uninstall` | Gỡ cài đặt |
+| `npx anchi-kit doctor` | Kiểm tra setup health |
+
+---
+
 ## 🆘 Troubleshooting
 
 | Vấn đề | Giải pháp |
 |--------|-----------|
-| Commands không hoạt động | Dùng trong Chat Panel (`Ctrl+L`), restart Cursor |
-| AI không hiểu dự án | Tag files: `@.cursorrules @docs/PROJECT.md` |
-| Không biết chọn preset | Hỏi Team Lead hoặc dùng `professional` |
+| Commands không work | Dùng trong Chat Panel (Ctrl+L), không phải Terminal |
+| AI không hiểu context | Tag files: `@.cursorrules @docs/PROJECT.md` |
+| Không biết bắt đầu | Chạy `/start` |
+| Setup có vấn đề | Chạy `npx anchi-kit doctor` |
+| Muốn reset | Chạy `npx anchi-kit uninstall` rồi `init` lại |
+
+---
+
+## 🔗 Links
+
+- **GitHub:** https://github.com/ANCHI-STE/anchi-webkit-dev
+- **npm:** https://npmjs.com/package/anchi-kit
+- [Changelog](./CHANGELOG.md)
+
+---
+
+## 📖 Tài Liệu Thêm
+
+| File | Mô tả |
+|------|-------|
+| [USAGE_GUIDE.md](./USAGE_GUIDE.md) | Hướng dẫn sử dụng chi tiết |
+| [BEGINNER_GUIDE_VI.md](./BEGINNER_GUIDE_VI.md) | Hướng dẫn người mới (Tiếng Việt) |
+| [docs/ONBOARDING.md](./docs/ONBOARDING.md) | Checklist onboarding |
+| [docs/WORKFLOW.md](./docs/WORKFLOW.md) | Team workflow chi tiết |
+| [docs/FAQ.md](./docs/FAQ.md) | Câu hỏi thường gặp |
 
 ---
 
@@ -206,4 +506,4 @@ MIT License
 
 ---
 
-**Built with ❤️ by Anchi Team**
+**v2.2.0** | Built with ❤️ by Anchi Team

package/package.json

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

package/src/cli.js

@@ -269,6 +269,11 @@ async function main() {
             await doctor();
             break;
 
+        case 'memory':
+            const { memory } = require('./commands/memory');
+            await memory(args[1], args[2]);
+            break;
+
         default:
             showHelp();
             break;
@@ -285,6 +290,7 @@ function showHelp() {
     log.success('  npx anchi-kit update     Kiểm tra cập nhật');
     log.success('  npx anchi-kit uninstall  Gỡ cài đặt');
     log.success('  npx anchi-kit doctor     Kiểm tra setup health');
+    log.success('  npx anchi-kit memory     Quản lý project context');
     console.log('');
     console.log('Documentation:');
     console.log('  https://github.com/ANCHI-STE/anchi-webkit-dev');